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

OSB コントロール

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

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

概要 : OSB コントロール

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

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

サンプル OSB コントロール

関連トピック

Oracle Service Bus ユーザーズ ガイド

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

概要 : OSB コントロール

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

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

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

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

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

OSB コントロールは次の方法で作成できます。

WSDL から OSB コントロールを作成する

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

新しい OSB コントロールを作成するには

サービス消費フレームワークを使用して OSB コントロールを作成する

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

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

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

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

RmiSoapProtocol

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

@Retention(RetentionPolicy.RUNTIME)

@Target({ElementType.TYPE})

public @interface RmiSoapProtocol

{

}

RmiSoap12Protocol

このアノテーションはマーカ アノテーションで、SOAP 1.2 over RMI をサポートする OSB コントロールを指定します。このアノテーションは、クラス レベルでのみ指定できます。このアノテーションは、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 メッセージの転送をサポートする OSB コントロールを指定するために使用します。このアノテーションは、クラス レベルでのみ指定できます。このアノテーションは、抽象 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

{

}

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

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

OSB コントロールでは、ビジネス プロセス内のメソッド レベルで、トランザクション コンテキストの伝播がサポートされています。特定のメソッドのトランザクション コンテキストを伝播するか、あるいは 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 属性に応じ、Oracle Service Bus へのメッセージの転送中に以下の説明に従って発生します。

サンプル OSB コントロール

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

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(); }