本文別のルーティング

2008-09-17

このサンプルでは、任意の SOAP アクションでメッセージオブジェクトを受け入れるサービスを実装する方法を示します。このサンプルは、電卓サービスを実装する「入門サンプル」に基づいています。このサービスは、Message 要求パラメータを受け入れる 1 つの Calculate 操作を実装して、Message 応答を返します。

このサンプルでは、クライアントはコンソールアプリケーション (.exe) で、サービスは IIS によってホストされています。

メモ :
このサンプルのセットアップ手順とビルド手順については、このトピックの最後を参照してください。

このサンプルでは、本文の内容に基づくメッセージディスパッチを示します。組み込みの Windows Communication Foundation (WCF) サービスモデルのメッセージディスパッチメカニズムは、メッセージの Action に基づいています。ただし既存の多くの Web サービスでは、すべての操作が Action="" で定義されています。アクション情報に基づいてディスパッチ要求メッセージを保持する WSDL を基準として、サービスを構築することはできません。このサンプルでは、WSDL に基づくサービスコントラクトを示します (WSDL はこのサンプルに含まれる Service.wsdl 内に格納されています)。このサービスコンストラクトは電卓で、「入門サンプル」で使用されているものと同様です。ただし、[OperationContract] は、すべての操作に対して Action="" を指定します。

[ServiceContract(Namespace = "http://Microsoft.ServiceModel.Samples"),  
                 XmlSerializerFormat, DispatchByBodyBehavior]
    public interface ICalculator
    {
        [OperationContract(Action="")]
        double Add(double n1, double n2);
        [OperationContract(Action = "")]
        double Subtract(double n1, double n2);
        [OperationContract(Action = "")]
        double Multiply(double n1, double n2);
        [OperationContract(Action = "")]
        double Divide(double n1, double n2);
    }

コントラクトが指定されている場合、サービスはカスタムのディスパッチ動作 DispatchByBodyBehavior に対して、複数の操作間でメッセージをディスパッチするように要求します。このディスパッチ動作は、カスタムの DispatchByBodyElementOperationSelector 操作セレクタを、それぞれのラッパー要素の QName をキーとする操作名のテーブルを使用して初期化します。DispatchByBodyElementOperationSelector は本文の最初の子の開始タグを参照し、前述のテーブルを使用して操作を選択します。

クライアントは、Service Metadata Utility Tool (Svcutil.exe) を使用するサービスによってエクスポートされた WSDL から自動生成された、プロキシを使用します。

svcutil.exe  /n:http://Microsoft.ServiceModel.Samples,Microsoft.ServiceModel.Samples /uxs https://localhost/servicemodelsamples/service.svc?wsdl /out:generatedProxy.cs

すべての操作のアクションが空であっても、クライアントコードには影響ありません。ただし、自動生成されたプロキシ内の Action パラメータは例外です。

クライアントコードは、複数の計算を実行します。このサンプルを実行する場合は、操作要求および応答はクライアントのコンソールウィンドウに表示されます。クライアントをシャットダウンするには、クライアントウィンドウで Enter キーを押します。

Add(100, 15.99) = 115.99
Subtract(145, 76.54) = 68.46
Multiply(9, 81.25) = 731.25
Divide(22, 7) = 3.14285714285714

Press <ENTER> to terminate client.

サンプルを設定、ビルド、および実行するには

「Windows Communication Foundation サンプルの 1 回限りのセットアップの手順」が実行済みであることを確認します。
ソリューションをビルドするには、「Windows Communication Foundation サンプルのビルド」の手順に従います。
単一コンピュータ構成か複数コンピュータ構成かに応じて、「Windows Communication Foundation サンプルの実行」の手順に従います。

Footer image

次の方法で共有

本文別のルーティング

サンプルを設定、ビルド、および実行するには

その他のリソース