TCP アクティベーション

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

TCPActivation サンプルでは、net.tcp プロトコルで通信するサービスをアクティブ化するために、Windows プロセスアクティブ化サービス (WAS) を使用してサービスをホストする方法について示します。このサンプルは、「入門サンプル」に基づいています。

Note

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

このサンプルは、クライアントコンソールプログラム (.exe) と、WAS によってアクティブ化されるワーカープロセス内でホストされるサービスライブラリ (.dll) で構成されています。クライアントアクティビティは、コンソールウィンドウに表示されます。

サービスは、要求/応答通信パターンを定義するコントラクトを実装します。コントラクトは ICalculator インターフェイスによって定義されており、算術演算 (Add、Subtract、Multiply、および Divide) を公開しています。次のサンプルコードを参照してください。

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

このサービス実装は、計算を行い、結果を返します。

// Service class that implements the service contract.
public class CalculatorService : ICalculator
{
    public double Add(double n1, double n2)
    {
        return n1 + n2;
    }
    public double Subtract(double n1, double n2)
    {
        return n1 - n2;
    }
    public double Multiply(double n1, double n2)
    {
        return n1 * n2;
    }
    public double Divide(double n1, double n2)
    {
        return n1 / n2;
    }
}

このサンプルでは、TCP ポート共有が有効でセキュリティが無効になっている net.tcp バインディングの変化形を使用します。セキュリティ保護された TCP バインディングを使用する場合は、サーバーのセキュリティモードを必要な設定に変更し、クライアントで Svcutil.exe を再実行して更新クライアントの構成ファイルを生成します。

サービスの構成を次のサンプルに示します。

<system.serviceModel>

    <services>
      <service name="Microsoft.ServiceModel.Samples.CalculatorService"
               behaviorConfiguration="CalculatorServiceBehavior">
        <!-- This endpoint is exposed at the base address provided by host: net.tcp://localhost/servicemodelsamples/service.svc  -->
        <endpoint binding="netTcpBinding" bindingConfiguration="PortSharingBinding"
          contract="Microsoft.ServiceModel.Samples.ICalculator" />
        <!-- the mex endpoint is exposed at net.tcp://localhost/servicemodelsamples/service.svc/mex -->
        <endpoint address="mex"
                  binding="mexTcpBinding"
                  contract="IMetadataExchange" />
      </service>
    </services>
    <bindings>
      <netTcpBinding>
        <binding name="PortSharingBinding" portSharingEnabled="true">
          <security mode="None" />
        </binding>
      </netTcpBinding>
    </bindings>

    <!--For debugging purposes set the includeExceptionDetailInFaults attribute to true-->
    <behaviors>
      <serviceBehaviors>
        <behavior name="CalculatorServiceBehavior">
          <serviceMetadata />
          <serviceDebug includeExceptionDetailInFaults="False" />
        </behavior>
      </serviceBehaviors>
    </behaviors>

  </system.serviceModel>

クライアントのエンドポイントが構成されます。次のサンプルコードを参照してください。

<system.serviceModel>
    <bindings>
        <netTcpBinding>
          <binding name="NetTcpBinding_ICalculator">
            <security mode="None"/>
          </binding>
        </netTcpBinding>
    </bindings>
    <client>
        <endpoint address="net.tcp://localhost/servicemodelsamples/service.svc"
            binding="netTcpBinding" bindingConfiguration="NetTcpBinding_ICalculator"
            contract="Microsoft.ServiceModel.Samples.ICalculator" name="NetTcpBinding_ICalculator" />
    </client>
</system.serviceModel>

このサンプルを実行すると、操作要求および応答がクライアントのコンソールウィンドウに表示されます。クライアントをシャットダウンするには、クライアントウィンドウで 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.

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

IIS 7.0 がインストールされていることを確認します。 WAS のアクティブ化には IIS 7.0 が必要です。
「Windows Communication Foundation サンプルの 1 回限りのセットアップの手順」を実行したことを確認します。

さらに、WCF 非 HTTP アクティブ化コンポーネントをインストールする必要があります。
1. [スタート] メニューの [コントロールパネル] をクリックします。
2. [プログラムと機能] をクリックします。
3. [Windows コンポーネントの有効化または無効化] をクリックします。
4. [Microsoft .NET Framework 3.0] ノードを展開し、 [Windows Communication Foundation 非 HTTP アクティブ化] 機能をオンにします。
TCP アクティベーションをサポートするよう WAS を構成します。

便宜上次の 2 つの手順が、サンプルディレクトリにある AddNetTcpSiteBinding.cmd というバッチファイルに実装されています。
1. net.tcp アクティベーションをサポートするには、既定の Web サイトをあらかじめ net.tcp ポートにバインドしておく必要があります。これは、インターネットインフォメーションサービス 7.0 (IIS) 管理ツールセットと共にインストールされる Appcmd.exe を使用して行います。管理者レベルのコマンドプロンプトから、次のコマンドを実行します。
```
%windir%\system32\inetsrv\appcmd.exe set site "Default Web Site" -+bindings.[protocol='net.tcp',bindingInformation='808:*']
```
  ヒント
  
  このコマンドはテキスト 1 行です。このコマンドは、net.tcp サイトバインディングを、TCP ポート 808 で任意のホスト名をリッスンする既定の Web サイトに追加します。
2. サイト内のすべてのアプリケーションが同じ net.tcp バインディングを共有しますが、net.tcp サポートの有効化はアプリケーションごとに指定できます。 /servicemodelsamples アプリケーションで net.tcp を有効にするには、管理者レベルのコマンドプロンプトから、次のコマンドを実行します。
```
%windir%\system32\inetsrv\appcmd.exe set app
"Default Web Site/servicemodelsamples" /enabledProtocols:http,net.tcp
```
  Note
  
  このコマンドはテキスト 1 行です。このコマンドにより、http://localhost/servicemodelsamples と net.tcp://localhost/servicemodelsamples の両方を使用して /servicemodelsamples アプリケーションにアクセスできるようになります。
ソリューションの C# 版または Visual Basic .NET 版をビルドするには、「 Building the Windows Communication Foundation Samples」の手順に従います。
単一コンピューター構成または複数コンピューター構成でサンプルを実行するには、「Windows Communication Foundation サンプルの実行」の手順に従います。

このサンプル用に追加した net.tcp サイトバインディングを削除します。

便宜上次の 2 つの手順が、サンプルディレクトリにある RemoveNetTcpSiteBinding.cmd というバッチファイルに実装されています。
1. 管理者レベルのコマンドプロンプトから次のコマンドを実行して、有効なプロトコルの一覧から net.tcp を削除します。
```
%windir%\system32\inetsrv\appcmd.exe set app
"Default Web Site/servicemodelsamples" /enabledProtocols:http
```
  Note
  
  このコマンドは、全体で 1 行のテキストになるように入力する必要があります。
2. 管理者レベルのコマンドプロンプトから次のコマンドを実行して、net.tcp サイトバインディングを削除します。
```
%windir%\system32\inetsrv\appcmd.exe set site "Default Web Site"
--bindings.[protocol='net.tcp',bindingInformation='808:*']
```
  Note
  
  このコマンドは、全体で 1 行のテキストになるように入力する必要があります。

TCP アクティベーション

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

関連項目

その他のリソース