Web Services no JEE 7. Prof. Fellipe Aleixo

Transcrição

1 Web Services no JEE 7 Prof. Fellipe Aleixo (fellipe.aleixo@ifrn.edu.br)

2 O que são Web Services? Web services are client and server applications that communicate over the World Wide Web's (WWW) HyperText Transfer Protocol (HTTP). As described by the World Wide Web Consortium (W3C), web services provide a standard means of interoperating between software applications running on a variety of platforms and frameworks. Web services are characterized by their great interoperability and extensibility as well as their machine-processable descriptions, thanks to the use of XML. Web services can be combined in a loosely coupled way to achieve complex operations. Programs providing simple services can interact with each other to deliver sophisticated added-value services. Tutorial JEE 7

3 Tipos de Web Services Web Services XML (Big) JAX-WS Utiliza mensagens em XML e o protocolo SOAP Descritor por WSDL Web Services Description Language Web Services RESTful JAX-RS Funcionalidade RESTful Representational State Transfer Acoplamento ao protocolo HTTP

4 Big Web Services Utiliza mensagens em XML (padrão SOAP) SOAP = Simple Object Access Protocol Contrato de operações através de WSDL Web Services Description Language Atendem a vários requisitos não funcionais Exemplo: transações, segurança, relações de confiança, coordenação e etc.

5 Web Services RESTful Provê a Representational State Transfer Melhor integrado ao HTTP do que o SOAP Não requer mensagens XML nem definições WSDL Estrutura mais leve utiliza os padrões HTTP Algumas condições para utilizar o modelo REST: Serviço completamente sem estado Entendimento mútuo entre cliente e servidor Particularmente útil em clientes limitados (móveis) Inclusão de serviços em sistemas Web já existentes

6 Qual Tipo Usar? JAX-WS Pode atender a requisitos avançados de QoS Mais fácil suporte aos protocolos WS-* (segurança, confiabilidade, etc.) JAX-RS Integrar facilmente serviços em aplicações Web Mais fácil para clientes consumirem o serviço

7 JAX-WS Construindo Web Services com

8 Java API for XML Web Services Estilo RPC chamada remota a procedimento Operação por meio do protocolo SOAP A JAX-WS permite a abstração da complexidade do SOAP a definição da interface do serviço em Java o cliente interage com um proxy local o cliente não está amarrado à plataforma Java

9 Java API for XML Web Services

10 Implementando com JAX-WS Ponto de partida uma classe Java anotada (javax.jws) Service Endpoint Interface e implementação em Java A interface não é obrigatória, mas pode ser definida pelo atributo endpointinterface da

11 Criar um Serviço e um Cliente 1. Codificar a classe de implementação 2. Compilar a classe de implementação 3. Empacotar arquivos em um WAR 4. Implantar o WAR em um servidor de aplicação 5. Codificar a classe cliente 6. Utilizar o script wsimport para gerar e os artefatos necessários à conexão ao serviço 7. Compilar a classe cliente 8. Executar o cliente

12 Requisitos para um Endpoint JAX-WS Classe anotada Não pode ser final, nem abstrata Construtor público padrão Não pode definir o método finalize Indicar a interface com o atributo endpointinterface Métodos de negócio devem ser públicos Não podem ser estáticos, nem finais Anotados (javax.jws) Podem ter argumentos compatíveis com JAXB Pode anotar métodos

13 Exemplo import javax.jws.webservice; import publicclass Hello { private String message = new String("Hello, "); publicvoid Hello() publicstring sayhello(string name) { return message + name + ".";

14 Testando o Serviço sem um Cliente Para acessar o WSDL: Para abrir a interface de teste do serviço:

15 Aplicação Cliente JAX-WS Simples Artefatos necessários gerados pelo wsimport Usar a classe gerada pelo wsimport e a URI do WSDL como referência para o serviço import helloservice.endpoint.helloservice; import javax.xml.ws.webserviceref; publicclass "META-INF/wsdl/localhost_8080/helloservice/HelloService.wsdl") privatestatic HelloService service;...

16 Aplicação Cliente JAX-WS Simples Recuperar um proxy a partir do serviço, o qual possibilita a invocação do método de negócio helloservice.endpoint.hello port = service.gethelloport();... return port.sayhello(arg0);

17 Aplicação Cliente JAX-WS Simples import helloservice.endpoint.helloservice; import javax.xml.ws.webserviceref; publicclass "META-INF/wsdl/localhost_8080/helloservice/HelloService.wsdl") privatestatic HelloService service; public static void main(string[] args) { System.out.println(sayHello("world")); privatestatic String sayhello(java.lang.string arg0) { helloservice.endpoint.hello port= service.gethelloport(); return port.sayhello(arg0);

18 // UM CLIENTE urlpatterns={"/helloservlet") public class HelloServlet extends HttpServlet = " private HelloService service; protected void processrequest(httpservletrequest request, HttpServletResponse response) throws ServletException, IOException { response.setcontenttype("text/html;charset=utf-8"); try (PrintWriter out = response.getwriter()) { out.println("<html lang=\ pt-br\">"); out.println("<head>"); out.println("<title>servlet HelloServlet</title>"); out.println("</head>"); out.println("<body>"); out.println("<h1>servlet HelloServlet at " + request.getcontextpath () + "</h1>"); out.println("<p>" + sayhello("world") + "</p>"); out.println("</body>"); out.println("</html>"); private String sayhello(java.lang.string arg0) { javaeetutorial.helloservice.endpoint.hello port = service.gethelloport(); return port.sayhello(arg0);

19 Tipos Suportados por JAX-WS JAX-WS delega o mapeamento dos tipos da linguagem Java para o XML ao JAXB Alguns mapeamentos Java-para-Schema: Tipo no SchemaXML xsd:string xsd:integer xsd:int xsd:double xsd:boolean xsd:datetime xsd:date Tipo de Java java.lang.string java.math.biginteger int double boolean javax.xml.datatype.xmlgregoriancalendar javax.xml.datatype.xmlgregoriancalendar

20 Mais Informações sobre JAX-WS Especifcação 2.2 da API Java para Web Services XML: x4.html Portal JAX-WS: Simple Object Access Protocol (SOAP) 1.2: Web Services Description Language (WSDL) 1.1: Perfil básico WS-I 1.1:

21 JAX-RS Construindo Web Services com

22 Java API for RESTful Web Services Infraestrutura mais leve, com fraco acoplamento REST Representational State Transfer (estilo arquitetural baseado em cliente/servidor) Foco na transferência de representações de recursos por meio de requisições e respostas Dados e funcionalidadessão recursos acessados por URIs links (URLs) da Web Os recursos são representados por documentos, os quais são processados por operações bem definidas

23 Java API for RESTful Web Services Exemplo de recurso: Condições de tempo para uma cidade A representação do recurso pode ser um documento XML, ou uma imagem, ou um HTML Um cliente pode: recuperar uma representação particular modificar o recurso atualizando os seus dados remover completamente um recurso

24 Princípios a serem Seguidos Criar aplicações simples, leves e rápidas Identificação de recursos por meio de URIs Interface uniforme (operações do HTTP) Mensagens auto-descritivas Recursos desacoplados da sua representação Interações com estado através de links Reescrita de URL, cookies, campos escondidos, etc.

25 Criando uma Classe de Recurso Classes de recurso (root resource classes) são POJOs anotadas Ou ter ao menos um método anotado Ou ter algum método associado a uma requisição @POST As anotações definem os recursos, e as ações que podem ser realizadas com estes

26 Anotações Descrição Indica a URI à qual a classe estará vinculada (e parâmetros) Designa um método para processar uma solicitação GET Designa um método para processar uma solicitação POST Designa um método para processar uma solicitaçãoput Designa um método para processar uma solicitação DETELE Designa um método para processar uma solicitação HEAD Define os parâmetros que podem ser utilizados pelo recurso Defineas consultas que podem ser utilizadas pelo recurso Define os tipos MIME das representações recebidas de clientes Define os tipos MIME das representações enviadas para clientes Mecanismosde acesso ao provedor (baixo nível) Define o mapeamento de URL para a aplicação

27 Exemplo Simples #1 import javax.ws.rs.consumes; import javax.ws.rs.get; import javax.ws.rs.put; import javax.ws.rs.path; import javax.ws.rs.produces; import javax.ws.rs.core.context; import javax.ws.rs.core.uriinfo; /** * Root resource (exposed at "helloworld" path) publicclass HelloWorld {

28 Exemplo Simples privateuriinfo context; public public String gethtml() { return <html lang=\ en\ ><body><h1>hello, World!!</h1> + public void postclichedmessage(stringmessage) { // Store the message

29 Passando Parâmetros em URIs Especificação de parâmetros embutidos Denotados entre parênteses Valores obtidos public class public formato String esperado getuser(@pathparam("username") definido (expressão regular) String username) [a-za-z][a-za-z_0-9]*")

30 Passando Mais de Um Parâmetro Exemplo de URI com dois parâmetros Mapeando a URL de um recurso (web.xml) <servlet-mapping> <servlet-name>javax.ws.rs.core.application</servlet-name> <url-pattern>/resources/*</url-pattern> </servlet-mapping> Recuperando os parâmetros pelo publicclass SomeResource {...

31 Respondendo a Solicitações HTTP Utilizar anotações para designar publicresponse putcontainer() { System.out.println("PUT CONTAINER " + container); URI uri = uriinfo.getabsolutepath(); Container c = new Container(container, uri.tostring()); Response r; if (!MemoryStore.MS.hasContainer(c)) { r = Response.created(uri).build(); else { r = Response.noContent().build(); MemoryStore.MS.createContainer(c); return r;

32 Respondendo a Solicitações HTTP Por padrão o ambiente de execução JAX-RS suporta os métodos HEAD e OPTIONS Se não forem explicitamente implementados Tais métodos deve retornar void Tipo básico Java Um objeto javax.ws.rs.core.response

33 Respondendo a Solicitações HTTP A classe ResponseBuilder cria a public Response getitem() { System.out.println("GET ITEM " + container + " " + item); Item i = MemoryStore.MS.getItem(container, item); if (i == null) { throw new NotFoundException("Item not found"); Date lastmodified = i.getlastmodified().gettime(); EntityTag et = new EntityTag(i.getDigest()); ResponseBuilder rb = request.evaluatepreconditions(lastmodified, et); if (rb!= null) { return rb.build(); byte[] b = MemoryStore.MS.getItemData(container, item); return Response.ok(b, i.getmimetype()).lastmodified(lastmodified).tag(et).build();

34 Customizando Requisições e Respostas @Produces("text/plain") publicclass SomeResource publicstring publicstring dogetashtml() {...

35 Customizando Requisições publicclass SomeResource publicstring public String dopost2(formurlencodedproperties formdata) {...

36 Extraindo Parâmetros de Solicitações Podem ser extraídos os seguintes tipos de parâmetros para serem utilizados no recurso Consulta (Query) Caminho URI Formulário Cookie Cabeçalho (Header) Matriz (Matrix)

37 Parâmetros de Consulta Extraídos a partir da URI de consulta public ColorParam lastcolor ) {...

38 Parâmetros de URI Parâmetros definidos pelo template de publicclass MyResourceBean publicstring String userid) {...

39 Demais @CookieParam, Mesmas regras de @Consumes("application/x-www-form-urlencoded") publicvoid post(@formparam("name") String name) { // Store the message

40 Configurando Aplicações JAX-RS A URI base para os recursos pode ser definida: Utilizando a em uma subclasse de javax.ws.rs.core.application Através do mapeamento de URL no publicclass MyApplicationextends Application {... <servlet-mapping> <servlet-name>javax.ws.rs.core.application</servlet-name> <url-pattern>/webapi/*</url-pattern> </servlet-mapping>

41 Exemplo de Aplicação com JAX-RS Criando um Web Service RESTful simples Classe Java com a hello ) Crie o seguinte publicstring gethtml() { return <html lang=\ en\ ><body><h1>hello, World!! + </body></h1></html> ; Acesse com:

42 Mais Informações sobre JAX-RS Artigo sobre que abordagem utilizar: RESTful Web Services vs. 'Big' Web Services: Making the Right Architectural Decision Dissertação de Fielding: Representational State Transfer (REST)": Livro RESTful Web Services, de Leonard Richardson e Sam Ruby, da editora O'Reilly JSR 339: JAX-RS: The Java API for RESTful Web Services Projeto Jersey (implementação de referência de JAX-RS):