Axis 2 [Parte 2]: Implementación y uso

Implementación

• Para usar Axis es necesario un servidor de aplicaciones como TomCat o más precisamente un servlet container. Por lo tanto, lo primero que vamos a hacer es instalar un servidor de aplicaciones en el que serán desplegados los servicios Web.
• Para iniciar con Axis vamos a utilizar la distribución binaria estándar proporcionada por Apache Software Foundation.
• Tan solo hay que descomprimir el fichero comprimido axis2-1.4-bin.zip para encontrar lo necesario para ejecutar Axis.
• Axis puede ser ejecutado en modo standolone mediante el fichero $AXIS2_HOME\bin\axis2server.bat
• Después de haber iniciado Axis, podemos consultar la lista de servicios disponibles en modo standalone por medio de la URL siguiente: http://localhost:8080/axis2/services/
• Para utilizar Axis con un servidor de aplicaciones seguimos estos pasos:
  • Descomprimimos la distribución de Axis 2 a partir del fichero axis2-1.4-bin.zip.
  • Abrimos el prompt y escribimos cd $AXIS2_HOME\axis2-1.4\webapp
  • Instalamos Ant 1.6.5 o versión mas reciente.
  • Ejecutamos el fichero build.xml con Ant
  • Es generado un fichero axis2.war en el directorio /dist
  • Colocamos el fichero axis2.war en el directorio webapps y reiniciamos el servidor
  • Axis será entonces una aplicación Web desplegada bajo TomCat. El fichero axis2.war contiene todas las bibliotecas necesarias para la creación y el despliegue de los servicios Web. La estructura de axis2.war es similar a la siguiente:

axis2-web 
META-INF
WEB-INF
    classes 
    conf
        axis2.xml 
    lib
        activation.jar
        ...
        xmlSchema.jar
    modules
        modules.list 
        addressing.mar
        ...
        soapmonitor.mar
    services
        services.list
        aservice.aar
        ...
        version.aar
    web.xml

• • El enlace http://localhost:8080/axis2/ permite consultar la pagina de inicio de la aplicación Axis

• • Para consultar la lista de servicios desplegados hacemos clic en el vinculo Services.

• • El vinculo Validate permite comprobar que todas las bibliotecas requeridas por Axis están presentes en la aplicación.

• • Despliegue de Servicios Web==

Los servicios Web Axis2 pueden ser desplegados bajo forma de ficheros *.aar. Por consiguiente, Un servicio tiene una estructura bien definida como se muestra a continuación:

- CatalogoPrecios
   - META-INF
     - services.xml
   - lib
   - com
     - owliance
       - consola
         - configuracion
           - CatalogoPrecios.class

En el que catalogoPrecios es el nombre del servicio que debe ser el mismo que el indicado en el fichero services.xml.
Las clases son puestas directamente en la raíz con sus paquetes. Y el directorio lib contiene los *.jar necesarios para la ejecución de los servicios. El fichero services.xml define el servicio y le hace corresponder la clase java adecuada.

Creación del servicio Web

El siguiente modelo de proyecto muestra bien cómo crear un servicio Web. Se trata de un proyecto eclipse con la estructura de árbol siguiente:

• La clase asociada al servicio Web permite consultar el precio de un producto y actualizarlo.
• En este proyecto llamado OwlianceWS es previsto un fichero build.xml para construir el proyecto mediante la utilidad ANT.

• El fichero build.xml contiene un target compile.service para la compilación, un target generate.wsdl para la generación de la descripción wsdl asociada al servicio Web y un target generate.service que permite la encapsulación del servicio Web en un fichero con extensión “.aar” que puede ser reconocido por el engin de despliegue de los servicios Web Axis2.
• Para desplegar el servicio basta con colocar el fichero .aar generado en el directorio Webservices $TomeCat\ webapps\axis2\WEB-INF\services y reiniciar el servidor de aplcaciones.
• Para testear el servicio tan solo hay que llamar a la URL http://localhost:8080/axis2/services/CatalogoPrecios/getPrice?symbol=OWLT. El resultado obtenido es:

El artículo original fue escrito por n00r, contribuidor de CommentCaMarche