WebOTX Manual V10.3 (第4版) 目次を表示

---

3.2.10. TCP/IPバインディング

図2.9.10-1

3.2.10.1. サービスユニットのファイル構成

図2.9.10.1-1

3.2.10.2. エンドポイントの設定

図2.9.10.2-1

Memo
 エンドポイントを追加する方法については、 2.7.1. エンドポイントの追加 をご覧下さい。

図2.9.10.2-2

3.2.10.3. オペレーション設定

図2.9.10.3-1

3.2.10.4. セキュリティ認証の設定

図2.9.10.4-1

3.2.10.5. トランザクションの設定

3.2.10.6. メッセージ送信優先度の設定

3.2.10.7. エラーリトライの設定

3.2.10.8. オプション一覧の設定

3.2.10.9. メッセージエクスチェンジハンドラの設定

3.2.10.10. メッセージ交換方式(MEP)

TCP/IP BC は Outbound、Inbound ともに In-Only、Robust In-Only、In-Out、In-Optional-Out の4つのMEPをサポートします。
メッセージ交換方式(MEP)の説明は [ 製品構成と提供機能 > 3.JBI仕様 > 3.2.Normalized Message Router ] を参照してください。

Outbound
Outboundの各MEPの動作を説明します。

Inbound
Inboundの各MEPの動作を説明します。

3.2.10.11. ノーマライズ規則

ノーマライズ規則

TCP/IP BCのInboundのリクエスト受信処理、およびOutboundのレスポンス受信処理では、 外部アプリケーションから受け取ったメッセージをTCP/IPハンドラのreceiveメソッドに より処理した結果をメッセージエクスチェンジに変換（ノーマライズ）します。 TCP/IP BCのノーマライズを示した図です。 オペレーションの設定項目「入力メッセージのタイプ」によりメッセージを 格納する箇所を指定することができます。 「入力メッセージのタイプ」を"XML"に指定した場合はノーマライズメッセージの メッセージコンテントに、"attachment"に指定した場合は添付ファイルに格納します。

図2.9.10.11-1

デノーマライズ規則

TCP/IP BCのInboundのレスポンス送信処理、およびOutboundのリクエスト送信処理では、 ノーマライズとは逆に、メッセージエクスチェンジから受け取ったメッセージを TCP/IPハンドラのsendメソッドにより外部アプリケーションに送信するメッセージに変換（デノーマライズ）します。 オペレーションの設定項目「出力メッセージのタイプ」によりメッセージを 取りだす箇所を指定することができます。 「出力メッセージのタイプ」を"XML"に指定した場合はノーマライズメッセージの メッセージコンテントから、"attachment"に指定した場合は添付ファイルから取り出します。

図2.9.10.11-2

3.2.10.12. TCP/IPハンドラ

TCP/IPハンドラを作成するにはインタフェース com.nec.webotx.jbi.binding.tcpip.handler.ProtocolHandler を implementしたクラスを作成します。実装するメソッドを以下で説明します。

インタフェースProtocolHandlerの定義は以下の通りです。
このインタフェースクラスは[WEBOTX_DIR]/jbi/components/tcpip/tcpipbinding.jar を展開して 生成される tcpipbinding_rt.jar か、[WEBOTX_DIR]/jbi/lib/jbi-api.jar(*WebOTX Developerをインストールした場合のみ) に含まれます。

package com.nec.webotx.jbi.binding.tcpip.handler;
import com.nec.webotx.jbi.binding.tcpip.handler.FaultException;

public interface ProtocolHandler {

    public void init(Map<String, String> properties, Logger logger);

    public InputStream receive(InputStream senderIn, OutputStream senderOut, Logger logger) throws IOException, FaultException;

    public void send(InputStream nmrIn, OutputStream receiverOut, Logger logger) throws IOException;

    public void fault(InputStream nmrIn, OutputStream receiverOut, Logger logger) throws IOException;

    public void error(Exception e, OutputStream receiverOut, Logger logger) throws IOException;

    public void destroy(Logger logger);

    public boolean check(InputStream receiveIn, OutputStream receiveOut, Logger logger) throws IOException;
    
    public void initMessage(MessageContext arg0, Logger arg1)throws IOException;
}

次にこれらの各メソッドの実装方法について説明します。 Developers' Studio を使用している場合は、[新規]-[その他]-[ESB]-[TCP/IPハンドラ]を選択することで クラスの雛型を生成できます。詳細は [ 2.12.サービスアセンブリへのカスタム処理の組み込み > 2.12.3.TCP/IPハンドラの作成 ] を 参照してください。

• WebOTX Developerを使用して追加する方法は次を参照してください。
  [ 2.12.サービスアセンブリへのカスタム処理の組み込み > 2.12.5. カスタマイズ用Javaクラスの追加 ]
• 手動で行う場合は、作成したTCP/IPハンドラクラスをJDK付属のjarコマンドなどによりJAR形式にアーカイブしてください。
  その後、作成したJARファイルを次の3箇所のいずれかに配置します。
  • [サービスユニット名]/META-INF/lib/ 以下
  • [domain1などのドメインディレクトリ]/jbi/bindings/TCPIPBinding/install_root/workspace/lib/ 以下
  classファイル形式のままで配置する場合は以下に格納します。
  • [サービスユニット名]/META-INF/classes/ 以下