Taller de Sistemas de Información 2

Transcripción

1 Taller de Sistemas de Información 2 Web Services 11 de Setiembre de 2012 Instituto de Computación Facultad de Ingeniería Universidad de la República de Uruguay

2 Instituto de Computación Facultad de Ingeniería UdelaR Montevideo, Uruguay 2

3 Que es un web service? Es un servicio o funcionalidad Se encuentra disponible a través de Internet o una Intranet Usando una forma estandarizada de mensajería (generalmente XML) No se encuentra atado a ningún sistema operativo ni ningún lenguaje de programación Se puede auto describir (generalmente vía XML) Puede ser descubierto a través de un mecanismo de búsqueda Instituto de Computación Facultad de Ingeniería UdelaR Montevideo, Uruguay 3

4 Tendencias Hoy día tenemos dos grandes tendencias en el desarrollo de web services Web services que estandarizan su información a través de mensajes XML, en formato SOAP. Estos se denominan servicios SOAP Web services que no estandarizan su información, denominados servicios REST Instituto de Computación Facultad de Ingeniería UdelaR Montevideo, Uruguay 4

5 Web Services SOAP Este tipo de servicios, implica el intercambio de mensajes XML, codificados según el protocolo SOAP Estos mensajes tienen la forma: Instituto de Computación Facultad de Ingeniería UdelaR Montevideo, Uruguay 5

6 Web Services SOAP Estos mensajes en formato SOAP son movidos de un sistema a otro, utilizando HTTP El sistema recibe el mensaje, hace lo que tiene que hacer, y devuelve una respuesta también en formato SOAP Es un sistema simple, que no tiene en cuenta aspectos importantes del desarrollo de soluciones empresariales, pero que son tenidas en cuenta a través de extensiones a los estándares Instituto de Computación Facultad de Ingeniería UdelaR Montevideo, Uruguay 6

7 Especificaciones Los servicios web utilizan diferentes especificaciones para estandarizar su funcionamiento Estas se dividen en dos tipos Especificaciones básicas Especificaciones avanzadas, de las cuales algunas se destacan por su utilidad para la construcción de soluciones de integración Instituto de Computación Facultad de Ingeniería UdelaR Montevideo, Uruguay 7

8 Especificaciones basicas Universal Description, Discovery and Integration (UDDI) Web Services Description Language (WSDL) Find Publish WSDL FTP, SMTP, etc. HTTP SOAP Simple Object Access Protocol (SOAP) Instituto de Computación Facultad de Ingeniería UdelaR Montevideo, Uruguay 8

9 Instituto de Computación Facultad de Ingeniería UdelaR Montevideo, Uruguay 9

10 Instituto de Computación Facultad de Ingeniería UdelaR Montevideo, Uruguay 10

11 Instituto de Computación Facultad de Ingeniería UdelaR Montevideo, Uruguay 11

12 Mensajes SOAP La estructura básica de un mensaje SOAP consiste de un elemento Envelope el cual contiene un elemento opcional Header un elemento requerido Body que puede incluir un elemento Fault El Envelope es el elemento raíz de todo mensaje SOAP e identifica un documento XML como un mensaje SOAP Instituto de Computación Facultad de Ingeniería UdelaR Montevideo, Uruguay 12

13 Mensaje SOAP <?xml version="1.0"?> <soap:envelope xmlns:soap=" soap:encodingstyle=" <soap:header>... </soap:header> <soap:body>... </soap:body> </soap:envelope> <soap:fault>... </soap:fault> Instituto de Computación Facultad de Ingeniería UdelaR Montevideo, Uruguay 13

14 Mensaje SOAP Body <soap:body> <t:translate xmlns:t=" <t:word>red</t:word> </t:translate> </soap:body> <soap:body> <t:translateresponse xmlns:t=" <t:translation>rojo</t:translation> </t:translateresponse> </soap:body> solicitud resultado Instituto de Computación Facultad de Ingeniería UdelaR Montevideo, Uruguay 14

15 Transporte de mensajes SOAP no impone el uso de un determinado protocolo para el intercambio de mensajes A través del concepto de binding SOAP permite especificar: cómo los mensajes SOAP se encapsulan en un protocolo de transporte cómo los mensajes SOAP deben ser tratados con las primitivas del protocolo Instituto de Computación Facultad de Ingeniería UdelaR Montevideo, Uruguay 15

16 Instituto de Computación Facultad de Ingeniería UdelaR Montevideo, Uruguay 16

17 WSDL Web Services Description Language Lenguaje basado en XML que permite describir la interfaz y otras características de un Web Service Un documento WSDL puede dividirse en dos partes: descripción abstracta descripción concreta Instituto de Computación Facultad de Ingeniería UdelaR Montevideo, Uruguay 17

18 Instituto de Computación Facultad de Ingeniería UdelaR Montevideo, Uruguay 18

19 Estandares avanzados Instituto de Computación Facultad de Ingeniería UdelaR Montevideo, Uruguay 19

20 Profiles Basic Profile (BP) Guías para el desarrollo de WS interoperables utilizando las especificaciones centrales Basic Security Profile (BSP) Extiende el BP definiendo guías para el desarrollo de WS seguros Algunos ejemplos: Prohíbe el uso de SSL 2.0 Restringe cantidad de timestamps en header a 1 Prohíbe encriptar los elementos body, header y envelope Instituto de Computación Facultad de Ingeniería UdelaR Montevideo, Uruguay 20

21 Plataformas para web services Las plataformas de Web Services son un conjunto de herramientas para un lenguaje de programación específico Permiten: invocar web services realizar el deploy de Web Services Las plataformas tienen en general componentes en el servidor y en el cliente Instituto de Computación Facultad de Ingeniería UdelaR Montevideo, Uruguay 21

22 Plataformas para web services Los componentes en el servidor se alojan usualmente en algún tipo de contenedor servidor Java EE contenedor de servlets Los componentes en el cliente se empaquetan en general como herramientas para acceder a interfaces asociadas a WS Instituto de Computación Facultad de Ingeniería UdelaR Montevideo, Uruguay 22

23 Plataformas para web services Las plataformas de Web Services proveen en general tres subsistemas: Invocación Serialización Deployment Instituto de Computación Facultad de Ingeniería UdelaR Montevideo, Uruguay 23

24 Subsistema de invocación (servidor) Recibir SOAPs desde el transporte (HTTP, etc) Invocar manejadores para QoS (seguridad, etc) Determinar la operación que se quiere invocar Determinar la clase/método que se quiere invocar Enviar el SOAP al sistema de serialización Invocar la clase-método Enviar el resultado al sistema de serialización Crear y enviar el mensaje SOAP al transporte para el envío de la respuesta Instituto de Computación Facultad de Ingeniería UdelaR Montevideo, Uruguay 24

25 Subsistema de invocación (cliente) Instanciar la clase que implementa la interfaz para acceder a WS y manejar su invocación Enviar parámetros al sistema de serialización Adjuntar los mismos en un mensaje SOAP Invocar manejadores para QoS Enviar el SOAP a través del trasporte (ej. HTTP) Recibir los SOAPs respuesta desde el transporte Enviar los SOAP al sistema de serialización y completar la invocación Instituto de Computación Facultad de Ingeniería UdelaR Montevideo, Uruguay 25

26 Subsistema de invocación Subsistema de Invocación (cliente) Subsistema de Invocación (servidor) Param Request Request Param Param SOAP SOAP Param Objeto Param Param Función Return Respons e SOAP Respons e SOAP Return Invocación de Métodos Intercambio de Mensajes SOAP Invocación de Métodos Instituto de Computación Facultad de Ingeniería UdelaR Montevideo, Uruguay 26

27 Subsistema de serialización Instituto de Computación Facultad de Ingeniería UdelaR Montevideo, Uruguay 27

28 Subsistema de deployment Provee herramientas para configurar un componente de software para que pueda ser invocado como un WS vía mensajes SOAP Desplegar el componente de SW Mapeo operaciones WSDL componente SW Configuración serialización (esquema params) Publicación del WSDL Configurar aspectos avanzados (seguridad, etc.) Configurar el listener en una dirección de red Instituto de Computación Facultad de Ingeniería UdelaR Montevideo, Uruguay 28

29 Algunas plataformas de WS Windows Communication Foundation Apache AXIS 2 Apache CXF Proyecto Metro JBoss Web Services Instituto de Computación Facultad de Ingeniería UdelaR Montevideo, Uruguay 29

30 Implementacion de WS Implementación Bottom-up Se comienza por el código (por ejemplo, una clase Java) Code-First / Contract-Last Implementación Top-down Se comienza por el WSDL Code-Last / Contract-First Instituto de Computación Facultad de Ingeniería UdelaR Montevideo, Uruguay 30

31 Bottom-Up Ventajas Forma rápida de exponer funcionalidades vía WS No requiere conocimiento de XMLSchema, WSDL Desventajas El esquema es embebido en el WSDL Los cambios en la interfaz son más difíciles de manejar En el WSDL hay dependencias con la implementación (paquetes y namespaces) Instituto de Computación Facultad de Ingeniería UdelaR Montevideo, Uruguay 31

32 Top-Down Ventajas Permite el desarrollo independiente y paralelo entre cliente y servicio Cuando se crean nuevos tipos, éstos pueden ser reutilizados por otros servicios No se generan dependencias con la implementación Desventajas Requiere conocimiento de XMLSchema y WSDL Instituto de Computación Facultad de Ingeniería UdelaR Montevideo, Uruguay 32

33 Web Services en JavaEE 6 La plataforma JavaEE 6, incluye soporte para web services, utilizando el protocolo SOAP, a traves del API JAX-WS Java API for XML Web Services La implementacion de referencia se denomina Metro, es desarrollada por Oracle y viene incluida dentro del servidor de aplicaciones GlassFish Instituto de Computación Facultad de Ingeniería UdelaR Montevideo, Uruguay 33

34 Web Services en JavaEE6 y JDK6 En el caso de Jboss, la implementacion de referencia viene incluida en el componente JBossWS, dentro del servidor de aplicaciones JBoss 6 A partir de la version 6 (update 4), la plataforma Java estandar (JDK), incluye las APIs para trabajar con JAX-WS y JAXB, fundamentales para el consumo de web services Instituto de Computación Facultad de Ingeniería UdelaR Montevideo, Uruguay 34

35 Definiendo un web service Instituto de Computación Facultad de Ingeniería UdelaR Montevideo, Uruguay 35

36 Definiendo un web service En el ejemplo anterior se intercambia un objeto CreditCard entre el consumidor y el proveedor del servicio Los datos intercambiados, deben ser un documento XML, por lo que se necesita un método para transformar el objeto Java en un documento XML y viceversa Para esto utilizamos JAXB, anotándolo Instituto de Computación Facultad de Ingeniería UdelaR Montevideo, Uruguay 36

37 Definiendo un web service Instituto de Computación Facultad de Ingeniería UdelaR Montevideo, Uruguay 37

38 Invocando un web service Un ejemplo de posible cliente... Instituto de Computación Facultad de Ingeniería UdelaR Montevideo, Uruguay 38

39 JAXB Si bien el intercambio de información entre el consumidor y proveedor se hace en base a XML, el codigo Java no tiene porque interactuar con esto directamente JAXB provee un estándar para trabajar con representaciones Java de documentos XML y viceversa Instituto de Computación Facultad de Ingeniería UdelaR Montevideo, Uruguay 39

40 La clase CreditCard Instituto de Computación Facultad de Ingeniería UdelaR Montevideo, Uruguay 40

41 El documento XML Instituto de Computación Facultad de Ingeniería UdelaR Montevideo, Uruguay 41

42 El schema XML Instituto de Computación Facultad de Ingeniería UdelaR Montevideo, Uruguay 42

43 Binding Instituto de Computación Facultad de Ingeniería UdelaR Montevideo, Uruguay 43

44 Marshalling/Unmarshalling Instituto de Computación Facultad de Ingeniería UdelaR Montevideo, Uruguay 44

45 Anotaciones JAXB es similar a JPA, salvo que la persistencia se realiza contra un documento XML, en vez de una tabla de la base de datos El mapping al documento puede ser customizado utilizando las anotaciones en el paquete javax.xml.bind.annotation El equivalente en JAXB, se Instituto de Computación Facultad de Ingeniería UdelaR Montevideo, Uruguay 45

46 Anotaciones Instituto de Computación Facultad de Ingeniería UdelaR Montevideo, Uruguay 46

47 El esquema asociado... Instituto de Computación Facultad de Ingeniería UdelaR Montevideo, Uruguay 47

48 El documento obtenido Instituto de Computación Facultad de Ingeniería UdelaR Montevideo, Uruguay 48

49 Instituto de Computación Facultad de Ingeniería UdelaR Montevideo, Uruguay 49

50 Web Services / Funcionamiento Si bien el programador Java no debe preocuparse del manejo de los protocolos de bajo nivel en web services, es conveniente conocer que esta sucediendo por detras... Instituto de Computación Facultad de Ingeniería UdelaR Montevideo, Uruguay 50

51 JAX-WS Como la mayoría de los componentes Java EE, los web services utilizan el esquema de configuración por excepción Solo necesitamos una anotación para transformar un POJO en un web Como en el caso de los EJBs, hay una serie de requerimientos a la hora de escribir un servicio... Instituto de Computación Facultad de Ingeniería UdelaR Montevideo, Uruguay 51

52 JAX-WS La clase debe estar anotada Si el web service es implementado con un EJB, entonces este solo puede ser stateless La clase debe ser publica, y no puede ser final ni abstract La clase debe tener un constructor por defecto La clase no debe definir el método finalize El servicio debe ser stateless Instituto de Computación Facultad de Ingeniería UdelaR Montevideo, Uruguay 52

53 JAX-WS Basta con que un POJO cumpla con los requisitos anteriores, para que pueda ser desplegado en un servlet container Esto se conoce como servlet endpoint Análogamente, un Stateless EJB puede ser utilizado como clase de implementación del servicio Esto se conoce como EJB endpoint Instituto de Computación Facultad de Ingeniería UdelaR Montevideo, Uruguay 53

54 @WebService Esta anotación marca una clase o interfaz como un web service Si se aplica directamente sobre la clase y no la interfaz, entonces el container generara la interfaz a partir de los métodos públicos Instituto de Computación Facultad de Ingeniería UdelaR Montevideo, Uruguay 54

55 @WebMethod Por defecto, todos los métodos públicos del web service (o de su interfaz) son incluidos dentro de lo que se expone al exterior Para customizar la forma en como se hace esto (por ejemplo para cambiar el nombre del método), usamos la aplicada sobre el método a modificar Por ejemplo... Instituto de Computación Facultad de Ingeniería UdelaR Montevideo, Uruguay 55

56 @WebMethod Instituto de Computación Facultad de Ingeniería UdelaR Montevideo, Uruguay 56

57 @WebResult Opera en conjunto con la anotación anterior Permite customizar el nombre del mensaje devuelto como resultado de la operación Instituto de Computación Facultad de Ingeniería UdelaR Montevideo, Uruguay 57

58 @WebParam Permite customizar los parámetros que son enviados al servicio Podemos cambiar el nombre y el tipo de parámetro (IN, OUT, INOUT) Instituto de Computación Facultad de Ingeniería UdelaR Montevideo, Uruguay 58

59 @OneWay Es una anotación que permite indicar que un método, no retorna valores Por ejemplo, los métodos que retornan void Esto permite que el container realice optimizaciones con los métodos de este tipo, por ejemplo, usando Asynchronous (solo en EJB) Instituto de Computación Facultad de Ingeniería UdelaR Montevideo, Uruguay 59

60 Ciclo de vida El ciclo de vida de los web services es similar al de los stateless session beans No mantienen ningún estado, simplemente existen o no existen Como en el caso de los stateless, podemos usar las En el caso de un web service implementado como EJB, se pueden utilizar interceptors Instituto de Computación Facultad de Ingeniería UdelaR Montevideo, Uruguay 60

61 Ciclo de vida Instituto de Computación Facultad de Ingeniería UdelaR Montevideo, Uruguay 61

62 Web Service Context Como en el caso de los EJBs, el web service tiene un contexto que permite obtener información útil del ambiente de ejecución del servicio Se inyecta como en el caso de los EJB, Instituto de Computación Facultad de Ingeniería UdelaR Montevideo, Uruguay 62

63 Web Service Context GetMessageContext Permite acceder al mensaje SOAP, por ejemplo para obtener los headers GetUserPrincipal Identifica a traves del Principal al emisor del mensaje IsUserInRole Determina si un usuario autenticado esta presente en un rol determinado Instituto de Computación Facultad de Ingeniería UdelaR Montevideo, Uruguay 63

64 Invocando un web service Instituto de Computación Facultad de Ingeniería UdelaR Montevideo, Uruguay 64

65 Invocando un web service Usando herramientas que generen stubs y clases Java a partir del WSDL, podemos invocar un servicio web El JDK provee una herramienta, denominada wsimport que genera las clases necesarias para poder realizar la invocación a un determinado web service del que conocemos su wsdl Las interfaces generadas se denominan SEI (Service Endpoint Interfaces) Instituto de Computación Facultad de Ingeniería UdelaR Montevideo, Uruguay 65

66 Invocando un web service Las interfaces y artefactos generados, deben ser colocados en el proyecto que realizara el consumo del servicio web Una vez colocados los artefactos (.java) generados, podemos hacer la invocacion de esta forma: Instituto de Computación Facultad de Ingeniería UdelaR Montevideo, Uruguay 66

67 Generando los artefactos Usamos la herramienta wsimport Por ejemplo, en el practico tenemos este ejemplo: wsimport -keep -d../src viceimpl/calculadoraserviceimpl?wsdl keep permite mantener el codigo fuente generado -d../src es la ruta donde se almacena dicho codigo Instituto de Computación Facultad de Ingeniería UdelaR Montevideo, Uruguay 67

68 @WebServiceRef Permite inyectar una referencia a un servicio web, indicando la localizacion del WSDL del servicio Por 080/app/CalculatorService?WSDL") private CalculatorService service; Solo puede ser utilizado en componentes managed (managed beans, ejbs, etc) Instituto de Computación Facultad de Ingeniería UdelaR Montevideo, Uruguay 68

69 REST La motivación para desarrollar REST fue la de crear un modelo arquitectónico de como tiene que funcionar la web, de forma que sirva de guía para los protocolos de la web REST ha sido usado para describir la arquitectura de la web, identificar problemas existentes, comparar soluciones alternativas, y asegurarse que las extensiones a los protocolos no violan las restricciones centrales que hace a la web exitosa Instituto de Computación Facultad de Ingeniería UdelaR Montevideo, Uruguay 69

70 REST Representational State Transfer Es un estilo arquitectónico para la construcción de software REST fue desarrollado junto con el protocolo HTTP/1.1, el cual se adhiere a REST Instituto de Computación Facultad de Ingeniería UdelaR Montevideo, Uruguay 70

71 Conceptos La arquitectura esta compuesta por clientes y servidores Requests y Responses Los Requests y Responses son construidos en base a la idea de transferir representaciones de recursos Los clientes contienen representaciones Los servidores contienen los recursos en si Instituto de Computación Facultad de Ingeniería UdelaR Montevideo, Uruguay 71

72 Conceptos Instituto de Computación Facultad de Ingeniería UdelaR Montevideo, Uruguay 72

73 Conceptos Instituto de Computación Facultad de Ingeniería UdelaR Montevideo, Uruguay 73

74 ROA REST es un estilo arquitectónico Una arquitectura que se adhiere a este estilo, es ROA: Resource Oriented Architecture Existen otras que pueden (en parte) también adherirse a este estilo de trabajo Instituto de Computación Facultad de Ingeniería UdelaR Montevideo, Uruguay 74

75 Ejemplos de ROA Las URLs apuntan a recursos (sustantivos) Métodos universales para manejar los recursos GET, POST, PUT, DELETE No se maneja estado en el servidor Se hace uso de cache Instituto de Computación Facultad de Ingeniería UdelaR Montevideo, Uruguay 75

76 Definimos REST en base a... Recursos y URIs Representaciones Interfaces uniformes HATEOAS Instituto de Computación Facultad de Ingeniería UdelaR Montevideo, Uruguay 76

77 ... pero NO en base a... Schemas (XSD) Lenguajes de descripción Generación de código Registros Instituto de Computación Facultad de Ingeniería UdelaR Montevideo, Uruguay 77

78 REST/HTTP: Recursos Algo, una cosa con identidad Una persona, un perfil de Facebook, un usuario en Twitter, una direccion, una imagen, un video en Youtube Los recursos se nombran con URIs Las URIs son estables (no cambian tan seguido) Instituto de Computación Facultad de Ingeniería UdelaR Montevideo, Uruguay 78

79 REST/HTTP: Recursos Podemos pensar que la URI es la PK del recurso Instituto de Computación Facultad de Ingeniería UdelaR Montevideo, Uruguay 79

80 URI Generalmente son opacas Lo importante es que los clientes no tengan que parsearla y entenderla Sin embargo, son opacas para las aplicaciones cliente, pero no para los desarrolladores de clientes Una buena forma de organizar los recursos, es usar un enfoque jerárquico Instituto de Computación Facultad de Ingeniería UdelaR Montevideo, Uruguay 80

81 Representaciones Son los elementos que se envían dentro de un request, y que se reciben en un response Por ejemplo: Instituto de Computación Facultad de Ingeniería UdelaR Montevideo, Uruguay 81

82 Media Types (MIME Types) Son el equivalente a la clase de un objeto, o el schema de un documento XML Instituto de Computación Facultad de Ingeniería UdelaR Montevideo, Uruguay 82

83 Negociacion Las representaciones son negociables Instituto de Computación Facultad de Ingeniería UdelaR Montevideo, Uruguay 83

84 Negociacion La idea es no sobrecargar las URIs Le decimos a los intermediarios y clientes como vamos a aceptar una representación Instituto de Computación Facultad de Ingeniería UdelaR Montevideo, Uruguay 84

85 Interfaz uniforme Instituto de Computación Facultad de Ingeniería UdelaR Montevideo, Uruguay 85

86 Instituto de Computación Facultad de Ingeniería UdelaR Montevideo, Uruguay 86

87 Como se describen las APIs Instituto de Computación Facultad de Ingeniería UdelaR Montevideo, Uruguay 87

88 Un ejemplo: Una aplicación quiere transferir U$S1000 de una cuenta bancaria a la otra Que Recursos y URIs tendriamos? Instituto de Computación Facultad de Ingeniería UdelaR Montevideo, Uruguay 88

89 Un ejemplo Instituto de Computación Facultad de Ingeniería UdelaR Montevideo, Uruguay 89

90 Una transferencia... Instituto de Computación Facultad de Ingeniería UdelaR Montevideo, Uruguay 90

91 ... respuesta Instituto de Computación Facultad de Ingeniería UdelaR Montevideo, Uruguay 91

92 Status Instituto de Computación Facultad de Ingeniería UdelaR Montevideo, Uruguay 92

93 Es esto RESTful? En realidad, son nombres de recursos Instituto de Computación Facultad de Ingeniería UdelaR Montevideo, Uruguay 93

94 Es esto RESTful? A través de GET, queremos hacer una operación de modificación Debemos usar PUT Instituto de Computación Facultad de Ingeniería UdelaR Montevideo, Uruguay 94

95 Es esto RESTful? Estamos usando GET y POST como sinónimos, cuando no lo son Instituto de Computación Facultad de Ingeniería UdelaR Montevideo, Uruguay 95

96 Es esto RESTful? Estamos usando IDs internos de aplicación, cuando deberían utilizarse LINKS Instituto de Computación Facultad de Ingeniería UdelaR Montevideo, Uruguay 96

97 Es esto RESTful? Estamos escondiendo errores del intermediario o del cliente Debemos usar los códigos de error de HTTP 4xx o 5xx Instituto de Computación Facultad de Ingeniería UdelaR Montevideo, Uruguay 97

98 Web Service + REST Son web services desarrollados según la filosofía de REST El énfasis esta en el uso de una comunicación simple usando HTTP entre cliente y servidor, intercambiando POX (Plain Old Xml) También pueden intercambiarse otros formatos equivalente sencillos (JSON) Un ejemplo sencillo Instituto de Computación Facultad de Ingeniería UdelaR Montevideo, Uruguay 98

99 Web Service + REST Tenemos un servicio REST para obtener el valor de un stock en el mercado Este seria el REQUEST Instituto de Computación Facultad de Ingeniería UdelaR Montevideo, Uruguay 99

100 Web Service + REST Y esta seria la respuesta Instituto de Computación Facultad de Ingeniería UdelaR Montevideo, Uruguay 100

101 Comparación Sitios web, por el año 1992 Instituto de Computación Facultad de Ingeniería UdelaR Montevideo, Uruguay 101

102 Comparación Servicios web WS-*, desde el año 2000 Instituto de Computación Facultad de Ingeniería UdelaR Montevideo, Uruguay 102

103 Comparación Servicios web REST, desde el año 2006 Instituto de Computación Facultad de Ingeniería UdelaR Montevideo, Uruguay 103

104 Estandares Instituto de Computación Facultad de Ingeniería UdelaR Montevideo, Uruguay 104

105 Servicio Web SOAP Instituto de Computación Facultad de Ingeniería UdelaR Montevideo, Uruguay 105

106 Servicio web RESTful Instituto de Computación Facultad de Ingeniería UdelaR Montevideo, Uruguay 106

107 Protocolos en SOAP Instituto de Computación Facultad de Ingeniería UdelaR Montevideo, Uruguay 107

108 Protocolos en REST Instituto de Computación Facultad de Ingeniería UdelaR Montevideo, Uruguay 108

109 JAX-RS Para escribir un servicio web que utilice REST, solo se necesita un cliente y un servidor que soporte HTTP Como en el caso de SOAP, a fin de eliminar el trabajo con protocolos de bajo nivel, aparece el API JAX-RS La implementación de referencia de esta API, se denomina Jersey (es un proyecto open source) Instituto de Computación Facultad de Ingeniería UdelaR Montevideo, Uruguay 109

110 JAX-RS Instituto de Computación Facultad de Ingeniería UdelaR Montevideo, Uruguay 110

111 JAX-RS En el ejemplo anterior, el recurso BookResource esta publicado en la URI /book El método getbooktitle() queda asociado al método GET HTTP, produciendo un contenido de tipo text/plain Para acceder al recurso, solo debemos usar un browser con la dirección Instituto de Computación Facultad de Ingeniería UdelaR Montevideo, Uruguay 111

112 JAX-RS El servicio REST no implementa ninguna interfaz ni extiende ninguna clase Debemos usar la Si queremos usar un EJB, entonces solo podemos La clase debe ser public, y no abstract ni final Debe contener un constructor por defecto La clase no debe incluir el método finalize() Instituto de Computación Facultad de Ingeniería UdelaR Montevideo, Uruguay 112

113 Default Providers Instituto de Computación Facultad de Ingeniería UdelaR Montevideo, Uruguay 113

114 Interfaz de acceso al recurso JAX-RS define una serie de anotaciones, para indicar que método HTTP se utilizara para acceder a un recurso Estas anotaciones corresponden a los métodos Solo los métodos públicos de una clase pueden exponerse como métodos de recurso Instituto de Computación Facultad de Ingeniería UdelaR Montevideo, Uruguay 114

115 Interfaz CRUD Instituto de Computación Facultad de Ingeniería UdelaR Montevideo, Uruguay 115

116 Interfaz de acceso al recurso Cuando un método de recurso es invocado Los parámetros para los cuales hay un extractor, son cargados con dicho valor Los valores de parámetros no anotados, llamados entity parameters, es mapeado del cuerpo del request, a través de un entity provider Los métodos pueden devolver void, un tipo Java o un Response Response es usado cuando es necesario devolver mas información (metadatos) en la respuesta Instituto de Computación Facultad de Ingeniería UdelaR Montevideo, Uruguay 116

117 Información contextual Instituto de Computación Facultad de Ingeniería UdelaR Montevideo, Uruguay 117

118 Manejo de excepciones Instituto de Computación Facultad de Ingeniería UdelaR Montevideo, Uruguay 118

119 Ciclo de vida Instituto de Computación Facultad de Ingeniería UdelaR Montevideo, Uruguay 119

120 HelloWorld Creamos una web application Para exponer recursos REST, necesitamos una implementacion de REST Puede ser JAX-RS En el caso de JBoss, podemos usar RESTEasy Esta es una implementacion que ya viene incorporada en el servidor 6.0 Necesitamos que el web.xml sea version 3.0 Instituto de Computación Facultad de Ingeniería UdelaR Montevideo, Uruguay 120

121 HelloWorld <web-app version="3.0" xmlns=" xmlns:xsi=" xsi:schemalocation=" </web-app> Instituto de Computación Facultad de Ingeniería UdelaR Montevideo, Uruguay 121

122 HelloWorld Creamos una clase HelloWorldResource package ejemplos; import public class public String helloworld() { return "Hello World!"; } } Instituto de Computación Facultad de Ingeniería UdelaR Montevideo, Uruguay 122

123 HelloWorld Luego de creado el recurso, deployeamos y ejecutamos la aplicación web Accedemos al recurso, a través de la URL ello Deberíamos obtener Hello World!! Instituto de Computación Facultad de Ingeniería UdelaR Montevideo, Uruguay 123

124 PathParam Permite extraer pedazos de la URL package ejemplos; import public class public String helloworld(@pathparam("name") final String name) { return "Hi!, how are you " + name; } } Instituto de Computación Facultad de Ingeniería UdelaR Montevideo, Uruguay 124

125 PathParam Como antes, se deployea y ejecuta la aplicacion Debemos entrar a la URL: Deberíamos obtener: Hi!, how are you Pablo Instituto de Computación Facultad de Ingeniería UdelaR Montevideo, Uruguay 125

126 Intercambio de XML Podemos intercambiar objetos XML, tanto para el resultado como para los parametros Para esto debemos usar providers JAXB (idem SOAP), que se encarguen de mapear instancias en documentos XML Por ejemplo, vamos a intercambiar objetos Java, Items Instituto de Computación Facultad de Ingeniería UdelaR Montevideo, Uruguay 126

127 package public class Item { private String codigo; private int precio; public Item() { } public Item(String codigo, int precio) { this.codigo = codigo; this.precio = precio; } public String getcodigo() { return codigo; } public void setcodigo(string codigo) { this.codigo = codigo; } public int getprecio() { return precio; } public void setprecio(int precio) { this.precio = precio; } } Instituto de Computación Facultad de Ingeniería UdelaR Montevideo, Uruguay 127

128 ItemResource package ejemplo; import public class ItemResource @Produces({ "application/xml" }) public Item getitem() { Item item = new Item("IPhone5", 1500); return item; } Instituto de Computación Facultad de Ingeniería UdelaR Montevideo, Uruguay 128

129 ItemResource Si ejecutamos la aplicacion, al especificar application/xml, se utilizara el provider adecuado para obtener este XML <item> <description>iphone5</description> <price>1500</price> </item> Instituto de Computación Facultad de Ingeniería UdelaR Montevideo, Uruguay 129

130 @FormParam Esta anotacion sirve para extraer informacion de un formulario <html> <body> <form method="post" action="login"> Address: <input type="text" name=" "><br> Password: <input type="text" name="password"><br> <br> <input type="submit"> </form> </body> </html> Instituto de Computación Facultad de Ingeniería UdelaR Montevideo, Uruguay 130

131 @FormParam package ejemplos; import javax.ws.rs.formparam; import javax.ws.rs.post; import public class LoginResource public String String String password) { return "Ingreso con el " + + " y el password " + password; } Instituto de Computación Facultad de Ingeniería UdelaR Montevideo, Uruguay 131

132 @QueryParam Es muy similar al anterior, solo que al usarlo, se trata de extraer el valor el query parameter con el nombre public String String idvalue) { return "Id es " + idvalue; } de proyecto>/login?id=12345 Instituto de Computación Facultad de Ingeniería UdelaR Montevideo, Uruguay 132