Blog de Justo Aguilar » axis http://blog.justoaguilar.com Libros, Java y lo que surja. Sun, 22 Jan 2012 14:26:48 +0000 en hourly 1 http://wordpress.org/?v=3.3.1 Particularidades de Java2WSDL en Axis http://blog.justoaguilar.com/2008/08/particularidades-de-java2wsdl-en-axis/ http://blog.justoaguilar.com/2008/08/particularidades-de-java2wsdl-en-axis/#comments Wed, 20 Aug 2008 20:15:27 +0000 justo http://blog.justoaguilar.com/?p=112

Hace un par de semana me estuve peleando con los scripts de Axis que permiten crear documento WSDL a partir de una clase Java, Java2WSDL y viceversa, generar el skeleton o stub Java a partir de un documento WSDL, WSDL2Java. Particularmente la herramienta java2wsdl tiene ciertos detalles que pueden llegar a ser molestos si no se sabe como abordarlos. A continuación os cuento los problemas que tuve y las soluciones que adopté.

 

1. WSDL es un estándar web.
La afirmación anterior implica que la información que puede contener este documento debe ser independiente de cualquier plataforma, arquitectura, sistema operativo o lenguaje de programación, por tanto, en la sección donde se define los tipos ... no puede haber referencia a ningún tipo específico Java, tal como List, ArrayList, Map, ….

Solución:
Cualquier método que quiera ser publicado a través de un servicio web debe tener como parámetros de entrada y/o salida, tipos estándares, esto es en Java, tipos primitivos, arrays u objetos propios serializables que contengan tipos estándares.

Ejemplo
Supongamos que tenemos una clase Foo que queremos publicar como servicio web y que contiene un tipo no estándar, por ejemplo una Lista.

public class Foo {
  private List<String> lstStrings;

  public List<String> getLstStrings() {
    return this.lstStrings;
  }

  public void setLstStrings(List<String> lstStrings){
    this.lstStrings = lstStrings;
  }
  ...
}

Bien, pues si queremos que la herramienta java2wsdl genere un documento WSDL correcto debemos transformar el código anterior en el siguiente:

public class Foo {
  private List<String> lstStrings;
  private String[] arrayStrings;     // Según la versión de axis, es necesario declararlo o no

  public List<String> getLstStrings() {
    return this.lstStrings;
  }

  public void setLstStrings(List<String> lstStrings) {
    this.lstStrings = lstStrings;
  } 

  public String[] getArrayStrings() {
    if ( getLstStrings() != null ) {
      return getLstStrings().toArray(new String[getLstStrings().size()]);
    }
    return new String[0];
  }

  public void setArrayStrings(String[] arrayStrings) {
    this.setArrayStrings(Arrays.asList(arrayStrings));
  }
  ...
}

 

2. No están soportados los modelos de datos con clases internas.
Actualmente el script no genera correctamente el conjunto de tipos del documento WSDL si el método de la clase a publicar contiene parametros cuyos tipos sean clases internas.

Este error es debido a un fallo en el jar annogen-0.1.0; existe un parche oficioso que genera el WSDL correctamente pero si usamos wsdl2java para generar el cliente, la invocación al servicio dará un fallo.

Solución:

  1. Sacar las clases internas de la clase del servicio.
  2. Utilizar el jar oficioso de Deepal Jayasinghe y crear el stub sin utilizar WSDL2Java.

 

3. Nuestro servicio lanza una excepción.
Siempre que nuestro servicio lanza una Exception la herramienta java2wsdl intenta mapear el tipo de la excepción a un tipo WSDL. Esto siempre produce el código :

...
<xs:complexType name="MyException">
  <xs:complexContent>
    <xs:extension base="xs:Exception" />
    <!-- o <xs:extension base="xs:RuntimeException" /> -->
    <xs:sequence />
  </xs:complexContent>
</xs:complexType>
...

Al final java2wsdl busca la clase padre de la que extiende nuestra exception para mapearla según la semántica que permite WSDL, sin embargo, ni xs:Exception ni xs:RuntimeException existen como tipo estándares de XML-Schema lo que provoca la existerncia de warnings/errores de los editores XML que validan los documentos.

Solución: La única solución que he encontrado es hacer el siguiente cambio :

…
<xs:complexType name="MyException">
  <xs:complexContent>
    <xs:extension base="xs:anyType" />
    <!– o <xs:extension base="xs:anyType" /> –>
    <xs:sequence />
  </xs:complexContent>
</xs:complexType>
…

Eso si, si se genera un cliente a partir de este documento WSDL se deberán modificar las clases asociadas a las excepciones para que extiendan de RuntimeException o Exception o cualquier otra.

 

4. <soap12:fault />.
Cuando se crea un documento WSDL para que pueda ser utilizado por las dos versiones de SOAP existentes, 1.1 y 1.2, la parte del binding de SOAP 1.2 es incorrecta.

La herramienta java2wsdl genera un código tal como este : 

...
<wsdl:binding...>
  <soap12:opertation ... />
  <wsdl:operation ...>
    ...
    <wsdl:fault ...>
      <soap12:fault use="literal" name="MyException" />
    </wsdl:fault>
  </wsdl:operation>
</wsdl:binding>
...

pues el código anterior falla, el elemento <soap12:fault use="literal" name="MyException" /> no es correcto y, por ejemplo, la herramient wsdl2java no puede crear un cliente correcto a partir del WSDL

Solución: Cambiar <soap12:fault use="literal" name="MyException" /> por <soap:fault use="literal" name="MyException" />

 

Si habéis tenido problemas parecidos y los habéis resuelto de una forma distinta a la mía, por favor, no dudéís es compartirlo para que todos salgamos ganando.

 

]]> http://blog.justoaguilar.com/2008/08/particularidades-de-java2wsdl-en-axis/feed/ 3 Configurar Axis 2 + Spring 2 + Weblogic 9.2 http://blog.justoaguilar.com/2008/07/configurar-axis-2-spring-2-weblogic-92/ http://blog.justoaguilar.com/2008/07/configurar-axis-2-spring-2-weblogic-92/#comments Tue, 08 Jul 2008 16:54:04 +0000 justo http://blog.justoaguilar.com/?p=45

Aunque existen en la red muchos posts acerca de este tipo de configuración, no hay ninguno, que yo haya leído, que explique todo el proceso de forma sencilla. Este es el propósito de este post, describir de una manera cercana la configuración de Axis 2 para que use el contexto de Spring todo ello sobre el servidor Weblogic 9.2.

Antes de empezar a describir todos los detalles de la configuración vamos a intentar explicar el porqué de ésta, particularmente la interacción entre Axis y Spring.

Sin Spring

Supongamos que en nuestra aplicación no usamos Spring, el fichero service.xml de un servicio de Axis sería como sigue:

<service name="ServicioWebSinSpring">
  <parameter name="ServiceClass">
    com.jmaguilar.springaxisweblogic.ws.services.ServicioWebSinSpring
  </parameter>
  <operation name="saluda">
    <messageReceiver class="org.apache.axis2.receivers.RawXMLINOutMessageReceiver"/>
  </operation>
</service>

En el código anterior se indica que el servicio web tiene el nombre de ServicioWebSinSpring, está asociado a la clase com.jmaguilar.springaxisweblogic.ws.services.ServicioWebSinSpring y tiene publicado el método saluda. Simple.

Con Spring

Ahora la cosa cambia, Axis no debería poder instanciar la clase del servicio que va a usar, sino que debe solicitarla a Spring para que le proporcione la instancia ya creada y configurada previamente, de forma declarativa, a través del applicationContext-manager.xml.

En primer lugar vamos a ver el fichero de configuración de Spring.

<?xml version="1.0" encoding="UTF-8"?>
<beans xmlns="http://www.springframework.org/schema/beans"
            xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
            xsi:schemaLocation="http://www.springframework.org/schema/beans

http://www.springframework.org/schema/beans/spring-beans-2.5.xsd">

  <bean id="applicationContext" class="org.apache.axis2.extensions.spring.receivers.ApplicationContextHolder" />
  <bean id="servicioWebConSpring" class=" com.jmaguilar.springaxisweblogic.ws.services.ServicioWebConSpring" />
</beans>

El fichero define dos beans, applicationContext y servicioWebConSpring. El primero de ellos será utilizado por el motor de Axis para recuperar el applicationContext y, a partir de él, extraer cualquier bean ahí definido. Si hemos leido con atención el código nos habrá llamado la atención la clase asociada a este bean, ApplicationContextHolder se encuentra en el jar axis2-spring-x.y, que viene en el fuente de Axis. El segundo bean, servicioWebConSpring, es nuestro servicio.

Para indicar al motor de Axis que debe recuperar el bean servicioWebConSpring se debe incluir el siguiente código en el fichero service.xml del nuestro servicio web.

<service name="ServicioWebConSpring">
  <parameter name="ServiceObjectSupplier" locked="false">org.apache.axis2.extensions.spring.receivers.SpringAppContextAwareObjectSupplier</parameter>
  <parameter name="SpringBeanName" locked="false">servicioWebConSpring</parameter>
  <operation name="saluda">
    <messageReceiver class="org.apache.axis2.receivers.RawXMLINOutMessageReceiver"/>
  </operation>
</service>

En este caso, dentro del fichero service.xml se indica mediante el parámetro ServiceObjectSupplier la clase que proporcionará los objetos de servicio, SpringAppContextAwareObjectSupplier que también está dentro del jar axis2-spring-x.y. A través del parámetro SpringBeanName se especifica el bean que actuará como servicio, ojo se debe especifica el nombre del bean, no su clase. Y, por último, se indican las operaciones disponibles.

Weblogic 9.2

Sólo faltan por ultimar los detalles para que el despliegue en Weblogic sea correcto.

web.xml

<!DOCTYPE web-app PUBLIC "-//Sun Microsystems, Inc.//DTD Web Application 2.3//EN" "http://java.sun.com/dtd/web-app_2_3.dtd" >
<web-app>
  <context-param>
    <param-name>contextConfigLocation</param-name>
    <param-value><!-- indica los ficheros que contienen los beans a inyectar -->
      classpath*:applicationContext-manager.xml
    </param-value>
  </context-param>

  <listener><!-- permite la inyeccion de los beans definidos ficheros indicados anteriormente -->
    <listener-class>org.springframework.web.context.ContextLoaderListener</listener-class>
  </listener>

  <!-- AXIS 2 Configuration -->
  <servlet>
    <servlet-name>AxisServlet</servlet-name>
    <servlet-class>org.apache.axis2.transport.http.AxisServlet</servlet-class>
    <load-on-startup>1</load-on-startup>
  </servlet>

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

  ...

</web-app>

Debido a que el servidor de BEA tiene una implementación propia del pull-parser StAX es necesario, para el correcto funcionamiento de Axis, tirar de los jars que vienen incluidos en la distribución de Axis. Para ello es necesario indicar a Weblogic que la preferencia en el classpath es para los jars contenidos en el directorio WEB-INF/lib, ésto se hace a través del fichero weblogic.xml que debe situarse bajo WEB-INF.

<?xml version="1.0" encoding="ISO-8859-1"?>
<weblogic-web-app xmlns="http://www.bea.com/ns/weblogic/90">
  <container-descriptor>
    <prefer-web-inf-classes>true</prefer-web-inf-classes>
  </container-descriptor>
</weblogic-web-app>
]]> http://blog.justoaguilar.com/2008/07/configurar-axis-2-spring-2-weblogic-92/feed/ 2