How to: Host a WCF Service that Uses the Service Bus Service

1. Create an address for your service.

   The address for your Service Bus project is used in both service and client applications. For a service, the URI is used to determine where the Service Bus exposes the service. For a client, the URI determines where the client looks for the service:

   Copy

   string servicePath = "ServicePath";
   string serviceNamespace = "ServiceNamespace";
   Uri uri = ServiceBusEnvironment.CreateServiceUri("sb", serviceNamespace, servicePath);
   
   

2. Create a new instance of ServiceHost.

   Copy

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

   In this example, the service host takes the supplied address, in addition to the type that the service contract implements. In this example, the class that implements the service contract is named EchoService.

3. Create a description of the contract with a call to ContractDescription.

   Copy

   ContractDescription contractDescription = ContractDescription.GetContract(typeof(IEchoContract), typeof(EchoService));
   

   ContractDescription links the contract with the specific implementation you want to use. In this example, the contract is defined in IEchoContract, and the implementation of the contract is EchoService.

4. Define the address and binding for the endpoint:

   Copy

   ServiceEndpoint serviceEndPoint = new ServiceEndpoint(contractDescription);
   serviceEndPoint.Address = new EndpointAddress(uri);
   serviceEndPoint.Binding = new NetTcpRelayBinding();
   

5. Add any additional behaviors to the endpoint, such as security or publishing behaviors:

   Copy

   serviceEndPoint.Behaviors.Add(sharedSecretServiceBusCredential);
   

   In this code sample, sharedSecretServiceBusCredential had previously been created to store the security credentials.

6. Add the service endpoint to the service host instance. This step indicates which endpoint you want to instantiate.

   Copy

   host.Description.Endpoints.Add(serviceEndPoint);
   

7. Open the service by using a call to ServiceHost.Open.

   If successful, the service will be available for a client application to contact and communicate with through the Service Bus without additional action required. However, you may want to perform additional tasks, such as notifying the user that the host has succeeded.

   Copy

   host.Open();
   
   Console.WriteLine(String.Format("Listening at: {0}", endPoint));
   Console.WriteLine("Press [Enter] to exit");
   Console.ReadLine();
   

8. When you are finished, close the host with ServiceHost.Close.

   Copy

   host.Close();
   

1. Create the name of the project to expose on the Service Bus:

   Copy

   string serviceBusProjectName = "myProjectNameHere";
   

2. Create the URI for your service:

   Copy

   Uri address = ServiceBusEnvironment.CreateServiceUri("sb", serviceBusProjectName, "OnewayService");
   

3. Create a new instance of the ServiceHost.

   Copy

   ServiceHost host = new ServiceHost(typeof(LogService), uri);
   

   Here, the service host takes the supplied address, and also the type that the service contract implements. In this example, the class that implements the service contract is named LogService.

4. If successful, the service will be available for a client application to contact and communicate with through the Service Bus without additional action required.

   Copy

   host.Open();
   
   Console.WriteLine("Press [Enter] to exit");
   Console.ReadLine();
   

5. When you are finished, close the host with ServiceHost.Close.

   Copy

   host.Close();
   

6. In your App.config file, add the credential and binding information for your project.

   An example App.config file that contains this information is located in the code sample at the end of this topic.

The following example shows how to programmatically define and create a service application.

    class Program
    {
        static void Main(string[] args)
        {
            string servicePath = "ServicePath";
            string serviceNamespace = "ServiceNamespace";
            string issuerName = "IssuerName";
            string issuerSecret = "IssuerSecret";

            // Construct a Service Bus URI
            Uri uri = ServiceBusEnvironment.CreateServiceUri("sb", serviceNamespace, servicePath);

            // Create a Behavior for the Credentials
            TransportClientEndpointBehavior sharedSecretServiceBusCredential = new TransportClientEndpointBehavior();
            sharedSecretServiceBusCredential.CredentialType = TransportClientCredentialType.SharedSecret;
            sharedSecretServiceBusCredential.Credentials.SharedSecret.IssuerName = issuerName;
            sharedSecretServiceBusCredential.Credentials.SharedSecret.IssuerSecret = issuerSecret;

            // Create the Service Host 
            host = new ServiceHost(typeof(EchoService), uri);
            ContractDescription contractDescription = ContractDescription.GetContract(typeof(IEchoContract), typeof(EchoService));
            ServiceEndpoint serviceEndPoint = new ServiceEndpoint(contractDescription);
            serviceEndPoint.Address = new EndpointAddress(uri);
            serviceEndPoint.Binding = new NetTcpRelayBinding();
            serviceEndPoint.Behaviors.Add(sharedSecretServiceBusCredential);
            host.Description.Endpoints.Add(serviceEndPoint);

            host.Open();

            Console.WriteLine(String.Format("Listening at: {0}", endPoint));
            Console.WriteLine("Press [Enter] to exit");
            Console.ReadLine();

            host.Close();
        }
    }




//Service that is configured mainly with an App.config file
   class Program
    {
        static void Main(string[] args)
        {
            string serviceNamespace = GetServiceNamespace();
            Uri address = ServiceBusEnvironment.CreateServiceUri("sb", serviceNamespace, "OnewayService");

            ServiceHost host = new ServiceHost(typeof(OnewayService), address);
            host.Open();

            Console.WriteLine("Press [Enter] to exit");
            Console.ReadLine();

            host.Close();
        }
    }


//App.config file associated with the previous code sample

<?xml version="1.0" encoding="utf-8" ?>
<configuration>
  <system.serviceModel>
    <behaviors>
      <endpointBehaviors>
        <behavior name="sharedSecretClientCredentials">
          <transportClientEndpointBehavior credentialType="SharedSecret">
            <clientCredentials>
              <sharedSecret issuerName="ISSUER_NAME" issuerSecret="ISSUER_SECRET" />
            </clientCredentials>
          </transportClientEndpointBehavior>
        </behavior>
      </endpointBehaviors>
    </behaviors>
    <bindings>
      <!-- Application Binding -->
      <netOnewayRelayBinding>
        <binding name="default" />
      </netOnewayRelayBinding>
    </bindings>
    <services>
      <service name="Microsoft.ServiceBus.Samples.OnewayService">
        <endpoint address="" behaviorConfiguration="sharedSecretClientCredentials"
          binding="netOnewayRelayBinding" bindingConfiguration="default"
          name="RelayEndpoint" contract="Microsoft.ServiceBus.Samples.IOnewayContract" />
      </service>
    </services>
   
  </system.serviceModel>
</configuration>

Other Resources