リファレンス ガイド

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 プラグインの使用」の「メッセージ変換プラグインのプログラミング」を参照してください。

<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 の『管理ガイド』の「転送レベル セキュリティのコンフィグレーション」を参照してください。