Web Services RESTful

Passo a Passo para criao de um Web Service RESTfull com Jersey / Eclipse / Tomcat

Testado tambm em JBoss e WebSphere

Juliano Marcos Martinsjuliano.jmm@gmail.comhttp://jmmwrite.wordpress.com

Jersey

API Java que implementa JAX-RS

Open source

Utilitrios

https://jersey.java.net/index.html

Especificao https://jax-rs-spec.java.net/

Passo 1

Baixar a Jersey de https://jersey.java.net/download.html

OBS: Existem vrias formas diferentes de se implementar, a utilizada aqui, a que considero a mais simples. Meu fim didtico, no me preocupo nesse momento em desenvolver um cdigo a prova de falhas.

Passo 2

Criar um projeto Dinmico WEB no Eclipse

Dei o nome de RestTeste

Adicionei o projeto a um EAR chamado RestTeste

Marquei a opo abaixo para gerar o web.xml (caso nao tenha marcado, possvel gerar posteriormente)

Passo 3

Adicionar as libs abaixo da Jersey ao WEB-INF/lib do projeto

Passo 4

Alterei o arquivo WEB.XML adicionei a parte em laranja, nela, estou mapeando os servios que criarei.

RestTesteindex.htmlindex.htmindex.jspdefault.htmldefault.htmdefault.jspJAX-RS Tools Generated - Do not modifyJersey REST Servicecom.sun.jersey.spi.container.servlet.ServletContainer1Jersey REST Service/rest/*

Passo 5

Criei uma classe chamada ClienteServico

Passo 6

Implementei o Web Service. Veja que anotei com @Path para ouvir em /clientes.

O metodo ir listar clientes no formato JSON

package br.com.jmmwrite.servicos;

import javax.ws.rs.GET;import javax.ws.rs.Path;import javax.ws.rs.Produces;import javax.ws.rs.core.Context;import javax.ws.rs.core.MediaType;import javax.ws.rs.core.UriInfo;

@Path("/clientes")public class ClientesServico {

@GET@Produces(MediaType.APPLICATION_JSON + ";charset=utf-8")public String selectAll() {String clientes = "{'nome': 'Cliente 1','endereco': 'Rua do Cliente 1','RG':3030030066},"+ "{'nome': 'Cliente 2','endereco': 'Rua do Cliente 2','RG':1010010011}";return clientes;}

}

Passo 6.1

No exemplo, estou simplesmente listando algo hardcoded.

Normalmente, neste ponto iramos efetuar uma invocao a um DAO que iria trazer os dados do banco, e utilizariamos alguma API, tal como GSON, para transformar a lista de clientes num objeto Json bem formatado.

Tambm teramos preocupao com algum mecanismo de segurana para no expor para o mundo um servio dessa forma.

Passo 7

Clicamos no projeto criado e vamos em Run on Server para testar:

Passo 8

O projeto deve subir sem erros e ser acessvel pela URL http://127.0.0.1:8080/RestTeste/rest/clientes/

Prximos passos

Como sugesto de estudo, interessante construir um CRUD.

Uma dvida comum como receber parametros para Inserir/Alterar/Excluir informaes, uma forma simples com o cdigo do proximo slide.

Passo 9

O mtodo abaixo recebe parmetros, adicione o mesmo ao seu Web Service:

@GET@Path("/inserir")@Produces(MediaType.APPLICATION_JSON + ";charset=utf-8")public String insertCliente(@Context UriInfo uriInfo ) {// queryParam

String nome = uriInfo.getQueryParameters().getFirst("nome");String endereco = uriInfo.getQueryParameters().getFirst("endereco");String rg = uriInfo.getQueryParameters().getFirst("rg");

String cliente = "{'nome': '" + nome + "','endereco': '" + endereco + "','rg':" + rg + "}";

return cliente;

}

Passo 9

Invoque-o utilizando a URL http://127.0.0.1:8080/RestTeste/rest/clientes/inserir?nome=juliano&endereco=ruax&rg=5555555555599

Concluso

A ponta do Iceberg essa. Com esta apresentao voc consegue construir um simples CRUD.

Cada vez mais o mundo demanda Web Services, principalemente com o nmero crescende de aplicaes mveis que acessam aplicativos WEB e Legadas.

Tenha em mente que implementar um servio relativamente fcil, qualquer pessoa implementa, porm, a preocupao com segurana e escalabilidade (volumetria/carga), no so comuns. Cuidado com os problemas que isso possa te gerar!

Enjoy!