WebLogic Tuxedo Connector サービス EJB の開発



\| WebLogic Server ホーム \| WTC ATMI プログラマーズガイド \| 前へ \| 次へ \| 目次 \| 索引 \| PDF 版

次の節では、WebLogic Tuxedo Connector サービス EJB の作成方法について説明します。

サービス EJB の基本操作

サービスアプリケーションは、Java および JATMI プリミティブを使用して、次のタスクを提供します。

サービス情報へのアクセス

注意: TPServiceInformation クラスの詳細については、WebLogic Server クラスの Javadoc を参照してください。WebLogic Tuxedo Connector クラスは weblogic.wtc.jatmi パッケージに含まれています。

TPServiceInformation クラスを使用すると、service.do を実行するために Tuxedo クライアントによって送信されるサービス情報にアクセスできます。

表3-1 JATMI TPServiceInformation プリミティブ

バッファタイプ	説明
`getServiceData()`	Tuxedo クライアントから送信されるサービスデータを返すために使用する。
`getServiceFlags()`	Tuxedo クライアントから送信されるサービスフラグを返すために使用する。
`getServiceName()`	呼び出されたサービス名を返すために使用する。

バッファメッセージ

アプリケーションと Tuxedo 間でメッセージの送信および受信を行うときは、次のバッファタイプを使用します。

表3-2 TypedBuffers

バッファタイプ	説明
TypedString	データが NULL 文字で終了する文字の配列である場合に使用されるバッファタイプ。Tuxedo の等価タイプ : STRING。
TypedCArray	データが、NULL 可能な文字の未定義配列（バイト配列）である場合に使用されるバッファタイプ。Tuxedo の等価タイプ : CARRAY。
TypedFML	データが自己定義である場合に使用されるバッファタイプ。各データフィールドは独自の識別子、オカレンス番号、および可能であれば長さインジケータを保持する。Tuxedo の等価タイプ : FML。
TypedFML32	TypeFML に似たバッファタイプだが、より大きい文字フィールド、より多くのフィールド、およびより大きいバッファ全体に対して使用可能。Tuxedo の等価タイプ : FML32。
TypedXML	データが XML ベースのメッセージである場合に使用されるバッファタイプ。Tuxedo の等価タイプ : XML（Tuxedo リリース 7.1 以降）。

リクエストされたサービスの実行

サービスを提供するために必要なロジックを表現するには、Java コードを使用します。

要求/応答通信でクライアントメッセージを返す

注意: TuxedoReply クラスの詳細については、WebLogic Server クラスの Javadoc を参照してください。WebLogic Tuxedo Connector クラスは weblogic.wtc.jatmi パッケージに含まれています。

クライアントリクエストに応答するには、TuxedoReply クラスの setReplyBuffer() メソッドを使用します。

対話通信での tpsend および tprecv の使用

注意: 対話通信の詳細については、 WebLogic Tuxedo コネクタ JATMI 対話を参照してください。

以下の JATMI プリミティブは、Tuxedo クライアントと通信する対話サーバを作成する際に使用します。

表3-3 WebLogic Tuxedo Connector の対話クライアントのプリミティブ

名前	操作
`tpconnect`	Tuxedo 対話サービスとの接続を確立するために使用する。
`tpdiscon`	対話を管理するプロセスによって実行された場合に接続を中止し、TPEV_DISCONIMM イベントを生成するために使用する。
`tprecv`	Tuxedo アプリケーションからオープンな接続を介してデータを受信するために使用する。
`tpsend`	Tuxedo アプリケーションにオープンな接続を介してデータを送信するために使用する。

サービス EJB の例

文字列引数を受信し、その文字列をすべて小文字に変換して、変換された文字列をクライアントに返す TolowerBean.java サービス EJB の例を次に示します。

コードリスト 3-1 サービス EJB の例

.
.
.

public Reply service(TPServiceInformation mydata) throws TPException {
     TypedString data;
     String lowered;
     TypedString return_data;

     log("service tolower called");

     data = (TypedString) mydata.getServiceData();
     lowered = data.toString().toLowerCase();
     return_data = new TypedString(lowered);

     mydata.setReplyBuffer(return_data);

     return (mydata);
} 
.
.
.