二重

[アーティクル]
05/10/2023

二重サンプルでは、二重コントラクトを定義して実装する方法を示します。双方向通信は、クライアントがサービスとのセッションを確立し、サービスからクライアントにメッセージを返信できるチャネルがサービスに提供されると発生します。このサンプルは、「入門サンプル」に基づいています。双方向コントラクトは、クライアントからサービスへのプライマリインターフェイスとサービスからクライアントへのコールバックインターフェイスという 2 つのインターフェイスのペアとして定義されます。このサンプルでは、ICalculatorDuplex インターフェイスを使用することにより、クライアントは算術演算を実行し、セッション経由で結果を計算できます。サービスは、ICalculatorDuplexCallback インターフェイスで結果を返します。コンテキストを確立して、クライアントとサービスの間で送信される一連のメッセージを相互に関連付ける必要があるため、二重のコントラクトにはセッションが必要です。

Note

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

この例では、クライアントはコンソールアプリケーション (.exe) であり、サービスはインターネットインフォメーションサービス (IIS) によってホストされます。双方向コントラクトは、次のように定義されます。

[ServiceContract(Namespace = "http://Microsoft.ServiceModel.Samples", SessionMode=SessionMode.Required,
                 CallbackContract=typeof(ICalculatorDuplexCallback))]
public interface ICalculatorDuplex
{
    [OperationContract(IsOneWay = true)]
    void Clear();
    [OperationContract(IsOneWay = true)]
    void AddTo(double n);
    [OperationContract(IsOneWay = true)]
    void SubtractFrom(double n);
    [OperationContract(IsOneWay = true)]
    void MultiplyBy(double n);
    [OperationContract(IsOneWay = true)]
    void DivideBy(double n);
}

public interface ICalculatorDuplexCallback
{
    [OperationContract(IsOneWay = true)]
    void Result(double result);
    [OperationContract(IsOneWay = true)]
    void Equation(string eqn);
}

CalculatorService クラスは、プライマリ ICalculatorDuplex インターフェイスを実装します。このサービスは PerSession インスタンスモードを使用して、各セッションの結果を保持します。クライアントへのコールバックチャネルへのアクセスには、Callback というプライベートプロパティを使用します。サービスはこのコールバックを使用し、コールバックインターフェイスを介してメッセージをクライアントに返信します。

[ServiceBehavior(InstanceContextMode = InstanceContextMode.PerSession)]
public class CalculatorService : ICalculatorDuplex
{
    double result = 0.0D;
    string equation;

    public CalculatorService()
    {
        equation = result.ToString();
    }

    public void Clear()
    {
        Callback.Equation($"{equation} = {result}");
        equation = result.ToString();
    }

    public void AddTo(double n)
    {
        result += n;
        equation += $" + {n}";
        Callback.Result(result);
    }

    //...

    ICalculatorDuplexCallback Callback
    {
        get
        {
            return OperationContext.Current.GetCallbackChannel<ICalculatorDuplexCallback>();
        }
    }
}

クライアントは、サービスからのメッセージを受信するために、双方向コントラクトのコールバックインターフェイスを実装するクラスを提供する必要があります。このサンプルでは、CallbackHandler クラスは ICalculatorDuplexCallback インターフェイスを実装するように定義されています。

public class CallbackHandler : ICalculatorDuplexCallback
{
   public void Result(double result)
   {
      Console.WriteLine("Result({0})", result);
   }

   public void Equation(string equation)
   {
      Console.WriteLine("Equation({0}", equation);
   }
}

双方向コントラクト用に生成されるプロキシは、コンストラクト時に InstanceContext が提供される必要があります。この InstanceContext がコールバックインターフェイスを実装するオブジェクトのサイトとして使用され、サービスから返信されるメッセージを処理します。 InstanceContext は、CallbackHandler クラスのインスタンスを使用して構築されます。このオブジェクトは、コールバックインターフェイスでサービスからクライアントに送信されるメッセージを処理します。

// Construct InstanceContext to handle messages on callback interface.
InstanceContext instanceContext = new InstanceContext(new CallbackHandler());

// Create a client.
CalculatorDuplexClient client = new CalculatorDuplexClient(instanceContext);

Console.WriteLine("Press <ENTER> to terminate client once the output is displayed.");
Console.WriteLine();

// Call the AddTo service operation.
double value = 100.00D;
client.AddTo(value);

// Call the SubtractFrom service operation.
value = 50.00D;
client.SubtractFrom(value);

// Call the MultiplyBy service operation.
value = 17.65D;
client.MultiplyBy(value);

// Call the DivideBy service operation.
value = 2.00D;
client.DivideBy(value);

// Complete equation.
client.Clear();

Console.ReadLine();

//Closing the client gracefully closes the connection and cleans up resources.
client.Close();

この構成は、セッション通信と双方向通信の両方をサポートするバインディングを提供するように変更されています。 wsDualHttpBinding はセッション通信をサポートし、どちらの方向にも HTTP 接続が 1 つ用意される双方向 HTTP 接続を提供して双方向通信を実現します。サービスでの構成の唯一の違いは、使用されるバインディングです。クライアントで、サーバーがクライアントへの接続に使用するアドレスを構成する必要があります。次のサンプル構成を参照してください。

<client>
  <endpoint name=""
            address="http://localhost/servicemodelsamples/service.svc"
            binding="wsDualHttpBinding"
            bindingConfiguration="DuplexBinding"
            contract="Microsoft.ServiceModel.Samples.ICalculatorDuplex" />
</client>

<bindings>
  <!-- Configure a binding that support duplex communication. -->
  <wsDualHttpBinding>
    <binding name="DuplexBinding"
             clientBaseAddress="http://localhost:8000/myClient/">
    </binding>
  </wsDualHttpBinding>
</bindings>

サンプルを実行すると、クライアントに戻ってきたメッセージがサービスから送信されたコールバックインターフェイスに表示されます。それぞれの中間結果が表示され、その後にすべての操作が完了したときの数式全体が表示されます。 Enter キーを押してクライアントをシャットダウンします。

サンプルをセットアップ、ビルド、および実行するには

Windows Communication Foundation サンプルの 1 回限りのセットアップの手順を実行したことを確認します。
ソリューションの C#、C++、Visual Basic .NET 版をビルドするには、「Windows Communication Foundation サンプルのビルド」の手順に従います。
単一または複数コンピューター構成でサンプルを実行するには、「Windows Communication Foundation サンプルの実行」の手順に従います。

重要

複数コンピューター構成でクライアントを実行する場合は、次に示すように、<client> 要素の <endpoint> の address 属性と、<wsDualHttpBinding> 要素の <binding> 要素の clientBaseAddress 属性の両方で、必ず "localhost" を適切なコンピューターの名前に置き換えてください。
```
<client>
    <endpoint name = ""
    address="http://service_machine_name/servicemodelsamples/service.svc"
    ... />
</client>
...
<wsDualHttpBinding>
    <binding name="DuplexBinding" clientBaseAddress="http://client_machine_name:8000/myClient/">
    </binding>
</wsDualHttpBinding>
```

二重

サンプルをセットアップ、ビルド、および実行するには

その他のリソース