WebOTX Manual V11.1 (第6版) 目次を表示

---

3.2.2. JMSバインディング

図2.9.2-1

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

図2.9.2.1-1

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

図2.9.2.2-1

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

図2.9.2.2-2

3.2.2.3. オペレーション設定

図2.9.2.3-1

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

図2.9.2.4-1

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

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

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

Memo
JMSメッセージの付加情報については、「メッセージ変換規則」もあわせてご覧ください。

3.2.2.8. ノーマライズ規則

図2.9.2.8-1

図2.9.2.8-2

図2.9.2.8-3

図2.9.2.8-4

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

3.2.2.10. 異常系メッセージ

WebOTX ESBにおいて「誤ったメッセージが入力された」、「外部サービスとの連携に失敗した」等の異常が発生した場合、確認型のMEP(Robust In-Only/In-Out)であれば、JMS BCのInboundから要求側JMSクライアントにTextMessageタイプのJMSメッセージが返却されます。 要求側JMSクライアントでは返却されたJMSメッセージから発生した異常の内容を知ることができます。 以下では、発生する異常の種類ごとのJMS BCのInboundからクライアントアプリケーションに返却するメッセージについて説明します。

異常の種類により Fault または Error の分類があります。 どちらに該当するかは、JMSメッセージに設定されるプロパティJBI_STATUSの値("FAULT"または"ERROR")で判断します。 JMS BCにおいて異常が発生するパターンの一覧です。 [ リファレンス集 開発編（Enterprise Service Bus） > 2. 異常系メッセージ(Fault/Error) > 2.1. バインディングコンポーネント > 2.1.2. JMS BC ]

プロバイダエンドポイントがFaultを返却した場合(JMS BC同士の連携時)

JMS BCのプロバイダエンドポイントが応答側JMSクライアントからFAULT相当のJMSメッセージを受け取ると、JMS BCのInboundにはWebOTX ESB共通のFaultとして通知され、要求側JMSクライアントには、WebOTX ESB共通のFaultフォーマット(esb-fault)で変換したXMLテキストを格納したJMSメッセージが返信されます。

JBI_STATUS=FAULT

<esb-fault xmlns="http://www.nec.com/WebOTX/jbi/fault/">
    <exchangeid>1339724865956-593600000029</exchangeid>
    <date>2012-06-15T10:47:46.222+09:00</date>
    <component>JMSBinding</component>
    <service-assembly>PerformJMSBC_SA</service-assembly>
    <service-unit>JMSBC_SU</service-unit>
    <service-name xmlns:ns2="http://webotx.com/">ns2:PerformSVC</service-name>
    <endpoint>Perform</endpoint>
    <role>PROVIDER</role>
    <string>
        <UserFault xmlns:java="java:sample" xmlns:sam="http://sample.org">
            <sam:Error>Invalid message format.</sam:Error>
        </UserFault>
    </string>
    <detail/>
</esb-fault>

プロバイダエンドポイントがFaultを返却した場合(JMS BC以外との連携時)

SOAP BCのプロバイダエンドポイントが定義誤り(該当オペレーションが存在しない)によりFaultを返却した場合の例です。 要求側JMSクライアントには、WebOTX ESB共通のFaultフォーマット(esb-fault)で変換したXMLテキストを格納したJMSメッセージが返信されます。

JBI_STATUS=FAULT

<esb-fault xmlns="http://www.nec.com/WebOTX/jbi/fault/">
    <exchangeid>1339722122647-593600000010</exchangeid>
    <date>2012-06-15T10:02:03.194+09:00</date>
    <component>SOAPBinding</component>
    <service-assembly>09_HttpInbound_SoapOutbound</service-assembly>
    <service-unit>SOAPSU_09_HttpInbound_SoapOutbound_002</service-unit>
    <service-name xmlns:ns2="http://www.nec.com">ns2:ep_09_HttpInbound_SoapOutbound_002</service-name>
    <endpoint>ep_09_HttpInbound_SoapOutbound_002</endpoint>
    <role>PROVIDER</role>
    <string>500</string>
    <detail>
        <S:Envelope xmlns:S="http://schemas.xmlsoap.org/soap/envelope/">
            <S:Body>
                <S:Fault xmlns:ns4="http://www.w3.org/2003/05/soap-envelope">
                <faultcode xmlns="" xmlns:ns4_="http://www.nec.com/WebOTX/jbi/fault/">S:Client</faultcode>
                <faultstring xmlns="" xmlns:ns4_="http://www.nec.com/WebOTX/jbi/fault/">Cannot find dispatch method for {}request</faultstring>
                </S:Fault>
            </S:Body>
        </S:Envelope>
    </detail>
</esb-fault>

プロバイダエンドポイントがErrorを返却した場合

SOAP BCのプロバイダエンドポイントが外部Webサーバから404を受け取りErrorを返却した場合の例です。 要求側JMSクライアントには、WebOTX ESB共通のErrorを変換したテキストを格納したJMSメッセージが返信されます。

JBI_STATUS=ERROR

com.nec.webotx.jbi.exception.WebOTXESBExceptionImpl: javax.jbi.JBIException: 外部WebサービスからSOAPメッセージ以外のレスポンスメッセージを受け取りました。
レスポンスコードは 404 Not Found です。
ESB Exception message
Message ID: 1339723414204-593600000017
Date      : Fri Jun 15 10:23:34 JST 2012
Component : SOAPBinding
String    : 外部WebサービスからSOAPメッセージ以外のレスポンスメッセージを受け取りました。レスポンスコードは 404 Not Found です。
ServiceAssembly:09_HttpInbound_SoapOutbound
ServiceUnit    :SOAPSU_09_HttpInbound_SoapOutbound_002
ServiceName    :{http://www.nec.com}ep_09_HttpInbound_SoapOutbound_002
EndpointName   :ep_09_HttpInbound_SoapOutbound_002

プロバイダからの応答がなくてタイムアウトした場合

SOAP BCのコンシューマに設定する「タイムアウト」を超えてタイムアウトした場合の例です。 要求側JMSクライアントには、JMS BCとしてメッセージを受理できていないため、エラーを示す単純なテキストを格納したJMSメッセージが返信されます。

JBI_STATUS=ERROR

JMS BC: Timeout happend. 1339669945005-1041600000022

3.2.2.11. オプション設定

3.2.2.12. JMSリソースアダプタの設定

図2.9.2.12-1

3.2.2.13. JMS付加情報の伝播設定

図2.9.2.13-1

図2.9.2.13-2

図2.9.2.13-3