EGL インターフェース・パーツには、1 つ以上の関数プロトタイプが含まれています。それぞれの関数プロトタイプは、サービスで使用可能な操作を識別します。
次の例で示すように、関数プロトタイプには、終了セミコロン (;)、関数名、パラメーター・リスト、および (オプションで) 戻りの型が含まれています。
Interface WeatherForecast
Function GetWeatherByZipCode(zipcode string in) returns(myRecordPart);
end
SOAP サービスについては、関数プロトタイプには、修飾子が IN、INOUT、または OUT のパラメーターが含まれていることがあります。
WSDL ファイルからインターフェース・パーツを作成するには、以下のステップを実行します。
- Web サービスの WSDL ファイルを EGL ソース・フォルダー (例えば、wsdl という名前のサブフォルダー) に入れます。
- 「プロジェクト・エクスプローラー」ビューで、WSDL ファイルを右クリックしてから、
「EGL クライアント・インターフェースを作成」をクリックします。1 番目の「新規 EGL インターフェース」ページが表示されます。
- インターフェース・パーツの作成元の Web サービスを選択します。Web サービスの SOAP サービス・バインディングを作成するには、「SOAP サービス・バインディングの作成」をクリックしてください。
- 「次へ」をクリックして、2 番目の「新規 EGL インターフェース」ページを表示します。
- 選択されている WEb サービスに関連する WSDL ファイルの portType 項目について、以下の手順を実行します。
- 新規インターフェース・パーツの名前を受け入れるか、または更新します。
- portType 項目内のどの操作が新しいインターフェース・パーツで表現されるかを指定するため、チェック・ボックスを選択またはクリアします。
- 「ソース・フォルダー」、「パッケージ」および「EGL ソース・ファイル名」フィールドで、新しいインターフェース・パッケージを含むファイルの名前とロケーションを設定します。
- Rich UI アプリケーションでインターフェース・パーツを参照する場合は、「Rich UI アプリケーションと互換性のあるインターフェースおよびデータの作成」を選択します。
- 同名の EGL ファイルを上書きするには、「既存のファイルの上書き」を選択します。
- SOAP サービス・バインディングを作成しないことを指定した場合は、「完了」をクリックします。それ以外の場合は、「次へ」をクリックして「新規 EGL SOAP サービス・バインディング」ページを表示します。
- 「ソース・フォルダー」フィールドに EGL デプロイメント記述子のロケーションが示されていることを確認してください。
- 「EGL デプロイメント記述子ファイル名」フィールドで、サービス・バインディングの追加先 EGL デプロイメント記述子の名前を選択します。
- 既にこのファイルに記述されているサービス・バインディングの詳細を更新するには、「既存のバインディングをすべて更新」を選択します。
- WSDL ファイル・ポート項目のテーブルで、インターフェース・パーツの作成元 WSDL ファイルの portType 項目を参照する項目を選択します。
- 「バインディング名」列で、デフォルト値 (WSDL ファイルの portType 項目の名前) を受け入れるか、または異なる名前を入力します。
サービス・アクセス変数を宣言し、@BindService プロパティーおよび bindingKey フィールドを設定するときに、この名前を指定します。
- 「終了」をクリックします。
上記の手順でインターフェース・パーツを作成する場合、インターフェース・パーツが含まれるファイルに挿入されているコメントに注意してください。これらのコメントは、サービスへのアクセスに関する詳細を指定するときに役立つ複合プロパティーを示します。以下のいずれかの場合に、これらの詳細を指定します。
- インターフェース・パーツに基づくサービス・アクセス変数を作成するとき
- EGL デプロイメント記述子でサービス・バインディングを作成するが、上記の手順に従って操作していなかったとき
パーツを作成しておくと、WSDL ファイルからコピーした名前が EGL では無効な場合に役立ちます。また、WSDL ファイルから派生していない EGL パッケージの名前を使用する場合にも、パーツを作成することがあります。
詳しくは、『@xml』を参照してください。