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

---

3.2.3. JCAバインディング

図2.9.3-1

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

図2.9.3.1-1

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

図2.9.3.2-1

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

図2.9.3.2-2

3.2.3.3. オペレーション設定

図2.9.3.3-1

図2.9.3.3-2

図2.9.3.3-3

図2.9.3.3-4

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

図2.9.3.4-1

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

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

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

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

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

3.2.3.10. 活性化構成情報の設定

図2.9.3.10-1

図2.9.3.10-2

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

3.2.3.12. ノーマライズ規則

図2.9.3.12-1 デノーマライズ規則

図2.9.3.12-2 ノーマライズ規則

3.2.3.13. ノーマライズメッセージ

ここでは、JCA BC がリソースアダプタと送受信したメッセージを NMR とやりとりするためのノーマライズメッセージ形式へ変換する方法について説明します。
JCA BC ではリソースアダプタから受信したメッセージをノーマライズメッセージに変換して NMR に渡す操作が「ノーマライズ」、 NMR からノーマライズメッセージを受け取りリソースアダプタに渡すメッセージに変換する操作が「デノーマライズ」です。

図2.9.3.13-1

(1) ノーマライズ(正常系メッセージ)

ノーマライズでは、リソースアダプタから受信したメッセージをノーマライズメッセージへ格納します。
リソースアダプタからの受信データは、JCA BC がコンシューマ動作の場合、<record-definition>の<record pattern="in">の中に設定されます。
JCA BC がプロバイダ動作の場合、<record-definition>の<record pattern="out">の中に設定されます。
以下に、JCA BC がコンシューマ動作時に NMR に渡すノーマライズメッセージの例を示します。

<jca-bc>
  <record-definition>
    <record pattern="in">
      <mappedrecord name="TX01">
        <mappedrecord-property>
          <key-type>java.lang.String</key-type>
          <key>NAME</key>
          <type>java.lang.String</type>
          <value>CustomerName</value>
        </mappedrecord-property>
      </mappedrecord>
    </record>
    <record pattern="out"/>
  </record-definition>
</jca-bc>

(2) デノーマライズ(正常系メッセージ)

デノーマライズでは、ノーマライズメッセージから取り出した値を元にリソースアダプタに渡すメッセージを構築します。
JCA BC がコンシューマ動作の場合、<record-definition>の<record pattern="out">の中に設定されているデータが、 リソースアダプタに渡されます。
JCA BC がプロバイダ動作の場合、<record-definition>の<record pattern="in">の中に設定されているデータが、 リソースアダプタに渡されます。
以下に、JCA BC がプロバイダ動作時のノーマライズメッセージの例を示します。

<?xml version="1.0" encoding="UTF-8"?>
<jca-bc>
  <connectionspec-definition>
    <connectionspec-impl-class>
      jp.co.nec.WebOTX.connector.olftp.cci.ConnectionSpecImpl
    </connectionspec-impl-class>
  </connectionspec-definition>
  <interactionspec-definition>
    <interactionspec-impl-class>
      jp.co.nec.WebOTX.connector.olftp.cci.InteractionSpecImpl
    </interactionspec-impl-class>
    <config-property>
      <config-property-name>TXID</config-property-name>
      <config-property-type>java.lang.String</config-property-type>
      <config-property-value>TX01</config-property-value>
    </config-property>
  </interactionspec-definition>
  <record-definition>
    <record pattern="in">
      <mappedrecord name="TX01">
      <mappedrecord-property>
      <key-typegt;java.lang.String</key-type>
      <key>NAME</key>
      <type>java.lang.String</type>
      <value>CustomerName</value>
      </mappedrecord-property>
      </mappedrecord>
    </record>
    <record pattern="out">
      <mappedrecord name="">
      </mappedrecord>
    </record>
  </record-definition>
</jca-bc>

(3) ノーマライズ(異常系メッセージ)

JCA BC がプロバイダ動作時に、JCA BC 内部で異常が発生した場合や JCA BC が連携しているリソースアダプタから異常が返却された場合、 異常を表すメッセージを元に Fault/Error を作成し、作成した Fault/Error を NMR に返却します。

以下に、NMR に返却する Fault の例を示します。

<esb-fault xmlns="http://www.nec.com/WebOTX/jbi/fault/">
    <exchangeid>1339467478562-00000002</exchangeid>
    <date>2012-06-12T11:18:01.234+09:00</date>
    <component>JCABinding</component>
    <service-assembly>SA_JCAProvider</service-assembly>
    <service-unit>JCASU_SA_JCAProvider_002</service-unit>
    <service-name xmlns:ns2="http://nec.com/testengine.wsdl">ns2:ep_SA_JCAProvider_002</service-name>
    <endpoint>ep_SA_JCAProvider_002</endpoint>
    <role>PROVIDER</role>
    <string>OTX21344610: In-out メッセージの処理中にExceptionが発生しました。理由 : ResourceException :OTX12008021 transaction was refused.(retid=0x90,detail=0x000002c1), error code: 0x8021</string>
    <detail/>
</esb-fault>

(4) デノーマライズ(異常系メッセージ)

JCA BC がコンシューマ動作時に JCA BC や JCA BC と連携している BC/SE 内で Fault/Error が発生した場合、Fault/Error 内のメッセージを元に javax.resource.ResourceException を作成し、作成した ResourceException を連携しているリソースアダプタに返却します。
以下に、リソースアダプタに返却する ResourceException の例を示します。

javax.resource.ResourceException: com.nec.webotx.jbi.exception.WebOTXESBExceptionImpl: ファイル書き込み時にエラーが発生しました。

3.2.3.14. 異常系メッセージ

WebOTX ESB において「JCA BC に誤ったメッセージが入力された」、「サービス呼び出しに失敗した」等の異常が発生した場合、JCA BC の Inbound から 連携しているリソースアダプタに対して javax.resource.cci.MessageListener クラスの onMessage メソッドの戻り値として javax.resource.ResourceException が返却されます。
javax.resource.ResourceException には、Fault/Error 内のメッセージが含まれるため、リソースアダプタでは javax.resource.ResourceException から 異常の内容を知ることができます。

異常の種類により Fault または Error の分類があります。 JCA BC において異常が発生するパターンは [ リファレンス集 開発編（Enterprise Service Bus） > 2. 異常系メッセージ(Fault/Error) > 2.1. バインディングコンポーネント > 2.1.3. JCA BC ] を参照してください。