概要このオブジェクトは、SOAP/WSDLベースのWebサービスを呼び出すためのオブジェクトです。このオブジェクトを利用することにより、XMLやJavaを意識することなく、Webサービスを呼び出すことが可能です。SOAPClientオブジェクトを利用したWebサービスの呼び出しは、以下の3ステップで実現できます。オブジェクトが例外としてスローされます。オブジェクトを利用したエラー処理を行う事が可能です。注意事項SOAPClientオブジェクトは、データバインディング方式に「ADB」を利用したAxis2のスタブを利用しています。そのため、Axis2が対応していないWebサービスを呼び出すことはできません。サービスに対応しています。SOAPClientは、非同期型コールバック形式のWebサービスを実行することはできません。(=WSDLの解析、Javaスタブ・ソースの生成&コンパイル、および、JavaScriptソースの生成)に関する設定です。以下の3つの設定が可能です。Webサービスのスタブを毎回作成します。開発時に利用する設定です。このモードは同じマルチスレッド環境において正常に動作しません、本番環境では利用しないで下さい。Webサービスのスタブが存在しない場合のみスタブを作成します。Webサービスのスタブを自動生成しません。このモードの場合、別途、Webサービスのスタブを配備する必要があります。ソースディレクトリ(通常は%IM_HOME%/WEB-INF/pages/src/)に追加する必要があります。Webサービスのスタブ、および、WSDLファイルを展開するディレクトリです。Runtimeが展開してできたWEB-INFディレクトリからの相対パスで指定します。trueの場合、詳細情報が出力され、falseの場合詳細情報は出力されません。Webサービスのスタブをコンパイルする際の最大ヒープサイズを設定します。256mと設定した場合、最大ヒープサイズは256Mバイトに設定されます。スタブ生成に必要なファイルの拡張子を設定します。パブリックストレージ上に保存されているWSDLファイルを利用する際に必要な設定です。あるWSDLファイルで参照している要素が、別のファイルで定義されている場合、その定義ファイルの拡張子をここに設定します。スタブ生成に必要なファイルが格納されているディレクトリ名の設定です。パブリックストレージ上に保存されているWSDLファイルを利用する際に必要な設定です。そのファイルが保存されているディレクトリ名をここに設定します。WSDLファイルが保存されているディレクトリのサブディレクトリ名として利用されます。SOAPClientオブジェクトを利用してWebサービスを呼び出すサンプルです。メンバー情報を追加します。Debug.browse("エラーが発生しました。"Webサービスを呼び出すソースコードのサンプルが表示されました。Debug.browse("エラーが発生しました。指定するコンストラクタ。オブジェクトで指定するコンストラクタ。オブジェクトで指定するコンストラクタ。()SOAPClientの関連リソースをクリーンアップします。()このWebサービスで利用可能なオペレーション名を返却します。[operationName])Webサービスを呼び出すソースコードのサンプルを返却します。charset)送信するSOAPメッセージの文字セットを設定します。Mechanism)の有効・無効を設定します。timeOutInMilliSeconds)タイムアウト値を設定します。指定するコンストラクタ。SOAPClientは、インスタンス生成時に以下の処理を行います。上記で示した一連の処理は、インスタンス生成時に一度だけ行われます。2回目以降のインスタンス生成では上記処理が省略され、1回目に作成されたスタブが利用されます。この動作は、初期設定時の動作です。WSDL内に複数のWebサービスが定義されている場合は、第2引数「serviceName」に実行したいWebサービス名を指定します。WSDLのポート要素を指定したい場合は、第3引数「portName」に利用したいポート名を指定します。WSDL内に定義されているエンドポイントとは異なるエンドポイントを利用する場合は、第4引数「endpoint」に指定してください。serviceNameやportNameを指定しない場合は、以下のようにエンドポイントを設定してください。endpoint);なお、WSDLファイルは、パブリックストレージ上に存在するWSDLファイルを利用することも可能です。オブジェクトで指定するコンストラクタ。Runtime上に保存されているWSDLファイルを利用することが可能です。オブジェクトを指定してください。そのほかの動作は、「WSDLをURLで指定するコンストラクタ」と同等です。オブジェクトで指定するコンストラクタ。このコンストラクタを利用すると、パブリックストレージ上に保存されているWSDLファイルを利用することが可能です。オブジェクトを指定してください。コンストラクタに指定したWSDLファイルと同じディレクトリ(または、設定可能なサブディレクトリ)にそれらのファイルを保存してください。別のXSDファイルで定義されている場合が当てはまります。そのほかの動作は、「WSDLをURLで指定するコンストラクタ」と同等です。()SOAPClientの関連リソースをクリーンアップします。このメソッドを呼び出すことは、Axis2のorg.apache.axis2.client.Stub#cleanup()メソッドを呼び出すことに相当します。()このWebサービスで利用可能なオペレーション名を返却します。[operationName])Webサービスを呼び出すソースコードのサンプルを返却します。getSampleCode()の引数にはWebサービス・オペレーション名を指定します。実行すると、Webサービス内で利用可能なすべてのオペレーションに関するソースコードが返却されます。getSampleCode()関数の目的はサンプルコードの表示です。したがって、getSampleCode()関数の実行ロジックは、Webサービスを呼び出すコードの作成完了後に削除してください。以下に、getSampleCode()関数で生成される、Webサービスを呼び出すソースコードのサンプルを示します。************************************************************サンプルコードはJSON形式で出力されます。そのため、コピー&ペーストで利用することが可能です。コメントとしてJavaScriptの型情報が付与されています。JavaScriptの型情報の右側に表示されている「<>」内の文字列は、そのオブジェクト構成を表す名称です。ことを意味しています。定義されている型などは、サンプルデータが生成されません。サンプルデータが生成されていない型については、WSDL、および、実行するWebサービスの仕様を確認してください。charset)送信するSOAPメッセージの文字セットを設定します。設定しない場合の初期値は「UTF-8」です。Mechanism)の有効・無効を設定します。timeOutInMilliSeconds)タイムアウト値を設定します。CORPORATION。