Integration コントロールを使用する

ALSB コントロール

ALSB コントロールを使用すると、Web サービスやビジネス プロセスから AquaLogic Service Bus (ALSB) プロキシ サービスを呼び出したり、セキュリティ コンテキストやトランザクション コンテキストの伝播をサポートしたりできます。

この節に含まれるトピック

概要 : ALSB コントロール

ALSB コントロールを作成する

ALSB コントロールのアノテーション

サンプル : ALSB コントロール

関連トピック

AquaLogic Service Bus ユーザーズ ガイド

サービス ブローカ コントロール

概要 : ALSB コントロール

ALSB コントロールを使用すると、RMI による Service Bus 転送がコンフィグレーションされた ALSB プロキシ サービスを、ビジネス プロセスから呼び出すことができます。また、Web サービス、リモート Web サービス、またはビジネス プロセスにリクエストを送信したり、それらからのコールバックを受信したりできます。

ALSB コントロールはサービス ブローカ コントロールを拡張したもので、サービス コントロールでサポートされる機能は ALSB コントロールでもサポートされます。サービス ブローカ コントロールの詳細については、「サービス ブローカ コントロール」を参照してください。

ALSB コントロールは、以下の機能を提供します。

最初のステップは、ALSB コントロール ファイルの作成です。コントロールは、BEA WorkSpace Studio を使用して、対象のサービス (WSDL ファイル) から自動的に生成できます。また、BEA WorkSpace Studio の データ パレットの [コントロール] セクションにある [追加] 機能を使用して作成することもできます。コントロールのメソッドとコールバックは、対象のサービスのオペレーションとコールバックに対応しています。このコントロール ファイルのインスタンスは対象のサービスを呼び出すために親サービスで使用されます。また、対象のサービスからコールバックを取得するためにも使用されます。ALSB コントロール ファイルでは、対象のサービスがステートフルな場合は、開始メソッドに対してのみセレクタのアノテーションを設定できます。一方、対象のサービスがステートレスな場合は、どのメソッドに対してもセレクタのアノテーションを設定できます。

ALSB コントロールを作成する

ALSB コントロールは、以下を用途として作成できます。

WLI ビジネス プロセス用の ALSB コントロールを作成する

新しい ALSB コントロールを作成して Web サービスまたはビジネス プロセスに追加するには、[コントロールの挿入 : ALSB] ダイアログを使用します。

新しい ALSB コントロールを作成するには、次の手順に従います。

ALSB プロキシ サービスを使用して ALSB コントロールを作成する

プロキシ サービスを使用して ALSB コントロールを作成するには、既存の ALSB プロジェクトが必要になります。

ALSB コントロールのアノテーション

ALSB コントロールは、サービス ブローカ コントロールの拡張です。サービス ブローカ コントロールのアノテーションに加え、要件に応じて以下のアノテーションが追加で提供されています。

サービス ブローカ コントロールのアノテーションの詳細については、「サービス ブローカ コントロールのアノテーションに関する注意」を参照してください。

RmiSoapProtocol

このアノテーションはマーカ アノテーションで、SOAP 1.1 over RMI をサポートする ALSB コントロールを指定します。このアノテーションは、クラス レベルでのみ指定できます。このアノテーションは、SOAP over RMI をサポートするために使用します。次に、このアノテーションの使用例を示します。

@Retention(RetentionPolicy.RUNTIME)

@Target({ElementType.TYPE})

public @interface RmiSoapProtocol

{

}

RmiSoap12Protocol

このアノテーションはマーカ アノテーションで、SOAP 1.2 over RMI をサポートする ALSB コントロールを指定します。このアノテーションは、クラス レベルでのみ指定できます。このアノテーションは、SOAP over RMI をサポートするために使用します。次に、このアノテーションの使用例を示します。

@Retention(RetentionPolicy.RUNTIME)

@Target({ElementType.TYPE})

public @interface RmiSoap12Protocol

{

}

SBTransport

このアノテーションは、SB シン クライアント API で必要になる RMI 関連パラメータを指定するために使用します。このアノテーションは、クラス レベルでのみ指定できます。このアノテーションは、SOAP over RMI、抽象 SOAP over RMI、抽象 XML over RMI をサポートするために使用します。次に、このアノテーションの使用例を示します。

@Retention(RetentionPolicy.RUNTIME)

@Target({ElementType.TYPE, ElementType.FIELD})

public @interface SBTransport

{

String serviceURI();

boolean execute() default true;

       String jndiURL() default “”;

表 13-1 は、SBTransport アノテーションのフィールドを示しています。

CustomHeader

このアノテーションは、SB 転送にカスタム ヘッダを指定するために使用します。このアノテーションは、クラス レベルで指定できます。このアノテーションは、SOAP over RMI をサポートするために使用します。次に、このアノテーションの使用例を示します。

@Retention(RetentionPolicy.RUNTIME)

@Target({ElementType.TYPE})

public @interface CustomHeader

{

String name;

String value;

}

表 13-2 は、CustomHeader アノテーションのフィールドを示しています。

CustomHeaders

このアノテーションは、SB 転送に複数のカスタム ヘッダを指定するために使用します。このアノテーションは、クラス レベルで指定できます。このアノテーションは、SOAP over RMI、抽象 SOAP over RMI、抽象 XML over RMI をサポートするために使用します。次に、このアノテーションの使用例を示します。

@Retention(RetentionPolicy.RUNTIME)

@Target({ElementType.TYPE})

public @interface CustomHeaders

{

CustomHeader[] headers;

}

このアノテーションのフィールドは headers で、名前/値ペアの配列を表します。

RmiXmlProtocol

このアノテーションはマーカ アノテーションで、RMI による抽象 XML メッセージの転送をサポートする ALSB コントロールを指定するために使用します。このアノテーションは、クラス レベルでのみ指定できます。このアノテーションは、抽象 SOAP over RMI および抽象 XML over RMI をサポートするために使用します。次に、このアノテーションの使用例を示します。

@Retention(RetentionPolicy.RUNTIME)

@Target({ElementType.TYPE})

public @interface RmiXmlProtocol

{

}

OneWay

このアノテーションはマーカ アノテーションで、一方向のオペレーションを指定するために使用します。このアノテーションは、メソッド レベルでのみ指定できます。このアノテーションは、抽象 SOAP over RMI および抽象 XML over RMI をサポートするために使用します。次に、このアノテーションの使用例を示します。

@Retention(RetentionPolicy.RUNTIME)

@Target({ElementType.METHOD})

public @interface OneWay

{

}

このアノテーションを指定した場合、それぞれのメソッド シグネチャは以下のようになります。

トランザクション コンテキストの伝播

ALSB コントロールでは、ビジネス プロセス内のメソッド レベルで、トランザクション コンテキストの伝播がサポートされています。特定のメソッドのトランザクション コンテキストを伝播するか、あるいは Transactional アノテーションを使用しないかを指定できます。このアノテーションでは、トランザクション コンテキストが伝播されない場合に備え、RMI 呼び出しのタイムアウトも指定します。

transaction アノテーションは、コントロール レベルで指定した場合はコントロール内のすべてのメソッドに適用され、メソッド レベルで指定した場合はメソッド レベルで適用されます。

次に、このアノテーションの使用例を示します。

@Retention(RetentionPolicy.RUNTIME)

@Target({ElementType.TYPE, ElementType.METHOD})

public @interface Transactional

{

boolean value() default true;

       int timeout() default 60;

}

表 13-3 に、Transactional アノテーションのフィールドを示します。.

セキュリティ コンテキストの伝播

SBTransport アノテーションの一部としてプリンシパルおよび資格を指定した場合は、それらの資格がリモート JNDI プロバイダでの認証に使用されます。セキュリティ コンテキストの伝播は、SBTransport アノテーションの execute 属性に応じ、ALSB へのメッセージの転送中に以下の説明に従って発生します。

サンプル : ALSB コントロール

この節では、ALSB コントロールのサンプルを示します。

package requestquote;

import com.bea.control.SbTransportControl;

import org.apache.beehive.controls.api.events.EventSet;

import org.apache.beehive.controls.api.bean.ControlExtension;

@SbTransportControl.SBTransport(serviceURI = "/MyAddProxy", jndiURL = "t3://localhost:7001")

@SbTransportControl.RmiSoapProtocol

@SbTransportControl.SOAPBinding(style = SbTransportControl.SOAPBinding.Style.DOCUMENT, use = SbTransportControl.SOAPBinding.Use.LITERAL, parameterStyle = SbTransportControl.SOAPBinding.ParameterStyle.WRAPPED)

@SbTransportControl.WSDL(path = "../requestquote/AddPro_proxy.wsdl", service = "AddPro")

@ControlExtension

public interface ALSBControl extends SbTransportControl

{

static final long serialVersionUID = 1L;

public int addNumbers(int num1_arg,int num2_arg);

/** このイベントは、onAsyncFailure イベントのサポートを提供するインタフェースを設定する。

*/

@EventSet(unicast=true)

public interface Callback extends SbTransportControl.Callback {};

public ALSBControl create(); }