WEB SERVICES CON AXIS Introduccin Esta gua muestra cmo generar servicios web con AXIS.

Se ha tomado como referencia bsica el manual que aparece en http://www.eclipse.org/webtools/community/tutorials/BottomUpAxis2WebService/bu_tutorial.html Inicialmente se enumeran los pasos a seguir para instalar y configurar todas las libreras y herramientas necesarias para posteriormente detallar, paso a paso, cmo generar un servicio web. Instalacin Para poder hacer funcionar el sistema, es necesario tener instalados: ECLIPSE WTP: lo ms sencillo es descargar la versin Eclipse J2EE all in one desde http:// www.eclipse.org/downloads/packages/eclipse-ide-java-ee-developers/ganymeder/ AXIS2 desde http://ws.apache.org/axis2/download.cgi TOMCAT desde http://tomcat.apache.org/download-60.cgi

Se puede hacer funcionar todo sin necesidad de usar un entorno de desarrollo como ECLIPSE con sus plugins para desarrollo web (en realidad slo hay que copiar la carpeta webapps/axis de AXIS dentro de la webapps de TOMCAT), pero usaremos los plugins de Eclipse porque agilizan el desarrollo de los servicios. La instalacin de TOMCAT lleva su propio asistente. La de AXIS, as como la de ECLIPSE, basta con descomprimirlo y dejarlo en el directorio que se desee. Seguidamente vamos a configurar ECLIPSE para que funcione con AXIS y TOMCAT, dentro de la opcin de men WindowPreferences:

Pgina 1

TOMCAT: Dentro de la opcin SERVER, seleccionaremos como Runtime Environment el directorio donde tengamos instalado Tomcat (si le decimos SEARCH y le damos la ruta l solo pone el resto)

Pgina 2

Pgina 3

AXIS: Debemos ir a la parte de Web Services, ah dentro de AXIS2 Preferences, seleccionar el directorio donde est instalado:

Con estos sencillos pasos hemos configurado correctamente ECLIPSE + TOMCAT + AXIS para desarrollar servicios web.

Pgina 4

Un ejemplo sencillo Vamos a comenzar generando un sencillo servicio web. Crearemos un File-New-Dynamic Web Project

Pgina 5

En la parte de CONFIGURATION, hay que pulsar el modify para aadir los facets de AXIS2.

Pgina 6

De manera que cambia y pone CUSTOM.

Pulsamos FINISH y ya tenemos creado el proyecto.

Pgina 7

La perspectiva ECLIPSE para este tipo de proyectos es como se muestra a continuacin:

Pgina 8

Dentro de Java Resources:src, creamos una nueva clase:

Tecleamos el cdigo de la clase:

package org.simple; public class Calculator { public int add (int a, int b) { return (a+b); } public int res (int a, int b) { return (a-b); }

Pgina 9

Pinchamos en el rbol de la izquierda donde sale el nombre de la clase y, con el botn derecho del ratn, nos sale un men contextual.

Pinchamos en Web-Services y en Create Web Service.

Pgina 10

Nos sale el asistente de AXIS dentro de ECLIPSE para crear un servicio web a partir de la clase que anteriormente habamos generado:

Pgina 11

Debemos pinchar donde pone Web service runtime: Apache AXIS, para decirle que es AXIS2

Pgina 12

Subimos el nivel de creacin (lado izquierdo, donde sale en azul) para que genere servidor, cliente y casos de prueba:

Pgina 13

Next

Pgina 14

Next

Pgina 15

Start Server, Next Pasamos a generar el cliente

Pgina 16

Next

Pgina 17

Next

Pgina 18

Ya tenemos creado y desplegado en TOMCAT nuestro servicio. Eclipse se abre ahora con el cliente auto-generado para poder probar nuestro servicio.

Pgina 19

Pinchamos en el servicio, luego en la operacin (por ejemplo add), y en cada parmetro le tendremos que aadir un valor (add) y luego pulsar GO para probar el servicio.

En la parte inferior podemos ver la respuesta.

Pgina 20

Para desplegar el servicio web fuera de eclipse, basta con: Instalar AXIS dentro de TOMCAT, desplegando el axis2-1.4-war. Desplegando el servicio dentro de TOMCAT, copiando la carpeta Calculator desde xxx\workspace\AXISSimpleWS\WebContent\WEB-INF\services\ hasta xxx\apache-tomcat-6.0.16\webapps\axis2\WEB-INF\services\ Accediendo a http://localhost:8080/axis2/ se puede validar que AXIS est bien instalado dentro de TOMCAT y ver la lista de servicios publicados y, de cada uno, consultar su WSDL.

Pgina 21