Creación de cliente WS con Eclipse

En el post anterior habéis visto como se crea un WS con Eclipse. En este, explicaremos cómo crear un cliente Java sencillo para invocarlo a partir de su fichero WSDL.

Al igual que en el caso anterior, supondremos que tenemos instalado en nuestra máquina el Eclipse 3.3 con el plugin WST (Web Service Tools). Hay varias formas de crear un cliente de un WS.

Creación de WS a través de la URL del fichero WSDL 

Lo primero que tenemos que hacer es crearnos un proyecto simple Java en Eclipse. Para ello, pulsamos File > New > Project. Una vez hecho esto pulsamos sobre Java > Java Project. 

Al hacer esto nos aparece un asistente en el que rellenamos los datos de nuestro proyecto como el nombre o la versión de la JRE que queremos utilizar. Llamaremos al proyecto SumaWSClient y utilizaremos la JRE 1.5.

Pulsamos el botón Next y a nos aparece la ventana para añadir paquetes de código fuente y añadir librerías. En nuestro no tenemos que hacer nada y pulsamos directamente Finish:

Ya tenemos nuestro proyecto Java. Ahora lo que tenemos que hacer es crear las clases cliente que nos ayudarán a invocar nuestro WS. 

Imaginemos que tenemos nuestro WS desplegado en la siguiente ruta local http://localhost:8080/SumaWS/services/OperacionCalculadoraWS?WSDL. Podemos saber la ruta de nuestro WS si abrimos el WSDL y nos vamos al final al elemento address. 

Para crear las clases clientes del WS pulsamos con el botón derecho sobre el proyecto SumaWSClient. En la ventana emergente pulsaremos sobre la opcion New > Other. Se nos abre un asistente en la que tendremos que seleccionar la opción Web Service > Web Service Client y pulsar sobre Next. 

En el campo Service definition introducimos la URL del WSDL (http://localhost:8080/SumaWS/services/OperacionCalculadoraWS?WSDL). El nivel de generación de clases cliente del WS lo dejamos como esté (en mi Eclipse es Deploy client) y pulsamos Next. 

En la siguiente ventana del asistente debemos completar la ruta donde queremos que se generen nuestras clases cliente. Lo dejamos todo como está por defecto y pulsamos Finish. 

Nuestro proyecto quedaría de la siguiente forma:

En el primer circulo señalado en rojo vemos que se han generado nuestras clases clientes del WS. En el segundo circulo vemos que como en el caso de creación del WS se han añadido automáticamente las librerías de Axis para la invocación correcta de nuestro WS.

Para la invocación de nuestro WS creamos una simple clase main con el siguiente código y ya tenemos nuestro cliente funcionando:

package es.jpascu.calculadora;

public class Test {

 /**
  * @param args
  */
 public static void main(String[] args) throws Exception {
  OperacionCalculadoraWSProxy proxy = new OperacionCalculadoraWSProxy();
  proxy.setEndpoint("http://localhost:8080/SumaWS/services/OperacionCalculadoraWS");
  System.out.println("Suma = " + proxy.suma(99, 99));
 }

}

Creación de WS a través del fichero WSDL 

Otra forma de crearlo muy similar a la anterior es a partir del fichero WSDL físicamente en nuestro fichero. Podemos descargar el fichero WSDL a nuestro disco y guardarlo dentro de nuestro proyecto Java.

Luego hacemos click con el botón derecho sobre el WSDL y pulsamos la opción Web Services > Generate Client. Esto nos crearía las clases cliente y añadiría los JARs de AXIS como en el caso anterior. 

Espero que os hayan resultado útiles ambos tutoriales. Como veis son sencillos y prácticos. Desde luego no sólo existe Axis para crear WS. Se pueden crear también  con Spring-WS,  JAX-RPC, XFire, JbossWS... Todas ellas con sus ventajas e inconvenientes, pero eso será en otro artículo.