WEB SERVICES CON AXIS

Transcripción

1 WEB SERVICES CON AXIS Introducción Esta guía muestra cómo generar servicios web con AXIS. Se ha tomado como referencia básica el manual que aparece en Inicialmente se enumeran los pasos a seguir para instalar y configurar todas las librerías y herramientas necesarias para posteriormente detallar, paso a paso, cómo generar un servicio web. Instalación Para poder hacer funcionar el sistema, es necesario tener instalados: ECLIPSE WTP: lo más sencillo es descargar la versión Eclipse J2EE all in one desde AXIS2 desde TOMCAT desde Se puede hacer funcionar todo sin necesidad de usar un entorno de desarrollo como ECLIPSE con sus plugins para desarrollo web (en realidad sólo 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 instalación 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 opción de menú Window- Preferences: Página 1

2 TOMCAT: Dentro de la opción 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) Página 2

3 Página 3

4 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. Página 4

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

6 En la parte de CONFIGURATION, hay que pulsar el modify para añadir los facets de AXIS2. Página 6

7 De manera que cambia y pone CUSTOM. Pulsamos FINISH y ya tenemos creado el proyecto. Página 7

8 La perspectiva ECLIPSE para este tipo de proyectos es como se muestra a continuación: Página 8

9 Dentro de Java Resources:src, creamos una nueva clase: Tecleamos el código 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); } Página 9

10 } Pinchamos en el árbol de la izquierda donde sale el nombre de la clase y, con el botón derecho del ratón, nos sale un menú contextual. Pinchamos en Web-Services y en Create Web Service. Página 10

11 Nos sale el asistente de AXIS dentro de ECLIPSE para crear un servicio web a partir de la clase que anteriormente habíamos generado: Página 11

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

13 Subimos el nivel de creación (lado izquierdo, donde sale en azul) para que genere servidor, cliente y casos de prueba: Página 13

14 Next Página 14

15 Next Página 15

16 Start Server, Next Pasamos a generar el cliente Página 16

17 Next Página 17

18 Next Página 18

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

20 Pinchamos en el servicio, luego en la operación (por ejemplo add), y en cada parámetro le tendremos que añadir un valor (add) y luego pulsar GO para probar el servicio. En la parte inferior podemos ver la respuesta. Página 20

21 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 \webapps\axis2\web-inf\services\ Accediendo a 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. Página 21