リファレンス・ガイド

Oracle SALT Webサービス定義ファイルのリファレンス

以下の項では、SALT Webサービス定義ファイル(WSDF)リファレンス情報を説明します。

概要

Oracle SALT Webサービス定義ファイル(WSDF)は、XMLベースのファイルであり、Oracle SALT Webサービス・コンポーネント(Webサービス・バインディング、Webサービス操作、Webサービス・ポリシー等)を定義するのに使用します。 WSDFは、Webサービス定義言語データ・モデルのSALT特定の表現です。 以下の2つのWSDFタイプがあります。

詳細は、Oracle SALTコマンド・リファレンスの「tmwsdlgen」および「wsdlcvt」 を参照してください。

Oracle SALT WSDFの書式

図A-1に、WSDF書式のグラフィカル表現を示します。

XMLスキーマ

XMLスキーマは、WSDFに関連付けられます。 WSDFの書式を説明するXMLスキーマ・ファイルは、$TUXDIR/udataobj/salt/wsdf.xsdディレクトリにあります。

Oracle SALT WSDF のサンプル

リストA-1およびリストA-2に、ネイティブと非ネイティブのWSDFの例を示します。

<Definition name="bankapp" 
  xmlns=http://www.bea.com/Tuxedo/WSDF/2007 >
  <WSBinding id="bankapp_binding" >
    <Servicegroup id="bankapp">
      <Policy location="/home/user/rm.xml" />
      <Service name="inquiry" />
      <Service name="deposit" />
    </Servicegroup>
    <SOAP>
      <AccessingPoints>
        <Endpoint id="HTTP1" address="http://myhost:7001" />
        <Endpoint id="HTTPS1" address="https://myhost:7002/bankapp" />
      </AccessingPoints>
    </SOAP>
  </ WSBinding >
</Definition>

<Definition name="myWebservice"
  wsdlNamespace="http://www.example.org/myWebservice"
  xmlns=http://www.bea.com/Tuxedo/WSDF/2007 >
  <WSBinding id="A_binding">
    <Servicegroup id="portType">
      <Service name="operation_1" soapAction="op1" />
      <Service name="operation_2" soapAction="op2" />
    </Servicegroup>
    <SOAP version="1.1" style="rpc" use="encoded">
      <AccessingPoints>
        <Endpoint id="example_http_port"
                  address="http://www.example.org/abc" />
        <Endpoint id="example_https_port"
                  address="https://www.example.org/abcssl" />
      </AccessingPoints>
    </SOAP>
  </WSBinding>
  <WSBinding id="B_binding">
    <Servicegroup id="portType">
      <Service name="operation_3" soapAction="op3" />
      <Service name="operation_4" soapAction="op4" />
    </Servicegroup>
    <SOAP version="1.2">
      <AccessingPoints>
        <Endpoint id="another_http_port"
                  address="http://www.example.org/def" />
      </AccessingPoints>
    </SOAP>
  </WSBinding>
</Definition>

Oracle SALT WSDFの要素の説明

次のセクションには、WSDF書式要素およびこれらの属性を一覧表示し説明します。

<Definition>

WSDFファイルのルート要素です。

<WSBinding>

具体的なプロトコル・バインディング情報を定義します。 1つのWSDFファイルに0またはそれ以上のWSBindingオブジェクトを指定できます。

ネイティブWSDF: サブ要素<SOAP>を使用して、Webサービス・クライアント接続用のSOAPバージョン、エンコーディング・スタイル、複数のエンドポイントを設定でき、サブ要素<Servicegroup>を使用して、呼出し用に公開するTuxedoサービスのセットを設定できます。

非ネイティブのWSDF :外部WSDLドキュメントの各SOAPバインディング・オブジェクト(つまり、soap:binding拡張のwsdl:bindingオブジェクト)は1つのWSBindingオブジェクトに変換します。

<Servicegroup>

1つのWSBindingオブジェクト用Servicegroupオブジェクトを定義します。 WSBindingオブジェクトごとに正確に1つのServicegroupが含める必要があります。 Servicegroupオブジェクトは、Tuxedoサービスのセットをカプセル化します。

<Service>

WSBindingオブジェクト用のサービスを指定します。

ネイティブWSDF :各サービスはTuxedoサービスです。

非ネイティブのWSDF :各サービスは外部WSDLドキュメント内で定義されたwsdl:operationオブジェクトから変換されたTuxedoサービスを表します。

<Input>

特定のサービス用の入力メッセージ属性を指定します。 この要素は省略可能です。

<Output>

特定のサービス用の出力メッセージ属性を指定します。 この要素は省略可能です。

<Fault>

特定のサービス用のフォルト・メッセージの属性を指定します。 この要素は省略可能です。

<Msghandler>

カスタマイズしたメッセージ変換のハンドラを指定します。サービスの要素<Input>、<Output>および/または<Fault>に対して省略可能です。この要素の値はハンドラ名で、最大で30文字入力できます(NULLで終わる文字を除く)。

GWWSサーバーは、ハンドラ名を使用したすべてのメッセージ変換プラグインの共有ライブラリからメッセージ変換のハンドラを探します。メッセージ変換のハンドラを使用することで、デフォルトのGWWSメッセージ変換のかわりにカスタマイズしたTuxedoバッファおよびSOAPメッセージのペイロード変換関数を開発できます。

詳細は、Oracle SALT Webサービスのプログラミングの メッセージ変換プラグインのプログラミングに関する項を参照してください。

<Policy>

以下2つのレベルのうちいずれかのレベルに適用する1つのWebサービス・ポリシー・ファイルを参照します。

オブジェクトごとに最大で10のWebサービス・ポリシーをリファレンスできます。

<Property>

サービス・オブジェクトごとにSALTの特定プロパティを指定します。

次の表に、サービス・オブジェクトごとに指定できるすべてのプロパティを示します。

<SOAP>

WSBindingオブジェクトのSOAPプロトコル情報を指定します。 この要素ではSOAPバージョンおよびメッセージ・スタイルのアクセス・エンドポイントを指定します。

<AccessingPoints>

WSBindingオブジェクトのエンドポイント・リストを指定します。各サブ要素<Endpoint>は、特定のエンドポイントを表します。

この要素に対する属性はありません。

<Endpoint>

WSBindingオブジェクトにの各アクセスのエンドポイントを指定します。

<Realm>

HTTPまたはHTTP/SエンドポイントのHTTPレルム属性を指定します。この要素は1つのエンドポイントに対して構成されている場合、GWWSは、このエンドポイントを介して発信呼出しを発行する際、HTTP基本認証情報をリクエスト・メッセージに組込めようとします。

詳細は、Oracle SALTのOracle SALT管理ガイドの「トランスポート・レベル・セキュリティの構成」を参照してください。