Blog de Antonio Manuel Muñiz

Desarrollo, Ingeniería y Calidad del Software

Construcción y Testing de Web Services con Axis y Maven

Hace tiempo estuve desarrollando un stack de servicios web que dieran acceso a una serie de
procedimientos almacenados en una base de datos Oracle. Uno de los objetivos fue automatizar
totalmente el proceso de construcción de los web services con Maven.
La solución se basó en el framework WS de Apache, Axis2 1.3, que en principio ofrece un conjunto
de herramientas en línea de comandos para la generación del código tanto del servicio como de
los clientes. Para la generación del código del servicio se ejecuta:

wsdl2java -uri InterfazWS.wsdl -p interfaz.ws -o target_directory -d xmlbeans -s -ss -sd

Esto genera todos los artefactos necesarios para gestionar las peticiones al web service, solo
tenemos que implementar la lógica de la clase Skeleton.

Este proceso es algo tedioso cuando se esta desarrollando, y además necesitamos tener instalado wsdl2java para generar el código, vamos a automatizarlo con maven, de forma que solo tenemos que ejecutar el comando anterior una sola vez, la primera, para que nos genere la clase Skeleton, esta clase es la que pondremos como fuente de nuestro proyecto (en src/main/java). Desde luego, en el momento del despliegue del servicio no tendremos que ejecutar wsdl2java en la línea de comandos.

La estructura del proyecto será la siguiente:

- -+ src
- - - -+ main
- - - - - - - -+ java
- - - - - - - - - - -+ InterfazWSSkeleton.java
- - - - - - - -+ resources
- - - - - - - - - - - - -+ META-INF
- - - - - - - - - - - - - - - - -+ InterfazWS.wsdl
- -+ interfaz-ws-soapui-project.xml
- -+ pom.xml

Utilizaremos el plugin axis2-wsdl2code-maven-plugin para la generación del servicio
a partir del WSDL (e la fase generate-sources).

Pero este plugin genera todo el código en el directorio que le indiquemos, en nuestro caso target/generated-by-axis2, ahora tenemos que moverlo a src/main/java. ¿Por que no haberlo generado directamente en src/main/java?, por que entonces se sobreescibiría la clase Skeleton y no queremos que pase esto, es en ella donde dotaremos de lógica al servicio y hay que mantenerla, de hecho, será la única clase que tendremos en src/main/java, el resto se generará. Para mover los fuentes y el resto de recursos utilizaremos maven-antrun-plugin.

El segundo objetivo es automatizar las pruebas, lo haremos con maven-soapui-plugin. Este plugin
necesita un fichero xml generado con la herramienta SoapUI. Por tanto debemos definir nuestros
tests con SoapUI y utilizar el fichero xml en el que la herramienta almacena la información de
los tests definidos. A este plugin solo hay que indicarle donde encontrar el fichero xml de SoapUI
y la URL del servidor en el que se encuentra el servicio (el path al wsdl ya lo contiene el xml de SoapUI).
Por último también tenemos que configurar el plugin maven-clean-plugin para que elimine lo que nos
interesa.

Una vez configurado todo, podemos generar y testear el servicio web automaticamente con maven.
El proceso completo consta de los siguientes pasos:

mvn package

– Genera un jar que podemos desplegar en el Axis Manager (WAR) (o en nuestra aplicación web, en
caso de que la hayamos adaptado para desplegar servicios Axis2)

mvn eviware:maven-soapui-plugin:test

– Ejecución de tests funcionales

mvn eviware:maven-soapui-plugin:loadtest

– Ejecucuión de tests de carga

Aún no lo he probado con la versión 1.4 de Axis, en cuanto lo pruebe comento como ha ido.

Este es el fichero pom.xml completo

6 Respuestas a “Construcción y Testing de Web Services con Axis y Maven

  1. Nicolas Gonzalez 9 noviembre 2008 en 3:31 pm

    Lo pudiste probar? porque pienso hacerlo mañana y queria saber si funcionaba bien

  2. Antonio Manuel Muñiz Martín 9 noviembre 2008 en 11:37 pm

    Hola Nicolas,
    Al poco tiempo de escribir el post lo probé, tuve algunos problemas con mis wsdl (ciertas etiquetas no eran válidas en Axis 1.4) debido a la renovación de la especificación.
    En teoría no deberías tener problemas.
    Ya me contarás ;)

    Un saludo.

  3. Anónimo 1 junio 2009 en 3:08 pm

    Hola que tal?

    He intetado hacer el ejemplo pero hay algunas cosas que no me han quedad claras, tengo que ejecutar wsdl2java? o con el wsdl2code ya esta?cada vez que compilo me hace lo wsdl2code, no se deberia hacer una solo la primera vez, esque no lo acabo de entender.
    Un saludo, gracias.
    pd:Tienes el codigo fuente del ejemplo?

  4. juan 13 abril 2010 en 5:01 pm

    ¿Es necesario desplegar axis2.war para crear web services con axis?

    • Antonio Manuel Muñiz Martín 13 abril 2010 en 6:51 pm

      Hola Juan,

      Para crearlos no, pero para usarlos sí. Un servicio web en Axis es tan solo un fichero aar (que en el fondo es un jar), este fichero debe ser desplegado en un contenedor para exponerlo via web, axis.war es ese contenedor.

      Un saludo.

Responder

Introduce tus datos o haz clic en un icono para iniciar sesión:

Logo de WordPress.com

Estás comentando usando tu cuenta de WordPress.com. Cerrar sesión / Cambiar )

Imagen de Twitter

Estás comentando usando tu cuenta de Twitter. Cerrar sesión / Cambiar )

Foto de Facebook

Estás comentando usando tu cuenta de Facebook. Cerrar sesión / Cambiar )

Google+ photo

Estás comentando usando tu cuenta de Google+. Cerrar sesión / Cambiar )

Conectando a %s

A %d blogueros les gusta esto: