Conceitos, SOAP, WSDL, UDDI, Exemplos. Programação com Objetos Distribuídos (C. Geyer) Web Services 1

Transcrição

1 Conceitos, SOAP, WSDL, UDDI, Exemplos Programação com Objetos Distribuídos (C. Geyer) Web Services 1

2 Autores Local Sérgio Mergen Cláudio Geyer Emanuel Müller Ramos Instituto de Informática UFRGS Versão V20 Maio 2010 cursos: Sistemas Operacionais II Programação com Objetos Distribuídos Programação com Objetos Distribuídos (C. Geyer) Web Services 2

3 Súmula conceitos gerais sobre Web Services conceitos de SOAP Introdução à biblioteca Axis WS no J2EE conceitos de WSDL conceitos de UDDI Observações Ênfase em WS para Java Programação com Objetos Distribuídos (C. Geyer) Web Services 3

4 Bibliografia Coulouris, G. Et al. Sistemas Distribuídos Conceitos e Projeto. Bookman, Cap. 19 CERAMI Ethan. Web Services Essentials - Distributed Applications with XML-RPC, SOAP, UDDI & WSDL. O'Reilly, NEWCOMER Eric. Understanding Web Services: XML, WSDL, SOAP, and UDDI. David Chappell Series Editor Wutka, M. Special Edition Using Java 2 Enterprise Edition. QUE, capítulo 25 Tutoriais da Sun para J2EE e do NetBeans Capítulos sobre WS: JAX-WS, SOAP,... Programação com Objetos Distribuídos (C. Geyer) Web Services 4

5 Links Atividades do W3 em Web Services XML Protocol Working Group Projetos WS do grupo Apache Implementações de Java SOAP Axis 2 Axis Programação com Objetos Distribuídos (C. Geyer) Web Services 5

6 Links Links SOAP do W3 SOAP Message Transmission Optimization Mechanism SOAP Resource Representation Header SOAP Version 1.2 Part 0: Primer SOAP Version 1.2 Part 1: Messaging Framework Programação com Objetos Distribuídos (C. Geyer) Web Services 6

7 Links Links SOAP do W3 SOAP Version 1.2 Part 2: Adjuncts SOAP Version 1.2 Specification Assertions and Test Collection Programação com Objetos Distribuídos (C. Geyer) Web Services 7

8 Links Links WSDL do W3 Semantic Annotations for WSDL and XML Schema Web Services Description Language (WSDL) Version 2.0 Part 0: Primer Web Services Description Language (WSDL) Version 2.0 Part 1: Core Language Web Services Description Language (WSDL) Version 2.0 Part 2: Adjuncts as Recommendation. Programação com Objetos Distribuídos (C. Geyer) Web Services 8

9 Súmula Conceitos gerais sobre Web Services motivação para o uso de Web Services definição arquitetura componentes pilha de protocolos Programação com Objetos Distribuídos (C. Geyer) Web Services 9

10 Súmula Conceitos de SOAP Introdução ao SOAP Vantagens do SOAP Desvantagens do SOAP Estrutura de uma mensagem SOAP Exemplo de WS/SOAP com Apache Axis Comparação entre RMI e Apache SOAP Programação com Objetos Distribuídos (C. Geyer) Web Services 10

11 Súmula WS no J2EE Características Tipos JAX-WS RESTFul WSDL UDDI Programação com Objetos Distribuídos (C. Geyer) Web Services 11

12 A Internet Tradicional Ótima forma para troca de informações Independência de plataforma Abstração do hardware, software e sistema operacional utilizados Problemas: WWW era centrada no ser humano pessoas acessam, modificam, inserem e removem documentos remotos Aplicações que desejavam trocar informações pela Web necessitavam utilizar soluções ad-hoc Necessidade de estender a Web para suportar esse novo tipo de interação Web Services: web para sistemas coorportaivos Programação com Objetos Distribuídos (C. Geyer) Web Services 12

13 Web Services Objetivos Permitir uma comunicação fácil entre diferentes aplicações utilizando a estrutura já existente da Web Determinam um conjunto de mecanismos (padrões, especificões, etc.) que permitam estender a Internet para aceitar a troca de informações entre aplicações Adicionalmente: permitir que aplicações descubram automaticamente qual serviço elas desejam utilizar Chamada automática de serviços Sem nenhuma intervenção do ser humano Ainda não é totalmente realidade Obs: CORBA tinha alguns objetivos similares Programação com Objetos Distribuídos (C. Geyer) Web Services 13

14 Web Services Conceito Um Web Service é uma aplicação que: Está disponível através da Internet Utiliza padrões baseados em XML para descrever as mensagens enviadas e recebidas, bem como seus dados É independente de hardware, sistema operacional e linguagem de programação Pode ser descrita utilizando XML (WSDL) Pode ser encontrada facilmente (usando UDDI por exemplo) OBS.: Web Services baseados na arquitetura REST (REST WS) não seguem exatamente esses conceitos REST WS são mais simples Programação com Objetos Distribuídos (C. Geyer) Web Services 14

15 Exemplo Básico - Linguagens Java e C - SOs Windows e Linux - Mensagem XML - requisição e resposta Programação com Objetos Distribuídos (C. Geyer) Web Services 15

16 Arquitetura Pode ser descrita de duas formas Pelos componentes que a compõem Pela pilha de protocolos utilizada Programação com Objetos Distribuídos (C. Geyer) Web Services 16

17 Componentes Programação com Objetos Distribuídos (C. Geyer) Web Services 17

18 Pilha de Protocolos Conjunto mais utilizado: HTTP + SOAP + WSDL + UDDI Programação com Objetos Distribuídos (C. Geyer) Web Services 18

19 Nível de transporte Responsável por transmitir os dados entre as aplicações Pode utilizar protocolos já disponíveis pela internet (HTTP, SMTP, FTP, etc.) Nível de mensagem Define o formato das mensagens enviadas entre as aplicações Obs.: Formato XML puro não garante interoperabilidade entre aplicações Programação com Objetos Distribuídos (C. Geyer) Web Services 19

20 Nível de descrição Representa a interface de um Web Service aos clientes Nome das operações disponíveis Parâmetros Protocolos do nível de transporte utilizados Etc Nível de descoberta Registros onde é possível publicar um Web Service Programação com Objetos Distribuídos (C. Geyer) Web Services 20

21 Súmula da parte SOAP Conceitos de SOAP Introdução ao SOAP Vantagens do SOAP Desvantagens do SOAP Estrutura de uma mensagem SOAP Exemplo de WS/SOAP com Apache Comparação entre RMI e Apache SOAP Programação com Objetos Distribuídos (C. Geyer) Web Services 21

22 O que é SOAP? Protocolo para troca de mensagens distribuídas Pode ser usado como o nível de mensagem da arquitetura WS Concorrente de IIOP (Corba), JRMP (Java RMI), XML-RPC, REST- WS e outros Proposto a IETF e ao W3 W3: World Wide Web Consortium IETF: organização que publica padrões para Internet como TCP, FTP, HTTP, Especificação inicial desenvolvida por Microsoft, IBM/Lotus, Don Box (guru COM), Dave Winer (criador de um XML-RPC) Programação com Objetos Distribuídos (C. Geyer) Web Services 22

23 Características do SOAP Baseado em tecnologias já existentes HTTP, SMTP como nível de transporte XML Utiliza mensagens no formato XML Unidirecional Sem estado Não define um modelo de objetos Não define um modelo para troca de mensagens Não está necessariamente ligado a Web Services Programação com Objetos Distribuídos (C. Geyer) Web Services 23

24 Características do SOAP Quando usado em chamada de WS Aplica modelo requisição resposta (cliente/servidor) com 2 mensagens SOAP Chamada pode ser: Síncrona (normal em RPC) Assíncrona Assíncrona com resposta no futuro Programação com Objetos Distribuídos (C. Geyer) Web Services 24

25 Vantagens do SOAP Firewall Friendly uso de protocolos Web como HTTP Infraestrutura já conhecida Amplo suporte a XML Suportado por grandes organizações Variedade de bibliotecas (livres e pagas) para sua utilzação Programação com Objetos Distribuídos (C. Geyer) Web Services 25

26 Vantagens SOAP Independe de linguagem (se utilizado seguindo corretamente os padrões) RMI: só Java observação: RMI-IIOP permite Java x linguagens com IIOP IIOP: exige biblioteca IIOP para a linguagem SOAP: somente um parser XML mais biblioteca para envio de requisições HTTP Independe de plataforma permitiria ponte entre mundos Linux e Microsoft obs: RMI e CORBA oferecem essa ponte, mas não com o mesmo nível de abstração Programação com Objetos Distribuídos (C. Geyer) Web Services 26

27 Desvantagens SOAP Brechas na segurança WS-Security tenta resolver esses problemas wg_abbrev=wss Problemas de performance menos rápido que atuais competidores tipo RPC como RMI (Java), IIOP (CORBA), DCOM e Remote (Microsoft) mais lento mesmo comparado a competidores que são baseados em XML (XML-RPC, REST-WS) Muito complexo: overhead aplicações geralmente não necessitam de tantas funcionalidades para realizar seus objetivos REST-WS é mais simples -> mais eficiente (?) Programação com Objetos Distribuídos (C. Geyer) Web Services 27

28 Desvantagens SOAP Não oferece serviços avançados A revisar conforme novos padrões Web Services Como CORBA, J2EE, CORBA possuía mais de 20 serviços como persistência, transações, real-time, aluguel de objetos,... Não possui noção de objeto com estado como em RMI Não suporta passagem por referência Obs.: possível simular esses comportamentos de OO Programação com Objetos Distribuídos (C. Geyer) Web Services 28

29 Versões SOAP SOAP Programação com Objetos Distribuídos (C. Geyer) Web Services 29

30 Especificação (estrutura geral dos documentos) Parte 1: define o envelope, um framework geral para definir o conteúdo de uma mensagem Também define os protocolos de ligação e o mapeamento para um protocolo inferior Parte 2: Define um modelo de dados para o SOAP Representação de recurso Especifica um bloco de cabeçalho, no qual há a representação de um recurso Web Outros documentos Programação com Objetos Distribuídos (C. Geyer) Web Services 30

31 Envelope: define o começo da mensagem SOAP Header: possui informações específicas da aplicação Dados de autenticação Número de transação Etc. opcional Body: contém a mensagem propriamente dita Contém dados que devem ser transmitidos de forma estruturada Possiveis excessões durante o tratamento da mensagem Programação com Objetos Distribuídos (C. Geyer) Web Services 31

32 POST /Temperature HTTP/1.1X Host: Content-Type: text/xml Content-Length: <whatever> SOAPMethodName: <some-uri>#currenttemp Http Header Soap Extensions <SOAP:Envelope xmlns:soap="urn:schemas-xmlsoaporg:soap.v1"> <SOAP:Body> </SOAP:BODY> <SOAP:Envelope> <m:currenttemp xmlns:m="some-uri"> <zip_code>37919</zip_code> <m:currenttemp> Sem header Xml Payload argumento Programação com Objetos Distribuídos (C. Geyer) Web Services 32

33 HTTP/ OK Content-Type: text/xml Content-Length: <whatever> Http Header Com header <SOAP:Envelope xmlns:soap="urn:schemas-xmlsoap-org:soap.v1"> <SOAP:Header> <t:transaction xmlns:t="some-uri"> 5 </t:transaction> </SOAP:Header> <SOAP:Body> Xml Payload <m:currenttempresponse xmlns:m="some-uri"> <return>42</return> </m:currenttempresponse> </SOAP:Body> </SOAP:Envelope> resposta Programação com Objetos Distribuídos (C. Geyer) Web Services 33

34 Estrutura XML das mensagens SOAP inicialmente complexa como exemplos anteriores eliminando as informações de namespace como <SOAP:Envelope xmlns:soap="urn:schemas-xmlsoaporg:soap.v1"> o resto é simples e legível (?) Ao menos mais do que formato Java/RMI, Corba/IIOP,... Programação com Objetos Distribuídos (C. Geyer) Web Services 34

35 Implementação Apache Axis para Java baseada em implementação anterior Apache SOAP conjunto de bibliotecas clientes bibliotecas para o servidor servlet para processamento das chamadas Classe servidora ferramentas auxiliares para utilização de Web Services Programação com Objetos Distribuídos (C. Geyer) Web Services 35

36 Implementação Apache programa cliente usa as suas bibliotecas para empacotar a chamada (request) Diferentes níveis de abstração dependendo da abordagem utilizada servidor decodifica a chamada chama o método do objeto servidor e empacota o resultado para o cliente obs: tudo isto de forma transparente para o programador Programação com Objetos Distribuídos (C. Geyer) Web Services 36

37 Exemplo Hello especificação cliente realiza uma chamada SOAP a uma operação de um servidor Hello servidor Interface: 2 (duas) operações responde à chamada de saudação recebe nova saudação Programação com Objetos Distribuídos (C. Geyer) Web Services 37

38 Exemplo Hello codificação do cliente duas aproximações criar chamada manualmente parte mais complexa uso de vários métodos do pacote SOAP criação da chamada inclusão de cada argumento da chamada utilizar o arquivo WSDL (se disponível) WSDL: descrição (opcional) de um WS em xml aproximação estática (geração de Stubs) ou dinâmica chamada similar à de um método local Programação com Objetos Distribuídos (C. Geyer) Web Services 38

39 Exemplo Hello código do cliente codificação manual trabalhosa import java.io.*; import java.net.*; import java.util.*; import org.w3c.dom.*; import org.apache.soap.*; import org.apache.soap.encoding.*; import org.apache.soap.encoding.soapenc.*; import org.apache.soap.rpc.*; import org.apache.soap.util.xml.*; Programação com Objetos Distribuídos (C. Geyer) Web Services 39

40 public class GetHello { public static void main(string[] args) throws Exception { // The URL for the SOAP servlet (servidor WS) URL url = new URL(" rpcrouter"); // Create a new call Call call = new Call(); // Tell SOAP which object you want (qual serviço) call.settargetobjecturi("urn:helloapp"); // Tell SOAP which method to invoke call.setmethodname("gethello"); Programação com Objetos Distribuídos (C. Geyer) Web Services 40

41 // Tell SOAP to use the regular SOAP encoding style call.setencodingstyleuri (Constants.NS_URI_SOAP_ENC); // Create a vector to hold the method parameters Vector params = new Vector(); // Add a string parameter called extra1 with a value of "Hello info // Specify null for the encoding style params.addelement(new Parameter("extra1", String.class, "Hello info", null)); Programação com Objetos Distribuídos (C. Geyer) Web Services 41

42 // Add an int parameter called extra2 with a value of 123 // Specify null for the encoding style params.addelement(new Parameter("extra2", Integer.class, new Integer(123), null)); // Store the parameters in the request call.setparams(params); // Prepara uma variável para a resposta Response resp = null; Programação com Objetos Distribuídos (C. Geyer) Web Services 42

43 // Invoke the call method try { resp = call.invoke(url, ""); } catch (SOAPException e) { e.printstacktrace(); System.exit(0); } Programação com Objetos Distribuídos (C. Geyer) Web Services 43

44 // See if the response contains an error if (!resp.generatedfault()) { // If not, get the return value Parameter ret = resp.getreturnvalue(); // Expect it to be a string String value = (String) ret.getvalue(); } System.out.println(value); Programação com Objetos Distribuídos (C. Geyer) Web Services 44

45 else { Fault fault = resp.getfault(); System.err.println("Generated fault: "); System.out.println (" Fault Code = " + fault.getfaultcode()); System.out.println (" Fault String = " + fault.getfaultstring()); } } } Programação com Objetos Distribuídos (C. Geyer) Web Services 45

46 Código do cliente geração de Stubs Outra alternativa para codificação Axis gera automaticamente classes para acessar o Web Service baseados em SOAP/WSDL A partir dessas classes, o desenvolvedor necessita apenas instanciá-las para executar a operação desejada Hello WSDL Hello Service.java Hello Port.java Arquivo WSDL Axis WSDL2Java Hello Service Locator.java Hello BindingStub.java Stubs Gerados Programação com Objetos Distribuídos (C. Geyer) Web Services 46

47 Código do cliente geração de Stubs import HelloServiceLocator; import HelloService; import HelloPort; import HelloBindingStub; public class GetHello { public static void main(string[] args) throws Exception { // localize the service; uso de métodos das classes geradas HelloService locator = new HelloServiceLocator(); HelloPort port = locator.gethelloport(); } } //execute the remote method String result = port.gethello( Hello Info, new Integer(123)); System.out.println(result); Programação com Objetos Distribuídos (C. Geyer) Web Services 47

48 Exemplo Hello código do servidor // standard Java public class SoapHello { protected String hellostring; public SoapHello() { hellostring = "Hello!"; } Programação com Objetos Distribuídos (C. Geyer) Web Services 48

49 public String gethello(string extra1, int extra2) { return hellostring+" "+extra1+" "+extra2; } } public void sethello(string newhello) { hellostring = newhello; } Programação com Objetos Distribuídos (C. Geyer) Web Services 49

50 Publicando o servidor utilizando Apache Axis Duas formas principais Salvar código do servidor na pasta raiz do Axis com a extensão.jws instalação instantânea Extremamente simples; Necessita do código fonte (e não o binário); Web service é gerado no instante em que o cliente o acessa: baixo desempenho; Utilizar um arquivo de configuração WSDD (Web Service Deployment Descriptor) Mais complicado; Resolve os problemas da alternativa anterior; Programação com Objetos Distribuídos (C. Geyer) Web Services 50

51 Programação com Objetos Distribuídos (C. Geyer) Web Services 51

52 Protocolo de transporte SOAP qualquer um (preferência para HTTP) XML-RPC somente HTTP Tipos extensível utilizando XML Schema restritos a um conjunto básico Ordem de parâmetros indiferente importante Complexidade complicado simples SOAP tem várias vantagens; mas é mais complexo Programação com Objetos Distribuídos (C. Geyer) Web Services 52

53 Pacote da Sun para Web Services Obs.: em 2006 nome: JWSDP - Java Web Services Developer Pack 1.2 link agora: previous/webservicespack.jsp anteriormente: webservicespack.html em transição para projeto GlassFish: Programação com Objetos Distribuídos (C. Geyer) Web Services 53

54 Pacote da Sun para Web Services conteúdo (obs. Versão 1.2): JavaServer Faces (JSF) v1.0 EA4 XML and Web Services Security (xws-security) v1.0 EA Java Architecture for XML Binding (JAXB) v1.0.1 Java API for XML Processing (JAXP) v1.2.3 Java API for XML Registries (JAXR) v1.0.4 Java API for XML-based RPC (JAX-RPC) v1.1 EA SOAP with Attachments API for Java (SAAJ) v1.2 EA JavaServer Pages Standard Tag Library (JSTL) v1.1 EA Java WSDP Registry Server v1.0_05 Ant Build Tool Apache Tomcat v5 development container Programação com Objetos Distribuídos (C. Geyer) Web Services 54

55 Pacote Sun Web Services pacote testado com plataformas Sun Solaris Operating Environment 8 and 9 Windows 2000 Professional Edition Windows XP Professional Edition RedHat Linux 8.0 ambiente Java Java 2 SDK, Standard Edition version 1.4.1_02 plataforma de desenvolvimento e execução Sun recomenda Sun ONE Studio 4 and Sun ONE Application Server 7. Programação com Objetos Distribuídos (C. Geyer) Web Services 55

56 WS no J2EE WS no J2EE Tecnologias incluídas JAX-WS Java API para XML Web Services JAX-RS Conceito WS Java API para RESTFul Web Services São aplicações cliente / servidor Comunicando sobre o protocolo HTTP Programação com Objetos Distribuídos (C. Geyer) Web Services 56

57 WS no J2EE WS no J2EE Características Interoperabilidade via padrões Portabilidade sobre diversas plataformas e frameworks Extensíveis Descrições processáveis graças a XML Combináveis de forma leve para obter operações complexas Tipos Big WS RESTFul WS Programação com Objetos Distribuídos (C. Geyer) Web Services 57

58 WS no J2EE WS no J2EE Big WS Uso de XML e SOAP Descrição dos serviços em WSDL (linguagem em XML) opcional Adotado por diversas ferramentas como NetBeans IDE Programação com Objetos Distribuídos (C. Geyer) Web Services 58

59 WS no J2EE WS no J2EE Big WS Elementos principais Contrato formal Descreve a interface Mensagens, operações, localização do WS, ligações Arquitetura Tratar diversos requisitos complexos não funcionais Transações, segurança, endereçamento, confiança, cordenação,... Processamento e chamada assíncronos Programação com Objetos Distribuídos (C. Geyer) Web Services 59

60 WS no J2EE WS no J2EE RESTFul Representational State Transfer Apropriado para cenários básicos e ad doc Melhor integração com HTTP que serviços SOAP Não exigem mensagens XML nem WSDL Uso do projeto Jersey Segue padrão: JSR 311 JAX-RS Permite anotações Mais funcionalidades extra JSR 311 Mais leves Exigem poucas ferramentas Também integrado no NetBeans IDE Programação com Objetos Distribuídos (C. Geyer) Web Services 60

61 WS no J2EE WS no J2EE RESTFul Usos reais Muitos sites de blogs Download de arquivos XMl em formato RSS com listas de links Twitter Amazon Simple Storage Service (S3) Programação com Objetos Distribuídos (C. Geyer) Web Services 61

62 WS no J2EE WS no J2EE RESTFul Apropriado em/se WS sem estado Teste: interação sobrevive a queda / colocar-no-ar do servidor (restart) Infra-estrutura de cache pode ser mais simples Quando dados de retorno são estáticos Técnicas de cache do servidor web mais simples Cuidado: em geral limitado a método GET do HTTP Programação com Objetos Distribuídos (C. Geyer) Web Services 62

63 WS no J2EE WS no J2EE RESTFul Apropriado em/se Contrato liente (consumidor) e serviço (produtor) em formato ad hoc Sobre contexto e conteúdo Muitos serviços distribuem toolkits com Descrição de interfaces em linguagens populares Quando banda é limitada Por exemplo para PDAs e smartphones SOAP é pesado Programação com Objetos Distribuídos (C. Geyer) Web Services 63

64 WS no J2EE WS no J2EE RESTFul Apropriado em/se Agregação de serviços é simples Via uso de tecnologias como JAX-RS AJAX: Asynchronous JavaScript com XML Toolkits como DWR (Direct Web Remoting) Serviços já existentes podem ser expostos via páginas HTML sem muito esforço Desenvolvimento mais produtivo Não é uma nova tecnologia Programação com Objetos Distribuídos (C. Geyer) Web Services 64

65 WS no J2EE WS no J2EE Big WS x RESTFul Usar JAX-WS quando Aplicação necessita de vários requisitos de QoS Usualmente em aplicações coorporativas Mais fácil o uso de padrões de segurança e confiabilidade Melhor interoperabilidade com outros WS Programação com Objetos Distribuídos (C. Geyer) Web Services 65

66 WS no J2EE WS no J2EE Big WS x RESTFul Usar JAX-RS quando Desenvolvimento mais simples Acoplamento reduzido Mais fácil o consumo (clientes) Facilita manutenção (extensão da app) e escalabilidade Cliente pode consumir parte do serviço e combiná-lo como outros serviços (mash-up) Artigo Pautasso, C. et al. RESTFul Web Services vs. Big Web Services: Making the Right Architectural Decision. WWW 08, pp Programação com Objetos Distribuídos (C. Geyer) Web Services 66

67 WS no J2EE WS no J2EE Desenvolvendo com JAX-WS Características Complexidade do SOAP escondida via APIs do JAX-WS Lado servidor Operações definidas por métodos em interface Java Implementação via classe(s) que implementam os métodos da interface Lado cliente Cria um proxy Objeto local que representa o serviço Chama métodos do proxy Não é necessário gerar ou examinar mensagens SOAP Programação com Objetos Distribuídos (C. Geyer) Web Services 67

68 WS no J2EE WS no J2EE Desenvolvendo com JAX-WS Características Portabilidade de Java Independência de plataforma Interoperabilidade entre plataformas Cliente JAX-WS pode acessar WS não Java Cliente não Java pode acessar serviço JAX-WS Óbvio... (?) Devido JAX-WS seguir padrões do W3C para WS Programação com Objetos Distribuídos (C. Geyer) Web Services 68

69 WS no J2EE WS no J2EE Desenvolvendo com JAX-WS Porta do servidor Diversos arquivos referenciam a porta do servidor Padrão é 8080 Pode ser alterada Programação com Objetos Distribuídos (C. Geyer) Web Services 69

70 WS no J2EE WS no J2EE Desenvolvendo com JAX-WS Exemplo Hello Serviço Classe Java anotada Classe passa a ser um SEI SEI Service Endpoint Interface ou Service Endpoint Implementation A interface não é obrigatória Se interface Indicada por argumento endpointinterface na Programação com Objetos Distribuídos (C. Geyer) Web Services 70

71 WS no J2EE WS no J2EE Desenvolvendo com JAX-WS Exemplo Hello Serviço Ferramenta (wsgen) gera todos os artefatos Em uso Via o Enterprise Server (container) Passos Codificação da classe Compilação da classe Criação dos artefatos (wsgen) Empacotamento em arquivo WAR Instalação (deploy) do WAR no servidor Programação com Objetos Distribuídos (C. Geyer) Web Services 71

72 WS no J2EE WS no J2EE Desenvolvendo com JAX-WS Exemplo Hello Servidor Requisitos Anotar classe ou interface (se houver) Métodos da classe devem ser Públicos Não static nem final Métodos do WS Anotados Programação com Objetos Distribuídos (C. Geyer) Web Services 72

73 WS no J2EE WS no J2EE Desenvolvendo com JAX-WS Exemplo Hello Servidor Código package helloservice.endpoint; import public class Hello { private String message = new String("Hello, "); public void Hello() {} public String sayhello(string name) { return message + name + "."; } Programação com Objetos Distribuídos (C. Geyer) Web Services 73

74 WS no J2EE WS no J2EE Desenvolvendo com JAX-WS Exemplo Hello Servidor Teste sem cliente Após WS instalado (no container do J2EE) Entrar com URL (local) do serviço mais função de teste?tester Na página de teste (resposta) entrar com argumentos (se for o caso) e clicar no método Será mostrada a resposta do método Programação com Objetos Distribuídos (C. Geyer) Web Services 74

75 WS no J2EE WS no J2EE Desenvolvendo com JAX-WS Exemplo Hello / Cliente Instanciar a classe gerada helloservice.endpoint.helloservice Ela representa o serviço na URI indicada no arquivo WSDL instalado HelloService service = new HelloService(); Recuperar um proxy ao serviço Também conhecido como port Chamando o método gethelloport do serviço Hello port = service.gethelloport(); Chamar o método de negócio via proxy String response = port.sayhello(name); Programação com Objetos Distribuídos (C. Geyer) Web Services 75

76 WS no J2EE WS no J2EE Desenvolvendo com JAX-WS Exemplo Hello / Cliente Código completo O exemplo completo é um pouco mais complexo Mas o adicional não é exigido pelo JAX-WS Puro Java Programação com Objetos Distribuídos (C. Geyer) Web Services 76

77 J2EE / RESTFul conceitos Programação com Objetos Distribuídos (C. Geyer) Web Services 77

78 RESTFul RESTful WS Serviços desenvolvidos para funcionar melhor na web Melhor? Escalabilidade REST Desempenho Capacidade de modificação REpresentational State Transfer Recurso Combinação de dados e funcionalidades Programação com Objetos Distribuídos (C. Geyer) Web Services 78

79 RESTFul RESTful WS Identificação por URI Endereço global Protocolo de comunicação sem estado Por exemplo, HTTP Uso de interface uniforme Programação com Objetos Distribuídos (C. Geyer) Web Services 79

80 J2EE / RESTful RESTful Objetivos Aplicações RESTful devem ser Simples Leves Alto desempenho Interface (uniforme) 4 operações PUT: cria um novo recurso DELETE: recurso (criado) é excluído GET: recupera o estado de um recurso POST: atualiza o estado de um recurso Programação com Objetos Distribuídos (C. Geyer) Web Services 80

81 J2EE / RESTful RESTful Mensagens auto-descritas Recursos são independentes da sua representação Recursos podem ser acessados de diferentes formas como HTML, XML, texto, PDF, JPEG, JSON e outras Metadados sobre o recurso usados para Controlar cache Detectar erros de transmissão Negociar forma de representação Realizar autenticação Controlar acesso Programação com Objetos Distribuídos (C. Geyer) Web Services 81

82 J2EE / RESTful RESTful Interações com estado Cada interação com um recurso é sem estado Mensagens são auto-contidas Interações com estado via conceito de transferência explícita de estado Via técnicas como Reescrita de URI Cookies Campos escondidos de form Técnicas não aprofundadas no tutorial Java EE Programação com Objetos Distribuídos (C. Geyer) Web Services 82

83 J2EE / RESTful RESTful Jersey implementação Segue padrão JSR 311: JAX-RS Suporte a anotações Documentação em: A documentação teria que ser instalada (?) no Enterprise server v3 Programação com Objetos Distribuídos (C. Geyer) Web Services 83

84 J2EE/RESTful RESTful Classes de recurso raiz Anotadas Ou ao menos um método anotado ou com designador de método @POST Métodos de recursos Métodos com o designador de requisição Programação com Objetos Distribuídos (C. Geyer) Web Services 84

85 J2EE/RESTful RESTFul JAX-RS API Java API para facilitar o desenvolvimento de aplicações com RSET Uso de anotações, específicas para HTTP Anotações são resolvidas durante execução (runtime) Uso de reflexão para gerar classes auxiliares e outros artefatos para o recurso Classes e artefatos agrupados em arquivo WAR (web) WAR deve ser instalado em container J2EE ou web Programação com Objetos Distribuídos (C. Geyer) Web Services 85

86 J2EE/RESTful RESTful Principais Caminho relativo de URI Indica onde a classe Java será instalada Pode ser adicionada com variáveis para definir modelos (templates) Exemplos /helloworld Com controle de usuário/senha /helloworld{username} Programação com Objetos Distribuídos (C. Geyer) Web Services 86

87 RESTful J2EE/RESTful Principais devem processar requisições HTTP devem processar requisições HTTP Métodos Métodos Programação com Objetos Distribuídos (C. Geyer) Web Services 87

88 RESTful J2EE/RESTful Principais Tipo de parâmetro que pode ser extraído para uso na classe (em métodos por exemplo) Extraído da URI requisitada Nomes de parâmetros definidos Tipo de parâmetro que pode ser extraído para uso na classe Extraído da URI requisitada Programação com Objetos Distribuídos (C. Geyer) Web Services 88