Cómo exponer un servicio web en Mule 2 usando Apache Axis

Para crear servicios web existen 2 estilos de desarrollo:

1. Contract-Last. Se comienza con el código Java y se genera el contrato del servicio web (WSDL) a partir de éste.
2. Contract-First. Se comienza con el contrato del servicio web (WSDL) y se usa Java para implementar dicho contrato.

Mule 2 provee de dos tecnologías para trabajar con servicios web: Apache Axis y Apache CXF. En éste post explicaré como exponer un servicio web en Mule usando Apache Axis y el estilo de desarrollo Contract-Last.

En el siguiente código expondré un servicio web muy simple que solicita como entrada un nombre y un apellido y devuelve de respuesta una cadena de texto. Para trabajar con el estilo de desarrollo  Contract-Last, primero se debe de partir con la codificación Java, creando una interface con la firma de o los métodos a exponer en el servicio web y una o varias clases que implementen la interface como se muestra a continuación:

Interface HelloAxis

package com.blogspot.ingmmurillo.axisws;

public interface HelloAxis {

    public String helloAxis(String firstName, String lastName);

}

Clase HelloAxisImpl

package com.blogspot.ingmmurillo.axisws;

public class HelloAxisImpl implements HelloAxis {

    public String helloAxis(String firstName, String lastName) {

        String greeting = "Welcome to Axis " + firstName + " " + lastName;

        return greeting; 
    }
}

Una vez que se tenga codificado el código Java se usará la siguiente configuración en Mule para exponer el servicio web usando Axis, es decir para que Mule genere automáticamente el contrato (WSDL).

Configuración en Mule

<service name="helloaxis">
            <inbound>
                <axis:inbound-endpoint
                        address="http://localhost:8282/webservices/axis"
                        serviceNamespace="http://ingmmurillo.blogspot.com/webservices/axis"
                        synchronous="true">
                    <axis:soap-method method="helloAxis">
                        <axis:soap-parameter parameter="firstName" type="string" mode="IN"/>
                        <axis:soap-parameter parameter="lastName" type="string" mode="IN"/>
                        <axis:soap-return type="string"/>
                    </axis:soap-method>
                </axis:inbound-endpoint>
            </inbound>
            <component class="com.blogspot.ingmmurillo.axisws.HelloAxisImpl"/>
        </service>

En la siguiente captura de pantalla se muestra comó se consumiría el servicio web, las parámetros de entrada y la respuesta del mismo usando el cliente de servicios web SoapUI. Tomése en cuenta que la invocación al WSDL es de la siguiente forma: http://localhost:8282/webservices/axis/helloaxis?wsdl

Cómo verificar la versión del JDK con el cúal se compilo una clase

Existen 2 formas para verificar la versión del JDK (Java Development Kit) con el cúal fue compilada una clase.

1. Usando el comando javap
2. Codificando en Java para leer los 8 primeros bytes, usando clases del paquete java.io

Los archivos de clase Java (.class) tienen 3 elementos iniciales importantes que se encuentran distribuídos en los primeros 8 bytes del archivo.

4 Bytes	2  Bytes	2 Bytes
Número Mágico	Versión Menor	Versión Mayor
0xCAFEBABE	{0,3}	{45,46,47,48,49,50}
11001010111111101011101010111110	…	…

 
Los primeros 4 bytes corresponden a un número único que identifica que el archivo corresponde a un archivo de clase Java, éste número se lo conoce como número mágico y en hexadecimal corresponde al número  0xCAFEBABE.
Los 2 bytes siguientes representan la versión menor  y los 2 bytes subsiguientes representan la versión mayor del JDK con el cuál fue compilada la clase. En la siguiente tabla se describen las versiones de la plataforma Java:

Minor Version	Major Version	Java Platform Version	Release Date
3	45	1.0	23-ENE-1996
3	45	1.1	19-FEB-1997
0	46	1.2	08-DIC-1998
0	47	1.3	08-MAY-2000
0	48	1.4	06-FEB-2002
0	49	1.5	30-SEP-2004
0	50	1.6	11-DIC-2006

  Utilización del comando javap

Para utilizar el comando javap, es necesario abrir la consola de comandos del sistema operativo y ubicarse en dónde se encuentra el archivo de clase compilado, por ejemplo: suponiendo que la clase MiClase.class se encuentre en el paquete com.mypackage, el comando se usaría de la siguiente forma:

javap -verbose MiClase

Y se obtendría el siguiente resultado.

Como se puede observar aquí se muestra los valores de minor version y major version, con los cuáles se pueden identificar con cuál JDK fue compilada la clase. 

Código fuente para leer los 8 primeros bytes del archivo de clase

Adicional al comando se podría usar el siguiente code snippet para leer los 8 bytes del archivo de clase Java:

try {

    String nombreArchivo = "c:\java\src\com\mypackage\MiClase.class";
    DataInputStream in = new DataInputStream(new FileInputStream(nombreArchivo));

    int numeroMagico = in.readInt();
    
    if (numeroMagico != 0xCAFEBABE) {
        System.out.println(nombreArchivo + " no es una clase valida...");
    }

    int versionMenor = in.readUnsignedShort();
    int versionMayor = in.readUnsignedShort();

    System.out.println("major version = " + versionMayor);

    in.close();

} catch (IOException e) {
    System.err.println(e);
}

Cumpleaños Nro. 15 de Java

James Gosling, uno de los creadores de la plataforma Java, publica en su blog que Java cumple hoy 15 años. Durante éste tiempo Java ha evolucionado bastante, lo que sí me preocupa es cómo ha caído la popularidad en los últimos años según los índices de TIOBE. Sin embargo, el futuro y destino de Java sigue en manos de nosotros los desarrolladores de software y sobre todo de las decisiones que Oracle tome para que Java siga cumpliendo muchísimos años más.

HAPPY 15th BIRTHDAY JAVA!!!!!

Tarea de Ant para generar clientes de servicios web usando Apache Axis

A continuación comparto la tarea de Apache Ant para poder crear los client stubs para consumir servicios web usando Apache Axis.

La última versión de Apache Axis es la v1.4, se lo puede descargar del siguiente link: http://www.apache.org/dyn/closer.cgi/ws/axis/1_4

La tarea de Ant para crear los client stubs de un servicio web es la siguiente:

<property name="axis.home" location="${lib.home}/apache-axis-1.4"/>

    <target name="axis-generate-client-stubs" depends="init"
            description="Generate the client stubs for a web service">
        <path id="axis.path">
            <fileset dir="${axis.home}/lib">
                <include name="*.jar"/>
            </fileset>
        </path>
        <java classname="org.apache.axis.wsdl.WSDL2Java" fork="true">
            <arg value="-client"/>
            <arg value="-o"/>
            <arg value="${javaproject.home}/src-generated"/>
            <arg value="http://www.webservicex.net/CurrencyConvertor.asmx?WSDL"/>
            <arg value="-p"/>
            <arg value="com.myapplication.webservices"/>
            <classpath>
                <path refid="axis.path"/>
            </classpath>
        </java>
    </target>

En dónde:

•  axis.home direcciona al directorio que contiene las librerías de Apache Axis

•  -o  para configurar la ubicación en dónde se crearán las clases Java para el cliente del servicio web, en éste ejemplo: ${javaproject.home}/src-generated
• La URL dónde se encuentra publicado el servicio web, en éste caso:  http://www.webservicex.net/CurrencyConvertor.asmx?WSDL
• -p para definir el paquete Java en el cuál se crearán las clases del cliente del servicio web, por ejemplo: com.myapplication.webservices
  

Consulta de Estadísticas en los metadatos de BusinessObjects Data Integrator

Otra vez trabajando con las herramientas de BusinessObjects me encontré con la necesidad de consultar las estadísticas de Data Integrator directamente en el repositorio de metadatos.

La versión del repositorio con la cuál expongo el siguiente ejemplo es:

BODI-20031: The local repository version: 11.5.2.0000

Al consultar directamente en las tablas del repositorio de metadatos puedo conocer la historia de las ejecuciones de los flujos de datos y el detalle de ejecución de los mismos. Por ejemplo, es posible conocer el nombre del flujo de datos (dataflow), el nombre del objeto, eltipo, el número de registros cargados y el tiempo de ejecución.

Para realizar la consulta de las estadísticas se puede usar la siguiente consulta SQL:

select dataflow_name, object_name, object_type, execution_time as exec_time, row_count from (
select  
         (select x.value from al_statistics x 
         where x.object_key = y.object_key and x.seqnum= '2' and x.key2 = y.key2) as object_name,
         (select x.value from al_statistics x 
         where x.object_key = y.object_key and x.seqnum= '3' and x.key2 = y.key2) as object_type,
         (select x.value from al_statistics x 
         where x.object_key = y.object_key and x.seqnum= '4' and x.key2 = y.key2) as row_count,
         (select x.value from al_statistics x 
         where x.object_key = y.object_key and x.seqnum= '5' and x.key2 = y.key2) as start_time,
         (select x.value from al_statistics x 
         where x.object_key = y.object_key and x.seqnum= '6' and x.key2 = y.key2) as end_time,
         (select x.value from al_statistics x 
         where x.object_key = y.object_key and x.seqnum= '7' and x.key2 = y.key2) as execution_time,
         (select x.value from al_statistics x 
         where x.object_key = y.object_key and x.seqnum= '8' and x.key2 = y.key2) as dataflow_name
from al_statistics y
where y.object_key = '5' and y.seqnum= '8' 
)  order by dataflow_name; 

En donde object_key hace referencia a la clave primaria de la tabla al_history. Para consultar ésta tabla se puede usar la siguiente consulta SQL:

select object_key,service,start_time,end_time, status, has_error from al_history order by object_key desc;