次の方法で共有


チュートリアル: Azure WCF Relay を使用してオンプレミスの WCF REST サービスを外部クライアントに公開する

このチュートリアルでは、Azure Relay を使用して WCF Relay クライアント アプリケーションとサービスを構築する方法について説明します。 元の WCF サービスと同様に、サービスは 1 つ以上のエンドポイントを公開するコンストラクトです。 各エンドポイントでは 1 つ以上のサービス操作が公開されます。 サービスのエンドポイントでは、サービスが見つかるアドレス、クライアントがサービスとやり取りする必要がある情報を含むバインド、サービスがそのクライアントに提供する機能を定義するコントラクトを指定します。 WCF と WCF Relay の主な違いは、エンドポイントがコンピューターのローカルではなくクラウドで公開される点です。

このチュートリアルの一連のセクションを実行すると、実行中のサービスが作成されます。 また、サービスの操作を呼び出すことができるクライアントも作成されます。

このチュートリアルでは、次のタスクを行います。

  • このチュートリアルの前提条件をインストールする。
  • Relay 名前空間を作成する。
  • WCF サービス コントラクトを作成する。
  • WCF コントラクトを実装する。
  • リレー サービスに登録する WCF サービスをホストして実行する。
  • サービス コントラクト用の WCF クライアントを作成する。
  • WCF クライアントを構成する。
  • WCF クライアントを実装する。
  • アプリケーションを実行する。

前提条件

このチュートリアルを完了するには、次の前提条件を用意しておく必要があります。

Relay 名前空間を作成する

最初の手順として、名前空間を作成し、Shared Access Signature (SAS) キーを取得します。 名前空間により、リレー サービスが公開する各アプリケーションにアプリケーション境界が設けられます。 SAS キーは、サービスの名前空間が作成されると、システムによって自動的に生成されます。 サービス名前空間と SAS キーの組み合わせが、アプリケーションへのアクセスを Azure が認証する資格情報になります。

  1. Azure portal にサインインします。

  2. 左側のメニューから、 [すべてのサービス] を選択します。 [統合] を選択し、[リレー] を検索し、[リレー] の上にマウス ポインターを移動して、[作成] を選択します。

    [リレー] -> [作成] ボタンの選択を示すスクリーンショット。

  3. [名前空間の作成] ページで、これらの手順を実行します。

    1. 名前空間を作成する Azure サブスクリプションを選択します。

    2. [リソース グループ] で、名前空間を追加する既存のリソース グループを選択するか、新しいリソース グループを作成します。

    3. リレー名前空間の名前を入力します。

    4. 名前空間をホストするリージョンを選択します。

    5. ページ下部にある [確認と作成] を選択します。

      [名前空間の作成] ページを示すスクリーンショット。

    6. [確認および作成] ページで、 [作成] を選択します。

    7. 数分後に、名前空間の [リレー] ページを確認します。

      リレー名前空間のホーム ページを示すスクリーンショット。

管理資格情報を取得する

  1. [リレー] ページで、左側のメニューの [共有アクセス ポリシー] を選択します。 `

  2. [共有アクセス ポリシー] ページで、 [RootManageSharedAccessKey] を選択します。

  3. [SAS ポリシー:RootManageSharedAccessKey] の下で、 [プライマリ接続文字列] の横の [コピー] ボタンを選択します。 これで、後で使用できるように接続文字列がクリップボードにコピーされます。 この値をメモ帳などに一時的に貼り付けます。

  4. 前の手順を繰り返し、 [主キー] の値をコピーして、後で使用するために一時的な場所に貼り付けます。

    リレー名前空間の接続情報を示すスクリーンショット。

WCF サービス コントラクトを定義する

サービス コントラクトでは、サービスがサポートする操作を指定します。 操作は、Web サービスのメソッドまたは関数です。 コントラクトを作成するには、C++、C#、または Visual Basic インターフェイスを定義します。 インターフェイスの各メソッドは、特定のサービス操作に対応しています。 各インターフェイスには、ServiceContractAttribute 属性が適用されている必要があります。また、各操作には、OperationContractAttribute 属性が適用されている必要があります。 ServiceContractAttribute 属性があるインターフェイスのメソッドに OperationContractAttribute 属性がない場合、そのメソッドは公開されません。 以下の手順では、これらのタスクのコード例を示します。 コントラクトとサービスの概要については、「サービスの設計と実装」を参照してください。

インターフェイスを使用してリレー コントラクトを作成する

  1. Microsoft Visual Studio を管理者として起動します。 これを行うには、Visual Studio のプログラム アイコンを右クリックして [管理者として実行] を選択します。

  2. Visual Studio で、 [新しいプロジェクトの作成] を選択します。

  3. [新しいプロジェクトの作成] で、C# の [コンソール アプリ (.NET Framework)] を選択してから、 [次へ] を選択します。

  4. プロジェクトに EchoService という名前を付けて、[作成] を選択します。

    コンソール アプリを作成する

  5. ソリューション エクスプローラーで、プロジェクトを右クリックし、 [NuGet パッケージの管理] を選択します。 [NuGet パッケージ マネージャー][参照] を選択してから、WindowsAzure.ServiceBus を検索して選択します。 [インストール] を選択して、使用条件に同意します。

    Service Bus パッケージ

    Service Bus ライブラリと WCF の System.ServiceModel への参照が、このパッケージによって自動的に追加されます。 System.ServiceModel は、WCF の基本機能にプログラムでアクセスできるようにする名前空間です。 Service Bus は、サービス コントラクトの定義に WCF の多くのオブジェクトと属性を使用します。

  6. Program.cs ファイルの先頭に次の using ステートメントを追加します。

    using System.ServiceModel;
    using Microsoft.ServiceBus;
    
  7. 名前空間の名前を、既定の名前である EchoService から Microsoft.ServiceBus.Samples に変更します。

    重要

    このチュートリアルでは、C# の名前空間 Microsoft.ServiceBus.Samples を使用します。これは、コントラクトベースのマネージド型の名前空間で、「WCF クライアントを構成する」セクションに出てくる構成ファイルで使用されます。 このサンプルをビルドするときに、任意の名前空間を指定できます。 ただし、それに応じてアプリケーション構成ファイルでコントラクトとサービスの名前空間を変更しない限り、このチュートリアルは機能しません。 App.config ファイルで指定する名前空間は、C# ファイルで指定した名前空間と同じである必要があります。

  8. Microsoft.ServiceBus.Samples 名前空間の宣言の直後 (ただし、名前空間内部) に、IEchoContract という名前の新しいインターフェイスを定義し、このインターフェイスに名前空間の値が https://samples.microsoft.com/ServiceModel/Relay/ServiceContractAttribute 属性を適用します。 名前空間の宣言の後に次のコードを貼り付けます。

    [ServiceContract(Name = "IEchoContract", Namespace = "https://samples.microsoft.com/ServiceModel/Relay/")]
    public interface IEchoContract
    {
    }
    

    この名前空間の値は、コードのスコープ全体で使用する名前空間とは異なります。 代わりに、この名前空間の値は、このコントラクトの一意の識別子として使用されます。 名前空間を明示的に指定すると、既定の名前空間値がコントラクト名に追加されなくなります。

    Note

    通常、サービス コントラクトの名前空間には、バージョン情報を含む名前付けスキームが含まれています。 サービス コントラクトの名前空間にバージョン情報を含めると、サービスは、新しいサービス コントラクトを新しい名前空間を使用して定義し、それを新しいエンドポイントで公開することで、主要な変更を分離できます。 この方法では、クライアントは、古いサービス コントラクトを更新する必要なく、使用し続けることができます。 バージョン情報は、日付またはビルド番号で構成できます。 詳細については、「サービスのバージョン管理」を参照してください。 このチュートリアルでは、サービス コントラクトの名前空間の名前付けスキームにバージョン情報は含まれません。

  9. IEchoContract インターフェイス内で、IEchoContract コントラクトがインターフェイスで公開している単一操作のメソッドを宣言し、次に示すように、パブリック WCF Relay コントラクトの一部として公開するメソッドに OperationContractAttribute 属性を適用します。

    [OperationContract]
    string Echo(string text);
    
  10. 次に示すように、IEchoContract インターフェイスの定義の直後に、IEchoContract インターフェイスと IClientChannel インターフェイスの両方から継承するチャネルを宣言します。

    public interface IEchoChannel : IEchoContract, IClientChannel { }
    

    チャネルは、ホストとクライアントが相互に情報を渡すときに経由する WCF オブジェクトです。 後で、2 つのアプリケーション間で情報をエコーするチャネルに対するコードを記述します。

  11. [ビルド]>[ソリューションのビルド] の順に選択するか、Ctrl + Shift + B キーを押して、ここまでの作業に問題がないことを確認します。

WCF コントラクトの例

次のコードに、WCF Relay コントラクトを定義する基本的なインターフェイスを示します。

using System;
using System.ServiceModel;

namespace Microsoft.ServiceBus.Samples
{
    [ServiceContract(Name = "IEchoContract", Namespace = "https://samples.microsoft.com/ServiceModel/Relay/")]
    public interface IEchoContract
    {
        [OperationContract]
        String Echo(string text);
    }

    public interface IEchoChannel : IEchoContract, IClientChannel { }

    class Program
    {
        static void Main(string[] args)
        {
        }
    }
}

これでインターフェイスが作成されたので、このインターフェイスを実装することができます。

WCF コントラクトを実装する

Azure Relay を作成するには、まずインターフェイスを使用してコントラクトを作成する必要があります。 インターフェイスの作成の詳細については、前のセクションを参照してください。 次の手順では、インターフェイスを実装します。 このタスクには、ユーザー定義の EchoService インターフェイスを実装する IEchoContract というクラスの作成が含まれます。 インターフェイスを実装したら、App.config 構成ファイルを使用してインターフェイスを構成します。 この構成ファイルには、アプリケーションに必要な情報が含まれています。 この情報には、サービス名、コントラクト名、リレー サービスとの通信に使用されるプロトコルの種類が含まれます。 次の手順では、これらのタスクに使用するコード例を示します。 サービス コントラクトの実装方法の全般的な説明については、「サービス コントラクトの実装」をご覧ください。

  1. IEchoContract インターフェイスの定義の直後に、EchoService という新しいクラスを作成します。 EchoService クラスによって、IEchoContract インターフェイスが実装されます。

    class EchoService : IEchoContract
    {
    }
    

    他のインターフェイス実装と同様に、別のファイルに指定した定義を実装することができます。 ただし、このチュートリアルでは、インターフェイス定義や Main() メソッドと同じファイルに実装します。

  2. IEchoContract インターフェイスに ServiceBehaviorAttribute 属性を適用します。 サービスの名前と名前空間をこの属性で指定します。 指定後の EchoService クラスは次のようになります。

    [ServiceBehavior(Name = "EchoService", Namespace = "https://samples.microsoft.com/ServiceModel/Relay/")]
    class EchoService : IEchoContract
    {
    }
    
  3. EchoService クラスの IEchoContract インターフェイスで定義された Echo メソッドを実装します。

    public string Echo(string text)
    {
        Console.WriteLine("Echoing: {0}", text);
        return text;
    }
    
  4. [ビルド]>[ソリューションのビルド] の順に選択するか、Ctrl + Shift + B キーを押します。

サービス ホストの構成を定義する

構成ファイルは WCF 構成ファイルと似ています。 これには、サービス名、エンドポイント、およびバインドが含まれています。 エンドポイントは、クライアントとホストの相互通信用に Azure Relay により公開されている場所です。 バインドは、通信に使用されるプロトコルの種類です。 主な違いは、構成されているこのサービス エンドポイントで、.NET Framework に含まれていない NetTcpRelayBinding バインドが参照されている点です。 NetTcpRelayBinding は、サービスによって定義されたバインドの 1 つです。

  1. ソリューション エクスプローラーで、App.config をダブルクリックして、Visual Studio エディターでそのファイルを開きます。

  2. <appSettings> 要素内のプレースホルダーを、Azure Relay 名前空間の名前と前の手順でコピーした SAS キーに置き換えます。

  3. <system.serviceModel> タグ内に、<services> 要素を追加します。 1 つの構成ファイルで複数のリレー アプリケーションを定義できます。 ただし、このチュートリアルで定義するのは 1 つだけです。

    <?xmlversion="1.0" encoding="utf-8"?>
    <configuration>
      <system.serviceModel>
        <services>
    
        </services>
      </system.serviceModel>
    </configuration>
    
  4. <services> 要素内に、サービスの名前を定義する <service> 要素を追加します。

    <service name="Microsoft.ServiceBus.Samples.EchoService">
    </service>
    
  5. <service> 要素内で、エンドポイント コントラクトの場所に加え、エンドポイントのバインドの種類も定義します。

    <endpoint contract="Microsoft.ServiceBus.Samples.IEchoContract" binding="netTcpRelayBinding"/>
    

    エンドポイントは、クライアントがホスト アプリケーションを検索する場所を定義します。 このチュートリアルでは、後でこの手順を使用して、Azure Relay を介してホストを完全に公開する URI を作成します。 バインドにより、リレー サービスと通信するプロトコルとして TCP を使用することを宣言します。

  6. [ビルド]>[ソリューションのビルド] の順に選択するか、Ctrl + Shift + B キーを押して、ここまでの作業に問題がないことを確認します。

サービス コントラクトの実装例

次のコードは、サービス コントラクトの実装を示します。

[ServiceBehavior(Name = "EchoService", Namespace = "https://samples.microsoft.com/ServiceModel/Relay/")]

    class EchoService : IEchoContract
    {
        public string Echo(string text)
        {
            Console.WriteLine("Echoing: {0}", text);
            return text;
        }
    }

次のコードは、サービス ホストに関連付けられる App.config ファイルの基本的な形式を示します。

<?xml version="1.0" encoding="utf-8" ?>
<configuration>
  <system.serviceModel>
    <services>
      <service name="Microsoft.ServiceBus.Samples.EchoService">
        <endpoint contract="Microsoft.ServiceBus.Samples.IEchoContract" binding="netTcpRelayBinding" />
      </service>
    </services>
    <extensions>
      <bindingExtensions>
        <add name="netTcpRelayBinding"
                    type="Microsoft.ServiceBus.Configuration.NetTcpRelayBindingCollectionElement, Microsoft.ServiceBus, Culture=neutral, PublicKeyToken=31bf3856ad364e35"/>
      </bindingExtensions>
    </extensions>
  </system.serviceModel>
</configuration>

リレー サービスに登録する WCF サービスをホストして実行する

この手順では、Azure Relay サービスの実行方法について説明します。

リレー資格情報を作成する

  1. Main() で、コンソール ウィンドウから読み取った名前空間と SAS キーを格納するための 2 つの変数を作成します。

    Console.Write("Your Service Namespace: ");
    string serviceNamespace = Console.ReadLine();
    Console.Write("Your SAS key: ");
    string sasKey = Console.ReadLine();
    

    SAS キーは、後でプロジェクトにアクセスするために使用します。 名前空間は、サービスの URI を作成するために、パラメーターとして CreateServiceUri に渡されます。

  2. TransportClientEndpointBehavior オブジェクトを使用して、資格情報の種類として SAS キーを使用することを宣言します。 1 つ前の手順で追加したコードの直後に次のコードを追加します。

    TransportClientEndpointBehavior sasCredential = new TransportClientEndpointBehavior();
    sasCredential.TokenProvider = TokenProvider.CreateSharedAccessSignatureTokenProvider("RootManageSharedAccessKey", sasKey);
    

サービスのベース アドレスを作成する

前のセクションで追加したコードの後に、サービスのベース アドレスの Uri インスタンスを作成します。 この URI では、Service Bus スキーム、名前空間、サービス インターフェイスのパスを指定します。

Uri address = ServiceBusEnvironment.CreateServiceUri("sb", serviceNamespace, "EchoService");

"sb" は Service Bus スキームの省略形です。 プロトコルとして TCP を使用していることを示します。 このスキームは、以前に NetTcpRelayBinding がバインドとして指定されたときにも、構成ファイルで示されていました。

このチュートリアルでは、URI は sb://putServiceNamespaceHere.windows.net/EchoService です。

サービス ホストを作成して構成する

  1. まだ Main() で作業します。接続モードを AutoDetect に設定します。

    ServiceBusEnvironment.SystemConnectivity.Mode = ConnectivityMode.AutoDetect;
    

    接続モードは、サービスがリレー サービスとの通信に使用するプロトコル、つまり HTTP または TCP を表します。 既定の設定である AutoDetect を使用すると、サービスは、TCP が利用できる場合は TCP 経由で、TCP が利用できない場合は HTTP 経由で Azure Relay に接続しようとします。 この結果は、サービスがクライアントの通信に指定するプロトコルとは異なります。 そのプロトコルは、使用されるバインドによって決まります。 たとえば、サービスでは BasicHttpRelayBinding バインドを使用できますが、このバインドは、そのエンドポイントが HTTP 経由でクライアントと通信するように指定します。 同じサービスで、サービスが TCP 経由で Azure Relay と通信するように ConnectivityMode.AutoDetect を指定することもできます。

  2. このセクションで先に作成した URI を使用して、サービス ホストを作成します。

    ServiceHost host = new ServiceHost(typeof(EchoService), address);
    

    サービス ホストは、サービスをインスタンス化する WCF オブジェクトです。 ここで、作成するサービスの種類 (EchoService 型) とサービスを公開するアドレスをサービス ホストに渡します。

  3. Program.cs ファイルの先頭に、System.ServiceModel.DescriptionMicrosoft.ServiceBus.Description への参照を追加します。

    using System.ServiceModel.Description;
    using Microsoft.ServiceBus.Description;
    
  4. Main() に戻り、パブリック アクセスを有効にするようにエンドポイントを構成します。

    IEndpointBehavior serviceRegistrySettings = new ServiceRegistrySettings(DiscoveryType.Public);
    

    この手順では、プロジェクトの Atom フィードを調べることでアプリケーションがパブリックに見つけられることを、リレー サービスに通知します。 DiscoveryTypeprivate に設定した場合、クライアントは引き続きサービスにアクセスできます。 ただし、Relay 名前空間を検索するときには、サービスは表示されなくなります。 代わりに、クライアントは、エンドポイントのパスを事前に認識しておく必要があります。

  5. App.config ファイルで定義されているサービス エンドポイントにサービスの資格情報を適用します。

    foreach (ServiceEndpoint endpoint in host.Description.Endpoints)
    {
        endpoint.Behaviors.Add(serviceRegistrySettings);
        endpoint.Behaviors.Add(sasCredential);
    }
    

    前に説明したように、構成ファイルで複数のサービスとエンドポイントを宣言しておくことができます。 宣言した場合、このコードは構成ファイルを走査し、資格情報を適用する必要があるすべてのエンドポイントを検索します。 このチュートリアルでは、構成ファイルのエンドポイントは 1 つだけです。

サービス ホストを開く

  1. 引き続き Main() で、次の行を追加してサービスを開きます。

    host.Open();
    
  2. サービスが実行中であることをユーザーに通知し、サービスをシャットダウンする方法を説明します。

    Console.WriteLine("Service address: " + address);
    Console.WriteLine("Press [Enter] to exit");
    Console.ReadLine();
    
  3. 完了したら、サービス ホストを閉じます。

    host.Close();
    
  4. Ctrl + Shift + B キーを押して、プロジェクトをビルドします。

コンソール アプリケーションでサービスをホストする例

完成したサービス コードは次のようになります。 このコードには、チュートリアルの前の手順で説明したサービス コントラクトと実装が含まれています。ここでは、コンソール アプリケーションでサービスをホストします。

using System;
using System.ServiceModel;
using System.ServiceModel.Description;
using Microsoft.ServiceBus;
using Microsoft.ServiceBus.Description;

namespace Microsoft.ServiceBus.Samples
{
    [ServiceContract(Name = "IEchoContract", Namespace = "https://samples.microsoft.com/ServiceModel/Relay/")]
    public interface IEchoContract
    {
        [OperationContract]
        String Echo(string text);
    }

    public interface IEchoChannel : IEchoContract, IClientChannel { };

    [ServiceBehavior(Name = "EchoService", Namespace = "https://samples.microsoft.com/ServiceModel/Relay/")]
    class EchoService : IEchoContract
    {
        public string Echo(string text)
        {
            Console.WriteLine("Echoing: {0}", text);
            return text;
        }
    }

    class Program
    {
        static void Main(string[] args)
        {

            ServiceBusEnvironment.SystemConnectivity.Mode = ConnectivityMode.AutoDetect;         

            Console.Write("Your Service Namespace: ");
            string serviceNamespace = Console.ReadLine();
            Console.Write("Your SAS key: ");
            string sasKey = Console.ReadLine();

           // Create the credentials object for the endpoint.
            TransportClientEndpointBehavior sasCredential = new TransportClientEndpointBehavior();
            sasCredential.TokenProvider = TokenProvider.CreateSharedAccessSignatureTokenProvider("RootManageSharedAccessKey", sasKey);

            // Create the service URI based on the service namespace.
            Uri address = ServiceBusEnvironment.CreateServiceUri("sb", serviceNamespace, "EchoService");

            // Create the service host reading the configuration.
            ServiceHost host = new ServiceHost(typeof(EchoService), address);

            // Create the ServiceRegistrySettings behavior for the endpoint.
            IEndpointBehavior serviceRegistrySettings = new ServiceRegistrySettings(DiscoveryType.Public);

            // Add the Relay credentials to all endpoints specified in configuration.
            foreach (ServiceEndpoint endpoint in host.Description.Endpoints)
            {
                endpoint.Behaviors.Add(serviceRegistrySettings);
                endpoint.Behaviors.Add(sasCredential);
            }

            // Open the service.
            host.Open();

            Console.WriteLine("Service address: " + address);
            Console.WriteLine("Press [Enter] to exit");
            Console.ReadLine();

            // Close the service.
            host.Close();
        }
    }
}

サービス コントラクト用の WCF クライアントを作成する

次のタスクでは、クライアント アプリケーションを作成し、後で実装するサービス コントラクトを定義します。 これらの手順は、コントラクトの定義、App.config ファイルの編集、資格情報を使用したリレー サービスへの接続など、サービスの作成に使用した手順に似ています。 以下の手順では、これらのタスクに使用するコード例を示します。

  1. クライアント用の現在の Visual Studio ソリューションに新しいプロジェクトを作成します。

    1. ソリューション エクスプローラーで (プロジェクトではなく) 現在のソリューションを右クリックし、[追加]>[新しいプロジェクト] の順に選択します。
    2. [新しいプロジェクトの追加] で、C# の [コンソール アプリ (.NET Framework)] を選択し、[次へ] を選択します。
    3. プロジェクトに「EchoClient」という名前を付けて、[作成] を選択します。
  2. ソリューション エクスプローラー[EchoClient] プロジェクトの Program.cs ファイルをダブルクリックしてエディターで開きます (まだ開いていない場合)。

  3. 名前空間の名前を、既定の名前である EchoClient から Microsoft.ServiceBus.Samples に変更します。

  4. Service Bus NuGet パッケージをインストールします。

    1. ソリューション エクスプローラー[EchoClient] を右クリックし、[NuGet パッケージの管理] を選択します。

    2. [参照] を選択し、WindowsAzure.ServiceBus を探して選択します。 [インストール] を選択して、使用条件に同意します。

      Service Bus パッケージのインストール

  5. Program.cs ファイルに、System.ServiceModel 名前空間の using ステートメントを追加します。

    using System.ServiceModel;
    
  6. 次の例に示すように、サービス コントラクトの定義を名前空間に追加します。 この定義は Service プロジェクトで使用される定義と同じです。 Microsoft.ServiceBus.Samples 名前空間の先頭に次のコードを追加します。

    [ServiceContract(Name = "IEchoContract", Namespace = "https://samples.microsoft.com/ServiceModel/Relay/")]
    public interface IEchoContract
    {
        [OperationContract]
        string Echo(string text);
    }
    
    public interface IEchoChannel : IEchoContract, IClientChannel { }
    
  7. Ctrl + Shift + B キーを押して、クライアントをビルドします。

EchoClient プロジェクトの例

次のコードは、EchoClient プロジェクトの Program.cs ファイルの現在の状態を示します。

using System;
using Microsoft.ServiceBus;
using System.ServiceModel;

namespace Microsoft.ServiceBus.Samples
{

    [ServiceContract(Name = "IEchoContract", Namespace = "https://samples.microsoft.com/ServiceModel/Relay/")]
    public interface IEchoContract
    {
        [OperationContract]
        string Echo(string text);
    }

    public interface IEchoChannel : IEchoContract, IClientChannel { }


    class Program
    {
        static void Main(string[] args)
        {
        }
    }
}

WCF クライアントを構成する

この手順では、このチュートリアルで前に作成したサービスにアクセスする基本的なクライアント アプリケーションの App.config ファイルを作成します。 この App.config ファイルでは、エンドポイントのコントラクト、バインド、および名前を定義します。 以下の手順では、これらのタスクに使用するコード例を示します。

  1. ソリューション エクスプローラーで、[EchoClient] プロジェクトの App.config をダブルクリックし、Visual Studio エディターでファイルを開きます。

  2. <appSettings> 要素内のプレースホルダーを、実際のサービスの名前空間名と先ほどコピーした SAS キーに置き換えます。

  3. system.serviceModel 要素内に、<client> 要素を追加します。

    <?xmlversion="1.0" encoding="utf-8"?>
    <configuration>
      <system.serviceModel>
        <client>
        </client>
      </system.serviceModel>
    </configuration>
    

    このコードにより、WCF スタイルのクライアント アプリケーションを定義していることを宣言します。

  4. client 要素内で、エンドポイントの名前、コントラクト、バインドの種類を定義します。

    <endpoint name="RelayEndpoint"
                    contract="Microsoft.ServiceBus.Samples.IEchoContract"
                    binding="netTcpRelayBinding"/>
    

    このコードでは、エンドポイントの名前を定義します。 また、サービスで定義されたコントラクトと、クライアント アプリケーションが Azure Relay との通信に TCP を使用するという事実を定義します。 エンドポイント名は、次の手順でこのエンドポイント構成をサービス URI とリンクするために使用されます。

  5. [ファイル]>[すべて保存] を選択します。

App.config ファイルの例

次のコードは、Echo クライアントの App.config ファイルを示します。

<?xml version="1.0" encoding="utf-8" ?>
<configuration>
  <system.serviceModel>
    <client>
      <endpoint name="RelayEndpoint"
                      contract="Microsoft.ServiceBus.Samples.IEchoContract"
                      binding="netTcpRelayBinding"/>
    </client>
    <extensions>
      <bindingExtensions>
        <add name="netTcpRelayBinding"
                    type="Microsoft.ServiceBus.Configuration.NetTcpRelayBindingCollectionElement, Microsoft.ServiceBus, Culture=neutral, PublicKeyToken=31bf3856ad364e35"/>
      </bindingExtensions>
    </extensions>
  </system.serviceModel>
</configuration>

WCF クライアントを実装する

このセクションでは、このチュートリアルで前に作成したサービスにアクセスする基本的なクライアント アプリケーションを実装します。 サービスと同様に、クライアントでも、Azure Relay へアクセスするために多くの同じ操作が実行されます。

  • 接続モードを設定します。
  • ホスト サービスの場所を示す URI を作成します。
  • セキュリティ資格情報を定義します。
  • 資格情報を接続に適用します。
  • 接続を開きます。
  • アプリケーション固有のタスクを実行します。
  • 接続を閉じます。

しかし、主な違いの 1 つとして、クライアント アプリケーションではリレー サービスへの接続にチャネルが使用されます。 サービスでは ServiceHost の呼び出しが使用されます。 以下の手順では、これらのタスクに使用するコード例を示します。

クライアント アプリケーションを実装する

  1. 接続モードを AutoDetect に設定します。 EchoClient アプリケーションの Main() メソッドの中に次のコードを追加します。

    ServiceBusEnvironment.SystemConnectivity.Mode = ConnectivityMode.AutoDetect;
    
  2. コンソールから読み取られるサービス名前空間と SAS キーの値を保持する変数を定義します。

    Console.Write("Your Service Namespace: ");
    string serviceNamespace = Console.ReadLine();
    Console.Write("Your SAS Key: ");
    string sasKey = Console.ReadLine();
    
  3. Relay プロジェクトでのホストの場所を定義する URI を作成します。

    Uri serviceUri = ServiceBusEnvironment.CreateServiceUri("sb", serviceNamespace, "EchoService");
    
  4. サービス名前空間のエンドポイントの資格情報オブジェクトを作成します。

    TransportClientEndpointBehavior sasCredential = new TransportClientEndpointBehavior();
    sasCredential.TokenProvider = TokenProvider.CreateSharedAccessSignatureTokenProvider("RootManageSharedAccessKey", sasKey);
    
  5. App.config ファイルに記述されている構成を読み込むチャネル ファクトリを作成します。

    ChannelFactory<IEchoChannel> channelFactory = new ChannelFactory<IEchoChannel>("RelayEndpoint", new EndpointAddress(serviceUri));
    

    チャネル ファクトリは、サービスおよびクライアント アプリケーションが通信に使用するチャネルを作成する WCF オブジェクトです。

  6. 資格情報を適用します。

    channelFactory.Endpoint.Behaviors.Add(sasCredential);
    
  7. サービスに対するチャネルを作成して開きます。

    IEchoChannel channel = channelFactory.CreateChannel();
    channel.Open();
    
  8. エコーの基本的なユーザー インターフェイスと機能を記述します。

    Console.WriteLine("Enter text to echo (or [Enter] to exit):");
    string input = Console.ReadLine();
    while (input != String.Empty)
    {
        try
        {
            Console.WriteLine("Server echoed: {0}", channel.Echo(input));
        }
        catch (Exception e)
        {
            Console.WriteLine("Error: " + e.Message);
        }
        input = Console.ReadLine();
    }
    

    このコードでは、サービスのプロキシとしてチャネル オブジェクトのインスタンスを使用します。

  9. チャネルを閉じ、ファクトリを終了します。

    channel.Close();
    channelFactory.Close();
    

このチュートリアルのコード例

完成したコードは次のようになります。 このコードは、クライアント アプリケーションを作成する方法、サービスの操作を呼び出す方法、操作の呼び出しが完了した後でクライアントを終了する方法を示します。

using System;
using Microsoft.ServiceBus;
using System.ServiceModel;

namespace Microsoft.ServiceBus.Samples
{
    [ServiceContract(Name = "IEchoContract", Namespace = "https://samples.microsoft.com/ServiceModel/Relay/")]
    public interface IEchoContract
    {
        [OperationContract]
        String Echo(string text);
    }

    public interface IEchoChannel : IEchoContract, IClientChannel { }

    class Program
    {
        static void Main(string[] args)
        {
            ServiceBusEnvironment.SystemConnectivity.Mode = ConnectivityMode.AutoDetect;


            Console.Write("Your Service Namespace: ");
            string serviceNamespace = Console.ReadLine();
            Console.Write("Your SAS Key: ");
            string sasKey = Console.ReadLine();



            Uri serviceUri = ServiceBusEnvironment.CreateServiceUri("sb", serviceNamespace, "EchoService");

            TransportClientEndpointBehavior sasCredential = new TransportClientEndpointBehavior();
            sasCredential.TokenProvider = TokenProvider.CreateSharedAccessSignatureTokenProvider("RootManageSharedAccessKey", sasKey);

            ChannelFactory<IEchoChannel> channelFactory = new ChannelFactory<IEchoChannel>("RelayEndpoint", new EndpointAddress(serviceUri));

            channelFactory.Endpoint.Behaviors.Add(sasCredential);

            IEchoChannel channel = channelFactory.CreateChannel();
            channel.Open();

            Console.WriteLine("Enter text to echo (or [Enter] to exit):");
            string input = Console.ReadLine();
            while (input != String.Empty)
            {
                try
                {
                    Console.WriteLine("Server echoed: {0}", channel.Echo(input));
                }
                catch (Exception e)
                {
                    Console.WriteLine("Error: " + e.Message);
                }
                input = Console.ReadLine();
            }

            channel.Close();
            channelFactory.Close();

        }
    }
}

アプリケーションの実行

  1. Ctrl + Shift + B キーを押して、ソリューションをビルドします。 このアクションにより、前の手順で作成したサービス プロジェクトとクライアント プロジェクトの両方がビルドされます。

  2. クライアント アプリケーションを実行する前に、サービス アプリケーションが実行されていることを確認してください。 ソリューション エクスプローラーで、[EchoService] ソリューションを右クリックし、[プロパティ] を選択します。

  3. [プロパティ ページ] で、[共通プロパティ]>[スタートアップ プロジェクト] の順に選択し、[マルチ スタートアップ プロジェクト] を選択します。 EchoService がリストの先頭に表示されていることを確認してください。

  4. EchoService プロジェクトと EchoClient プロジェクトの両方の [アクション] ボックスを [開始] に設定します。

    [プロジェクト プロパティ] ページ

  5. [プロジェクトの依存関係] を選択します。 [プロジェクト] で、[EchoClient] を選択します。 [依存先] で、[EchoService] が選択されていることを確認します。

    プロジェクトの依存関係

  6. [OK] を選択して [プロパティ ページ] を閉じます。

  7. F5 キーを押して両方のプロジェクトを実行します。

  8. 両方のコンソール ウィンドウが開き、名前空間名の入力が求められます。 先にサービスを実行しておく必要があるので、[EchoService] コンソール ウィンドウで名前空間を入力し、Enter キーを押します。

  9. 次に、コンソールで、SAS キーの入力を求められます。 SAS キーを入力し、Enter キーを押します。

    コンソール ウィンドウの出力例を次に示します。 表示されている値は、単なる例です。

    Your Service Namespace: myNamespace

    Your SAS Key: <SAS key value>

    次の例に示すように、サービス アプリケーションによってリッスンされているアドレスがコンソール ウィンドウに出力されます。

    Service address: sb://mynamespace.servicebus.windows.net/EchoService/

    Press [Enter] to exit

  10. [EchoClient] コンソール ウィンドウに、先ほどサービス アプリケーションについて入力したものと同じ情報を入力します。 クライアント アプリケーションに対して、同じサービス名前空間と SAS キーの値を入力します。

  11. これらの値を入力すると、クライアントはサービスに対するチャネルを開き、次のコンソール出力例に示すように、なんらかのテキストを入力するよう求めます。

    Enter text to echo (or [Enter] to exit):

    サービス アプリケーションに送信するテキストを入力し、Enter キーを押します。 このテキストは、Echo サービス操作を介してサービスに送信され、次の出力例のように、サービス コンソール ウィンドウに表示されます。

    Echoing: My sample text

    クライアント アプリケーションは、Echo 操作の戻り値を受け取ります。これは元のテキストで、コンソール ウィンドウに出力されます。 クライアント コンソール ウィンドウの出力例のテキストを次に示します。

    Server echoed: My sample text

  12. この方法で、クライアントからサービスにテキスト メッセージの送信を続けることができます。 終了したら、クライアント コンソール ウィンドウとサービス コンソール ウィンドウで Enter キーを押して両方のアプリケーションを終了します。

次のステップ

次のチュートリアルに進みます。