Desenvolvendo um aplicativo

Antes de iniciar o tutorial, verifique se possui o Service Bus for Windows Server instalado e configurado corretamente, como descrito em Instalando e configurando o Service Bus for Windows Server.

Para verificar se você possui um namespace de serviço

  1. No prompt de comando do PowerShell, execute o seguinte comando para verificar se você possui pelo menos um namespace de serviço definido:

    get-SBNamespace
    

    Um exemplo de saída desse comando seria o seguinte:

    Name                  : myServiceNamespaceName
    AddressingScheme      : Path
    CreatedTime           : 2/29/2012 11:35:09 PM
    IssuerName            : myServiceNamespaceName
    IssuerUri             : myServiceNamespaceName
    ManageUsers           : {list of user accounts}
    Uri                   : 
    ServiceIdentifier     : 
    PrimarySymmetricKey   : myKey
    SecondarySymmetricKey :
    
    noteObservação
    Para obter mais informações sobre namespace de serviços, consulte Namespaces de serviço.

  2. No prompt de comando do PowerShell, execute o seguinte comando para exportar o arquivo de configuração de cliente do Service Bus for Windows Server:

    get-sbClientConfiguration > sbclient.config
    

Criar um novo projeto no Visual Studio

  1. Em Visual Studio 2012, crie um novo aplicativo de console.

  2. No Gerenciador de Soluções, clique com o botão direito do mouse em Referências e, em seguida, clique em Adicionar Referência. Clique para adicionar o item System.Runtime.Serialization.

Adicionar uma referência ao Service Bus for Windows Server SDK

  1. No Gerenciador de Soluções, clique com o botão direito do mouse em Referências e, em seguida, clique em Gerenciar pacotes NuGet. Essa opção só aparecerá se você tiver a extensão NuGet instalada.

  2. Na caixa Pesquisar, insira Service Bus 1.0. Clique no item Service Bus 1.0 (para Windows Server). Conclua a instalação e feche essa caixa de diálogo.

Conecte-se ao Service Bus for Windows Server usando uma cadeia de conexão e o arquivo de configuração

  1. O Service Bus for Windows Server permite que você especifique uma cadeia de conexão em um arquivo de configuração, e o use em seu código, sem especificar parâmetros adicionais. Esta opção é suportada pelo Service Bus for Windows Server e oferece flexibilidade na implantação. Ao usar cadeias de conexão, você pode mudar do Service Bus for Windows Server (no local) para o Windows Azure Service Bus (nuvem) alterando uma definição no arquivo de configuração.

    No prompt de comando do PowerShell, execute o seguinte comando para recuperar a cadeia de conexão para o seu namespace de serviço:

    get-SBClientConfiguration
    

    Um exemplo de saída desse comando seria o seguinte:

    Endpoint=sb://yourHost/ServiceBusDefaultNamespace;StsEndpoint=https://yourHost:9355/ServiceBusDefaultNamespace;RuntimePort=9354;ManagementPort=9355
    
  2. Abra o arquivo de configuração do aplicativo ou crie um, e depois cole a cadeia de conexão. Por exemplo:

    <configuration>
      <appSettings>
        <add key="Microsoft.ServiceBus.ConnectionString"         
            value="Endpoint=sb://yourHost/ServiceBusDefaultNamespace;StsEndpoint=https://yourHost:9355/ServiceBusDefaultNamespace;RuntimePort=9354;ManagementPort=9355" />
      </appSettings>
    </configuration>
    

    Observe que se tiver vários namespace de serviços, você deve selecionar e copiar apenas um dos pontos de extremidade gerados pelo cmdlet PowerShell.

  3. Crie os objetos NamespaceManager eMessagingFactory, como faria para o Windows Azure Service Bus.

    MessagingFactory messagingFactory = MessagingFactory.Create();
    NamespaceManager namespaceManager = NamespaceManager.Create();
    

    Quando está conectado ao Service Bus, você pode criar entidades de mensagens (filas, tópicos e assinaturas) usando a instância do gerenciador de namespace ou criar os objetos QueueClient, TopicClient, ou SubscriptionClient para enviar e receber mensagens.

Conecte-se ao Service Bus for Windows Server fornecendo parâmetros de conexão explicitamente

  1. Além de usar cadeias de conexão em um arquivo de configuração para se conectar ao Service Bus, há situações em que é preciso especificar explicitamente os parâmetros de entrada necessários para conectar-se ao Service Bus. O Service Bus apresenta uma classe auxiliar que permite a criação de cadeias de conexão no código.

    Em seu código, identifique os parâmetros de conexão (usando um arquivo de configuração ou qualquer outra forma).

    string ServerFQDN = "localhost";
    int HttpPort = 9355;
    int TcpPort = 9354;
    string ServiceNamespace = "ServiceBusDefaultNamespace";
    
  2. Em seu código, use a classe auxiliar ServiceBusConnectionStringBuilder para conectar-se ao Service Bus. Por exemplo:

    ServiceBusConnectionStringBuilder connBuilder = new ServiceBusConnectionStringBuilder();
    connBuilder.ManagementPort = HttpPort;
    connBuilder.RuntimePort = TcpPort;
    connBuilder.Endpoints.Add(new UriBuilder() { Scheme = "sb", Host = ServerFQDN, Path = ServiceNamespace }.Uri);
    connBuilder.StsEndpoints.Add(new UriBuilder() { Scheme = "https", Host = ServerFQDN, Port = HttpPort, Path = ServiceNamespace }.Uri);
    
    MessagingFactory messagingFactory = MessagingFactory.CreateFromConnectionString(connBuilder.ToString());
    NamespaceManager namespaceManager = NamespaceManager.CreateFromConnectionString(connBuilder.ToString());
    

    Cadeias de conexão do Para obter mais informações sobre para o Service Bus for Windows Server, consulte Configuration Connection Strings

Consulte também


Data da compilação:

2013-07-25

Contribuições da comunidade

ADICIONAR
Mostrar: