WSDL 結合の構成
関連項目
WSDL エディタを使用すると、結合を作成できます。また、「新規 WSDL」ウィザードで生成した結合を修正することもできます。
WSDL ファイルでは、結合によってポート型のメッセージ形式とプロトコルの詳細が定義されます。
SOAP 1.1 プロトコルへの結合を結合することができます。結合には、SOAP 結合ノードおよび 1 つ以上の操作が含まれます。各操作には、次の要素を含むことができます。
- soap:body 要素は、SOAP 本体の要素の情報を提供します。
- soap:header および soap:headerfault 要素は、SOAP ヘッダーの要素の情報を提供します。
- soap:fault 要素は、SOAP Fault Details 要素の情報を提供します。
結合の名前を変更すると、WSDL エディタによって同じファイル内にある該当する結合の名前がすべて変更されます。関連する XSD、WSDL、および BPEL の各ファイル内の該当する結合の名前もすべて変更するには、結合ノードを右クリックし、「リファクタリング」>「名前を変更」を選択します。
既存のポート型から、結合とサービスを簡単に作成することができます。あとで結合を修正する場合は、「結合の作成」の適切な手順を参照してください。
ポート型から結合とサービスを作成するには、次の手順に従います。
- 「WSDL」ビューでポート型ノードを右クリックし、「追加」>「結合およびサービスポート」を選択します。
「結合およびサービスポートを生成」ダイアログが表示されます。
- 結合の名前を指定します。
- このリリースでサポートされる結合の種類は SOAP プロトコルのみです。
- 結合サブタイプオプションには、SOAP メッセージへの結合を変換する方法を指定します。メッセージ部品と結合サブタイプの設定が WS-I Basic Profile に準拠していない場合は、エラーメッセージが表示されます。
- サービスの名前を指定します。
- ポートの名前を指定します。
- 「了解」をクリックします。
結合ノードとサービスノードが表示されます。結合ノードには、SOAP 結合ノードおよび 1 つ以上の操作が含まれます。サービスノードにはポートノードが含まれます。
- ポートの SOAP アドレスノードには、ポートのアドレスを指定する場所プロパティーが含まれます。ウィザードにより、場所プロパティーのダミー値が生成されます。ダミー値は、必ず有効な値に置き換えてください。
結合の作成
既存のポート型から簡単に結合とサービスを作成するのではなく、結合、サービス、およびそのサブノードを個別に作成することができます。この節では、結合の作成方法、および SOAP 情報の構成方法について説明します。
- 「結合およびサービスポートを生成」ダイアログの結合サブタイプオプションは、この節で説明するスタイルプロパティーと使用プロパティーの組み合わせになっています。
結合を作成するには、次の手順に従います。
- 「WSDL」ビューで、「結合」ノードを右クリックして「結合を追加」を選択します。
結合ノードが表示されます。
- 「プロパティー」ウィンドウが表示されない場合は、「ウィンドウ」>「プロパティー」を選択します。
- 結合ノードを選択します。
- (省略可能) 「名前」プロパティーに新しい名前を設定します。
- 「型」プロパティーに、結合で参照するポート型を設定します。
- 結合ノードを右クリックし、「追加」>「結合操作」を選択します。
- 結合のポート型に複数の操作がある場合は、「操作を選択」ダイアログが表示されます。1 つ以上の操作を選択し、「了解」をクリックします。 1 つ以上の操作ノードが表示されます。
SOAP 結合ノードを追加するには、次の手順に従います。
- 「WSDL」ビューで、結合ノードを右クリックして「追加」>「SOAP 結合」を選択します。
SOAP 結合ノードが表示されます。
- 「プロパティー」ウィンドウが表示されない場合は、「ウィンドウ」>「プロパティー」を選択します。
- SOAP 結合ノードを選択します。
- スタイルプロパティーには、SOAP メッセージへの結合を変換する方法を指定します。値に、「ドキュメント」または「RPC」を設定します。
操作の SOAP 要素を変更するには、次の手順に従います。
- 「WSDL」ビューで、操作ノードを右クリックして「追加」>「SOAP 操作」を選択します。
SOAP 操作ノードが表示されます。このノードには、操作に関する概要が含まれています。
- 「プロパティー」ウィンドウが表示されない場合は、「ウィンドウ」>「プロパティー」を選択します。
- SOAP 操作ノードを選択します。
- 「soapAction」プロパティーには、操作の SOAPAction ヘッダーの値を指定します。
- スタイルプロパティーには、SOAP メッセージへの結合を変換する方法を指定します。値に、「ドキュメント」または「RPC」を設定します。
- 実際のシナリオに応じて、「入力」、「出力」、「フォルト」の各ノードに要素を追加してください。
- 「入力」ノードで追加できる要素は、soap:body と soap:header です。
- 「出力」ノードで追加できる要素は、soap:body と soap:header です。
- 「フォルト」ノードで追加できる要素は、soap:fault です。
- soap:headerfault 要素を追加するには、「soap:header」ノードを右クリックし、「追加 headerfault」を選択します。
- soap:body 要素を追加した場合は、次のプロパティーを設定できます。
- 「部品」プロパティーには、SOAP 本体の要素でどのメッセージ部品が使用されているかが示されます。
- 「encodingStyle」プロパティーには、メッセージで使用されるエンコーディングを表す URI のリストを設定できます。
- 使用プロパティーには、SOAP メッセージへの結合を変換する方法を指定します。値に、「literal」または「encoded」を設定します。
- 名前空間プロパティーには、エンコーディング使用の情報が提供されます。
- soap:header 要素を追加した場合は、次のプロパティーを設定できます。「メッセージ」および「部品」プロパティーは必須です。
- 「メッセージ」および「部品」プロパティーは、ヘッダーの種類を定義するメッセージ部品を参照します。
- 使用プロパティーには、SOAP メッセージへの結合を変換する方法を指定します。値に、「literal」または「encoded」を設定します。
- 「encodingStyle」プロパティーには、メッセージで使用されるエンコーディングを表す URI のリストを設定できます。
- 名前空間プロパティーには、エンコーディング使用の情報が提供されます。
- soap:headerfault 要素を追加した場合は、次のプロパティーを設定できます。「メッセージ」および「部品」プロパティーは必須です。
- 「メッセージ」および「部品」プロパティーは、ヘッダーの種類を定義するメッセージ部品を参照します。
- 使用プロパティーには、SOAP メッセージへの結合を変換する方法を指定します。値に、「literal」または「encoded」を設定します。
- 「encodingStyle」プロパティーには、メッセージで使用されるエンコーディングを表す URI のリストを設定できます。
- 名前空間プロパティーには、エンコーディング使用の情報が提供されます。
- soap:fault 要素を追加した場合は、次のプロパティーを設定できます。
- 「encodingStyle」プロパティーには、メッセージで使用されるエンコーディングを表す URI のリストを設定できます。
- 使用プロパティーには、SOAP メッセージへの結合を変換する方法を指定します。値に、「literal」または「encoded」を設定します。
- 名前空間プロパティーには、エンコーディング使用の情報が提供されます。
結合の削除
WSDL ファイルから結合を削除することができます。
結合を削除するには、次の手順に従います。
- 「WSDL」ビューで結合ノードを右クリックし、「削除」を選択します。
- 関連項目
- WSDL ファイルコンポーネントの構成
著作権と商標について