Universidad ORT - Arquitecturas de Software sobre plataforma JEE Web Services (parte 1)

Transcripción

1 Requisitos Oracle Java Development Kit (JDK) 6 NetBeans con GlassFish Application Server 3 integrado Variable de entorno JAVA_HOME apuntando al directorio de instalación de la JDK Introducción El objetivo de este ejercicio es familiarizarse con la exposición y consumo de Web Services usando la plataforma JEE 6. En particular, esta guía está enfocada a la creación de una aplicación empresarial con un módulo web que expone un Web Service usando la especificación JAX-WS. Por otro lado, se creará una aplicación Java stand-alone que cumplirá la función de cliente que consume este servicio. Creación de la aplicación empresarial El primer paso consistirá en la creación de una aplicación empresarial con un módulo web que alojará el Web Service que queremos exponer. 1. Desde el menú del NetBeans, seleccionamos File New Project y en la ventana que aparece elegimos, dentro de la categoría Java EE, un proyecto del tipo Enterprise Application. 2. En la siguiente ventana, usaremos HolaMundoWS como nombre del proyecto (se creará un directorio con este nombre en el disco duro) y desmarcamos la opción Set as Main Project. 1 de 8

2 3. A continuación nos aseguramos que el tipo de servidor seleccionado sea GlassFish Server 3, y que la versión de Java EE sea la 6. De los checkboxes, marcaremos solamente Create Web Application Module. 2 de 8

3 Creación del Web Service Una vez completados los pasos de la sección anterior, tenemos un proyecto HolaMundoWS para la aplicación empresarial y otro proyecto HolaMundoWS-war para el módulo web. Ahora estamos en condiciones de crear un Web Service que será expuesto por nuestra aplicación. 1. Sobre el proyecto correspondiente al módulo web (HolaMundoWS-war), hacemos click derecho y seleccionamos New Web Service. Usaremos HolaMundo como nombre del servicio, y en el campo Package escribimos uy.edu.ort.holamundo.ws, de este modo la implementación de nuestro Web Service será creada en ese paquete. 2. Como resultado del paso anterior se habrá creado una clase HolaMundo en el paquete uy.edu.ort.holamundo.ws del módulo web. Inicialmente esta clase está vacía, pero notemos que ha sido anotada para indicarle al servidor de aplicaciones que se trata de la implementación de un Web Service. Ahora crearemos una operación en este Web Service. La operación recibirá un parámetro del tipo String con un nombre y como resultado generará un String con un saludo para el nombre indicado. Es posible crear la operación manualmente, pero lo más sencillo es hacer click derecho dentro de la clase HolaMundo y seleccionar Insert Code. Allí, elegiremos la opción Add Web Service Operation para especificar la operación a crear. 3 de 8

4 3. Una vez creada la operación, tenemos un método al que será necesario darle la implementación apropiada, la cual se adjunta a continuación. /* * To change this template, choose Tools Templates * and open the template in the editor. package uy.edu.ort.holamundo.ws; import javax.jws.webmethod; import javax.jws.webparam; import javax.jws.webservice; /** * public class HolaMundo { /** * Web service = "obtenersaludo") public String obtenersaludo(@webparam(name = "nombre") String nombre) { return "Hola " + nombre + "!"; 4. Ahora estamos listos para desplegar la aplicación y dejar el servicio listo para ser consumido. Sobre la aplicación empresarial HolaMundoWS hacemos click derecho y seleccionamos Deploy para compilar, empaquetar y desplegar la aplicación. 5. Podemos chequear que el Web Service fue desplegado correctamente ingresando a la URL 4 de 8

5 Creación del cliente para el Web Service En esta sección crearemos una aplicación Java estándar que consumirá el Web Service utilizando la API JAX-WS provista por la distribución de Java Standard Edition Desde el menú del NetBeans seleccionamos File New Project y seleccionamos un proyecto Java Application dentro de la categoría Java. 2. Como nombre de la aplicación usaremos HolaMundoWSClient y la clase principal será uy.edu.ort.holamundo.wsclient.main. 5 de 8

6 3. Una vez creado el proyecto, hacemos click derecho sobre HolaMundoWSClient y seleccionamos New Web Service Client. 4. Para poder invocar al Web Service desde esta aplicación, es necesario indicar la ubicación del WSDL que describe el servicio y sus operaciones. Ya que tenemos el proyecto con el Web Service en nuestro workspace, podemos seleccionar la opción Project y luego Browse para indicar el servicio a consumir. 5. Con el WSDL seleccionado, simplemente debemos indicar en el campo Package el paquete en el cual residirán las clases generadas por el IDE para simplificar la creación del cliente. En este caso usaremos uy.edu.ort.holamundo.wsclient. 6 de 8

7 6. Ahora es posible invocar el servicio desde nuestra aplicación estándar. Para ello, dentro de la clase Main creada junto con el proyecto hacemos click derecho y seleccionamos Insert Code. Luego, elegimos la opción Call Web Service Operation y allí marcamos la operación obtenersaludo. 7. Luego del paso anterior se habrá generado un método static llamado obtenersaludo() en nuestra clase Main que realiza la invocación al Web Service, por lo cual lo único que nos queda es implementar el método main() para llamar al servicio enviando el parámetro requerido. A continuación se presenta el código final para el cliente. 7 de 8

8 /* * To change this template, choose Tools Templates * and open the template in the editor. package uy.edu.ort.holamundo.wsclient; /** * ORT public class Main { /** args the command line arguments public static void main(string[] args) { String saludo = obtenersaludo("mundo"); System.out.println(saludo); private static String obtenersaludo(java.lang.string nombre) { uy.edu.ort.holamundo.wsclient.holamundoservice service = new uy.edu.ort.holamundo.wsclient.holamundoservice(); uy.edu.ort.holamundo.wsclient.holamundo port = service.getholamundoport(); return port.obtenersaludo(nombre); WSDL provisto por terceros Como es de esperar, en muchos casos en los cuales queremos invocar un Web Service no disponemos del proyecto con la implementación del servicio (el ejemplo más claro es cuando hacemos uso de servicios provistos por terceros, ej: Google, Amazon, etc.). De hecho, puede que el servicio haya sido implementado en una plataforma totalmente distinta. En estos casos, quien publica el servicio generalmente provee un archivo WSDL que funciona como contrato para el servicio y podemos usarlo para generar nuestro cliente de manera sencilla. Simplemente colocando el WSDL en algún directorio de nuestra aplicación, al crear el cliente lo hacemos del mismo modo que en la sección anterior, pero seleccionamos la opción Local File para el WSDL y entonces podemos usar el archivo que copiamos. Otra opción es que el proveedor del servicio publique el WSDL en una cierta URL, en este caso elegimos la opción WSDL URL y allí ingresamos la URL provista para ubicar el servicio. 8 de 8