プロキシー・クライアントの生成 (.NET)

.NET クライアント・アプリケーションは、プロキシー・クライアント を使用して Web サービス API と対話します。プロキシー・クライアントのおかげで、クライアント・アプリケーションは、 複雑な Web サービス・メッセージング・プロトコルを意識する必要がなくなります。

始める前に

プロキシー・クライアントを作成するには、 まず WebSphere® 環境からいくつかの WSDL ファイルをエクスポートして、それをクライアントのプログラミング環境にコピーする必要があります。

注: WebSphere Process Server クライアント CD を所有している場合は、 代わりにその CD からファイルをコピーすることもできます。

このタスクを実行する理由と実行時期

プロキシー・クライアントは、C# Bean クラスのセットで構成されています。各クラスには 、単一の Web サービスで公開されるメソッドおよびオブジェクトがすべて含まれています。サービス・メソッドは、 パラメーターを完全な SOAP メッセージにアセンブルし、 その SOAP メッセージを HTTP 経由で Web サービスに送信し、Web サービスから応答を受信して、 戻されたデータを処理します。

注: プロキシー・クライアントの生成が必要なのは一度だけです。 Web サービス API にアクセスするクライアント・アプリケーションはすべて、以後は同じプロキシー・クライアントを使用できます。

このタスクのステップ

  1. プロキシー・クライアントの生成には WSDL コマンドを使用します。 タイプ:

    wsdl options WSDLfilepath

    各部の意味は、次のとおりです。

    • オプション は以下のとおりです。
      /language
      プロキシー・クラスの作成に使用する言語を指定できます。デフォルトは C# です。言語引数として 、VB (Visual Basic)、JS (JScript)、または VJS (Visual J#) を指定することもできます。
      /output
      該当するサフィックスの付いた出力ファイルの名前。例えば、proxy.cs です。
      /protocol
      プロキシー・クラスでインプリメントされるプロトコル。SOAP がデフォルトの設定です。

      WSDL.exe パラメーターの完全なリストが必要な場合は 、/? コマンド行スイッチを使用するか、Visual Studio で WSDL ツールのオンライン・ヘルプを 参照してください。

    • WSDLfilepath は、WebSphere 環境からエクスポートしたか、クライアント CD からコピーした WSDL ファイルのパスおよびファイル名です。
    次の例では、ヒューマン・タスク・マネージャー Web サービス API 用のプロキシー・クライアントが 生成されます。
    	wsdl /language:cs /output:proxyclient.cs c:¥ws¥bin¥HTMWS.wsdl
  2. プロキシー・クライアントをダイナミック・リンク・ライブラリー (DLL) ファイルとしてコンパイルします。
関連タスク
WSDL ファイルの公開

(c) Copyright IBM Corporation 2005, 2006. All rights reserved.
(c) Copyright IBM Japan 2006
このインフォメーション・センターでは、Eclipse テクノロジー (http://www.eclipse.org) が採用されています。