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

---

3.2. バインディングコンポーネントの定義

3.2.1. SOAPバインディング

図2.9.1-1

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

図2.9.1.1-1

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

図2.9.1.2-1

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

Memo
 エンドポイントロールをコンシューマにした場合、動作には別途Inboundサーブレットを配備する必要があります。詳細は[2.9.1.14. Inboundサーブレット]をご参照ください。  エンドポイントロールをプロバイダにした場合、サービス名とエンドポイント名の設定が他のプロバイダと重複しないようにしてください。

Memo
 外部に公開するエンドポイントURLのコンテキストルートは、Inbound用に配備するServletのコンテキストルートと一致する必要があります。詳細は[2.9.1.14. Inboundサーブレット]をご参照ください。

Memo
CORBA BC，RMI BC，JDBC BCと接続する場合に、DOMの方が高速になります。

Memo
XOPは、XML文書とバイナリデータをそのまま通信パケットにまとめる標準的な手段を提供しており、MTOMはXOPの機能を利用してSOAPメッセージを処理する仕様です。MTOM/XOPをSOAP 1.2とともに使用すると、大きなバイナリデータを転送する標準的な手法が利用可能となります。

図2.9.1.2-2

3.2.1.3. オペレーション設定

図2.9.1.3-1

Memo
unwrapped Documentの要素受信方向の要素名を設定しない場合、オペレーション名はSOAPメッセージのBody要素の子要素の名前と一致する必要があります。

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

図2.9.1.4-1

図2.9.1.4-2

図2.9.1.4-3

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

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

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

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

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

Memo
メッセージエクスチェンジハンドラと、SOAPメッセージハンドラ・トランスポートハンドラは別のものです。メッセージエクスチェンジハンドラの場合はSUエディタを編集すると自動的にendpoints.xmlが編集されますが、SOAPメッセージハンドラとトランスポートハンドラは手動でendpoints.xmlを編集する必要があります。（詳細は2.9.1.15.SOAPメッセージハンドラの実装と設定、2.9.1.16.トランスポートハンドラの実装と設定 を参照してください。）

3.2.1.10. メッセージ交換方式(MEP)とHTTPステータスコード／コンテントタイプ

Memo
Robust In-Onlyの場合のステータスコードがV8.21より200から202に変更されました。

3.2.1.11. ノーマライズ規則

図2.9.1.11-1

図2.9.1.11-2

図2.9.1.11-3

図2.9.1.11-4

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

<?xml version="1.0" encoding="UTF-8"?>
<SOAP-ENV:Envelope
 xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/"
 xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
 SOAP-ENV:encodingStyle="http://schemas.xmlsoap.org/soap/encoding">
  <SOAP-ENV:Header />
  <SOAP-ENV:Body>
    <ns0:operation xmlns:ns0="http://com.nec.webotx">
      <ns0:param0>abc</ns0:param0>
      <ns0:param1>100</ns0:param1>
    </ns0:operation>
  </SOAP-ENV:Body>
</SOAP-ENV:Envelope>

<?xml version="1.0" encoding="UTF-8"?>
<ns0:operation xmlns:ns0="http://com.nec.webotx">
  <ns0:param0>abc</ns0:param0>
  <ns0:param1>100</ns0:param1>
</ns0:operation>

<?xml version="1.0" encoding="UTF-8"?>
<ns0:operation xmlns:ns0="http://com.nec.webotx">
  <ns0:param0>abc</ns0:param0>
  <ns0:param1>100</ns0:param1>
</ns0:operation>

<?xml version="1.0" encoding="UTF-8"?>
<SOAP-ENV:Envelope
 xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/"
 xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
 SOAP-ENV:encodingStyle="http://schemas.xmlsoap.org/soap/encoding/">
  <SOAP-ENV:Header />
  <SOAP-ENV:Body>
    <ns0:operation xmlns:ns0="http://com.nec.webotx">
      <ns0:param0>abc</ns0:param0>
      <ns0:param1>100</ns0:param1>
    </ns0:operation>
  </SOAP-ENV:Body>
</SOAP-ENV:Envelope>

3.2.1.13. 異常系メッセージ

WebOTX ESBにおいて「SOAP BCに誤ったメッセージが入力された」、「サービス呼び出しに失敗した」等の異常が発生した場合、SOAP BCのInboundからクライアントアプリケーションにSOAP Faultメッセージが返却されます。 クライアントアプリケーションでは返却されたSOAP Faultメッセージから発生した異常の内容を知ることができます。 以下では、発生する異常の種類ごとのSOAP BCのInboundからクライアントアプリケーションに返却するメッセージを説明します。

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

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

SOAP BCのプロバイダエンドポイントが SOAP Fault を受け取ると、 SOAP BCのInboundにはFaultが通知され、 クライアントアプリケーションにはプロバイダエンドポイントが受け取った SOAP Fault がそのまま通知されます。

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

SOAP BC以外のプロバイダエンドポイントから Fault を受け取った場合、 SOAP BCのInboundでSOAP Fault形式のメッセージを生成し、クライアントアプリケーションに返信します。 UserProcessor SEから "User Fault" というメッセージの Fault メッセージが通知された例です。

500 Internal Server Error

<?xml version="1.0" encoding="utf-8"?>
<soap:Envelope xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
    <soap:Body>
      <soap:Fault>
        <faultcode>soap:Server</faultcode>
        <faultstring>User Fault</faultstring>
      </soap:Fault>
    </soap:Body>
</soap:Envelope>

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

SOAP BCのプロバイダエンドポイントが外部Webサーバから404を受け取った場合の例です。 コンシューマエンドポイントに Error が通知され、クライアントアプリケーションへ以下の電文が返信されます。

500 Internal Server Error

<?xml version="1.0" encoding="utf-8"?>
<soap:Envelope xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
    <soap:Body>
      <soap:Fault>
        <faultcode>soap:Server</faultcode>
        <faultstring>
          javax.jbi.JBIException: 外部WebサービスからSOAPメッセージ以外の
          レスポンスメッセージを受け取りました。レスポンスコードは 404 です。
        </faultstring>
      </soap:Fault>
    </soap:Body>
</soap:Envelope>

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

UserProcessor SEがプロセッサのインスタンスの生成に失敗した場合の例です。 「SOAPバージョン」を 1.2 にした場合、SOAP Fault形式も SOAP 1.2 に準拠した形式となります。

500 Internal Server Error

<?xml version="1.0" encoding="utf-8"?>
<soap:Envelope xmlns:soap="http://www.w3.org/2003/05/soap-envelope"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
  <soap:Body>
    <soap:Fault>
      <soap:Code>
        <soap:Value>soap:Receiver</soap:Value>
      </soap:Code>
      <soap:Reason>
        <soap:Text xml:lang="ja-JP">
          javax.jbi.JBIException: プロセサオブジェクトの生成時か、初期化時に異常が発生しました。
        </soap:Text>
      </soap:Reason>
    </soap:Fault>
  </soap:Body>
</soap:Envelope>

「同時処理最大リクエスト数」を超えてタイムアウトした場合

SOAP BCのコンシューマに設定する「同時処理最大リクエスト数」を超えてタイムアウトした場合の例です。 SOAP BCとしてメッセージを受理できていないためメッセージ内容はHTML形式の文書です。

503 Service Unavailable

<html><head><title>WebOTX 8.XX.XX.XX - Error report</title><style><!--H1 {font-family:Tahoma,Arial,sans-serif;color:white;background-color:#525D76;font-size:22px;} H2
{font-family:Tahoma,Arial,sans-serif;color:white;background-color:#525D76;font-size:16px;} H3 {font-family:Tahoma,Arial,sans-serif;color:white;background-color:#525D76;font-size:14px;} BODY
{font-family:Tahoma,Arial,sans-serif;color:black;background-color:white;} B {font-family:Tahoma,Arial,sans-serif;color:white;background-color:#525D76;} P
{font-family:Tahoma,Arial,sans-serif;background:white;color:black;font-size:12px;}A {color : black;}A.name {color : black;}HR {color : #525D76;}--></style> </head><body><h1>HTTP Status 503 - </h1><HR
size="1" noshade="noshade"><p><b>type</b> Status report</p><p><b>message</b> <u></u></p><p><b>description</b> <u>The requested service () is not currently available.</u></p><HR size="1"
noshade="noshade"><h3>WebOTX 8.XX.XX.XX</h3></body></html>

3.2.1.14. Inboundサーブレット

Memo
otxadminのloginコマンドでログイン済ならば--userオプションを指定する必要はありません。

3.2.1.15. SOAPメッセージハンドラの実装と設定

package com.nec.webotx.jbi.binding.soap;
public interface SoapMessageHandlerIF {
  public void init(java.util.Map initParam);
  public boolean handleFault(javax.xml.soap.SOAPMessage soapMessage, java.util.Map properties);
  public boolean handleToRouter(javax.xml.soap.SOAPMessage soapMessage, java.util.Map properties);
  public boolean handleFromRouter(javax.xml.soap.SOAPMessage soapMessage, java.util.Map properties);
}

<jbi:endpoint xmlns:jbi="http://www.sun.com/ns/jbi/component/soap/deploy"
       xmlns:webotx="http://www.nec.com/WebOTX"
       xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
       xsi:schemaLocation="http://www.sun.com/ns/jbi/component/soap/deploy ../schema/endpoints.xsd http://www.nec.com/WebOTX ../schema/endpoints_webotx.xsd ">
-
  <webotx:soap_handler_chain>
    <webotx:handler name="ハンドラ名" class="ハンドラクラス名">
      <webotx:parameter name="パラメータ名" value="値"/>
      ・・・
    </webotx:handler>
  </webotx:soap_handler_chain>
</jbi:endpoint>

Memo
endpoints.xmlへの設定の追加はｊbi:operation要素の記述の直後に記述してください。

3.2.1.16. トランスポートハンドラの実装と設定

package com.nec.webotx.jbi.binding.soap.outbound;

import com.nec.webotx.jbi.binding.soap.Endpoint;
import com.nec.webotx.jbi.binding.soap.SOAPWrapper;

public interface SOAPClient{
  void init(Endpoint endpointInfo);
  SOAPWrapper invokeService(SOAPWrapper requestWrapper) throws Exception;
}

<jbi:endpoint xmlns:jbi="http://www.sun.com/ns/jbi/component/soap/deploy"
          xmlns:webotx="http://www.nec.com/WebOTX"
          xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
          xsi:schemaLocation="http://www.sun.com/ns/jbi/component/soap/deploy ../schema/endpoints.xsd http://www.nec.com/WebOTX ../schema/endpoints_webotx.xsd ">
-
  <webotx:transporthandler name="ハンドラ名" class="ハンドラクラス名">
    <webotx:parameter name="パラメータ名" value="値"/>
    <webotx:parameter name="パラメータ名" value="値"/>
  </webotx:transporthandler>
</jbi:endpoint>

3.2.1.17. WSDLファイルのインポートによる属性自動設定

エンドポイントの自動設定

図2.9.1.17-1

図2.9.1.17-2

図2.9.1.17-3

図2.9.1.17-4

図2.9.1.17-5

図2.9.1.17-6

図2.9.1.17-7

オペレーションの自動設定

図2.9.1.17-8

図2.9.1.17-9

3.2.1.18. WSDLファイルのエクスポート

Memo
生成できるのは SOAP サービスユニットのコンシューマを含む場合のみです。

図2.9.1.18-1

図2.9.1.18-2

図2.9.1.18-3

図2.9.1.18-4

設定内容と WSDL の対応関係

図2.9.1.18-5

WSDL ファイル

<?xml version="1.0" encoding="UTF-8"?>
<definitions name="No_001" … �@
    targetNamespace="No_003" … �B
    xmlns="http://schemas.xmlsoap.org/wsdl/" xmlns:tns="No_003" … �B
	xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:soap="http://schemas.xmlsoap.org/wsdl/soap/">
  <types>
    <xsd:schema><xsd:import namespace="No_003" … �B
	schemaLocation="META-INF/schema/No_0012.xsd"/></xsd:schema> … �@ 末尾の 2 は生成時に付加される連番。
  </types>
  <message name="No_004"> … �C
    <part name="parameters" element="tns:No_004"> … �C
    </part>
  </message>
  <message name="No_004Response"> … �C
    <part name="parameters" element="tns:No_004Response"> … �C
    </part>
  </message>
  <portType name="No_002"> … �A
    <operation name="No_004"> … �C
      <input message="tns:No_004"> … �C
    </input>
      <output message="tns:No_004Response"> … �C
    </output>
    </operation>
  </portType>
  <binding name="No_002_Binding" type="tns:No_002"> … �A
    <soap:binding style="document" transport="http://schemas.xmlsoap.org/soap/http"/>
    <operation name="No_004"> … �C
      <soap:operation soapAction=""/>
      <input>
        <soap:body use="literal"/>
      </input>
      <output>
        <soap:body use="literal"/>
      </output>
    </operation>
  </binding>
  <service name="No_001"> … 
    <port name="No_002_Port" binding="tns:No_002_Binding"> … �A
      <soap:address location="No_005"/> … �D
    </port>
  </service>
</definitions>

XSD ファイル

SU 名 + 生成時に付加される連番.xsd

<?xml version="1.0" encoding="UTF-8"?>
<xsd:schema version="1.0" targetNamespace="No_003" … �B
    xmlns:tns="No_003" xmlns:xsd="http://www.w3.org/2001/XMLSchema"> … �B
  <xsd:element name="No_004"> … �C
    <xsd:complexType>
      <xsd:sequence>
        <xsd:element name="in" type="xsd:string"/>
      </xsd:sequence>
    </xsd:complexType>
  </xsd:element>
  <xsd:element name="No_004Response"> … �C
    <xsd:complexType>
      <xsd:sequence>
        <xsd:element name="out" type="xsd:string"/>
      </xsd:sequence>
    </xsd:complexType>
  </xsd:element>
</xsd:schema>

Memo
生成に必要な値が、SUエディタ、SAエディタで設定されていない場合、WSDL の該当箇所は、 "_NONE" という値が生成されます。

3.2.1.19. WSDLファイルの利用例

準備

 Hello 入力文字列 !

サービスアセンブリ作成手順の概要

図2.9.1.19-1

1. サービスユニットの配置
2. WSDLファイルのインポートによる属性の自動設定
3. プロバイダとコンシューマの接続
4. スキーマファイルの設定
5. 外部に公開するエンドポイントURL の設定
6. WSDLファイルのエクスポート
7. サービスアセンブリの配備
8. Web サービス・エクスプローラーを用いた実行

１．サービスユニットの配置

図2.9.1.19-2

２．WSDLファイルのインポートによる属性の自動設定

図2.9.1.19-3

図2.9.1.19-4

図2.9.1.19-5

図2.9.1.19-6

３．プロバイダとコンシューマの接続

図2.9.1.19-7

Memo
接続により、コンシューマのエンドポイント名やオペレーションなどの属性は、 プロバイダの設定で更新されますが、スキーマファイルの設定は更新されません。

４．スキーマファイルの設定

図2.9.1.19-8

Memo
ここでは、スキーマ定義の実体を含む、Hello1.xsd を直接、指定することで 設定手順を簡略化しています。 スキーマファイルとして、プロバイダ側と同じ、Hello.xsd を指定する場合、 Hello1.xsd もコンシューマ側の META-INF/schema 配下にコピーしてください。

５．外部に公開するエンドポイントURL の設定

図2.9.1.19-9

６．WSDLファイルのエクスポート

図2.9.1.19-10

７．サービスアセンブリの配備

図2.9.1.19-11

８．Web サービス・エクスプローラーを用いた実行

図2.9.1.19-12

図2.9.1.19-13

図2.9.1.19-14

図2.9.1.19-15

図2.9.1.19-16