Neste tutorial será demonstrado alguns conceitos de Web Service, como funciona e a utilidade dos serviços.  
Para este tutorial utilizaremos o Microsoft Visual Studio Team System 2008 com Framework 3.5 SP1.


Web Services

De forma resumida, os Web Services são utilizados para permitir a interoperabilidade entre sistemas distintos. É amplamente utilizado nas empresas que visam disponibilizar suas informações para outrem, sem se preocupar com a tecnologia utilizada entre elas.
Utilizando-se do protocolo SOAP e o formato XML no processo de envio e recebimento das informações, os Web Services difundiram-se rapidamente no mundo corporativo devido a sua padronização, que facilita e norteia o desenvolvimento de sistemas.

Exemplos de serviços disponibilizados na web é o Google Maps e o Microsoft Virtual Earth, que por meio de Web Services disponibilizam serviços para busca de informações territoriais, como o mapa, a localização geográfica em Latitude e Longitude, nome de ruas, avenidas, rodovias e etc.

Criando o Web Service

Para começar, vamos criar um serviço no Visual Studio. Vá em File -> New -> Project.... Como demonstra a Figura 01.



Figura 01 - Criando novo projeto

Na Figura 02 visualizaremos a janela para escolha do projeto Web Service.


Figura 02 - Criando um ASP .NET Web Service Application

Em Project types é necessário expandir o item Visual C# na árvore de opções e escolher o item Web. Desta forma, visualizaremos na caixa de diálogo o template ASP .NET Web Service Application, que deverá ser selecionado.

Nas caixas de textos Name, Location e Solution Name serão utilizados os seguintes valores:

•    Name: WebService1
•    Location: C:\WebService1
•    Solution Name: WebService1

Logo após, selecionamos OK, o Visual Studio abrirá o código conforme apresentado na Listagem 01. Este código encontra-se no arquivo Service1.asmx.cs que podemos visualizar na caixa de diálogo Solution Explorer conforme Figura 03.

using System; using System.Collections.Generic; using System.Linq; using System.Web; using System.Web.Services;   namespace WebService1 { /// <summary> /// Summary description for Service1 /// </summary> [WebService(Namespace = "http://tempuri.org/")] [WebServiceBinding(ConformsTo = WsiProfiles.BasicProfile1_1)] [System.ComponentModel.ToolboxItem(false)] // To allow this Web Service to be called from script, using ASP.NET AJAX, uncomment the following line. // [System.Web.Script.Services.ScriptService] public class Service1 : System.Web.Services.WebService {   [WebMethod] public string HelloWorld() { return "Hello World"; } } }

Listagem 01 – Código inicial do serviço criado



Figura 03 – Localização do arquivo Service1.asmx.cs.

Conforme está na Listagem 01, vamos analisar de forma resumida o código gerado automaticamente pelo Visual Studio.

•    O atributo [WebService] é utilizado para definir a namespace do serviço, de forma a identificá-lo dentre outras disponíveis na rede. O valor contido na namespace, geralmente, identifica o domínio que o serviço está hospedado, esta informação é encapsulada no protocolo SOAP e no XML de saída. Assim, é possível criar validações de acesso caso seja necessário, certificando-se que o serviço está realmente enviando informações do local correto. 

•    O atributo [WebServiceBinding(ConformsTo = WsiProfiles.BasicProfile1_1)] define o padrão que a WS-I determina para todas as plataformas que utilizam serviços na Web.

•    O atributo [System.ComponentModel.ToolboxItem(false)] é utilizado para habilitar a inclusão do serviço no Toolbox do Visual Studio, caso deseje que o mesmo seja utilizado em outros projetos. Para habilitar é necessário trocar o parâmetro de false para true.

•    O atributo [WebMetod] é o responsável por atribuir que o método poderá ser chamado para ser utilizado pelas aplicações que irão consumir o serviço.


O código gerado automaticamente pelo Visual Studio já contém um serviço simples, que nos retornará a mensagem Hello World pelo método HelloWorld.


Vamos executar a aplicação para testar o retorno do nosso serviço. Para isso, precisamos definir a página inicial do projeto, então vá para Solution Explorer, selecione o arquivo Service1.asmx pressionando o botão direito do mouse, em seguida visualizaremos uma caixa como na Figura 04. Então, selecione a opção Set As Start Page.


Figura 04 – Definir página inicial para execução.

Para executar o serviço pressione a tecla F5. E logo após, veremos uma caixa de informação como na Figura 05. Deixe a primeira opção selecionada e depois pressione o botão OK. Esta opção habilita o modo de depuração da aplicação, isto, para facilitar quando precisarmos analisar um erro ou fluxo de execução.



Figura 05 – Caixa de opção pra habilitar o modo de depuração da aplicação

O código gerado automaticamente pelo Visual Studio já contém um serviço simples, que nos retornará a mensagem Hello World pelo método HelloWorld.


Em seguida, a janela do navegador irá se abrir e veremos algumas informações. Note que existe um link chamado HelloWorld, que é o método implementado no código da Listagem 01. A Figura 06 mostra como deverá estar o serviço  Service1.



Figura 06 – Janela do navegador executando o serviço Service1.

Quando clicamos no link HelloWorld,  veremos uma tela de teste conforme Figura 07.


Figura 07 – Tela para teste do método HelloWorld.

Como você pode observar, existe um botão denominado Invoke, o qual é responsável por executar o método HelloWorld do serviço Service1. Veja o resultado na Figura 08.


Figura 08 – Retorno do método HelloWorld.

Como podemos ver, o método retornou a mensagem “Hello World”. Porém, notamos que o retorno está no formato XML, já que a norma de envio e recebimento de informações é feito pelo protocolo SOAP que utiliza o XML como padrão para transporte dos dados.

Este é o final do tutorial, que mostrou como criar um Web Service. Iremos falar mais sobre Web Services em tutoriais futuros, onde mostraremos como consumir os serviços criados. Espero que tenha gostado, e seja feliz.


Abraços,
Emerson Teruhiko Watanabe