Instalación y Configuración de Axis

Pasos Previos

Instalación del Tomcat

Instalación de Axis

  1. Bajar la versión binaria de Axis en: http://xml.apache.org/axis .

  2. Descomprimir el archivo Tar de Axis un directorio temporal ( /tmp/), esto genera un directorio llamado axis-<numero_de_version>.

  3. Dentro de este directorio existe otro sub-directorio llamado lib, dentro del cual residen las distintas librerías (archivos JAR) necesarias para ejecutar Axis.

Configuración de Tomcat

Para utilizar Axis dentro de Tomcat es necesario diseñar un WAR ("Web-Archive") donde residirán las Clases/Métodos que serán ejecutados como "Web-Services" así como Axis; para simplificar la instalación de Axis se asume que se utilizará la configuración "Default" de Tomcat descrita en la Guia de Tomcat .

Estructura del WAR ("Web-Archive") para Axis 
+-usr/local/tomcat/webapps+--\
                             |
 /---------------------------/                       
 |
 \ +-axis-+ 
          |
          |-*.jws (Clases/Métodos con Web-Services Nativos)
          |
          +-WEB-INF+
                   |
                   +-web.xml
                   |
                   +-classes--+
                   |          |
                   |          +- (Clases/Métodos 
                   |             para ser Web-Services)
                   +-lib--+
                          |
                          +-axis-ant.jar            /
                          +-axis.jar               |
                          +-commons-discovery.jar  |  Librerías 
                          +-commons-logging.jar    |  de la Distribución 
                          +-jaxrpc.jar             |  Axis 
                          +-log4j-1.2.4.jar        |  /tmp/versión_axis/lib/
                          +-saaj.jar               |
                          +-wsdl4j.jar             | 
                                                    \

Nótese que la estructura del archivo WAR es colocada bajo un directorio llamado axis dentro de la instalación básica de Tomcat , esto permitirá el acceso a "Web-Services" bajo el URL: www.servidorprueba.com:8080/axis.

Archivo web.xml del WAR("Web-Archive") Axis 
<?xml version="1.0" encoding="ISO-8859-1"?>

<!DOCTYPE web-app
    PUBLIC "-//Sun Microsystems, Inc.//DTD Web Application 2.3//EN"
    "http://java.sun.com/j2ee/dtds/web-app_2.3.dtd">

<web-app>

<!-- Definición de Servlets -->

  <servlet>
    <servlet-name>AxisServlet</servlet-name>
    <servlet-class>
        org.apache.axis.transport.http.AxisServlet
    </servlet-class>
  </servlet>

  <servlet>
    <servlet-name>AdminServlet</servlet-name>
    <servlet-class>
        org.apache.axis.transport.http.AdminServlet
    </servlet-class>
    <load-on-startup>100</load-on-startup>
  </servlet>

<!-- Mapeo de Servlets -->

  <servlet-mapping>
    <servlet-name>AxisServlet</servlet-name>
    <url-pattern>*.jws</url-pattern>
  </servlet-mapping>

  <servlet-mapping>
    <servlet-name>AxisServlet</servlet-name>
    <url-pattern>/services/*</url-pattern>
  </servlet-mapping>

  <servlet-mapping>
    <servlet-name>AxisServlet</servlet-name>
    <url-pattern>/servlet/AxisServlet</url-pattern>
  </servlet-mapping>

  <servlet-mapping>
    <servlet-name>AdminServlet</servlet-name>
    <url-pattern>/servlet/AdministracionAxis</url-pattern>
  </servlet-mapping>

</web-app>

Una vez definido este archivo web.xml es posible iniciar con el proceso de diseño de "Web-Services" a través de Axis; en Axis existen dos posibilidades para definir "Web-Services":