Desenvolvendo Web Services RESTFUL utilizando a API JAX-RS 2.0 e Jersey

O que � WebService?

WebServices S�o serviços/m�todos que as aplicaç�es disponibilizam para serem consumidos/executados por outras aplicaç�es. Envolvem um produtor e um consumidor e s�o disponibilizados via Internet. S�o aplicaç�es que, geralmente, rodam em cima do protocolo HTTP. WebServices s�o sistemas distribu�das e seus componentes podem ser executados em dispositivos diversos tais como: desktops, smartphones e tablets.

Por que utilizar WebServices? O que h� de bom neles?

Os WebServices s�o implantados usando um padr�o de ind�stria e protocolos independentes como HTTP e XML/JSON Eles podem prover a interoperabilidade entre os serviços e reduzir o custo de entrada, j� que podem aproveitar outras infraestruturas j� em vigor, como a segurança, redes, formataç�o de dados, etc.

Relacionado: Desenvolvendo Web Services RESTFUL utilizando a API JAX-RS 2.0 e Jersey

Os provedores de serviços e seus clientes podem interoperar mesmo que escritos em diferentes linguagens de programaç�o. As linguagens de programaç�o mais conhecidas e utilizadas pela Ind�stria de software d�o suporte � WebServices, a citar: PHP, Python, Java, etc... Isso � maravilhoso! Com isso, podemos desenvolver sistemas e disponibilizar funcionalidades destes para serem reaproveitados por outras aplicaç�es sem impor a elas a utilizaç�o da mesma plataforma em que o serviço foi desenvolvido, pois o pr�prio sistema JAX-RS � quem se responsabiliza pela integraç�o. Ele � reaproveit�vel!

Al�m de tudo, os WebServices tem design modular, onde novos serviços podem ser gerados atrav�s da integraç�o e sobreposiç�o de serviços existentes.

Existem WebServices com estilo REST e WebServices baseados em SOAP (caso especial do estilo REST).

Como vamos focar em RESTFUL, ent�o ser�o abordados conceitos de RESTFUL.

O REST surgiu em uma tese de PHD de Roy Fielding (Cofundador da Apache Software Fundation e um dos principais autores da especificaç�o HTTP). Enquanto SOAP � um protocolo de mensagens, RESTful � um estilo de arquitetura de software para sistemas distribu�dos com hiperm�dia (texto, gr�ficos, �udio, etc. que s�o armazenados em uma rede e interligados por hiperlinks).

Um recurso possui hiperlinks e estes utilizam URIs (Uniform Resource Identifier), que s�o identificadores �nicos para recursos na Internet, para fazer a ligaç�o. Um cliente RESTful emite uma solicitaç�o que envolve um recurso, se a solicitaç�o for bem-sucedida, uma representaç�o do recurso (podendo ser o texto/html) � transferida do servidor que hospeda o recurso para o cliente que fez a solicitaç�o.

Os WebServices RESTful exigem n�o s� recursos, mas precisam de operaç�es que representem o pedido dos clientes. No RESTful, s�o conhecidos como verbos os m�todos do protocolo HTTP: POST (cria um novo recurso); GET (l� um recurso); PUT(atualiza um recurso); DELETE (deleta um recurso); HEAD (recupera o header da URI passada); OPTIONS (recupera os m�todos que s�o poss�veis); TRACE (recupera informaç�es de debug).

O URI representa o recurso e assim deve ser colocado no substantivo (como j� � conhecido o recurso em REST). Por exemplo, em uma rede de lojas se quisermos ter acesso a dados de uma determinada loja (GET), a URI seria: �/lojas/id�, ou para listar todas as lojas(recursos) criadas: �/lojas�. Com o POST poder�amos utilizar a mesma URI �/lojas�, sendo que utilizando com o POST a intenç�o � criar um novo recurso loja. Utilizando a URI �/lojas/id� com o verbo DELETE a operaç�o seria de remover determinada loja.

Voc� pode definir nas classes quais verbos s�o convenientes � utilizaç�o, por exemplo, se � requisito que nenhuma loja seja exclu�da, ent�o n�o se implementa o m�todo DELETE.

Entendido um pouco de REST, vamos ao ponto de partida: HelloWorld

Java d� suporte a REST atrav�s da JSR 339 (Java Specification Resquest), esta especificaç�o � chamada de JAX-RS 2.0. Jersey � a implementaç�o da especificaç�o para JAX-RS. Basicamente, Jersey tem um servidor e um cliente REST. O �core-client� pode ser usado fornecendo uma biblioteca para se comunicar com o servidor. No lado do servidor, o Jersey usa um servlet que �escaneia� as classes predefinidas para identificar os recursos REST. ATENÇ�O: atrav�s do arquivo de configuraç�o �web.xml� � que se registra o servlet, que n�o precisa ser criado, ele j� � fornecido pela Jersey distribution (encontra-se nas bibliotecas).

Iniciando o projeto, crie um novo projeto no eclipse -> Dynamic Web Project, dar nome ao projeto e escolher o servidor (Apache Tomcat), como na Figura 1:

Figura 1: Criando novo projeto web e definindo algumas opç�es

Antes de criar, a classe Resource � importante baixar e adicionar nas libs do projeto (WebContent/WEB-INF/lib) os jars do Jersey. Os jars necess�rios s�o: asm-3.1.jar, Jersey-core-1.4.jar, Jersey-server-1.4.jar, jsr311-api-1.1.1.jar. Estes est�o presentes em um arquivo .zip dispon�vel para download no site do Jersey (link direto: http://maven.java.net/service/local/artifact/maven/redirect?r=releases&g=com.sun.jersey&a=jersey-archive&v=1.17&e=zip. Os jars aparecem circulados na Figura 2:

Figura 2: JARs adicionados na pasta lib

Criando a classe RESOURCE:

Listagem 1:�RECURSO que ir� ser utilizado


package luana.article.validator.devmedia.resource;

import javax.WebServices.rs.GET; //import da biblioteca jersey
import javax.WebServices.rs.Path; //import da biblioteca jersey
import javax.WebServices.rs.Produces; //import da biblioteca jersey

@Path("/helloworld") // o @path define a URI do recurso que nesse caso ser� /helloworld
public class RecursoHelloWorld {

	@GET // utilizando apenas o verbo GET, ou seja, vou apenas ler o recurso
	@Produces("text/plain") // define qual tipo MIME � retornado para o cliente
	public String exibir(){
		return "Hello World";
	}
}

Feito o Resource, basta agora mapear o servlet e o recurso no web.xml:�

Listagem 2: C�digo do arquivo web.xml.


<?xml version="1.0" encoding="UTF-8"?>
<web-app xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" 
		 xmlns="http://java.sun.com/xml/ns/javaee" 
		 xmlns:web="http://java.sun.com/xml/ns/javaee/web-app_2_5.xsd" 
		 xsi:schemaLocation="http://java.sun.com/xml/ns/javaee http://java.sun.com/xml/ns/javaee/web-app_2_5.xsd" 
		 id="WebApp_ID" 
		 version="2.5">
  <display-name>TesteWebServices</display-name> <!-- Como default o nome do meu projeto, esse nome ir� aparecer na URL -->
  <servlet> <!�- mapeando o servlet-->
    <servlet-name>Jersey RESTful</servlet-name>
    <servlet-class>com.sun.jersey.spi.container.servlet.ServletContainer</servlet-class>
    <init-param>
      <param-name>com.sun.jersey.config.property.packages</param-name>

<!�- O SERVLET-CLASS E O PARAM-NAME N�O S�O MODIFICADOS, BASTA COPIAR E COLAR.. POIS EST� UTILIZANDO O SERVLET QUE VEM NA BIBLIOTECA DO JERSEY-->

      <param-value>luana.article.validator.devmedia.resource</param-value>
<!�- J� O PARAM-VALUE � O ENDEREÇO DO PACOTE ONDE SE ENCONTRA O SEU RECURSO -->

    </init-param> 
    <load-on-startup>1</load-on-startup>
  </servlet>
  <servlet-mapping>
    <servlet-name>Jersey RESTful</servlet-name>
    <url-pattern>/*</url-pattern>
  </servlet-mapping>
</web-app>

�Agora, � s� colocar para a aplicaç�o rodar no servidor. E pronto coloque a seguinte URL (com as modificaç�es necess�rias porta, nome escolhido para o projeto e para o recurso): http://localhost:5550/TesteWebServices/helloworld se tudo correr bem ir� aparecer um Hello World na tela.

Com isto finalizo o artigo, por hoje � s�... Espero que tenham gostado.

�Um abraço.

DAS CONSIDERAÇ�ES FINAIS

V�-se que o RESTful n�o � um bicho de sete cabeças e � muito simples ser implementado. Para aplicaç�es mais complexas � necess�rio cautela para escolher os serviços de cada recurso. A base foi dada! M�os a obra com os pr�ximos WebServices!

Links �teis

Saiba mais sobre Java ;)

Curso b�sico de Java Aplicado:
O objetivo do curso de Java B�sico aplicado � apresentar os conceitos b�sicos da linguagem de programaç�o Java, assim como da Orientaç�o a Objetos, aplicados em exemplos simples e �teis, utilizados pela maioria dos desenvolvedores no dia a dia do desenvolvimento de software.
B�sico de Java e Orientaç�o a Objetos:
O objetivo deste curso b�sico de Java e Orientaç�o a Objetos � apresentar os conceitos b�sicos da linguagem de programaç�o Java e a orientaç�o a objetos (OO), visando ensinar usu�rios leigos, com pouca experi�ncia em linguagem de programaç�o a trabalhar com a plataforma Java.
Curso de Java: T�cnicas Avançadas para Java SE:
Neste curso de Java avançado iremos nos aprofundar em t�picos de programaç�o que ajudam voc� a entender os conceitos mais avançados de Java. Isso significa que o programador j� precisa ter conhecimentos pr�vios da linguagem Java, bem como dos seus recursos, l�gica de programaç�o, depuraç�o de c�digo, IDEs, dentre outros conceitos b�sicos de programaç�o.