Ejercicios de Introducción a los Servicios Web

1. La página http://www.xmethods.net contiene una serie de Servicios Web de demostración. En la sección XMethods Demo Services, en la parte inferior de la página, tenemos una lista de servicios que podremos integrar en nuestras aplicaciones.

a) Pulsar sobre el servicio Currency Exchange Rate para obtener información sobre él. Esto nos llevará a una página con documentación sobre este servicio, además de un enlace al documento WSDL que lo describe.

• Leer la documentación del servicio. ¿Qué función realiza?

• Descargar el documento WSDL y editarlo. ¿Qué operaciones nos ofrece el servicio? ¿Qué parámetros toman y que nos devuelven?

• Si pulsamos sobre el link Analyze WSDL, junto al link al documento WSDL, podremos ver los datos que aporta este documento de forma desglosada. Podemos ver el nombre del servicio, el puerto, las operaciones y los parámetros de entrada y datos devueltos por cada una de ellas.

b) Si queremos convertir la divisa europea (euro) a la de EEUU (dólar), ¿qué operación y qué parámetros debemos proporcionar?

c) Vamos a invocar el servicio mediante la aplicación Web Services Explorer (WSE) que podrás encontrar en la sección de recursos. Deberemos proporcionar la dirección del documento WSDL que describe el servicio y nos mostrará las operaciones que nos ofrece, pudiendo invocarlas desde la misma aplicación.

Para instalar WSE debemos:

• Descargar la aplicación de la sección de recursos.
• Descomprimir la aplicación en cualquier directorio.
• Compilaremos la aplicación invocando desde el directorio de WSE el siguiente comando:

ant compile

• Una vez compilada, podremos ejecutarla con:

ant run

Una vez hemos ejecutado la aplicación, para invocar la operación de cambio de moneda haremos lo siguiente:

• Introducimos en la barra de dirección la URL en la que se encuentra el documento WSDL del servicio.
• En la parte izquierda nos aparecerá un árbol desplegable con las distintas operaciones que tenemos disponibles. Seleccionamos la operación oportuna.
• En la parte central nos aparecerán una serie de cuadros de texto donde deberemos introducir los parámetros con los que invocamos la operación. Introducir los parámetros adecuados para la conversión de euro a dólar.
• Pulsar el botón Invoke para invocar el servicio. En el cuadro Results deberemos ver el valor actual del cambio entre ambas monedas, y debajo de este cuadro veremos los mensajes SOAP de petición y respuesta que se han utilizado en la invocación.

d) Consultar los mensajes SOAP de petición y respuesta utilizados. ¿Qué datos encontramos en cada uno de ellos?

2. Búsqueda de Servicios Web. En este ejercicio vamos a acceder a un registro UDDI para buscar un servicio.

Amazon ofrece Servicios Web para obtener información sobre los productos que venden. Vamos a buscar estos servicios en un registro UDDI, para posteriormente poder integrarlo en nuestras aplicaciones.

a) Acceder a un registro UDDI mediante su interfaz web y buscar el archivo WSDL que describa los servicios de Amazon.com.

• Podemos acceder al registro de IBM en la dirección:

http://www-3.ibm.com/services/uddi/

• Para acceder al registro pulsaremos sobre UDDI V2 Business Registry. Para hacer consultas no hace falta registrarnos, pero si queremos publicar nuestros servicios entonces si que deberemos hacerlo.
  
• En el menú de la izquierda pulsaremos sobre la opción Find para buscar servicios.
  
• Vamos a realizar una búsqueda por compañía (business), ya que buscamos los servicios que ofrece la compañia Amazon. En el campo Search for a seleccionamos Business. En el campo Starts with introduciremos el nombre de la compañía buscada, es decir, Amazon.
  
• Pulsamos sobre Find. Nos mostrará los resultados de la búsqueda. De los resultados obtenidos, nos interesará obtener información sobre los servicios que ofrece Amazon.com.
  
• Pulsamos sobre el link Services. Se nos mostrará una lista con los servicios que ofrece. Pulsaremos sobre el nombre del servicio para obtener información sobre como acceder a él.
  
• Aquí podremos ver una descripción del servicio, y un enlace al documento WSDL que lo describe.

b) Abrir el documento WSDL del servicio que ofrece Amazon.

• ¿Cuál es el endpoint del servicio?
  
• ¿Qué operaciones ofrece el servicio?
  
• Para la operación DirectorSearchRequest, ¿que parámetros toma, y que datos devuelve como resultado?
  
• ¿De que se compone el tipo DirectorRequest?

c) En el directorio AmazonCliente, tenemos un cliente que utiliza dicho servicio para hacer una búsqueda de DVDs teniendo como criterio de búsqueda el nombre del director.

• Generar la clases necesarias para el cliente con:

ant client

• Compilar la aplicación cliente con:

ant compile

• Una vez compilado, podremos hacer una búsqueda por director con:

ant run -Ddirector=nombre_director

Por ejemplo, podríamos buscar las películas en DVD de David Lynch, o de Stanley Kubrick:

ant run -Ddirector=lynch
ant run -Ddirector=kubrick

Con esto veremos los títulos de las películas encontradas en Amazon.

• Podemos ver los mensajes SOAP que está enviando y recibiendo nuestro programa internamente utilizando el comando:

ant run-debug -Ddirector=nombre_director

• Podemos redireccionar los mensajes a un fichero, para poder visualizarlos en cualquier editor:

ant run-debug -Ddirector=lynch > log

• Observar el mensaje de la petición SOAP.
  • ¿Qué operación se invoca?
  • ¿Qué parámetros se proporcionan?
  • ¿De que información se compone el parámetro suministrado?
    
• Ahora observar el mensaje de respuesta. ¿Qué información nos devuelve el servicio?

Ejercicios de Creación de Servicios Web

1. Vamos a ver como ejemplo la creación de un servicio HolaMundo. En el directorio HolaMundoSW tenemos ya implementado este servicio como ejemplo.

a) Para crear este servicio deberíamos seguir los siguientes pasos:

• Implementar la interfaz del servicio, HolaMundoIF, que tendrá un método público saluda que será la operación que ofrecerá nuestro servicio. Esta interfaz ya la encontraremos implementada en este ejemplo, abrirla y observar su código fuente.

  public String saluda(String nombre);

• Implementar una clase HolaMundoImpl que implemente la interfaz definida en el paso anterior, implementando de esta forma la funcionalidad de la operación saluda de nuestro servicio. Esta operación tomará como datos de entrada nuestro nombre, generando como salida un saludo con el nombre especificado. Por ejemplo, si proporcionamos como entrada "Miguel", deberá devolvernos el mensaje "Hola Miguel!". Esta clase ya la encontraremos implementada en este ejemplo, abrirla y observar su código fuente.
  
• Compilar la clase que implementa nuestro servicio. Podemos utilizar el objetivo compile de ant, aunque si estamos utilizando Eclipse normalmente las clases se habrán compilado automáticamente.

• Implementar el descriptor de despliegue (web.xml) y el fichero de configuración de servicios web (jaxrpc-ri.xml), ubicados en el directorio WEB-INF, con la configuración apropiada para nuestro servicio. Encontraremos estos ficheros ya implementados para este servicio, abrirlos y observar su contenido.

• Empaquetar los elementos anteriores en un fichero WAR con la estructura oportuna. Podemos utilizar para ello el objetivo dist de ant.

• Utilizar wsdeploy con este fichero WAR para generar las capas necesarias del servidor para nuestro servicio. Para realizar esto podemos utilizar el objetivo service de ant.

• Desplegar el fichero WAR obtenido en Tomcat y acceder mediante un navegador al endpoint del servicio para comprobar que es accesible. Podemos utilizar el objetivo deploy de ant para copiar el fichero WAR al directorio de despliegue del servidor.

b) Acceder al documento WSDL del servicio desplegado mediante un navegador web. Si el servicio ha sido desplegado correctamente, podremos obtener información sobre el mismo accediendo a la siguiente dirección:

http://localhost:8080/HolaMundo/hola

En esta página podemos encontrar un enlace al documento WSDL que describe el servicio, al que también podemos acceder directamente a través de la siguiente URL:

http://localhost:8080/HolaMundo/hola?WSDL

Consulta el documento WSDL del servicio e identifica los elementos que ves en él.

c) Utilizar la herramienta WSE (Web Service Explorer) para invocar el servicio web desplegado, y comprobar que su funcionamiento es correcto.

2. Vamos a implementar un Servicio Web sencillo que realice la conversión de euros a ptas y de ptas a euros. Para ello proporcionaremos dos operaciones:

double ptas2euro(int ptas)
int euro2ptas(double euros)

El nombre del servicio en este caso será Conversion.

a) Implementar el servicio. Como ayuda puedes seguir los pasos del ejercicio anterior, cambiando los datos que sean necesarios. En este caso tendremos que implementar nosotros las clases con la interfaz y la implementación del servicio, además del descriptor de despliegue y el fichero de configuración de JAX-RPC.

Vamos a desplegar el servicio en el contexto Conversion, y la ruta para acceder a él será /conv. Una vez hayamos finalizado, deberemos poder ser capaces de acceder al servicio en la dirección:

http://localhost:8080/Conversion/conv

b) Acceder al documento WSDL del servicio desplegado mediante un navegador web. Identifica los elementos que ves en él.

c) Utilizar la herramienta WSE (Web Service Explorer) para invocar el servicio web desplegado, y comprobar que su funcionamiento es correcto.

3. (OPTATIVO) Vamos a implementar un foro mediante servicios web. El foro deberá ofrecer dos operaciones:

public void publicarMensaje(String nick, String mensaje);
public Mensaje [] listaMensajes();

a) Implementar el servicio. Deberemos crear una clase Mensaje en la que se guardará el texto del mensaje y el nick de quien lo envió. AYUDA: Para guardar la lista de mensajes se puede utilizar una clase estática.

b) Acceder al documento WSDL del servicio desplegado mediante un navegador web. Identifica los elementos que ves en él.

c) Utilizar la herramienta WSE (Web Service Explorer) para invocar el servicio web desplegado, y comprobar que su funcionamiento es correcto.