Tutorial: Tutorial do REST de Retransmissão de WCF do Azure

Artigo
12/11/2024

Este tutorial descreve como criar um aplicativo host de Retransmissão do Azure que expõe uma interface baseada em REST. O REST permite que um cliente da Web, como, por exemplo, um navegador da Web, acesse as APIs de Barramento de Serviço por meio de solicitações HTTP.

Este tutorial usa o modelo de programação REST do WCF (Windows Communication Foundation) para construir um serviço REST na Retransmissão do Azure. Para obter mais informações, consulte o Modelo de Programação REST do WCF e Como Criar e Implementar Serviços.

Você executará as seguintes tarefas neste tutorial:

Instalar os pré-requisitos para este tutorial.
Criar um namespace de Retransmissão
Definir um contrato de serviço WCF baseado em REST.
Implementar o contrato do WCF baseado em REST.
Hospedar e executar o serviço WCF baseado em REST.
Executar e testar o serviço.

Pré-requisitos

Para concluir este tutorial, você precisará dos seguintes pré-requisitos:

Uma assinatura do Azure. Se você não tiver uma conta gratuita, crie uma antes de começar.
Visual Studio 2015 ou posterior. Os exemplos deste tutorial usam o Visual Studio 2019.
SDK do Azure para .NET. Instale-o a partir da página de downloads do SDK.

Criar um namespace de Retransmissão

Para começar a usar os recursos de retransmissão no Azure, você deve primeiro criar um namespace de serviço. Um namespace fornece um contêiner de escopo para endereçar recursos do Azure dentro de seu aplicativo. Siga as instruções aqui para criar um namespace de Retransmissão.

Definir um contrato de serviço WCF baseado em REST para usar com a Retransmissão do Azure

Quando você cria um serviço no estilo REST do WCF, é preciso definir o contrato. O contrato especifica para quais operações o host oferece suporte. Uma operação de serviço é semelhante a um método de serviço Web. Defina um contrato com uma interface C++, C# ou Visual Basic. Cada método na interface corresponde a uma operação de serviço específica. Aplique o atributo ServiceContractAttribute a cada interface e aplique o atributo OperationContractAttribute a cada operação.

Dica

Se um método em uma interface que tem o ServiceContractAttribute não tiver o OperationContractAttribute, esse método não será exposto. O código usado para essas tarefas é exibido no exemplo logo após o procedimento.

A principal diferença entre um contrato do WCF e um contrato no estilo REST é a adição de uma propriedade no OperationContractAttribute: WebGetAttribute. Esta propriedade permite mapear um método em sua interface para um método no outro lado da interface. Este exemplo usa o atributo WebGetAttribute para vincular um método a HTTP GET. Essa abordagem permite que o Barramento de Serviço recupere e interprete com precisão os comandos enviados para a interface.

Para criar um contrato com uma interface

Inicie o Microsoft Visual Studio como um administrador. Para fazer isso, clique com o botão direito do mouse no ícone de programa do Visual Studio e selecione Executar como administrador.
No Visual Studio, selecione Criar um projeto.
Em Criar um novo projeto, escolha Aplicativo de Console (.NET Framework) para C# e, em seguida, selecione Avançar.
Nomeie o projeto ImageListener. Use a Localização padrão e, em seguida, selecione Criar.

Para um projeto C#, o Visual Studio cria um arquivo Program.cs. Essa classe contém um método Main() vazio, necessário para um projeto de aplicativo de console ser criado corretamente.
No Gerenciador de Soluções, clique com o botão direito do mouse no projeto ImageListener e, em seguida, selecione Gerenciar Pacotes NuGet.
Selecione Procurar e, em seguida, pesquise e escolha WindowsAzure.ServiceBus. Selecione Instalar e aceite os termos de uso.

Essa etapa adiciona referências ao Barramento de Serviço e ao System.ServiceModel.dll. Esse pacote adiciona referências automaticamente às bibliotecas do Barramento de Serviço e ao System.ServiceModel do WCF.
Adicione explicitamente uma referência a System.ServiceModel.Web.dll ao projeto. Em Gerenciador de Soluções, clique com o botão direito do mouse em Referências na pasta do projeto e selecione Adicionar Referência.
Em Adicionar Referência, selecione Estrutura e insira System.ServiceModel.Web na Pesquisa. Selecione a caixa de seleção System.ServiceModel.Web e, a seguir, selecione OK.

Em seguida, faça as seguintes alterações de código no projeto:

Adicione as instruções using a seguir na parte superior do arquivo Program.cs.
```
using System.ServiceModel;
using System.ServiceModel.Channels;
using System.ServiceModel.Web;
using System.IO;
```
- System.ServiceModel é o namespace que permite o acesso programático aos recursos básicos do WCF. A Retransmissão de WCF usa vários dos objetos e atributos do WCF para definir contratos de serviço. Você usa este namespace na maioria dos seus aplicativos de retransmissão.
- O System.ServiceModel.Channels ajuda a definir o canal, objeto por meio do qual você se comunica com a Retransmissão do Azure e com o navegador da Web do cliente.
- O System.ServiceModel.Web contém tipos que permitem criar aplicativos baseados na Web.
Renomeie o namespace ImageListener para Microsoft.ServiceBus.Samples.
```
namespace Microsoft.ServiceBus.Samples
{
    ...
```
Imediatamente após a chave de abertura da declaração do namespace, defina uma nova interface chamada IImageContract e aplique o atributo ServiceContractAttribute à interface com um valor de https://samples.microsoft.com/ServiceModel/Relay/RESTTutorial1.
```
[ServiceContract(Name = "ImageContract", Namespace = "https://samples.microsoft.com/ServiceModel/Relay/RESTTutorial1")]
public interface IImageContract
{
}
```
O valor do namespace é diferente do namespace que você usa em todo o escopo do seu código. O valor do namespace é um identificador exclusivo para este contrato e deve ter informações sobre a versão. Para saber mais, veja Controle de Versão do Serviço. Especificar o namespace de forma explícita impede a adição do valor de namespace padrão ao nome do contrato.
Na interface IImageContract, declare um método para a operação única que o contrato IImageContract expõe na interface e aplique o atributo OperationContract ao método que desejar expor como parte do contrato de Barramento de Serviço público.
```
public interface IImageContract
{
    [OperationContract]
    Stream GetImage();
}
```
No atributo OperationContract, adicione o valor WebGet.
```
public interface IImageContract
{
    [OperationContract, WebGet]
    Stream GetImage();
}
```
Adicionar o valor de WebGet permite que o serviço de retransmissão encaminhe solicitações HTTP GET para GetImage e traduzir os valores retornados de GetImage em uma resposta HTTP GETRESPONSE. Posteriormente no tutorial, você usará um navegador da Web para acessar esse método e exibir a imagem no navegador.
Logo após a definição IImageContract, declare um canal que herde das interfaces IImageContract e IClientChannel.
```
public interface IImageChannel : IImageContract, IClientChannel { }
```
Um canal é o objeto WCF por meio do qual o serviço e o cliente trocam informações. Posteriormente, você criará o canal em seu aplicativo host. Em seguida, a Retransmissão do Azure usa este canal para passar as solicitações HTTP GET do navegador para a implementação de GetImage. A retransmissão também usa o canal para pegar o valor de retorno GetImage e convertê-lo em HTTP GETRESPONSE para o navegador do cliente.
Selecione Compilar>Compilar Solução para confirmar a precisão de seu trabalho até o momento.

Exemplo que define um contrato de Retransmissão do WCF

O código a seguir mostra uma interface básica que define um contrato de Retransmissão de WCF.

using System;
using System.Collections.Generic;
using System.Linq;
using System.Text;
using System.ServiceModel;
using System.ServiceModel.Channels;
using System.ServiceModel.Web;
using System.IO;

namespace Microsoft.ServiceBus.Samples
{

    [ServiceContract(Name = "IImageContract", Namespace = "https://samples.microsoft.com/ServiceModel/Relay/")]
    public interface IImageContract
    {
        [OperationContract, WebGet]
        Stream GetImage();
    }

    public interface IImageChannel : IImageContract, IClientChannel { }

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

Implementar o contrato de serviço WCF baseado em REST

Para criar um serviço de Retransmissão do WCF de estilo REST, primeiro crie o contrato usando uma interface. A próxima etapa é implementar a interface. Este procedimento envolve a criação de uma classe chamada ImageService que implementa a interface IImageContract definida pelo usuário. Após implementar o contrato, configure a interface usando um arquivo App.config. O arquivo de configuração contém as informações necessárias para o aplicativo. Essas informações incluem o nome do serviço, o nome do contrato e o tipo de protocolo usado para se comunicar com o serviço de retransmissão. O código usado para essas tarefas é exibido no exemplo logo após o procedimento.

Assim como nas etapas anteriores, existe pouca diferença entre implementar um contrato de estilo REST e um contrato de Retransmissão do WCF.

Para implementar um contrato de Barramento de Serviço no estilo REST

Crie uma nova classe chamada ImageService diretamente após a definição da interface IImageContract. A classe ImageService implementa a interface IImageContract.
```
class ImageService : IImageContract
{
}
```
Assim como outras implementações de interface, você pode implementar a definição em um arquivo diferente. No entanto, para este tutorial, a implementação é exibida no mesmo arquivo que a definição de interface e o método Main().
Aplique o atributo ServiceBehaviorAttribute à classe IImageService para indicar que a classe é uma implementação de um contrato do WCF.
```
[ServiceBehavior(Name = "ImageService", Namespace = "https://samples.microsoft.com/ServiceModel/Relay/")]
class ImageService : IImageContract
{
}
```
Como mencionado anteriormente, esse namespace não é tradicional. Ele faz parte da arquitetura WCF que identifica o contrato. Para obter mais informações, consulte os Nomes de Contrato de Dados.
Adicione uma imagem .jpg ao seu projeto. Este arquivo é uma imagem que o serviço exibe no navegador receptor.
1. Clique com o botão direito do mouse no projeto e selecione Adicionar.
2. Em seguida, selecione o Item Existente.
3. Use Adicionar Item Existente para navegar até um .jpg apropriado e, em seguida, selecione Adicionar. Ao adicionar o arquivo, selecione Todos os Arquivos na lista suspensa ao lado do Nome do arquivo.
O restante deste tutorial pressupõe que o nome da imagem seja image.jpg. Se você tiver um arquivo diferente, será necessário renomear a imagem ou alterar seu código para compensar.
Para ter certeza de que o serviço em execução pode localizar o arquivo de imagem, em Gerenciador de Soluções clique com o botão direito do mouse no arquivo de imagem e escolha Propriedades. Em Propriedades, defina Copiar para Diretório de Saída para Copiar se for mais recente.
Use o procedimento em Criar um contrato com uma interface para adicionar uma referência ao assembly do System.Drawing.dll ao projeto.

Adicione as seguintes instruções de using associadas:

using System.Drawing;
using System.Drawing.Imaging;
using Microsoft.ServiceBus;
using Microsoft.ServiceBus.Web;

Na classe ImageService, adicione o seguinte construtor que carrega o bitmap e prepara para enviá-lo ao navegador do cliente:

class ImageService : IImageContract
{
    const string imageFileName = "image.jpg";

    Image bitmap;

    public ImageService()
    {
        this.bitmap = Image.FromFile(imageFileName);
    }
}

Imediatamente após o código anterior, adicione o método GetImage a seguir na classe ImageService para retornar uma mensagem HTTP que contenha a imagem.
```
public Stream GetImage()
{
    MemoryStream stream = new MemoryStream();
    this.bitmap.Save(stream, ImageFormat.Jpeg);

    stream.Position = 0;
    WebOperationContext.Current.OutgoingResponse.ContentType = "image/jpeg";

    return stream;
}
```
Essa implementação usa MemoryStream para recuperar a imagem e prepará-la para streaming para o navegador. Ele inicia a posição da transmissão em zero, declara o conteúdo da transmissão como um .jpg e transmite as informações.
Selecione Compilar>Compilar Solução.

Para definir a configuração a fim de executar o serviço da Web no Barramento de Serviço

No Gerenciador de Soluções, clique duas vezes em App.config para abrir o arquivo no editor do Visual Studio.

O arquivo App.config inclui o nome do serviço, o ponto de extremidade e a associação. O ponto de extremidade é a localização que a Retransmissão do Azure expõe para clientes e hosts se comunicarem entre si. A associação é o tipo de protocolo usado para a comunicação. A principal diferença aqui é que o ponto de extremidade de serviço configurado se refere a uma vinculação do tipo WebHttpRelayBinding.
O elemento XML <system.serviceModel> é um elemento WCF que define um ou mais serviços. Aqui, ele é usado para definir o nome do serviço e o ponto de extremidade. Na parte inferior do elemento <system.serviceModel>, mas ainda em <system.serviceModel>, adicione um elemento <bindings> que tenha o seguinte conteúdo:
```
<bindings>
    
    <webHttpRelayBinding>
        <binding name="default">
            <security relayClientAuthenticationType="None" />
        </binding>
    </webHttpRelayBinding>
</bindings>
```
Esse conteúdo define as associações usadas no aplicativo. É possível definir várias associações, mas, para este tutorial, você definirá apenas uma.

O código anterior define uma Retransmissão do WCF WebHttpRelayBinding associação com relayClientAuthenticationType definido como None. Essa configuração indica que um ponto de extremidade que usa essa associação não requer uma credencial do cliente.

Após o elemento <bindings>, adicione um elemento <services>. Assim como nas associações, você pode definir vários serviços em um único arquivo de configuração. No entanto, para este tutorial, você definirá apenas um.

<services>
    <!-- Application Service -->
    <service name="Microsoft.ServiceBus.Samples.ImageService"
         behaviorConfiguration="default">
        <endpoint name="RelayEndpoint"
                contract="Microsoft.ServiceBus.Samples.IImageContract"
                binding="webHttpRelayBinding"
                bindingConfiguration="default"
                behaviorConfiguration="sbTokenProvider"
                address="" />
    </service>
</services>

Este conteúdo configura um serviço que usa o padrão webHttpRelayBinding definido anteriormente. Ele também usa o padrão sbTokenProvider, definido na próxima etapa.

Após o elemento <services>, crie um elemento <behaviors> com o conteúdo a seguir, substituindo SAS_KEY pela chave SAS (Assinatura de Acesso Compartilhado). Para obter uma chave SAS do portal do Azure, consulte como Obter credenciais de gerenciamento.

<behaviors>
    <endpointBehaviors>
        <behavior name="sbTokenProvider">
            <transportClientEndpointBehavior>
                <tokenProvider>
                    <sharedAccessSignature keyName="RootManageSharedAccessKey" key="YOUR_SAS_KEY" />
                </tokenProvider>
            </transportClientEndpointBehavior>
        </behavior>
        </endpointBehaviors>
        <serviceBehaviors>
            <behavior name="default">
                <serviceDebug httpHelpPageEnabled="false" httpsHelpPageEnabled="false" />
            </behavior>
        </serviceBehaviors>
</behaviors>

Ainda em App.config, no elemento <appSettings>, substitua todo o valor da cadeia de conexão pela cadeia de conexão obtida anteriormente no portal.

<appSettings>
   <!-- Service Bus specific app settings for messaging connections -->
   <add key="Microsoft.ServiceBus.ConnectionString"
       value="Endpoint=sb://yourNamespace.servicebus.windows.net/;SharedAccessKeyName=RootManageSharedAccessKey;SharedAccessKey=YOUR_SAS_KEY"/>
</appSettings>

Selecione Compilar>Compilar Solução para compilar a solução inteira.

Exemplo que implementa o contrato de serviço WCF baseado em REST

O código a seguir mostra a implementação do contrato e do serviço para um serviço baseado em REST que está em execução no Barramento de Serviço usando a associação de WebHttpRelayBinding.

using System;
using System.Collections.Generic;
using System.Linq;
using System.Text;
using System.ServiceModel;
using System.ServiceModel.Channels;
using System.ServiceModel.Web;
using System.IO;
using System.Drawing;
using System.Drawing.Imaging;
using Microsoft.ServiceBus;
using Microsoft.ServiceBus.Web;

namespace Microsoft.ServiceBus.Samples
{


    [ServiceContract(Name = "ImageContract", Namespace = "https://samples.microsoft.com/ServiceModel/Relay/")]
    public interface IImageContract
    {
        [OperationContract, WebGet]
        Stream GetImage();
    }

    public interface IImageChannel : IImageContract, IClientChannel { }

    [ServiceBehavior(Name = "ImageService", Namespace = "https://samples.microsoft.com/ServiceModel/Relay/")]
    class ImageService : IImageContract
    {
        const string imageFileName = "image.jpg";

        Image bitmap;

        public ImageService()
        {
            this.bitmap = Image.FromFile(imageFileName);
        }

        public Stream GetImage()
        {
            MemoryStream stream = new MemoryStream();
            this.bitmap.Save(stream, ImageFormat.Jpeg);

            stream.Position = 0;
            WebOperationContext.Current.OutgoingResponse.ContentType = "image/jpeg";

            return stream;
        }
    }

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

O exemplo a seguir mostra o arquivo App.config associado ao serviço.

<?xml version="1.0" encoding="utf-8"?>
<configuration>
    <startup> 
        <supportedRuntime version="v4.0" sku=".NETFramework,Version=v4.5.2"/>
    </startup>
    <system.serviceModel>
        <extensions>
            <!-- In this extension section we are introducing all known service bus extensions. User can remove the ones they don't need. -->
            <behaviorExtensions>
                <add name="connectionStatusBehavior"
                    type="Microsoft.ServiceBus.Configuration.ConnectionStatusElement, Microsoft.ServiceBus, Culture=neutral, PublicKeyToken=31bf3856ad364e35"/>
                <add name="transportClientEndpointBehavior"
                    type="Microsoft.ServiceBus.Configuration.TransportClientEndpointBehaviorElement, Microsoft.ServiceBus, Culture=neutral, PublicKeyToken=31bf3856ad364e35"/>
                <add name="serviceRegistrySettings"
                    type="Microsoft.ServiceBus.Configuration.ServiceRegistrySettingsElement, Microsoft.ServiceBus, Culture=neutral, PublicKeyToken=31bf3856ad364e35"/>
            </behaviorExtensions>
            <bindingElementExtensions>
                <add name="netMessagingTransport"
                    type="Microsoft.ServiceBus.Messaging.Configuration.NetMessagingTransportExtensionElement, Microsoft.ServiceBus,  Culture=neutral, PublicKeyToken=31bf3856ad364e35"/>
                <add name="tcpRelayTransport"
                    type="Microsoft.ServiceBus.Configuration.TcpRelayTransportElement, Microsoft.ServiceBus, Culture=neutral, PublicKeyToken=31bf3856ad364e35"/>
                <add name="httpRelayTransport"
                    type="Microsoft.ServiceBus.Configuration.HttpRelayTransportElement, Microsoft.ServiceBus, Culture=neutral, PublicKeyToken=31bf3856ad364e35"/>
                <add name="httpsRelayTransport"
                    type="Microsoft.ServiceBus.Configuration.HttpsRelayTransportElement, Microsoft.ServiceBus, Culture=neutral, PublicKeyToken=31bf3856ad364e35"/>
                <add name="onewayRelayTransport"
                    type="Microsoft.ServiceBus.Configuration.RelayedOnewayTransportElement, Microsoft.ServiceBus, Culture=neutral, PublicKeyToken=31bf3856ad364e35"/>
            </bindingElementExtensions>
            <bindingExtensions>
                <add name="basicHttpRelayBinding"
                    type="Microsoft.ServiceBus.Configuration.BasicHttpRelayBindingCollectionElement, Microsoft.ServiceBus, Culture=neutral, PublicKeyToken=31bf3856ad364e35"/>
                <add name="webHttpRelayBinding"
                    type="Microsoft.ServiceBus.Configuration.WebHttpRelayBindingCollectionElement, Microsoft.ServiceBus, Culture=neutral, PublicKeyToken=31bf3856ad364e35"/>
                <add name="ws2007HttpRelayBinding"
                    type="Microsoft.ServiceBus.Configuration.WS2007HttpRelayBindingCollectionElement, Microsoft.ServiceBus, Culture=neutral, PublicKeyToken=31bf3856ad364e35"/>
                <add name="netTcpRelayBinding"
                    type="Microsoft.ServiceBus.Configuration.NetTcpRelayBindingCollectionElement, Microsoft.ServiceBus, Culture=neutral, PublicKeyToken=31bf3856ad364e35"/>
                <add name="netOnewayRelayBinding"
                    type="Microsoft.ServiceBus.Configuration.NetOnewayRelayBindingCollectionElement, Microsoft.ServiceBus, Culture=neutral, PublicKeyToken=31bf3856ad364e35"/>
                <add name="netEventRelayBinding"
                    type="Microsoft.ServiceBus.Configuration.NetEventRelayBindingCollectionElement, Microsoft.ServiceBus, Culture=neutral, PublicKeyToken=31bf3856ad364e35"/>
                <add name="netMessagingBinding"
                    type="Microsoft.ServiceBus.Messaging.Configuration.NetMessagingBindingCollectionElement, Microsoft.ServiceBus, Culture=neutral, PublicKeyToken=31bf3856ad364e35"/>
            </bindingExtensions>
        </extensions>
      <bindings>
        <!-- Application Binding -->
        <webHttpRelayBinding>
          <binding name="default">
            <security relayClientAuthenticationType="None" />
          </binding>
        </webHttpRelayBinding>
      </bindings>
      <services>
        <!-- Application Service -->
        <service name="Microsoft.ServiceBus.Samples.ImageService"
             behaviorConfiguration="default">
          <endpoint name="RelayEndpoint"
                  contract="Microsoft.ServiceBus.Samples.IImageContract"
                  binding="webHttpRelayBinding"
                  bindingConfiguration="default"
                  behaviorConfiguration="sbTokenProvider"
                  address="" />
        </service>
      </services>
      <behaviors>
        <endpointBehaviors>
          <behavior name="sbTokenProvider">
            <transportClientEndpointBehavior>
              <tokenProvider>
                <sharedAccessSignature keyName="RootManageSharedAccessKey" key="YOUR_SAS_KEY" />
              </tokenProvider>
            </transportClientEndpointBehavior>
          </behavior>
        </endpointBehaviors>
        <serviceBehaviors>
          <behavior name="default">
            <serviceDebug httpHelpPageEnabled="false" httpsHelpPageEnabled="false" />
          </behavior>
        </serviceBehaviors>
      </behaviors>
    </system.serviceModel>
    <appSettings>
        <!-- Service Bus specific app settings for messaging connections -->
        <add key="Microsoft.ServiceBus.ConnectionString"
            value="Endpoint=sb://yourNamespace.servicebus.windows.net/;SharedAccessKeyName=RootManageSharedAccessKey;SharedAccessKey=YOUR_SAS_KEY>"/>
    </appSettings>
</configuration>

Hospedar o serviço WCF baseado em REST para usar a Retransmissão do Azure

Esta seção descreve como executar um serviço Web usando um aplicativo de console com a Retransmissão do WCF. Uma lista completa do código escrito nesta seção é exibida no exemplo após o procedimento.

Para criar um endereço base para o serviço

Na declaração de função Main(), crie uma variável para armazenar o namespace de seu projeto. Substitua yourNamespace pelo nome do namespace de Retransmissão que você criou anteriormente.
```
string serviceNamespace = "yourNamespace";
```
O Barramento de Serviço usa o nome do namespace para criar um URI exclusivo.
Crie uma instância de Uri para o endereço básico do serviço que está baseado no namespace.
```
Uri address = ServiceBusEnvironment.CreateServiceUri("https", serviceNamespace, "Image");
```

Para criar e configurar o host do serviço Web

Ainda em Main(), crie o host do serviço Web, usando o endereço URI criado anteriormente nesta seção.

WebServiceHost host = new WebServiceHost(typeof(ImageService), address);

O host do serviço é o objeto do WCF que instancia o aplicativo host. Este exemplo passa o tipo de host que você deseja criar, que é um ImageService, e também o endereço no qual deseja expor o aplicativo host.

Para executar o host do serviço Web

Ainda em Main(), adicione a linha a seguir para abrir o serviço.
```
host.Open();
```
O serviço está em execução.

É exibida uma mensagem indicando que o serviço está em execução e dizendo como parar o serviço.

Console.WriteLine("Copy the following address into a browser to see the image: ");
Console.WriteLine(address + "GetImage");
Console.WriteLine();
Console.WriteLine("Press [Enter] to exit");
Console.ReadLine();

Quando terminar, feche o host do serviço.
```
host.Close();
```

Exemplo do contrato de serviço e da implementação

O exemplo a seguir inclui o contrato e a implementação do serviço das etapas anteriores no tutorial e hospeda o serviço em um aplicativo de console. Compile o código a seguir em um arquivo executável chamado ImageListener.exe.

using System;
using System.Collections.Generic;
using System.Linq;
using System.Text;
using System.ServiceModel;
using System.ServiceModel.Channels;
using System.ServiceModel.Web;
using System.IO;
using System.Drawing;
using System.Drawing.Imaging;
using Microsoft.ServiceBus;
using Microsoft.ServiceBus.Web;

namespace Microsoft.ServiceBus.Samples
{

    [ServiceContract(Name = "ImageContract", Namespace = "https://samples.microsoft.com/ServiceModel/Relay/")]
    public interface IImageContract
    {
        [OperationContract, WebGet]
        Stream GetImage();
    }

    public interface IImageChannel : IImageContract, IClientChannel { }

    [ServiceBehavior(Name = "ImageService", Namespace = "https://samples.microsoft.com/ServiceModel/Relay/")]
    class ImageService : IImageContract
    {
        const string imageFileName = "image.jpg";

        Image bitmap;

        public ImageService()
        {
            this.bitmap = Image.FromFile(imageFileName);
        }

        public Stream GetImage()
        {
            MemoryStream stream = new MemoryStream();
            this.bitmap.Save(stream, ImageFormat.Jpeg);

            stream.Position = 0;
            WebOperationContext.Current.OutgoingResponse.ContentType = "image/jpeg";

            return stream;
        }
    }

    class Program
    {
        static void Main(string[] args)
        {
            string serviceNamespace = "InsertServiceNamespaceHere";
            Uri address = ServiceBusEnvironment.CreateServiceUri("https", serviceNamespace, "Image");

            WebServiceHost host = new WebServiceHost(typeof(ImageService), address);
            host.Open();

            Console.WriteLine("Copy the following address into a browser to see the image: ");
            Console.WriteLine(address + "GetImage");
            Console.WriteLine();
            Console.WriteLine("Press [Enter] to exit");
            Console.ReadLine();

            host.Close();
        }
    }
}

Executar e testar o serviço

Após compilar a solução, faça o seguinte para executar o aplicativo:

Selecione F5 ou navegue até o local do arquivo executável, ImageListener\bin\Debug\ImageListener.exe para executar o serviço. Mantenha o aplicativo em execução, pois ele é necessário para a próxima etapa.
Copie e cole o endereço do prompt de comando em um navegador para ver a imagem.
Quando tiver terminado, selecione Inserir na janela do prompt de comando para fechar o aplicativo.

Agora que você criou um aplicativo que usa o serviço de Retransmissão do Azure, leia os seguintes artigos para saber mais:

Compartilhar via

Tutorial: Tutorial do REST de Retransmissão de WCF do Azure

Pré-requisitos

Criar um namespace de Retransmissão

Definir um contrato de serviço WCF baseado em REST para usar com a Retransmissão do Azure

Para criar um contrato com uma interface

Exemplo que define um contrato de Retransmissão do WCF

Implementar o contrato de serviço WCF baseado em REST

Para implementar um contrato de Barramento de Serviço no estilo REST

Para definir a configuração a fim de executar o serviço da Web no Barramento de Serviço

Exemplo que implementa o contrato de serviço WCF baseado em REST

Hospedar o serviço WCF baseado em REST para usar a Retransmissão do Azure

Para criar um endereço base para o serviço

Para criar e configurar o host do serviço Web

Para executar o host do serviço Web

Exemplo do contrato de serviço e da implementação

Executar e testar o serviço

Comentários

Recursos adicionais

Compartilhar via

Tutorial: Tutorial do REST de Retransmissão de WCF do Azure

Pré-requisitos

Criar um namespace de Retransmissão

Definir um contrato de serviço WCF baseado em REST para usar com a Retransmissão do Azure

Para criar um contrato com uma interface

Exemplo que define um contrato de Retransmissão do WCF

Implementar o contrato de serviço WCF baseado em REST

Para implementar um contrato de Barramento de Serviço no estilo REST

Para definir a configuração a fim de executar o serviço da Web no Barramento de Serviço

Exemplo que implementa o contrato de serviço WCF baseado em REST

Hospedar o serviço WCF baseado em REST para usar a Retransmissão do Azure

Para criar um endereço base para o serviço

Para criar e configurar o host do serviço Web

Para executar o host do serviço Web

Exemplo do contrato de serviço e da implementação

Executar e testar o serviço

Conteúdo relacionado

Comentários

Recursos adicionais