Dos Ideas. - Contribuciones del usuario [es]

Web Service con CXF para Weblogic

2010-02-19T19:37:37Z

Esteban: /* Recursos */

Desarrollar un servicio CXF en Weblogic es posible, si bien son necesarias algunas consideraciones.

== Pasos ==

==== Incluir el proyecto Web dentro de un EAR ====

Esto es debido a que debe priorizarse el uso de ciertas clases paquetizadas con CXF.
Esto se hace incluyendo el siguiente código en el archivo weblogic-application.xml

<prefer-application-packages>
<package-name>javax.jws.*</package-name>
</prefer-application-packages>

==== Eliminar referencias al filesystem ====

Por default, el proceso de generación de código escribe ciertas referencias al fylesystem. Dado que Weblogic no descomprime los ejecutables, no puede obtener las referencias del sistema de archivos. Es por ello que deberemos remover dichas referencias de las clases *Service.java y *Impl.java
Ej:

@WebServiceClient(name = "CalculadoraService",
wsdlLocation = "'''CalculadoraService.wsdl'''",
targetNamespace = "http://www.dosideas.com/cursos/calculadora")
public class CalculadoraService extends Service {

public final static URL WSDL_LOCATION;
public final static QName SERVICE = new QName("http://www.dosideas.com/cursos/calculadora", "CalculadoraService");
public final static QName CalculadoraSoapPort = new QName("http://www.dosideas.com/cursos/calculadora", "CalculadoraSoapPort");
static {
URL url = null;
try {
url = new URL("'''CalculadoraService.wsdl'''");
} catch (MalformedURLException e) {
System.err.println("Can not initialize the default wsdl from file:./src/java/CalculadoraService.wsdl");
// e.printStackTrace();
}
WSDL_LOCATION = url;
}

==== Copiar WSDL a la carpeta WEB-INF ====

Como la carpeta WEB-INF si se descomprime, WL toma además las referencias relativas de los archivos respecto de esa carpeta, por lo que si se especifica el nombre del archivo a secas, lo CXF lo irá a buscar a ese carpeta.

== Recursos ==

[http://www.dosideas.com/descargas/category/8.html?download=35%3Ap-p-l Proyecto Ejemplo Java 1.5 y CXF 2.2.6 para Weblogic]

Creación de un Servicio Web partiendo de un WSDL con Apache CXF

2010-02-19T19:36:27Z

Esteban: /* Proyecto de ejemplo para descargar */

== Pasos: ==

==== Crear un proyecto Web con Netbeans ====
Utilizaremos el nombre CXF para el proyecto.
==== Agregar la librería CXF al proyecto ====
Como puede ser que no este instalada, deberemos bajarla del sitio Web (http://cxf.apache.org/download.html). Para este proyecto se utilizó la última versión al momento, que es la 2.2.6

El proyecto viene con muchas mas librerías de las que son estrictamente necesarias para el ejemplo. Las libreria de Geronimo no son necesarias para un despliegue en Tomcat, así como las de Jetty, Jettyson y XMLBeans.
Dentro del conjunto de librerias se incluye Spring 2.5.6, ya que usa CXF usa intensivamente dicho framework.

==== Copiar WSDL de ejemplo al proyecto ====
Para este proyecto, tenemos un WSDL de un servicio Calculadora, que tiene 2 operaciones:
* dividir (división entera)
* sumar

La operación dividir necesita 2 parámetros, dividendo y divisor y devuelve 2 valores, cociente y resto. Además debe devolver un mensaje de error en caso que el divisor sea 0.

Dicho archivo lo copiaremos a la raiz del directorio de fuentes.

==== Generar código java a partir de un documento WSDL ====
CXF, como también Axis 2, viene con un generador de código que ahorra al usuario la construcción de todas clases necesarias para la implementación de WebServices.
En este caso construiremos una tarea Ant para construir dichas clases.

<path id="cxf.classpath">
<fileset dir="./lib/CXF-2.2.6">
<include name="*.jar" />
</fileset>
</path>

<target name="create server side classes">
< java classname="org.apache.cxf.tools.wsdlto.WSDLToJava" fork="true">
<arg value="-server" />
<arg value="-validate" />
<arg value="-impl" />
<arg value="-d" />
<arg value="src/java" />
<arg value="./src/java/CalculadoraService.wsdl" />
<classpath>
<path refid="cxf.classpath" />
</classpath>
< /java>
</target>

<target name="create client side classes">
< java classname="org.apache.cxf.tools.wsdlto.WSDLToJava" fork="true">
<arg value="-client" />
<arg value="-validate" />
<arg value="-p" />
<arg value="test.dosideas.com" />
<arg value="-d" />
<arg value="test" />
<arg value="./src/java/CalculadoraService.wsdl" />
<classpath>
<path refid="cxf.classpath" />
</classpath>
< /java>
</target>

Se definen 2 tareas: la primera para crear las clases del lado servidor y la segunda para crear las clases del cliente. Cabe notar que a esta última le pasamos un package de parámetro. Esto es para evitar el clashing de clases entre la parte cliente y la parte servidora.
En ambos casos estas tareas Ant generarán las clases involucradas en el Web Service y una serie de archivos, incluyendo la clase que contendrá la lógica de negocio, la cual vendrá con implementaciones dummy.

==== Implementar lógica de negocio ====

De las clases generadas, la única que tendremos que implementar es la que tiene el sufijo Impl (CalculadoraImpl), la cual a su vez llamará a un objeto de negocio.

@javax.jws.WebService(
serviceName = "CalculadoraService",
portName = "CalculadoraSoapPort",
targetNamespace = "http://www.dosideas.com/cursos/calculadora",
wsdlLocation = "file:./src/java/CalculadoraService.wsdl",
endpointInterface = "com.dosideas.cursos.calculadora.Calculadora")

public class CalculadoraImpl implements Calculadora {
private static final Logger LOG = Logger.getLogger(CalculadoraImpl.class.getName());

protected CalculadoraBo calculadoraBo = null;

public CalculadoraBo getCalculadoraBo() {
return calculadoraBo;
}

public void setCalculadoraBo(CalculadoraBo calculadoraBo) {
this.calculadoraBo = calculadoraBo;
}

public com.dosideas.cursos.calculadora.DivisionRespuesta dividir(DivisionSolicitud parameters) throws DivisionPorCero {
LOG.info("Executing operation dividir");
System.out.println(parameters);
try {
int dividendo = parameters.getDividendo();
int divisor = parameters.getDivisor();
int cociente = calculadoraBo.dividir(dividendo, divisor);
int resto = calculadoraBo.resto(dividendo, divisor);
com.dosideas.cursos.calculadora.DivisionRespuesta _return = new DivisionRespuesta();
_return.setCociente(cociente);
_return.setResto(resto);
return _return;
} catch (ArithmeticException ex) {
/* Hay que completar todos los datos de la excepción de negocio */
DivisionPorCero divisionPorCero = new DivisionPorCero("DivisionPorCeroError", "DivisionPorCeroError");
throw divisionPorCero;
} catch (Exception ex) {
ex.printStackTrace();
throw new RuntimeException(ex);
}
}

public com.dosideas.cursos.calculadora.SumaRespuesta sumar(SumaSolicitud parameters) {
LOG.info("Executing operation sumar");
System.out.println(parameters);
try {
com.dosideas.cursos.calculadora.SumaRespuesta _return = new SumaRespuesta();
_return.setNumero(calculadoraBo.sumar(parameters.getNumero1(), parameters.getNumero2()));
return _return;
} catch (Exception ex) {
ex.printStackTrace();
throw new RuntimeException(ex);
}
}
}

Luego se crea la clase con la lógica de negocio, la cual después se inyectará en la clase Skeleton via Spring

public class CalculadoraBo {
public int sum(int n1, int n2) {
return n1 + n2;
}

public int divide(int n1, int n2){
return n1 / n2;
}

public int modulo(int n1, int n2){
return n1 % n2;
}
}

==== Configurar descriptores de Spring ====

<import resource="classpath:META-INF/cxf/cxf.xml" />
<import resource="classpath:META-INF/cxf/cxf-servlet.xml" />
<import resource="classpath:META-INF/cxf/cxf-extension-soap.xml" />

<bean id="calculadoraBo" class="com.dosideas.business.CalculadoraBo" />

<bean id="calculadoraImpl" class="com.dosideas.cursos.calculadora.CalculadoraImpl">
<property name="calculadoraBo" ref="calculadoraBo" />
</bean>

<jaxws:endpoint id="calculadoraService"
address="/calculadoraService"
wsdlLocation="CalculadoraService.wsdl"
implementor="#calculadoraImpl">
</jaxws:endpoint>

Es aquí donde configuramos el servicio Web propiamente. Se configura la url donde estará publicado, el WSDL que implementa, y la implementación.

==== Configurar web.xml ====

<context-param>
<param-name>contextConfigLocation</param-name>
<param-value>/WEB-INF/applicationContext.xml</param-value>
</context-param>
<listener>
<listener-class>org.springframework.web.context.ContextLoaderListener</listener-class>
</listener>

<servlet>
<servlet-name>CXFServlet</servlet-name>
<servlet-class>org.apache.cxf.transport.servlet.CXFServlet</servlet-class>
</servlet>
<servlet-mapping>
<servlet-name>CXFServlet</servlet-name>
<url-pattern>/*</url-pattern>
</servlet-mapping>

== Recursos ==

=== WSDL de Calculadora Service ===

Existe un pequeño problema con CXF parte cliente, por que se cambió el WSDL para subsanar ese problema.
Dicho problema consiste en que el cliente no escribe correctamente los namespaces en los elementos del mensaje de solicitud. Este error se subsana seteando el WSDL con el atributo elementFormDefault="unqualified" en el schema.

<wsdl:definitions name="CalculadoraServiceDefinitions" targetNamespace="http://www.dosideas.com/cursos/calculadora" xmlns:wsdl="http://schemas.xmlsoap.org/wsdl/" xmlns:xs="http://www.w3.org/2001/XMLSchema" xmlns:calc="http://www.dosideas.com/cursos/calculadora" xmlns:soap="http://schemas.xmlsoap.org/wsdl/soap/">
<wsdl:types>
<xs:schema attributeFormDefault="unqualified" elementFormDefault="unqualified" targetNamespace="http://www.dosideas.com/cursos/calculadora">
<xs:element name="divisionSolicitud">
<xs:complexType>
<xs:sequence>
<xs:element name="dividendo" type="xs:int"/>
<xs:element name="divisor" type="xs:int"/>
</xs:sequence>
</xs:complexType>
</xs:element>
<xs:element name="divisionRespuesta">
<xs:complexType>
<xs:sequence>
<xs:element name="cociente" type="xs:int"/>
<xs:element name="resto" type="xs:int"/>
</xs:sequence>
</xs:complexType>
</xs:element>
<xs:element name="divisionPorCero" type="xs:string"/>
<xs:element name="sumaSolicitud">
<xs:complexType>
<xs:sequence>
<xs:element name="numero1" type="xs:int"/>
<xs:element name="numero2" type="xs:int"/>
</xs:sequence>
</xs:complexType>
</xs:element>
<xs:element name="sumaRespuesta">
<xs:complexType>
<xs:sequence>
<xs:element name="numero" type="xs:int"/>
</xs:sequence>
</xs:complexType>
</xs:element>
</xs:schema>
</wsdl:types>
<wsdl:message name="divisionSolicitud">
<wsdl:part name="parameters" element="calc:divisionSolicitud">
</wsdl:part>
</wsdl:message>
<wsdl:message name="divisionRespuesta">
<wsdl:part name="parameters" element="calc:divisionRespuesta">
</wsdl:part>
</wsdl:message>
<wsdl:message name="divisionPorCero">
<wsdl:part name="divisionPorCero" element="calc:divisionPorCero">
</wsdl:part>
</wsdl:message>
<wsdl:message name="sumarResponse">
<wsdl:part name="parameters" element="calc:sumaRespuesta">
</wsdl:part>
</wsdl:message>
<wsdl:message name="sumarRequest">
<wsdl:part name="parameters" element="calc:sumaSolicitud">
</wsdl:part>
</wsdl:message>
<wsdl:portType name="Calculadora">
<wsdl:operation name="dividir" parameterOrder="parameters">
<wsdl:input message="calc:divisionSolicitud">
</wsdl:input>
<wsdl:output message="calc:divisionRespuesta">
</wsdl:output>
<wsdl:fault name="divisionPorCero" message="calc:divisionPorCero">
</wsdl:fault>
</wsdl:operation>
<wsdl:operation name="sumar">
<wsdl:input message="calc:sumarRequest">
</wsdl:input>
<wsdl:output message="calc:sumarResponse">
</wsdl:output>
</wsdl:operation>
</wsdl:portType>
<wsdl:binding name="CalculadoraServiceSoapBinding" type="calc:Calculadora">
<soap:binding style="document" transport="http://schemas.xmlsoap.org/soap/http"/>
<wsdl:operation name="dividir">
<soap:operation soapAction="http://www.dosideas.com/cursos/calculadora/dividir" style="document"/>
<wsdl:input>
<soap:body parts="parameters" use="literal"/>
</wsdl:input>
<wsdl:output>
<soap:body parts="parameters" use="literal"/>
</wsdl:output>
<wsdl:fault name="divisionPorCero">
<soap:fault name="divisionPorCero" use="literal"/>
</wsdl:fault>
</wsdl:operation>
<wsdl:operation name="sumar">
<soap:operation soapAction="http://www.dosideas.com/cursos/calculadora/sumar" style="document" />
<wsdl:input>
<soap:body parts="parameters" use="literal"/>
</wsdl:input>
<wsdl:output>
<soap:body parts="parameters" use="literal"/>
</wsdl:output>
</wsdl:operation>
</wsdl:binding>
<wsdl:service name="CalculadoraService">
<wsdl:port name="CalculadoraSoapPort" binding="calc:CalculadoraServiceSoapBinding">
<soap:address location="http://localhost:8080/CXF/calculadoraService"/>
</wsdl:port>
</wsdl:service>
</wsdl:definitions>

==Proyecto de ejemplo para descargar==

[http://www.dosideas.com/descargas/category/8.html?download=34%3Ap Proyecto Ejemplo con Java 1.5 y CXF 2.2.4]

==Ver también==
* [[Web Service]]
* [[Clientes De Web Service]]
* [[Web Service con CXF para Weblogic]]
* [http://cxf.apache.org/ Apache CXF]

[[Category:Java]]
[[Category:Web Service]]

Web Service con CXF para Weblogic

2010-02-18T19:13:57Z

Esteban: /* Debe desplegarse dentro de un EAR */

Web Service con CXF para Weblogic

2010-02-18T18:54:54Z

Esteban: Página creada con 'Desarrollar un servicio CXF en Weblogic es posible, si bien son necesarias algunas consideraciones. == Pasos == ==== Debe desplegarse dentro de un EAR ==== Esto es debido a q…'

Desarrollar un servicio CXF en Weblogic es posible, si bien son necesarias algunas consideraciones.

== Pasos ==

==== Debe desplegarse dentro de un EAR ====

Esto es debido a que debe priorizarse el uso de ciertas clases paquetizadas con CXF.
Esto se hace incluyendo el siguiente código en el archivo weblogic-application.xml

<prefer-application-packages>
<package-name>javax.jws.*</package-name>
</prefer-application-packages>

==== Eliminar referencias al filesystem ====

Por default, el proceso de generación de código escribe ciertas referencias al fylesystem. Dado que Weblogic no descomprime los ejecutables, no puede obtener las referencias del sistema de archivos. Es por ello que deberemos remover dichas referencias de las clases *Service.java y *Impl.java
Ej:

@WebServiceClient(name = "CalculadoraService",
wsdlLocation = "'''CalculadoraService.wsdl'''",
targetNamespace = "http://www.dosideas.com/cursos/calculadora")
public class CalculadoraService extends Service {

public final static URL WSDL_LOCATION;
public final static QName SERVICE = new QName("http://www.dosideas.com/cursos/calculadora", "CalculadoraService");
public final static QName CalculadoraSoapPort = new QName("http://www.dosideas.com/cursos/calculadora", "CalculadoraSoapPort");
static {
URL url = null;
try {
url = new URL("'''CalculadoraService.wsdl'''");
} catch (MalformedURLException e) {
System.err.println("Can not initialize the default wsdl from file:./src/java/CalculadoraService.wsdl");
// e.printStackTrace();
}
WSDL_LOCATION = url;
}

==== Copiar WSDL a la carpeta WEB-INF ====

Como la carpeta WEB-INF si se descomprime, WL toma además las referencias relativas de los archivos respecto de esa carpeta, por lo que si se especifica el nombre del archivo a secas, lo CXF lo irá a buscar a ese carpeta.

== Recursos ==

==== Proyecto de ejemplo ====

Creación de un Servicio Web partiendo de un WSDL con Apache CXF

2010-02-18T18:10:11Z

Esteban: Paso a paso como configurar un proyecto con CXF

== Pasos: ==

==== Crear un proyecto Web con Netbeans ====
Utilizaremos el nombre CXF para el proyecto.
==== Agregar la librería CXF al proyecto ====
Como puede ser que no este instalada, deberemos bajarla del sitio Web (http://cxf.apache.org/download.html). Para este proyecto se utilizó la última versión al momento, que es la 2.2.6

El proyecto viene con muchas mas librerías de las que son estrictamente necesarias para el ejemplo. Las libreria de Geronimo no son necesarias para un despliegue en Tomcat, así como las de Jetty, Jettyson y XMLBeans.
Dentro del conjunto de librerias se incluye Spring 2.5.6, ya que usa CXF usa intensivamente dicho framework.

==== Copiar WSDL de ejemplo al proyecto ====
Para este proyecto, tenemos un WSDL de un servicio Calculadora, que tiene 2 operaciones:
* dividir (división entera)
* sumar

La operación dividir necesita 2 parámetros, dividendo y divisor y devuelve 2 valores, cociente y resto. Además debe devolver un mensaje de error en caso que el divisor sea 0.

Dicho archivo lo copiaremos a la raiz del directorio de fuentes.

==== Generar código java a partir de un documento WSDL ====
CXF, como también Axis 2, viene con un generador de código que ahorra al usuario la construcción de todas clases necesarias para la implementación de WebServices.
En este caso construiremos una tarea Ant para construir dichas clases.

<path id="cxf.classpath">
<fileset dir="./lib/CXF-2.2.6">
<include name="*.jar" />
</fileset>
</path>

<target name="create server side classes">
< java classname="org.apache.cxf.tools.wsdlto.WSDLToJava" fork="true">
<arg value="-server" />
<arg value="-validate" />
<arg value="-impl" />
<arg value="-d" />
<arg value="src/java" />
<arg value="./src/java/CalculadoraService.wsdl" />
<classpath>
<path refid="cxf.classpath" />
</classpath>
< /java>
</target>

<target name="create client side classes">
< java classname="org.apache.cxf.tools.wsdlto.WSDLToJava" fork="true">
<arg value="-client" />
<arg value="-validate" />
<arg value="-p" />
<arg value="test.dosideas.com" />
<arg value="-d" />
<arg value="test" />
<arg value="./src/java/CalculadoraService.wsdl" />
<classpath>
<path refid="cxf.classpath" />
</classpath>
< /java>
</target>

Se definen 2 tareas: la primera para crear las clases del lado servidor y la segunda para crear las clases del cliente. Cabe notar que a esta última le pasamos un package de parámetro. Esto es para evitar el clashing de clases entre la parte cliente y la parte servidora.
En ambos casos estas tareas Ant generarán las clases involucradas en el Web Service y una serie de archivos, incluyendo la clase que contendrá la lógica de negocio, la cual vendrá con implementaciones dummy.

==== Implementar lógica de negocio ====

De las clases generadas, la única que tendremos que implementar es la que tiene el sufijo Impl (CalculadoraImpl), la cual a su vez llamará a un objeto de negocio.

@javax.jws.WebService(
serviceName = "CalculadoraService",
portName = "CalculadoraSoapPort",
targetNamespace = "http://www.dosideas.com/cursos/calculadora",
wsdlLocation = "file:./src/java/CalculadoraService.wsdl",
endpointInterface = "com.dosideas.cursos.calculadora.Calculadora")

public class CalculadoraImpl implements Calculadora {
private static final Logger LOG = Logger.getLogger(CalculadoraImpl.class.getName());

protected CalculadoraBo calculadoraBo = null;

public CalculadoraBo getCalculadoraBo() {
return calculadoraBo;
}

public void setCalculadoraBo(CalculadoraBo calculadoraBo) {
this.calculadoraBo = calculadoraBo;
}

public com.dosideas.cursos.calculadora.DivisionRespuesta dividir(DivisionSolicitud parameters) throws DivisionPorCero {
LOG.info("Executing operation dividir");
System.out.println(parameters);
try {
int dividendo = parameters.getDividendo();
int divisor = parameters.getDivisor();
int cociente = calculadoraBo.dividir(dividendo, divisor);
int resto = calculadoraBo.resto(dividendo, divisor);
com.dosideas.cursos.calculadora.DivisionRespuesta _return = new DivisionRespuesta();
_return.setCociente(cociente);
_return.setResto(resto);
return _return;
} catch (ArithmeticException ex) {
/* Hay que completar todos los datos de la excepción de negocio */
DivisionPorCero divisionPorCero = new DivisionPorCero("DivisionPorCeroError", "DivisionPorCeroError");
throw divisionPorCero;
} catch (Exception ex) {
ex.printStackTrace();
throw new RuntimeException(ex);
}
}

public com.dosideas.cursos.calculadora.SumaRespuesta sumar(SumaSolicitud parameters) {
LOG.info("Executing operation sumar");
System.out.println(parameters);
try {
com.dosideas.cursos.calculadora.SumaRespuesta _return = new SumaRespuesta();
_return.setNumero(calculadoraBo.sumar(parameters.getNumero1(), parameters.getNumero2()));
return _return;
} catch (Exception ex) {
ex.printStackTrace();
throw new RuntimeException(ex);
}
}
}

Luego se crea la clase con la lógica de negocio, la cual después se inyectará en la clase Skeleton via Spring

public class CalculadoraBo {
public int sum(int n1, int n2) {
return n1 + n2;
}

public int divide(int n1, int n2){
return n1 / n2;
}

public int modulo(int n1, int n2){
return n1 % n2;
}
}

==== Configurar descriptores de Spring ====

<import resource="classpath:META-INF/cxf/cxf.xml" />
<import resource="classpath:META-INF/cxf/cxf-servlet.xml" />
<import resource="classpath:META-INF/cxf/cxf-extension-soap.xml" />

<bean id="calculadoraBo" class="com.dosideas.business.CalculadoraBo" />

<bean id="calculadoraImpl" class="com.dosideas.cursos.calculadora.CalculadoraImpl">
<property name="calculadoraBo" ref="calculadoraBo" />
</bean>

<jaxws:endpoint id="calculadoraService"
address="/calculadoraService"
wsdlLocation="CalculadoraService.wsdl"
implementor="#calculadoraImpl">
</jaxws:endpoint>

Es aquí donde configuramos el servicio Web propiamente. Se configura la url donde estará publicado, el WSDL que implementa, y la implementación.

==== Configurar web.xml ====

<context-param>
<param-name>contextConfigLocation</param-name>
<param-value>/WEB-INF/applicationContext.xml</param-value>
</context-param>
<listener>
<listener-class>org.springframework.web.context.ContextLoaderListener</listener-class>
</listener>

<servlet>
<servlet-name>CXFServlet</servlet-name>
<servlet-class>org.apache.cxf.transport.servlet.CXFServlet</servlet-class>
</servlet>
<servlet-mapping>
<servlet-name>CXFServlet</servlet-name>
<url-pattern>/*</url-pattern>
</servlet-mapping>

== Recursos ==

=== WSDL de Calculadora Service ===

Existe un pequeño problema con CXF parte cliente, por que se cambió el WSDL para subsanar ese problema.
Dicho problema consiste en que el cliente no escribe correctamente los namespaces en los elementos del mensaje de solicitud. Este error se subsana seteando el WSDL con el atributo elementFormDefault="unqualified" en el schema.

<wsdl:definitions name="CalculadoraServiceDefinitions" targetNamespace="http://www.dosideas.com/cursos/calculadora" xmlns:wsdl="http://schemas.xmlsoap.org/wsdl/" xmlns:xs="http://www.w3.org/2001/XMLSchema" xmlns:calc="http://www.dosideas.com/cursos/calculadora" xmlns:soap="http://schemas.xmlsoap.org/wsdl/soap/">
<wsdl:types>
<xs:schema attributeFormDefault="unqualified" elementFormDefault="unqualified" targetNamespace="http://www.dosideas.com/cursos/calculadora">
<xs:element name="divisionSolicitud">
<xs:complexType>
<xs:sequence>
<xs:element name="dividendo" type="xs:int"/>
<xs:element name="divisor" type="xs:int"/>
</xs:sequence>
</xs:complexType>
</xs:element>
<xs:element name="divisionRespuesta">
<xs:complexType>
<xs:sequence>
<xs:element name="cociente" type="xs:int"/>
<xs:element name="resto" type="xs:int"/>
</xs:sequence>
</xs:complexType>
</xs:element>
<xs:element name="divisionPorCero" type="xs:string"/>
<xs:element name="sumaSolicitud">
<xs:complexType>
<xs:sequence>
<xs:element name="numero1" type="xs:int"/>
<xs:element name="numero2" type="xs:int"/>
</xs:sequence>
</xs:complexType>
</xs:element>
<xs:element name="sumaRespuesta">
<xs:complexType>
<xs:sequence>
<xs:element name="numero" type="xs:int"/>
</xs:sequence>
</xs:complexType>
</xs:element>
</xs:schema>
</wsdl:types>
<wsdl:message name="divisionSolicitud">
<wsdl:part name="parameters" element="calc:divisionSolicitud">
</wsdl:part>
</wsdl:message>
<wsdl:message name="divisionRespuesta">
<wsdl:part name="parameters" element="calc:divisionRespuesta">
</wsdl:part>
</wsdl:message>
<wsdl:message name="divisionPorCero">
<wsdl:part name="divisionPorCero" element="calc:divisionPorCero">
</wsdl:part>
</wsdl:message>
<wsdl:message name="sumarResponse">
<wsdl:part name="parameters" element="calc:sumaRespuesta">
</wsdl:part>
</wsdl:message>
<wsdl:message name="sumarRequest">
<wsdl:part name="parameters" element="calc:sumaSolicitud">
</wsdl:part>
</wsdl:message>
<wsdl:portType name="Calculadora">
<wsdl:operation name="dividir" parameterOrder="parameters">
<wsdl:input message="calc:divisionSolicitud">
</wsdl:input>
<wsdl:output message="calc:divisionRespuesta">
</wsdl:output>
<wsdl:fault name="divisionPorCero" message="calc:divisionPorCero">
</wsdl:fault>
</wsdl:operation>
<wsdl:operation name="sumar">
<wsdl:input message="calc:sumarRequest">
</wsdl:input>
<wsdl:output message="calc:sumarResponse">
</wsdl:output>
</wsdl:operation>
</wsdl:portType>
<wsdl:binding name="CalculadoraServiceSoapBinding" type="calc:Calculadora">
<soap:binding style="document" transport="http://schemas.xmlsoap.org/soap/http"/>
<wsdl:operation name="dividir">
<soap:operation soapAction="http://www.dosideas.com/cursos/calculadora/dividir" style="document"/>
<wsdl:input>
<soap:body parts="parameters" use="literal"/>
</wsdl:input>
<wsdl:output>
<soap:body parts="parameters" use="literal"/>
</wsdl:output>
<wsdl:fault name="divisionPorCero">
<soap:fault name="divisionPorCero" use="literal"/>
</wsdl:fault>
</wsdl:operation>
<wsdl:operation name="sumar">
<soap:operation soapAction="http://www.dosideas.com/cursos/calculadora/sumar" style="document" />
<wsdl:input>
<soap:body parts="parameters" use="literal"/>
</wsdl:input>
<wsdl:output>
<soap:body parts="parameters" use="literal"/>
</wsdl:output>
</wsdl:operation>
</wsdl:binding>
<wsdl:service name="CalculadoraService">
<wsdl:port name="CalculadoraSoapPort" binding="calc:CalculadoraServiceSoapBinding">
<soap:address location="http://localhost:8080/CXF/calculadoraService"/>
</wsdl:port>
</wsdl:service>
</wsdl:definitions>

==Proyecto de ejemplo para descargar==

==Ver también==
* [[Web Service]]
* [[Clientes De Web Service]]
* [[Web Service con CXF para Weblogic]]
* [http://cxf.apache.org/ Apache CXF]

[[Category:Java]]
[[Category:Web Service]]

Web Service con Axis 2

2010-02-18T17:34:09Z

Esteban:

Axis 2 es un framework para el desarrollo y consumo de Webservices en Java, e intenta solucionar algunos temas pendientes de su predecesor Axis 1.

A continuación haremos un proyecto prototipo, partiendo de un WSDL de un servicio sencillo de calculadora.

== Pasos: ==

==== Crear un proyecto Web con Netbeans ====
Utilizaremos el nombre DosIdeas-Axis2 para el proyecto.
==== Agregar la librería Axis 2 al proyecto ====
Como puede ser que no este instalada, deberemos bajarla del sitio Web (http://ws.apache.org/axis2/download/1_4_1/download.cgi). Utilizaremos la versión 1.4.1 que es la última versión compatible con Java 1.4.
En la versión 1.5 de Axis 2 cambia bastante la forma de construir Web Services, pero no será visto en este tutorial.

El proyecto viene con muchas mas librerías de las que son estrictamente necesarias para el ejemplo. No obstante, para simplificar incorporaremos todas.
==== Agregar Spring 2.5 o posterior ====
Si bien no es imprescindible para el funcionamiento, permite una clara separación de la lógica de negocio de la implementación del servicio Web.
==== Copiar WSDL de ejemplo al proyecto ====
Para este proyecto, tenemos un WSDL de un servicio Calculadora, que tiene 2 operaciones:
* dividir (división entera)
* sumar

La operación dividir necesita 2 parámetros, dividendo y divisor y devuelve 2 valores, cociente y resto. Además debe devolver un mensaje de error en caso que el divisor sea 0.

==== Generar código java a partir de un documento WSDL ====
Axis 2 viene con un generador de código que ahorra al usuario la construcción de todas clases necesarias para la implementación de WebServices.
En este caso utilizaremos una tarea Ant para construir dichas clases. En caso de trabajar con Eclipse, también tendremos la posibilidad de utilizar el plugin de Web Services, que viene con la distribución JEE del IDE.

<property name="axis2.home" value="D:/development/axis2-1.4.1" />
<property name="output.wsdl2java.dir" value="build/codegen" />
<property name="src.dir" value="src/java" />

<property name="wsdl.uri" value="resources/wsdl/CalculadoraService.wsdl" />
<property name="services.folder" value="web/WEB-INF/services" />

<property name="service.name" value="CalculadoraService" />

<property name="service.wsdl.uri" value="resources/wsdl/${service.name}.wsdl" />
<property name="service.folder" value="${services.folder}/${service.name}/META-INF" />

<path id="axis2.classpath">
<fileset dir="${axis2.home}/lib">
<include name="**/*.jar" />
</fileset>
</path>

<target name="run-wsdl2java-server">
<mkdir dir="${output.wsdl2java.dir}" />
<delete dir="${output.wsdl2java.dir}" includeemptydirs="true" />
<java classname="org.apache.axis2.wsdl.WSDL2Java" fork="true">
<classpath refid="axis2.classpath"/>
<arg value="-uri"/><arg file="${wsdl.uri}"/>
<arg value="-ss"/>
<arg value="-g"/>
<arg value="-sd"/>
<arg value="-o"/><arg file="${output.wsdl2java.dir}"/>
</java>

<copy todir="${src.dir}" overwrite="true">
<fileset dir="${output.wsdl2java.dir}/src">
<include name="**/*.java"/>
</fileset>
</copy>
<mkdir dir="${service.folder}" />
<delete dir="${service.folder}" includeemptydirs="true" />

<mkdir dir="${service.folder}/service" />

<copy todir="${service.folder}/service" overwrite="true">
<fileset dir="${output.wsdl2java.dir}/resources">
<include name="**/*"/>
</fileset>
</copy>
</target>

Esta tarea Ant generará todas las clases involucradas en el Web Service y una serie de archivos, incluyendo la clase que contendrá la lógica de negocio, la cual vendrá con implementaciones dummy.
Luego se copiaran los clases java al directorio de fuentes y por último se copiará el archivo de configuración y el wsdl al directorio de servicio predeterminado de Axis.

==== Implementar lógica de negocio ====
De las clases generadas, la única que tendremos que implementar es la que tiene el sufijo Skeleton. En caso que implementaramos la lógica aquí, sería poco reutilizable, por lo que haremos en un paso siguiente una clase con la lógica de negocio y en el Skeleton tan solo invocaremos dicha clase.

public class CalculadoraServiceSkeleton {

protected CalculadoraBo calculadoraBo = null;

public CalculadoraBo getCalculadoraBo() {
return calculadoraBo;
}

public void setCalculadoraBo(CalculadoraBo calculadoraBo) {
this.calculadoraBo = calculadoraBo;
}

/**
* Auto generated method signature
*
* @param divisionSolicitud
* @throws DivisionPorCeroError :
*/
public com.dosideas.www.cursos.calculadora.DivisionRespuesta dividir(
com.dosideas.www.cursos.calculadora.DivisionSolicitud divisionSolicitud)
throws DivisionPorCeroError {
int divisor = divisionSolicitud.getDivisor();
int dividendo = divisionSolicitud.getDividendo();
try {
int cociente = calculadoraBo.divide(dividendo, divisor);
int resto = calculadoraBo.modulo(dividendo, divisor);
DivisionRespuesta rta = new DivisionRespuesta();
rta.setCociente(cociente);
rta.setResto(resto);
return rta;
} catch (ArithmeticException e) {
DivisionPorCeroException error = new DivisionPorCeroException();
// En caso que no se setee el objeto descripcion, tira un error genérico AxisFault
DivisionPorCero div = new DivisionPorCero();
// Si no se llenan todos los campos obligatorios, devuelve error 500 de http
div.setDivisionPorCero("Descripcion del error");
error.setFaultMessage(div);
throw error;
}
}

/**
* Auto generated method signature
*
* @param sumaSolicitud
*/
public com.dosideas.www.cursos.calculadora.SumaRespuesta sumar(
com.dosideas.www.cursos.calculadora.SumaSolicitud sumaSolicitud) {
SumaRespuesta rta = new SumaRespuesta();
rta.setNumero(calculadoraBo.sum(sumaSolicitud.getNumero1(), sumaSolicitud.getNumero2()));
return rta;
}
}
Se recomienda prestar especial atención al tratamiento de los errores custom.
Cada error de negocio cuenta con un tipo interno, que contiene la descripción del error. En caso de no llenar dicha descripción, se lanzará un error genérico AxisFault.
Además hay que tener especial cuidado al llenar dicha descripción. En caso que no se cumpla con el formato, Axis devuelve un error http 500, en vez de un error descriptivo.
Luego se crea la clase con la lógica de negocio, la cual después se inyectará en la clase Skeleton via Spring

public class CalculadoraBo {
public int sum(int n1, int n2) {
return n1 + n2;
}

public int divide(int n1, int n2){
return n1 / n2;
}

public int modulo(int n1, int n2){
return n1 % n2;
}
}

==== Configurar descriptores de Spring ====

<bean id="applicationContext"
class="org.apache.axis2.extensions.spring.receivers.ApplicationContextHolder" />

<bean id="calculadoraBo" class="com.dosideas.business.CalculadoraBo">

</bean>
<bean id="calculadoraService" class="com.dosideas.www.cursos.calculadora.CalculadoraServiceSkeleton">
<property name="calculadoraBo" ref="calculadoraBo" />
</bean>

==== Configurar web.xml ====

<?xml version="1.0" encoding="UTF-8"?>
<web-app version="2.4" xmlns="http://java.sun.com/xml/ns/j2ee"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xsi:schemaLocation="http://java.sun.com/xml/ns/j2ee
http://java.sun.com/xml/ns/j2ee/web-app_2_4.xsd">
<context-param>
<param-name>contextConfigLocation</param-name>
<param-value>/WEB-INF/applicationContext.xml</param-value>
</context-param>

<listener>
<listener-class>org.springframework.web.context.ContextLoaderListener</listener-class>
</listener>

<servlet>
<display-name>Apache-Axis Servlet</display-name>
<servlet-name>AxisServlet</servlet-name>
<servlet-class>org.apache.axis2.transport.http.AxisServlet</servlet-class>
</servlet>

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

<welcome-file-list>
<welcome-file>index.jsp</welcome-file>
</welcome-file-list>
</web-app>

==== Modificar services.xml para que use Spring ====

<parameter name="ServiceObjectSupplier" locked="false">
org.apache.axis2.extensions.spring.receivers.SpringAppContextAwareObjectSupplier</parameter>
<parameter name="SpringBeanName" locked="false">calculadoraService</parameter>

La configuración descrita aquí funciona tanto para Tomcat como para Glassfish.
En caso que se desee hacer un Web Service para Weblogic o para Websphere, son necesarios algunos pasos adicionales. Se sugiere leer la siguiente nota: [[Web Service con Axis 2 para Weblogic y Websphere]]

==== Sugerencias para la construcción del WSDL ====

* No utilizar las palabras Error o Exception al final de los tipos o de los mensajes Fault. Estas palabras son utilizadas por el generador de código, por lo que luego el código generado será incorrecto.
* Si se usa la versión 1.4 de Axis 2, no nombrar de la misma forma un mensaje de error que el tipo que contiene. Genera un error extraño en el generador de código, por el que genera 2 excepciones con el nombre del mensaje. Ej: Con el tipo DivisionPorCero, generó DivisionPorCeroException0 y DivisionPorCeroException1.

== Recursos ==

=== WSDL de Calculadora Service ===

<?xml version="1.0" encoding="UTF-8"?>
<wsdl:definitions name="CalculadoraServiceDefinitions" targetNamespace="http://www.dosideas.com/cursos/calculadora" xmlns:wsdl="http://schemas.xmlsoap.org/wsdl/" xmlns:xs="http://www.w3.org/2001/XMLSchema" xmlns:calc="http://www.dosideas.com/cursos/calculadora" xmlns:soap="http://schemas.xmlsoap.org/wsdl/soap/">
<wsdl:types>
<xs:schema attributeFormDefault="unqualified" elementFormDefault="qualified" targetNamespace="http://www.dosideas.com/cursos/calculadora">
<xs:element name="divisionSolicitud">
<xs:complexType>
<xs:sequence>
<xs:element name="dividendo" type="xs:int"/>
<xs:element name="divisor" type="xs:int"/>
</xs:sequence>
</xs:complexType>
</xs:element>
<xs:element name="divisionRespuesta">
<xs:complexType>
<xs:sequence>
<xs:element name="cociente" type="xs:int"/>
<xs:element name="resto" type="xs:int"/>
</xs:sequence>
</xs:complexType>
</xs:element>
<xs:element name="divisionPorCero" type="xs:string"/>
<xs:element name="sumaSolicitud">
<xs:complexType>
<xs:sequence>
<xs:element name="numero1" type="xs:int"/>
<xs:element name="numero2" type="xs:int"/>
</xs:sequence>
</xs:complexType>
</xs:element>
<xs:element name="sumaRespuesta">
<xs:complexType>
<xs:sequence>
<xs:element name="numero" type="xs:int"/>
</xs:sequence>
</xs:complexType>
</xs:element>
</xs:schema>
</wsdl:types>
<wsdl:message name="divisionSolicitud">
<wsdl:part name="parameters" element="calc:divisionSolicitud">
</wsdl:part>
</wsdl:message>
<wsdl:message name="divisionRespuesta">
<wsdl:part name="parameters" element="calc:divisionRespuesta">
</wsdl:part>
</wsdl:message>
<wsdl:message name="divisionPorCero">
<wsdl:part name="divisionPorCero" element="calc:divisionPorCero">
</wsdl:part>
</wsdl:message>
<wsdl:message name="sumarResponse">
<wsdl:part name="parameters" element="calc:sumaRespuesta">
</wsdl:part>
</wsdl:message>
<wsdl:message name="sumarRequest">
<wsdl:part name="parameters" element="calc:sumaSolicitud">
</wsdl:part>
</wsdl:message>
<wsdl:portType name="Calculadora">
<wsdl:operation name="dividir" parameterOrder="parameters">
<wsdl:input message="calc:divisionSolicitud">
</wsdl:input>
<wsdl:output message="calc:divisionRespuesta">
</wsdl:output>
<wsdl:fault name="divisionPorCero" message="calc:divisionPorCero">
</wsdl:fault>
</wsdl:operation>
<wsdl:operation name="sumar">
<wsdl:input message="calc:sumarRequest">
</wsdl:input>
<wsdl:output message="calc:sumarResponse">
</wsdl:output>
</wsdl:operation>
</wsdl:portType>
<wsdl:binding name="CalculadoraServiceSoapBinding" type="calc:Calculadora">
<soap:binding style="document" transport="http://schemas.xmlsoap.org/soap/http"/>
<wsdl:operation name="dividir">
<soap:operation soapAction="" style="document"/>
<wsdl:input>
<soap:body parts="parameters" use="literal"/>
</wsdl:input>
<wsdl:output>
<soap:body parts="parameters" use="literal"/>
</wsdl:output>
<wsdl:fault name="divisionPorCero">
<soap:fault name="divisionPorCero" use="literal"/>
</wsdl:fault>
</wsdl:operation>
<wsdl:operation name="sumar">
<soap:operation soapAction="http://www.dosideas.com/cursos/calculadora/sumar"/>
<wsdl:input>
<soap:body use="literal"/>
</wsdl:input>
<wsdl:output>
<soap:body use="literal"/>
</wsdl:output>
</wsdl:operation>
</wsdl:binding>
<wsdl:service name="CalculadoraService">
<wsdl:port name="CalculadoraSoapPort" binding="calc:CalculadoraServiceSoapBinding">
<soap:address location="http://localhost:8080/Axis2-15/services/CalculadoraService"/>
</wsdl:port>
</wsdl:service>
</wsdl:definitions>
==Proyectos de ejemplo para descargar==
Aquí que te podés descargar 2 versiones del proyecto

* [http://www.dosideas.com/descargas/category/8-.html?download=32%3A2-1.4.1-p-1.4 Axis2 1.4.1 para JDK 1.4]
* [http://www.dosideas.com/descargas/category/8-.html?download=33%3A2-1.5.1-p-5 Axis2 1.5.1 para JDK 5]

==Ver también==
* [[Web Service]]
* [[Clientes De Web Service]]
* [[Cliente Web Service con Ant y Axis2]]
* [[Web Service con Axis 2 para Weblogic y Websphere]]
* [[Web Service Con Spring]]
* [http://ws.apache.org/axis2/ Apache Axis 2]

[[Category:Java]]
[[Category:Web Service]]

Apache CXF

2010-02-18T17:26:11Z

Esteban: /* Ver también */

[[Category:Java]]
[[Category:Web Service]]
=== Construcción de un servicio y su cliente con cxf ===
La noticia [http://www.dosideas.com/noticias/java/396-servicios-web-con-apache-cxf.html Servicios web con Apache CXF] da una introducción a cxf, explica cómo crear un [[Web Service]] con Apache CXF y también la creación de un cliente que lo consuma.

=== Apache CXF y WebLogic 9.2 ===
Deployar una aplicación que utiliza Apache CXF en [[WebLogic]] 9.2 provoca un conflicto de versiones de las librerías de jax-ws. Para solucionarlo, el archivo ''weblogic-application.xml'' debe contener lo siguiente:

<code xml>
<?xml version="1.0" encoding="UTF-8"?>
<weblogic-application xmlns="http://www.bea.com/ns/weblogic/90">


<prefer-application-packages>
<package-name>org.apache.xerces.*</package-name>
<package-name>javax.jws.*</package-name>
</prefer-application-packages>

</weblogic-application>
</code>

De esta manera indicamos a weblogic que debe dar prioridad a las clases contenidas en el jar de jax-ws provisto por la aplicación, por sobre la versión de esas mismas clases q están contenidas en el weblogic.jar.

== Ver también ==
* [[Web Service]]
* [http://www.dosideas.com/java/396-servicios-web-con-apache-cxf.html Servicios web con Apache CXF]
* [[Creación de un Servicio Web partiendo de un WSDL con Apache CXF]]

Web Service con Axis 2

2010-02-17T17:23:32Z

Esteban: /* Descargas */

Axis 2 es un framework para el desarrollo y consumo de Webservices en Java, e intenta solucionar algunos temas pendientes de su predecesor Axis 1.

A continuación haremos un proyecto prototipo, partiendo de un WSDL de un servicio sencillo de calculadora.

== Pasos: ==

==== Crear un proyecto Web con Netbeans ====
Utilizaremos el nombre DosIdeas-Axis2 para el proyecto.
==== Agregar la librería Axis 2 al proyecto ====
Como puede ser que no este instalada, deberemos bajarla del sitio Web (http://ws.apache.org/axis2/download/1_4_1/download.cgi). Utilizaremos la versión 1.4.1 que es la última versión compatible con Java 1.4.
En la versión 1.5 de Axis 2 cambia bastante la forma de construir Web Services, pero no será visto en este tutorial.

El proyecto viene con muchas mas librerías de las que son estrictamente necesarias para el ejemplo. No obstante, para simplificar incorporaremos todas.
==== Agregar Spring 2.5 o posterior ====
Si bien no es imprescindible para el funcionamiento, permite una clara separación de la lógica de negocio de la implementación del servicio Web.
==== Copiar WSDL de ejemplo al proyecto ====
Para este proyecto, tenemos un WSDL de un servicio Calculadora, que tiene 2 operaciones:
* dividir (división entera)
* sumar

La operación dividir necesita 2 parámetros, dividendo y divisor y devuelve 2 valores, cociente y resto. Además debe devolver un mensaje de error en caso que el divisor sea 0.

[[WSDL de Servicio Calculadora]]

==== Generar código java a partir de un documento WSDL ====
Axis 2 viene con un generador de código que ahorra al usuario la construcción de todas clases necesarias para la implementación de WebServices.
En este caso utilizaremos una tarea Ant para construir dichas clases. En caso de trabajar con Eclipse, también tendremos la posibilidad de utilizar el plugin de Web Services, que viene con la distribución JEE del IDE.

<property name="axis2.home" value="D:/development/axis2-1.4.1" />
<property name="output.wsdl2java.dir" value="build/codegen" />
<property name="src.dir" value="src/java" />

<property name="wsdl.uri" value="resources/wsdl/CalculadoraService.wsdl" />
<property name="services.folder" value="web/WEB-INF/services" />

<property name="service.name" value="CalculadoraService" />

<property name="service.wsdl.uri" value="resources/wsdl/${service.name}.wsdl" />
<property name="service.folder" value="${services.folder}/${service.name}/META-INF" />

<path id="axis2.classpath">
<fileset dir="${axis2.home}/lib">
<include name="**/*.jar" />
</fileset>
</path>

<target name="run-wsdl2java-server">
<mkdir dir="${output.wsdl2java.dir}" />
<delete dir="${output.wsdl2java.dir}" includeemptydirs="true" />
<java classname="org.apache.axis2.wsdl.WSDL2Java" fork="true">
<classpath refid="axis2.classpath"/>
<arg value="-uri"/><arg file="${wsdl.uri}"/>
<arg value="-ss"/>
<arg value="-g"/>
<arg value="-sd"/>
<arg value="-o"/><arg file="${output.wsdl2java.dir}"/>
</java>

<copy todir="${src.dir}" overwrite="true">
<fileset dir="${output.wsdl2java.dir}/src">
<include name="**/*.java"/>
</fileset>
</copy>
<mkdir dir="${service.folder}" />
<delete dir="${service.folder}" includeemptydirs="true" />

<mkdir dir="${service.folder}/service" />

<copy todir="${service.folder}/service" overwrite="true">
<fileset dir="${output.wsdl2java.dir}/resources">
<include name="**/*"/>
</fileset>
</copy>
</target>

Esta tarea Ant generará todas las clases involucradas en el Web Service y una serie de archivos, incluyendo la clase que contendrá la lógica de negocio, la cual vendrá con implementaciones dummy.
Luego se copiaran los clases java al directorio de fuentes y por último se copiará el archivo de configuración y el wsdl al directorio de servicio predeterminado de Axis.

==== Implementar lógica de negocio ====
De las clases generadas, la única que tendremos que implementar es la que tiene el sufijo Skeleton. En caso que implementaramos la lógica aquí, sería poco reutilizable, por lo que haremos en un paso siguiente una clase con la lógica de negocio y en el Skeleton tan solo invocaremos dicha clase.

public class CalculadoraServiceSkeleton {

protected CalculadoraBo calculadoraBo = null;

public CalculadoraBo getCalculadoraBo() {
return calculadoraBo;
}

public void setCalculadoraBo(CalculadoraBo calculadoraBo) {
this.calculadoraBo = calculadoraBo;
}

/**
* Auto generated method signature
*
* @param divisionSolicitud
* @throws DivisionPorCeroError :
*/
public com.dosideas.www.cursos.calculadora.DivisionRespuesta dividir(
com.dosideas.www.cursos.calculadora.DivisionSolicitud divisionSolicitud)
throws DivisionPorCeroError {
int divisor = divisionSolicitud.getDivisor();
int dividendo = divisionSolicitud.getDividendo();
try {
int cociente = calculadoraBo.divide(dividendo, divisor);
int resto = calculadoraBo.modulo(dividendo, divisor);
DivisionRespuesta rta = new DivisionRespuesta();
rta.setCociente(cociente);
rta.setResto(resto);
return rta;
} catch (ArithmeticException e) {
DivisionPorCeroException error = new DivisionPorCeroException();
// En caso que no se setee el objeto descripcion, tira un error genérico AxisFault
DivisionPorCero div = new DivisionPorCero();
// Si no se llenan todos los campos obligatorios, devuelve error 500 de http
div.setDivisionPorCero("Descripcion del error");
error.setFaultMessage(div);
throw error;
}
}

/**
* Auto generated method signature
*
* @param sumaSolicitud
*/
public com.dosideas.www.cursos.calculadora.SumaRespuesta sumar(
com.dosideas.www.cursos.calculadora.SumaSolicitud sumaSolicitud) {
SumaRespuesta rta = new SumaRespuesta();
rta.setNumero(calculadoraBo.sum(sumaSolicitud.getNumero1(), sumaSolicitud.getNumero2()));
return rta;
}
}
Se recomienda prestar especial atención al tratamiento de los errores custom.
Cada error de negocio cuenta con un tipo interno, que contiene la descripción del error. En caso de no llenar dicha descripción, se lanzará un error genérico AxisFault.
Además hay que tener especial cuidado al llenar dicha descripción. En caso que no se cumpla con el formato, Axis devuelve un error http 500, en vez de un error descriptivo.
Luego se crea la clase con la lógica de negocio, la cual después se inyectará en la clase Skeleton via Spring

public class CalculadoraBo {
public int sum(int n1, int n2) {
return n1 + n2;
}

public int divide(int n1, int n2){
return n1 / n2;
}

public int modulo(int n1, int n2){
return n1 % n2;
}
}

==== Configurar descriptores de Spring ====

<bean id="applicationContext"
class="org.apache.axis2.extensions.spring.receivers.ApplicationContextHolder" />

<bean id="calculadoraBo" class="com.dosideas.business.CalculadoraBo">

</bean>
<bean id="calculadoraService" class="com.dosideas.www.cursos.calculadora.CalculadoraServiceSkeleton">
<property name="calculadoraBo" ref="calculadoraBo" />
</bean>

==== Configurar web.xml ====

<?xml version="1.0" encoding="UTF-8"?>
<web-app version="2.4" xmlns="http://java.sun.com/xml/ns/j2ee"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xsi:schemaLocation="http://java.sun.com/xml/ns/j2ee
http://java.sun.com/xml/ns/j2ee/web-app_2_4.xsd">
<context-param>
<param-name>contextConfigLocation</param-name>
<param-value>/WEB-INF/applicationContext.xml</param-value>
</context-param>

<listener>
<listener-class>org.springframework.web.context.ContextLoaderListener</listener-class>
</listener>

<servlet>
<display-name>Apache-Axis Servlet</display-name>
<servlet-name>AxisServlet</servlet-name>
<servlet-class>org.apache.axis2.transport.http.AxisServlet</servlet-class>
</servlet>

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

<welcome-file-list>
<welcome-file>index.jsp</welcome-file>
</welcome-file-list>
</web-app>

==== Modificar services.xml para que use Spring ====

<parameter name="ServiceObjectSupplier" locked="false">
org.apache.axis2.extensions.spring.receivers.SpringAppContextAwareObjectSupplier</parameter>
<parameter name="SpringBeanName" locked="false">calculadoraService</parameter>

La configuración descrita aquí funciona tanto para Tomcat como para Glassfish.
En caso que se desee hacer un Web Service para Weblogic o para Websphere, son necesarios algunos pasos adicionales. Se sugiere leer la siguiente nota: [[Web Service con Axis 2 para Weblogic y Websphere]]

==== Sugerencias para la construcción del WSDL ====

* No utilizar las palabras Error o Exception al final de los tipos o de los mensajes Fault. Estas palabras son utilizadas por el generador de código, por lo que luego el código generado será incorrecto.
* Si se usa la versión 1.4 de Axis 2, no nombrar de la misma forma un mensaje de error que el tipo que contiene. Genera un error extraño en el generador de código, por el que genera 2 excepciones con el nombre del mensaje. Ej: Con el tipo DivisionPorCero, generó DivisionPorCeroException0 y DivisionPorCeroException1.

== Recursos ==

=== WSDL de Calculadora Service ===

<?xml version="1.0" encoding="UTF-8"?>
<wsdl:definitions name="CalculadoraServiceDefinitions" targetNamespace="http://www.dosideas.com/cursos/calculadora" xmlns:wsdl="http://schemas.xmlsoap.org/wsdl/" xmlns:xs="http://www.w3.org/2001/XMLSchema" xmlns:calc="http://www.dosideas.com/cursos/calculadora" xmlns:soap="http://schemas.xmlsoap.org/wsdl/soap/">
<wsdl:types>
<xs:schema attributeFormDefault="unqualified" elementFormDefault="qualified" targetNamespace="http://www.dosideas.com/cursos/calculadora">
<xs:element name="divisionSolicitud">
<xs:complexType>
<xs:sequence>
<xs:element name="dividendo" type="xs:int"/>
<xs:element name="divisor" type="xs:int"/>
</xs:sequence>
</xs:complexType>
</xs:element>
<xs:element name="divisionRespuesta">
<xs:complexType>
<xs:sequence>
<xs:element name="cociente" type="xs:int"/>
<xs:element name="resto" type="xs:int"/>
</xs:sequence>
</xs:complexType>
</xs:element>
<xs:element name="divisionPorCero" type="xs:string"/>
<xs:element name="sumaSolicitud">
<xs:complexType>
<xs:sequence>
<xs:element name="numero1" type="xs:int"/>
<xs:element name="numero2" type="xs:int"/>
</xs:sequence>
</xs:complexType>
</xs:element>
<xs:element name="sumaRespuesta">
<xs:complexType>
<xs:sequence>
<xs:element name="numero" type="xs:int"/>
</xs:sequence>
</xs:complexType>
</xs:element>
</xs:schema>
</wsdl:types>
<wsdl:message name="divisionSolicitud">
<wsdl:part name="parameters" element="calc:divisionSolicitud">
</wsdl:part>
</wsdl:message>
<wsdl:message name="divisionRespuesta">
<wsdl:part name="parameters" element="calc:divisionRespuesta">
</wsdl:part>
</wsdl:message>
<wsdl:message name="divisionPorCero">
<wsdl:part name="divisionPorCero" element="calc:divisionPorCero">
</wsdl:part>
</wsdl:message>
<wsdl:message name="sumarResponse">
<wsdl:part name="parameters" element="calc:sumaRespuesta">
</wsdl:part>
</wsdl:message>
<wsdl:message name="sumarRequest">
<wsdl:part name="parameters" element="calc:sumaSolicitud">
</wsdl:part>
</wsdl:message>
<wsdl:portType name="Calculadora">
<wsdl:operation name="dividir" parameterOrder="parameters">
<wsdl:input message="calc:divisionSolicitud">
</wsdl:input>
<wsdl:output message="calc:divisionRespuesta">
</wsdl:output>
<wsdl:fault name="divisionPorCero" message="calc:divisionPorCero">
</wsdl:fault>
</wsdl:operation>
<wsdl:operation name="sumar">
<wsdl:input message="calc:sumarRequest">
</wsdl:input>
<wsdl:output message="calc:sumarResponse">
</wsdl:output>
</wsdl:operation>
</wsdl:portType>
<wsdl:binding name="CalculadoraServiceSoapBinding" type="calc:Calculadora">
<soap:binding style="document" transport="http://schemas.xmlsoap.org/soap/http"/>
<wsdl:operation name="dividir">
<soap:operation soapAction="" style="document"/>
<wsdl:input>
<soap:body parts="parameters" use="literal"/>
</wsdl:input>
<wsdl:output>
<soap:body parts="parameters" use="literal"/>
</wsdl:output>
<wsdl:fault name="divisionPorCero">
<soap:fault name="divisionPorCero" use="literal"/>
</wsdl:fault>
</wsdl:operation>
<wsdl:operation name="sumar">
<soap:operation soapAction="http://www.dosideas.com/cursos/calculadora/sumar"/>
<wsdl:input>
<soap:body use="literal"/>
</wsdl:input>
<wsdl:output>
<soap:body use="literal"/>
</wsdl:output>
</wsdl:operation>
</wsdl:binding>
<wsdl:service name="CalculadoraService">
<wsdl:port name="CalculadoraSoapPort" binding="calc:CalculadoraServiceSoapBinding">
<soap:address location="http://localhost:8080/Axis2-15/services/CalculadoraService"/>
</wsdl:port>
</wsdl:service>
</wsdl:definitions>
==Descargas==

Aquí que te puedes descargar 2 versiones del proyecto

[http://www.dosideas.com/descargas/category/8-.html?download=32%3A2-1.4.1-p-1.4 Axis2 1.4.1 para JDK 1.4 (18.94 MB)]

[http://www.dosideas.com/descargas/category/8-.html?download=33%3A2-1.5.1-p-5 Axis2 1.5.1 para JDK 5 (20.08 MB)]

==Ver también==
* [[Web Service]]
* [[Clientes De Web Service]]
* [[Cliente Web Service con Ant y Axis2]]
* [[Web Service con Axis 2 para Weblogic y Websphere]]
* [[Web Service Con Spring]]
* [http://ws.apache.org/axis2/ Apache Axis 2]

[[Category:Java]]
[[Category:Web Service]]

Web Service con Axis 2

2010-02-17T17:23:15Z

Esteban: Se agregaron los links de descarga al proyecto

Axis 2 es un framework para el desarrollo y consumo de Webservices en Java, e intenta solucionar algunos temas pendientes de su predecesor Axis 1.

A continuación haremos un proyecto prototipo, partiendo de un WSDL de un servicio sencillo de calculadora.

== Pasos: ==

==== Crear un proyecto Web con Netbeans ====
Utilizaremos el nombre DosIdeas-Axis2 para el proyecto.
==== Agregar la librería Axis 2 al proyecto ====
Como puede ser que no este instalada, deberemos bajarla del sitio Web (http://ws.apache.org/axis2/download/1_4_1/download.cgi). Utilizaremos la versión 1.4.1 que es la última versión compatible con Java 1.4.
En la versión 1.5 de Axis 2 cambia bastante la forma de construir Web Services, pero no será visto en este tutorial.

El proyecto viene con muchas mas librerías de las que son estrictamente necesarias para el ejemplo. No obstante, para simplificar incorporaremos todas.
==== Agregar Spring 2.5 o posterior ====
Si bien no es imprescindible para el funcionamiento, permite una clara separación de la lógica de negocio de la implementación del servicio Web.
==== Copiar WSDL de ejemplo al proyecto ====
Para este proyecto, tenemos un WSDL de un servicio Calculadora, que tiene 2 operaciones:
* dividir (división entera)
* sumar

La operación dividir necesita 2 parámetros, dividendo y divisor y devuelve 2 valores, cociente y resto. Además debe devolver un mensaje de error en caso que el divisor sea 0.

[[WSDL de Servicio Calculadora]]

==== Generar código java a partir de un documento WSDL ====
Axis 2 viene con un generador de código que ahorra al usuario la construcción de todas clases necesarias para la implementación de WebServices.
En este caso utilizaremos una tarea Ant para construir dichas clases. En caso de trabajar con Eclipse, también tendremos la posibilidad de utilizar el plugin de Web Services, que viene con la distribución JEE del IDE.

<property name="axis2.home" value="D:/development/axis2-1.4.1" />
<property name="output.wsdl2java.dir" value="build/codegen" />
<property name="src.dir" value="src/java" />

<property name="wsdl.uri" value="resources/wsdl/CalculadoraService.wsdl" />
<property name="services.folder" value="web/WEB-INF/services" />

<property name="service.name" value="CalculadoraService" />

<property name="service.wsdl.uri" value="resources/wsdl/${service.name}.wsdl" />
<property name="service.folder" value="${services.folder}/${service.name}/META-INF" />

<path id="axis2.classpath">
<fileset dir="${axis2.home}/lib">
<include name="**/*.jar" />
</fileset>
</path>

<target name="run-wsdl2java-server">
<mkdir dir="${output.wsdl2java.dir}" />
<delete dir="${output.wsdl2java.dir}" includeemptydirs="true" />
<java classname="org.apache.axis2.wsdl.WSDL2Java" fork="true">
<classpath refid="axis2.classpath"/>
<arg value="-uri"/><arg file="${wsdl.uri}"/>
<arg value="-ss"/>
<arg value="-g"/>
<arg value="-sd"/>
<arg value="-o"/><arg file="${output.wsdl2java.dir}"/>
</java>

<copy todir="${src.dir}" overwrite="true">
<fileset dir="${output.wsdl2java.dir}/src">
<include name="**/*.java"/>
</fileset>
</copy>
<mkdir dir="${service.folder}" />
<delete dir="${service.folder}" includeemptydirs="true" />

<mkdir dir="${service.folder}/service" />

<copy todir="${service.folder}/service" overwrite="true">
<fileset dir="${output.wsdl2java.dir}/resources">
<include name="**/*"/>
</fileset>
</copy>
</target>

Esta tarea Ant generará todas las clases involucradas en el Web Service y una serie de archivos, incluyendo la clase que contendrá la lógica de negocio, la cual vendrá con implementaciones dummy.
Luego se copiaran los clases java al directorio de fuentes y por último se copiará el archivo de configuración y el wsdl al directorio de servicio predeterminado de Axis.

==== Implementar lógica de negocio ====
De las clases generadas, la única que tendremos que implementar es la que tiene el sufijo Skeleton. En caso que implementaramos la lógica aquí, sería poco reutilizable, por lo que haremos en un paso siguiente una clase con la lógica de negocio y en el Skeleton tan solo invocaremos dicha clase.

public class CalculadoraServiceSkeleton {

protected CalculadoraBo calculadoraBo = null;

public CalculadoraBo getCalculadoraBo() {
return calculadoraBo;
}

public void setCalculadoraBo(CalculadoraBo calculadoraBo) {
this.calculadoraBo = calculadoraBo;
}

/**
* Auto generated method signature
*
* @param divisionSolicitud
* @throws DivisionPorCeroError :
*/
public com.dosideas.www.cursos.calculadora.DivisionRespuesta dividir(
com.dosideas.www.cursos.calculadora.DivisionSolicitud divisionSolicitud)
throws DivisionPorCeroError {
int divisor = divisionSolicitud.getDivisor();
int dividendo = divisionSolicitud.getDividendo();
try {
int cociente = calculadoraBo.divide(dividendo, divisor);
int resto = calculadoraBo.modulo(dividendo, divisor);
DivisionRespuesta rta = new DivisionRespuesta();
rta.setCociente(cociente);
rta.setResto(resto);
return rta;
} catch (ArithmeticException e) {
DivisionPorCeroException error = new DivisionPorCeroException();
// En caso que no se setee el objeto descripcion, tira un error genérico AxisFault
DivisionPorCero div = new DivisionPorCero();
// Si no se llenan todos los campos obligatorios, devuelve error 500 de http
div.setDivisionPorCero("Descripcion del error");
error.setFaultMessage(div);
throw error;
}
}

/**
* Auto generated method signature
*
* @param sumaSolicitud
*/
public com.dosideas.www.cursos.calculadora.SumaRespuesta sumar(
com.dosideas.www.cursos.calculadora.SumaSolicitud sumaSolicitud) {
SumaRespuesta rta = new SumaRespuesta();
rta.setNumero(calculadoraBo.sum(sumaSolicitud.getNumero1(), sumaSolicitud.getNumero2()));
return rta;
}
}
Se recomienda prestar especial atención al tratamiento de los errores custom.
Cada error de negocio cuenta con un tipo interno, que contiene la descripción del error. En caso de no llenar dicha descripción, se lanzará un error genérico AxisFault.
Además hay que tener especial cuidado al llenar dicha descripción. En caso que no se cumpla con el formato, Axis devuelve un error http 500, en vez de un error descriptivo.
Luego se crea la clase con la lógica de negocio, la cual después se inyectará en la clase Skeleton via Spring

public class CalculadoraBo {
public int sum(int n1, int n2) {
return n1 + n2;
}

public int divide(int n1, int n2){
return n1 / n2;
}

public int modulo(int n1, int n2){
return n1 % n2;
}
}

==== Configurar descriptores de Spring ====

<bean id="applicationContext"
class="org.apache.axis2.extensions.spring.receivers.ApplicationContextHolder" />

<bean id="calculadoraBo" class="com.dosideas.business.CalculadoraBo">

</bean>
<bean id="calculadoraService" class="com.dosideas.www.cursos.calculadora.CalculadoraServiceSkeleton">
<property name="calculadoraBo" ref="calculadoraBo" />
</bean>

==== Configurar web.xml ====

<?xml version="1.0" encoding="UTF-8"?>
<web-app version="2.4" xmlns="http://java.sun.com/xml/ns/j2ee"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xsi:schemaLocation="http://java.sun.com/xml/ns/j2ee
http://java.sun.com/xml/ns/j2ee/web-app_2_4.xsd">
<context-param>
<param-name>contextConfigLocation</param-name>
<param-value>/WEB-INF/applicationContext.xml</param-value>
</context-param>

<listener>
<listener-class>org.springframework.web.context.ContextLoaderListener</listener-class>
</listener>

<servlet>
<display-name>Apache-Axis Servlet</display-name>
<servlet-name>AxisServlet</servlet-name>
<servlet-class>org.apache.axis2.transport.http.AxisServlet</servlet-class>
</servlet>

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

<welcome-file-list>
<welcome-file>index.jsp</welcome-file>
</welcome-file-list>
</web-app>

==== Modificar services.xml para que use Spring ====

<parameter name="ServiceObjectSupplier" locked="false">
org.apache.axis2.extensions.spring.receivers.SpringAppContextAwareObjectSupplier</parameter>
<parameter name="SpringBeanName" locked="false">calculadoraService</parameter>

La configuración descrita aquí funciona tanto para Tomcat como para Glassfish.
En caso que se desee hacer un Web Service para Weblogic o para Websphere, son necesarios algunos pasos adicionales. Se sugiere leer la siguiente nota: [[Web Service con Axis 2 para Weblogic y Websphere]]

==== Sugerencias para la construcción del WSDL ====

* No utilizar las palabras Error o Exception al final de los tipos o de los mensajes Fault. Estas palabras son utilizadas por el generador de código, por lo que luego el código generado será incorrecto.
* Si se usa la versión 1.4 de Axis 2, no nombrar de la misma forma un mensaje de error que el tipo que contiene. Genera un error extraño en el generador de código, por el que genera 2 excepciones con el nombre del mensaje. Ej: Con el tipo DivisionPorCero, generó DivisionPorCeroException0 y DivisionPorCeroException1.

== Recursos ==

=== WSDL de Calculadora Service ===

<?xml version="1.0" encoding="UTF-8"?>
<wsdl:definitions name="CalculadoraServiceDefinitions" targetNamespace="http://www.dosideas.com/cursos/calculadora" xmlns:wsdl="http://schemas.xmlsoap.org/wsdl/" xmlns:xs="http://www.w3.org/2001/XMLSchema" xmlns:calc="http://www.dosideas.com/cursos/calculadora" xmlns:soap="http://schemas.xmlsoap.org/wsdl/soap/">
<wsdl:types>
<xs:schema attributeFormDefault="unqualified" elementFormDefault="qualified" targetNamespace="http://www.dosideas.com/cursos/calculadora">
<xs:element name="divisionSolicitud">
<xs:complexType>
<xs:sequence>
<xs:element name="dividendo" type="xs:int"/>
<xs:element name="divisor" type="xs:int"/>
</xs:sequence>
</xs:complexType>
</xs:element>
<xs:element name="divisionRespuesta">
<xs:complexType>
<xs:sequence>
<xs:element name="cociente" type="xs:int"/>
<xs:element name="resto" type="xs:int"/>
</xs:sequence>
</xs:complexType>
</xs:element>
<xs:element name="divisionPorCero" type="xs:string"/>
<xs:element name="sumaSolicitud">
<xs:complexType>
<xs:sequence>
<xs:element name="numero1" type="xs:int"/>
<xs:element name="numero2" type="xs:int"/>
</xs:sequence>
</xs:complexType>
</xs:element>
<xs:element name="sumaRespuesta">
<xs:complexType>
<xs:sequence>
<xs:element name="numero" type="xs:int"/>
</xs:sequence>
</xs:complexType>
</xs:element>
</xs:schema>
</wsdl:types>
<wsdl:message name="divisionSolicitud">
<wsdl:part name="parameters" element="calc:divisionSolicitud">
</wsdl:part>
</wsdl:message>
<wsdl:message name="divisionRespuesta">
<wsdl:part name="parameters" element="calc:divisionRespuesta">
</wsdl:part>
</wsdl:message>
<wsdl:message name="divisionPorCero">
<wsdl:part name="divisionPorCero" element="calc:divisionPorCero">
</wsdl:part>
</wsdl:message>
<wsdl:message name="sumarResponse">
<wsdl:part name="parameters" element="calc:sumaRespuesta">
</wsdl:part>
</wsdl:message>
<wsdl:message name="sumarRequest">
<wsdl:part name="parameters" element="calc:sumaSolicitud">
</wsdl:part>
</wsdl:message>
<wsdl:portType name="Calculadora">
<wsdl:operation name="dividir" parameterOrder="parameters">
<wsdl:input message="calc:divisionSolicitud">
</wsdl:input>
<wsdl:output message="calc:divisionRespuesta">
</wsdl:output>
<wsdl:fault name="divisionPorCero" message="calc:divisionPorCero">
</wsdl:fault>
</wsdl:operation>
<wsdl:operation name="sumar">
<wsdl:input message="calc:sumarRequest">
</wsdl:input>
<wsdl:output message="calc:sumarResponse">
</wsdl:output>
</wsdl:operation>
</wsdl:portType>
<wsdl:binding name="CalculadoraServiceSoapBinding" type="calc:Calculadora">
<soap:binding style="document" transport="http://schemas.xmlsoap.org/soap/http"/>
<wsdl:operation name="dividir">
<soap:operation soapAction="" style="document"/>
<wsdl:input>
<soap:body parts="parameters" use="literal"/>
</wsdl:input>
<wsdl:output>
<soap:body parts="parameters" use="literal"/>
</wsdl:output>
<wsdl:fault name="divisionPorCero">
<soap:fault name="divisionPorCero" use="literal"/>
</wsdl:fault>
</wsdl:operation>
<wsdl:operation name="sumar">
<soap:operation soapAction="http://www.dosideas.com/cursos/calculadora/sumar"/>
<wsdl:input>
<soap:body use="literal"/>
</wsdl:input>
<wsdl:output>
<soap:body use="literal"/>
</wsdl:output>
</wsdl:operation>
</wsdl:binding>
<wsdl:service name="CalculadoraService">
<wsdl:port name="CalculadoraSoapPort" binding="calc:CalculadoraServiceSoapBinding">
<soap:address location="http://localhost:8080/Axis2-15/services/CalculadoraService"/>
</wsdl:port>
</wsdl:service>
</wsdl:definitions>
==Descargas==

Aquí que te puedes descargar 2 versiones del proyecto

[http://www.dosideas.com/descargas/category/8-.html?download=32%3A2-1.4.1-p-1.4 Axis2 1.4.1 para JDK 1.4 (18.94 MB)]
[http://www.dosideas.com/descargas/category/8-.html?download=33%3A2-1.5.1-p-5 Axis2 1.5.1 para JDK 5 (20.08 MB)]

==Ver también==
* [[Web Service]]
* [[Clientes De Web Service]]
* [[Cliente Web Service con Ant y Axis2]]
* [[Web Service con Axis 2 para Weblogic y Websphere]]
* [[Web Service Con Spring]]
* [http://ws.apache.org/axis2/ Apache Axis 2]

[[Category:Java]]
[[Category:Web Service]]

Web Service con Axis 2

2010-02-16T20:44:42Z

Esteban: /* Sugerencias para la construcción del WSDL */

Axis 2 es un framework para el desarrollo y consumo de Webservices en Java, e intenta solucionar algunos temas pendientes de su predecesor Axis 1.

A continuación haremos un proyecto prototipo, partiendo de un WSDL de un servicio sencillo de calculadora.

== Pasos: ==

==== Crear un proyecto Web con Netbeans ====
Utilizaremos el nombre DosIdeas-Axis2 para el proyecto.
==== Agregar la librería Axis 2 al proyecto ====
Como puede ser que no este instalada, deberemos bajarla del sitio Web (http://ws.apache.org/axis2/download/1_4_1/download.cgi). Utilizaremos la versión 1.4.1 que es la última versión compatible con Java 1.4.
En la versión 1.5 de Axis 2 cambia bastante la forma de construir Web Services, pero no será visto en este tutorial.

El proyecto viene con muchas mas librerías de las que son estrictamente necesarias para el ejemplo. No obstante, para simplificar incorporaremos todas.
==== Agregar Spring 2.5 o posterior ====
Si bien no es imprescindible para el funcionamiento, permite una clara separación de la lógica de negocio de la implementación del servicio Web.
==== Copiar WSDL de ejemplo al proyecto ====
Para este proyecto, tenemos un WSDL de un servicio Calculadora, que tiene 2 operaciones:
* dividir (división entera)
* sumar

La operación dividir necesita 2 parámetros, dividendo y divisor y devuelve 2 valores, cociente y resto. Además debe devolver un mensaje de error en caso que el divisor sea 0.

[[WSDL de Servicio Calculadora]]

==== Generar código java a partir de un documento WSDL ====
Axis 2 viene con un generador de código que ahorra al usuario la construcción de todas clases necesarias para la implementación de WebServices.
En este caso utilizaremos una tarea Ant para construir dichas clases. En caso de trabajar con Eclipse, también tendremos la posibilidad de utilizar el plugin de Web Services, que viene con la distribución JEE del IDE.

<property name="axis2.home" value="D:/development/axis2-1.4.1" />
<property name="output.wsdl2java.dir" value="build/codegen" />
<property name="src.dir" value="src/java" />

<property name="wsdl.uri" value="resources/wsdl/CalculadoraService.wsdl" />
<property name="services.folder" value="web/WEB-INF/services" />

<property name="service.name" value="CalculadoraService" />

<property name="service.wsdl.uri" value="resources/wsdl/${service.name}.wsdl" />
<property name="service.folder" value="${services.folder}/${service.name}/META-INF" />

<path id="axis2.classpath">
<fileset dir="${axis2.home}/lib">
<include name="**/*.jar" />
</fileset>
</path>

<target name="run-wsdl2java-server">
<mkdir dir="${output.wsdl2java.dir}" />
<delete dir="${output.wsdl2java.dir}" includeemptydirs="true" />
<java classname="org.apache.axis2.wsdl.WSDL2Java" fork="true">
<classpath refid="axis2.classpath"/>
<arg value="-uri"/><arg file="${wsdl.uri}"/>
<arg value="-ss"/>
<arg value="-g"/>
<arg value="-sd"/>
<arg value="-o"/><arg file="${output.wsdl2java.dir}"/>
</java>

<copy todir="${src.dir}" overwrite="true">
<fileset dir="${output.wsdl2java.dir}/src">
<include name="**/*.java"/>
</fileset>
</copy>
<mkdir dir="${service.folder}" />
<delete dir="${service.folder}" includeemptydirs="true" />

<mkdir dir="${service.folder}/service" />

<copy todir="${service.folder}/service" overwrite="true">
<fileset dir="${output.wsdl2java.dir}/resources">
<include name="**/*"/>
</fileset>
</copy>
</target>

Esta tarea Ant generará todas las clases involucradas en el Web Service y una serie de archivos, incluyendo la clase que contendrá la lógica de negocio, la cual vendrá con implementaciones dummy.
Luego se copiaran los clases java al directorio de fuentes y por último se copiará el archivo de configuración y el wsdl al directorio de servicio predeterminado de Axis.

==== Implementar lógica de negocio ====
De las clases generadas, la única que tendremos que implementar es la que tiene el sufijo Skeleton. En caso que implementaramos la lógica aquí, sería poco reutilizable, por lo que haremos en un paso siguiente una clase con la lógica de negocio y en el Skeleton tan solo invocaremos dicha clase.

public class CalculadoraServiceSkeleton {

protected CalculadoraBo calculadoraBo = null;

public CalculadoraBo getCalculadoraBo() {
return calculadoraBo;
}

public void setCalculadoraBo(CalculadoraBo calculadoraBo) {
this.calculadoraBo = calculadoraBo;
}

/**
* Auto generated method signature
*
* @param divisionSolicitud
* @throws DivisionPorCeroError :
*/
public com.dosideas.www.cursos.calculadora.DivisionRespuesta dividir(
com.dosideas.www.cursos.calculadora.DivisionSolicitud divisionSolicitud)
throws DivisionPorCeroError {
int divisor = divisionSolicitud.getDivisor();
int dividendo = divisionSolicitud.getDividendo();
try {
int cociente = calculadoraBo.divide(dividendo, divisor);
int resto = calculadoraBo.modulo(dividendo, divisor);
DivisionRespuesta rta = new DivisionRespuesta();
rta.setCociente(cociente);
rta.setResto(resto);
return rta;
} catch (ArithmeticException e) {
DivisionPorCeroException error = new DivisionPorCeroException();
// En caso que no se setee el objeto descripcion, tira un error genérico AxisFault
DivisionPorCero div = new DivisionPorCero();
// Si no se llenan todos los campos obligatorios, devuelve error 500 de http
div.setDivisionPorCero("Descripcion del error");
error.setFaultMessage(div);
throw error;
}
}

/**
* Auto generated method signature
*
* @param sumaSolicitud
*/
public com.dosideas.www.cursos.calculadora.SumaRespuesta sumar(
com.dosideas.www.cursos.calculadora.SumaSolicitud sumaSolicitud) {
SumaRespuesta rta = new SumaRespuesta();
rta.setNumero(calculadoraBo.sum(sumaSolicitud.getNumero1(), sumaSolicitud.getNumero2()));
return rta;
}
}
Se recomienda prestar especial atención al tratamiento de los errores custom.
Cada error de negocio cuenta con un tipo interno, que contiene la descripción del error. En caso de no llenar dicha descripción, se lanzará un error genérico AxisFault.
Además hay que tener especial cuidado al llenar dicha descripción. En caso que no se cumpla con el formato, Axis devuelve un error http 500, en vez de un error descriptivo.
Luego se crea la clase con la lógica de negocio, la cual después se inyectará en la clase Skeleton via Spring

public class CalculadoraBo {
public int sum(int n1, int n2) {
return n1 + n2;
}

public int divide(int n1, int n2){
return n1 / n2;
}

public int modulo(int n1, int n2){
return n1 % n2;
}
}

==== Configurar descriptores de Spring ====

<bean id="applicationContext"
class="org.apache.axis2.extensions.spring.receivers.ApplicationContextHolder" />

<bean id="calculadoraBo" class="com.dosideas.business.CalculadoraBo">

</bean>
<bean id="calculadoraService" class="com.dosideas.www.cursos.calculadora.CalculadoraServiceSkeleton">
<property name="calculadoraBo" ref="calculadoraBo" />
</bean>

==== Configurar web.xml ====

<?xml version="1.0" encoding="UTF-8"?>
<web-app version="2.4" xmlns="http://java.sun.com/xml/ns/j2ee"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xsi:schemaLocation="http://java.sun.com/xml/ns/j2ee
http://java.sun.com/xml/ns/j2ee/web-app_2_4.xsd">
<context-param>
<param-name>contextConfigLocation</param-name>
<param-value>/WEB-INF/applicationContext.xml</param-value>
</context-param>

<listener>
<listener-class>org.springframework.web.context.ContextLoaderListener</listener-class>
</listener>

<servlet>
<display-name>Apache-Axis Servlet</display-name>
<servlet-name>AxisServlet</servlet-name>
<servlet-class>org.apache.axis2.transport.http.AxisServlet</servlet-class>
</servlet>

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

<welcome-file-list>
<welcome-file>index.jsp</welcome-file>
</welcome-file-list>
</web-app>

==== Modificar services.xml para que use Spring ====

<parameter name="ServiceObjectSupplier" locked="false">
org.apache.axis2.extensions.spring.receivers.SpringAppContextAwareObjectSupplier</parameter>
<parameter name="SpringBeanName" locked="false">calculadoraService</parameter>

La configuración descrita aquí funciona tanto para Tomcat como para Glassfish.
En caso que se desee hacer un Web Service para Weblogic o para Websphere, son necesarios algunos pasos adicionales. Se sugiere leer la siguiente nota: [[Web Service con Axis 2 para Weblogic y Websphere]]

==== Sugerencias para la construcción del WSDL ====

* No utilizar las palabras Error o Exception al final de los tipos o de los mensajes Fault. Estas palabras son utilizadas por el generador de código, por lo que luego el código generado será incorrecto.
* Si se usa la versión 1.4 de Axis 2, no nombrar de la misma forma un mensaje de error que el tipo que contiene. Genera un error extraño en el generador de código, por el que genera 2 excepciones con el nombre del mensaje. Ej: Con el tipo DivisionPorCero, generó DivisionPorCeroException0 y DivisionPorCeroException1.

== Recursos ==

=== WSDL de Calculadora Service ===

<?xml version="1.0" encoding="UTF-8"?>
<wsdl:definitions name="CalculadoraServiceDefinitions" targetNamespace="http://www.dosideas.com/cursos/calculadora" xmlns:wsdl="http://schemas.xmlsoap.org/wsdl/" xmlns:xs="http://www.w3.org/2001/XMLSchema" xmlns:calc="http://www.dosideas.com/cursos/calculadora" xmlns:soap="http://schemas.xmlsoap.org/wsdl/soap/">
<wsdl:types>
<xs:schema attributeFormDefault="unqualified" elementFormDefault="qualified" targetNamespace="http://www.dosideas.com/cursos/calculadora">
<xs:element name="divisionSolicitud">
<xs:complexType>
<xs:sequence>
<xs:element name="dividendo" type="xs:int"/>
<xs:element name="divisor" type="xs:int"/>
</xs:sequence>
</xs:complexType>
</xs:element>
<xs:element name="divisionRespuesta">
<xs:complexType>
<xs:sequence>
<xs:element name="cociente" type="xs:int"/>
<xs:element name="resto" type="xs:int"/>
</xs:sequence>
</xs:complexType>
</xs:element>
<xs:element name="divisionPorCero" type="xs:string"/>
<xs:element name="sumaSolicitud">
<xs:complexType>
<xs:sequence>
<xs:element name="numero1" type="xs:int"/>
<xs:element name="numero2" type="xs:int"/>
</xs:sequence>
</xs:complexType>
</xs:element>
<xs:element name="sumaRespuesta">
<xs:complexType>
<xs:sequence>
<xs:element name="numero" type="xs:int"/>
</xs:sequence>
</xs:complexType>
</xs:element>
</xs:schema>
</wsdl:types>
<wsdl:message name="divisionSolicitud">
<wsdl:part name="parameters" element="calc:divisionSolicitud">
</wsdl:part>
</wsdl:message>
<wsdl:message name="divisionRespuesta">
<wsdl:part name="parameters" element="calc:divisionRespuesta">
</wsdl:part>
</wsdl:message>
<wsdl:message name="divisionPorCero">
<wsdl:part name="divisionPorCero" element="calc:divisionPorCero">
</wsdl:part>
</wsdl:message>
<wsdl:message name="sumarResponse">
<wsdl:part name="parameters" element="calc:sumaRespuesta">
</wsdl:part>
</wsdl:message>
<wsdl:message name="sumarRequest">
<wsdl:part name="parameters" element="calc:sumaSolicitud">
</wsdl:part>
</wsdl:message>
<wsdl:portType name="Calculadora">
<wsdl:operation name="dividir" parameterOrder="parameters">
<wsdl:input message="calc:divisionSolicitud">
</wsdl:input>
<wsdl:output message="calc:divisionRespuesta">
</wsdl:output>
<wsdl:fault name="divisionPorCero" message="calc:divisionPorCero">
</wsdl:fault>
</wsdl:operation>
<wsdl:operation name="sumar">
<wsdl:input message="calc:sumarRequest">
</wsdl:input>
<wsdl:output message="calc:sumarResponse">
</wsdl:output>
</wsdl:operation>
</wsdl:portType>
<wsdl:binding name="CalculadoraServiceSoapBinding" type="calc:Calculadora">
<soap:binding style="document" transport="http://schemas.xmlsoap.org/soap/http"/>
<wsdl:operation name="dividir">
<soap:operation soapAction="" style="document"/>
<wsdl:input>
<soap:body parts="parameters" use="literal"/>
</wsdl:input>
<wsdl:output>
<soap:body parts="parameters" use="literal"/>
</wsdl:output>
<wsdl:fault name="divisionPorCero">
<soap:fault name="divisionPorCero" use="literal"/>
</wsdl:fault>
</wsdl:operation>
<wsdl:operation name="sumar">
<soap:operation soapAction="http://www.dosideas.com/cursos/calculadora/sumar"/>
<wsdl:input>
<soap:body use="literal"/>
</wsdl:input>
<wsdl:output>
<soap:body use="literal"/>
</wsdl:output>
</wsdl:operation>
</wsdl:binding>
<wsdl:service name="CalculadoraService">
<wsdl:port name="CalculadoraSoapPort" binding="calc:CalculadoraServiceSoapBinding">
<soap:address location="http://localhost:8080/Axis2-15/services/CalculadoraService"/>
</wsdl:port>
</wsdl:service>
</wsdl:definitions>

==Ver también==
* [[Web Service]]
* [[Clientes De Web Service]]
* [[WSDL de CalculadoraService]]
* [[Cliente Web Service con Ant y Axis2]]
* [[Web Service con Axis 2 para Weblogic y Websphere]]
* [[Web Service Con Spring]]
* [http://ws.apache.org/axis2/ Apache Axis 2]

[[Category:Java]]
[[Category:Web Service]]

Web Service con Axis 2

2010-02-16T20:04:05Z

Esteban: Se incluyo el WSDL

Axis 2 es un framework para el desarrollo y consumo de Webservices en Java, e intenta solucionar algunos temas pendientes de su predecesor Axis 1.

A continuación haremos un proyecto prototipo, partiendo de un WSDL de un servicio sencillo de calculadora.

== Pasos: ==

==== Crear un proyecto Web con Netbeans ====
Utilizaremos el nombre DosIdeas-Axis2 para el proyecto.
==== Agregar la librería Axis 2 al proyecto ====
Como puede ser que no este instalada, deberemos bajarla del sitio Web (http://ws.apache.org/axis2/download/1_4_1/download.cgi). Utilizaremos la versión 1.4.1 que es la última versión compatible con Java 1.4.
En la versión 1.5 de Axis 2 cambia bastante la forma de construir Web Services, pero no será visto en este tutorial.

El proyecto viene con muchas mas librerías de las que son estrictamente necesarias para el ejemplo. No obstante, para simplificar incorporaremos todas.
==== Agregar Spring 2.5 o posterior ====
Si bien no es imprescindible para el funcionamiento, permite una clara separación de la lógica de negocio de la implementación del servicio Web.
==== Copiar WSDL de ejemplo al proyecto ====
Para este proyecto, tenemos un WSDL de un servicio Calculadora, que tiene 2 operaciones:
* dividir (división entera)
* sumar

La operación dividir necesita 2 parámetros, dividendo y divisor y devuelve 2 valores, cociente y resto. Además debe devolver un mensaje de error en caso que el divisor sea 0.

[[WSDL de Servicio Calculadora]]

==== Generar código java a partir de un documento WSDL ====
Axis 2 viene con un generador de código que ahorra al usuario la construcción de todas clases necesarias para la implementación de WebServices.
En este caso utilizaremos una tarea Ant para construir dichas clases. En caso de trabajar con Eclipse, también tendremos la posibilidad de utilizar el plugin de Web Services, que viene con la distribución JEE del IDE.

<property name="axis2.home" value="D:/development/axis2-1.4.1" />
<property name="output.wsdl2java.dir" value="build/codegen" />
<property name="src.dir" value="src/java" />

<property name="wsdl.uri" value="resources/wsdl/CalculadoraService.wsdl" />
<property name="services.folder" value="web/WEB-INF/services" />

<property name="service.name" value="CalculadoraService" />

<property name="service.wsdl.uri" value="resources/wsdl/${service.name}.wsdl" />
<property name="service.folder" value="${services.folder}/${service.name}/META-INF" />

<path id="axis2.classpath">
<fileset dir="${axis2.home}/lib">
<include name="**/*.jar" />
</fileset>
</path>

<target name="run-wsdl2java-server">
<mkdir dir="${output.wsdl2java.dir}" />
<delete dir="${output.wsdl2java.dir}" includeemptydirs="true" />
<java classname="org.apache.axis2.wsdl.WSDL2Java" fork="true">
<classpath refid="axis2.classpath"/>
<arg value="-uri"/><arg file="${wsdl.uri}"/>
<arg value="-ss"/>
<arg value="-g"/>
<arg value="-sd"/>
<arg value="-o"/><arg file="${output.wsdl2java.dir}"/>
</java>

<copy todir="${src.dir}" overwrite="true">
<fileset dir="${output.wsdl2java.dir}/src">
<include name="**/*.java"/>
</fileset>
</copy>
<mkdir dir="${service.folder}" />
<delete dir="${service.folder}" includeemptydirs="true" />

<mkdir dir="${service.folder}/service" />

<copy todir="${service.folder}/service" overwrite="true">
<fileset dir="${output.wsdl2java.dir}/resources">
<include name="**/*"/>
</fileset>
</copy>
</target>

Esta tarea Ant generará todas las clases involucradas en el Web Service y una serie de archivos, incluyendo la clase que contendrá la lógica de negocio, la cual vendrá con implementaciones dummy.
Luego se copiaran los clases java al directorio de fuentes y por último se copiará el archivo de configuración y el wsdl al directorio de servicio predeterminado de Axis.

==== Implementar lógica de negocio ====
De las clases generadas, la única que tendremos que implementar es la que tiene el sufijo Skeleton. En caso que implementaramos la lógica aquí, sería poco reutilizable, por lo que haremos en un paso siguiente una clase con la lógica de negocio y en el Skeleton tan solo invocaremos dicha clase.

public class CalculadoraServiceSkeleton {

protected CalculadoraBo calculadoraBo = null;

public CalculadoraBo getCalculadoraBo() {
return calculadoraBo;
}

public void setCalculadoraBo(CalculadoraBo calculadoraBo) {
this.calculadoraBo = calculadoraBo;
}

/**
* Auto generated method signature
*
* @param divisionSolicitud
* @throws DivisionPorCeroError :
*/
public com.dosideas.www.cursos.calculadora.DivisionRespuesta dividir(
com.dosideas.www.cursos.calculadora.DivisionSolicitud divisionSolicitud)
throws DivisionPorCeroError {
int divisor = divisionSolicitud.getDivisor();
int dividendo = divisionSolicitud.getDividendo();
try {
int cociente = calculadoraBo.divide(dividendo, divisor);
int resto = calculadoraBo.modulo(dividendo, divisor);
DivisionRespuesta rta = new DivisionRespuesta();
rta.setCociente(cociente);
rta.setResto(resto);
return rta;
} catch (ArithmeticException e) {
DivisionPorCeroException error = new DivisionPorCeroException();
// En caso que no se setee el objeto descripcion, tira un error genérico AxisFault
DivisionPorCero div = new DivisionPorCero();
// Si no se llenan todos los campos obligatorios, devuelve error 500 de http
div.setDivisionPorCero("Descripcion del error");
error.setFaultMessage(div);
throw error;
}
}

/**
* Auto generated method signature
*
* @param sumaSolicitud
*/
public com.dosideas.www.cursos.calculadora.SumaRespuesta sumar(
com.dosideas.www.cursos.calculadora.SumaSolicitud sumaSolicitud) {
SumaRespuesta rta = new SumaRespuesta();
rta.setNumero(calculadoraBo.sum(sumaSolicitud.getNumero1(), sumaSolicitud.getNumero2()));
return rta;
}
}
Se recomienda prestar especial atención al tratamiento de los errores custom.
Cada error de negocio cuenta con un tipo interno, que contiene la descripción del error. En caso de no llenar dicha descripción, se lanzará un error genérico AxisFault.
Además hay que tener especial cuidado al llenar dicha descripción. En caso que no se cumpla con el formato, Axis devuelve un error http 500, en vez de un error descriptivo.
Luego se crea la clase con la lógica de negocio, la cual después se inyectará en la clase Skeleton via Spring

public class CalculadoraBo {
public int sum(int n1, int n2) {
return n1 + n2;
}

public int divide(int n1, int n2){
return n1 / n2;
}

public int modulo(int n1, int n2){
return n1 % n2;
}
}

==== Configurar descriptores de Spring ====

<bean id="applicationContext"
class="org.apache.axis2.extensions.spring.receivers.ApplicationContextHolder" />

<bean id="calculadoraBo" class="com.dosideas.business.CalculadoraBo">

</bean>
<bean id="calculadoraService" class="com.dosideas.www.cursos.calculadora.CalculadoraServiceSkeleton">
<property name="calculadoraBo" ref="calculadoraBo" />
</bean>

==== Configurar web.xml ====

<?xml version="1.0" encoding="UTF-8"?>
<web-app version="2.4" xmlns="http://java.sun.com/xml/ns/j2ee"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xsi:schemaLocation="http://java.sun.com/xml/ns/j2ee
http://java.sun.com/xml/ns/j2ee/web-app_2_4.xsd">
<context-param>
<param-name>contextConfigLocation</param-name>
<param-value>/WEB-INF/applicationContext.xml</param-value>
</context-param>

<listener>
<listener-class>org.springframework.web.context.ContextLoaderListener</listener-class>
</listener>

<servlet>
<display-name>Apache-Axis Servlet</display-name>
<servlet-name>AxisServlet</servlet-name>
<servlet-class>org.apache.axis2.transport.http.AxisServlet</servlet-class>
</servlet>

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

<welcome-file-list>
<welcome-file>index.jsp</welcome-file>
</welcome-file-list>
</web-app>

==== Modificar services.xml para que use Spring ====

<parameter name="ServiceObjectSupplier" locked="false">
org.apache.axis2.extensions.spring.receivers.SpringAppContextAwareObjectSupplier</parameter>
<parameter name="SpringBeanName" locked="false">calculadoraService</parameter>

La configuración descrita aquí funciona tanto para Tomcat como para Glassfish.
En caso que se desee hacer un Web Service para Weblogic o para Websphere, son necesarios algunos pasos adicionales. Se sugiere leer la siguiente nota: [[Web Service con Axis 2 para Weblogic y Websphere]]

==== Sugerencias para la construcción del WSDL ====

* No utilizar las palabras Error o Exception al final de los tipos o de los mensajes Fault. Estas palabras son utilizadas por el generador de código, por lo que luego el código generado será incorrecto.

== Recursos ==

=== WSDL de Calculadora Service ===

<?xml version="1.0" encoding="UTF-8"?>
<wsdl:definitions name="CalculadoraServiceDefinitions" targetNamespace="http://www.dosideas.com/cursos/calculadora" xmlns:wsdl="http://schemas.xmlsoap.org/wsdl/" xmlns:xs="http://www.w3.org/2001/XMLSchema" xmlns:calc="http://www.dosideas.com/cursos/calculadora" xmlns:soap="http://schemas.xmlsoap.org/wsdl/soap/">
<wsdl:types>
<xs:schema attributeFormDefault="unqualified" elementFormDefault="qualified" targetNamespace="http://www.dosideas.com/cursos/calculadora">
<xs:element name="divisionSolicitud">
<xs:complexType>
<xs:sequence>
<xs:element name="dividendo" type="xs:int"/>
<xs:element name="divisor" type="xs:int"/>
</xs:sequence>
</xs:complexType>
</xs:element>
<xs:element name="divisionRespuesta">
<xs:complexType>
<xs:sequence>
<xs:element name="cociente" type="xs:int"/>
<xs:element name="resto" type="xs:int"/>
</xs:sequence>
</xs:complexType>
</xs:element>
<xs:element name="divisionPorCero" type="xs:string"/>
<xs:element name="sumaSolicitud">
<xs:complexType>
<xs:sequence>
<xs:element name="numero1" type="xs:int"/>
<xs:element name="numero2" type="xs:int"/>
</xs:sequence>
</xs:complexType>
</xs:element>
<xs:element name="sumaRespuesta">
<xs:complexType>
<xs:sequence>
<xs:element name="numero" type="xs:int"/>
</xs:sequence>
</xs:complexType>
</xs:element>
</xs:schema>
</wsdl:types>
<wsdl:message name="divisionSolicitud">
<wsdl:part name="parameters" element="calc:divisionSolicitud">
</wsdl:part>
</wsdl:message>
<wsdl:message name="divisionRespuesta">
<wsdl:part name="parameters" element="calc:divisionRespuesta">
</wsdl:part>
</wsdl:message>
<wsdl:message name="divisionPorCero">
<wsdl:part name="divisionPorCero" element="calc:divisionPorCero">
</wsdl:part>
</wsdl:message>
<wsdl:message name="sumarResponse">
<wsdl:part name="parameters" element="calc:sumaRespuesta">
</wsdl:part>
</wsdl:message>
<wsdl:message name="sumarRequest">
<wsdl:part name="parameters" element="calc:sumaSolicitud">
</wsdl:part>
</wsdl:message>
<wsdl:portType name="Calculadora">
<wsdl:operation name="dividir" parameterOrder="parameters">
<wsdl:input message="calc:divisionSolicitud">
</wsdl:input>
<wsdl:output message="calc:divisionRespuesta">
</wsdl:output>
<wsdl:fault name="divisionPorCero" message="calc:divisionPorCero">
</wsdl:fault>
</wsdl:operation>
<wsdl:operation name="sumar">
<wsdl:input message="calc:sumarRequest">
</wsdl:input>
<wsdl:output message="calc:sumarResponse">
</wsdl:output>
</wsdl:operation>
</wsdl:portType>
<wsdl:binding name="CalculadoraServiceSoapBinding" type="calc:Calculadora">
<soap:binding style="document" transport="http://schemas.xmlsoap.org/soap/http"/>
<wsdl:operation name="dividir">
<soap:operation soapAction="" style="document"/>
<wsdl:input>
<soap:body parts="parameters" use="literal"/>
</wsdl:input>
<wsdl:output>
<soap:body parts="parameters" use="literal"/>
</wsdl:output>
<wsdl:fault name="divisionPorCero">
<soap:fault name="divisionPorCero" use="literal"/>
</wsdl:fault>
</wsdl:operation>
<wsdl:operation name="sumar">
<soap:operation soapAction="http://www.dosideas.com/cursos/calculadora/sumar"/>
<wsdl:input>
<soap:body use="literal"/>
</wsdl:input>
<wsdl:output>
<soap:body use="literal"/>
</wsdl:output>
</wsdl:operation>
</wsdl:binding>
<wsdl:service name="CalculadoraService">
<wsdl:port name="CalculadoraSoapPort" binding="calc:CalculadoraServiceSoapBinding">
<soap:address location="http://localhost:8080/Axis2-15/services/CalculadoraService"/>
</wsdl:port>
</wsdl:service>
</wsdl:definitions>

==Ver también==
* [[Web Service]]
* [[Clientes De Web Service]]
* [[WSDL de CalculadoraService]]
* [[Cliente Web Service con Ant y Axis2]]
* [[Web Service con Axis 2 para Weblogic y Websphere]]
* [[Web Service Con Spring]]
* [http://ws.apache.org/axis2/ Apache Axis 2]

[[Category:Java]]
[[Category:Web Service]]

Web Service con Axis 2

2010-02-16T19:56:53Z

Esteban: /* Ver también */

Web Service con Axis 2

2010-02-16T19:53:11Z

Esteban: Modificaciones respecto el tratamiento de errores

Apache CXF

2010-02-15T18:04:53Z

Esteban:

Axis2ServiceDeployer

2010-02-08T13:15:31Z

Esteban: Axis2ServiceDeployer

package com.dosideas.spring;

import java.io.ByteArrayOutputStream;
import java.io.File;
import java.io.FileNotFoundException;
import java.io.FileOutputStream;
import java.io.IOException;
import java.io.InputStream;
import org.springframework.beans.BeansException;
import org.springframework.beans.factory.InitializingBean;
import org.springframework.context.ApplicationContext;
import org.springframework.context.ApplicationContextAware;
import org.springframework.web.context.WebApplicationContext;

/**
*
* @author ejgarcia
*/
public class Axis2ServiceDeployer implements InitializingBean, ApplicationContextAware {
/** Carpeta donde se van a desplegar los servicios.
* Debe coincidir la propiedad axis2.repository.path, declarada como
* init-param en la definición del AxisServlet en el archivo web.xml
*/
protected String servicesDeploymentFolder = null;
/** Nombre del servicio. El nombre debe coincidir con el wsdl */
protected String serviceName = null;
private WebApplicationContext ctx;

public String getServiceName() {
return serviceName;
}

public void setServiceName(String serviceName) {
this.serviceName = serviceName;
}

public String getServicesDeploymentFolder() {
return servicesDeploymentFolder;
}

public void setServicesDeploymentFolder(String servicesDeploymentFolder) {
this.servicesDeploymentFolder = servicesDeploymentFolder;
}

public void afterPropertiesSet() {
/** creo la estructura de directorios default */
File servicesDeploymentFolderFile = new File(servicesDeploymentFolder);
servicesDeploymentFolderFile.mkdirs();

File serviceFolderFile =
new File(servicesDeploymentFolderFile, "services" +
File.separator + serviceName + File.separator + "META-INF");
serviceFolderFile.mkdirs();

/** Copio los recursos al directorio */
String serviceFileResourcePath = "services/" + serviceName + "/META-INF/services.xml";
String serviceWsdlResourcePath = "services/" + serviceName + "/META-INF/" + serviceName + ".wsdl";

String serviceFileClassPath = "/WEB-INF/" + serviceFileResourcePath;
String serviceWsdlClassPath = "/WEB-INF/" + serviceWsdlResourcePath;
//ClassLoader cl = this.getClass().getClassLoader();
InputStream serviceIn = ctx.getServletContext().getResourceAsStream(serviceFileClassPath);
InputStream wsdlIn = ctx.getServletContext().getResourceAsStream(serviceWsdlClassPath);
System.err.println("Recurso 2: " + serviceFileClassPath + " : " + serviceIn);
System.err.println("Recurso 2: " + serviceWsdlClassPath + " : " + wsdlIn);
copyInputStreamToFile(serviceIn, new File(servicesDeploymentFolderFile, serviceFileResourcePath));
copyInputStreamToFile(wsdlIn, new File(servicesDeploymentFolderFile, serviceWsdlResourcePath));
}

private void copyInputStreamToFile(InputStream in, File file) {
if (in == null){System.err.println("No se pudo encontrar... "); return;}
FileOutputStream outToFile = null;
ByteArrayOutputStream out = null;
try {
byte[] buffer = new byte[10000];
out = new ByteArrayOutputStream();
outToFile = new FileOutputStream(file);
//int counter = 0;
int bytesRead = 0;
while ((bytesRead = in.read(buffer, 0, buffer.length)) > 0) {
System.err.println("bytes leidos: " + bytesRead);
out.write(buffer, 0, bytesRead);
//counter += bytesRead;
//if (bytesRead < buffer.length) break;
}
out.writeTo(outToFile);

in.close();
out.close();
outToFile.close();
} catch (FileNotFoundException ex) {
ex.printStackTrace();
} catch (IOException ex) {
ex.printStackTrace();
} finally {
try {
if (in != null) in.close();
if (outToFile != null) outToFile.close();
if (out != null) out.close();
} catch (IOException ex) {
ex.printStackTrace();
}
}
}

public void setApplicationContext(ApplicationContext arg0) throws BeansException {
this.ctx = (WebApplicationContext)arg0;
}
}

Web Service con Axis 2 para Weblogic y Websphere

2010-02-08T13:13:22Z

Esteban: Se agrega enlace a la clase

Hacer un webservice con Axis 2 para Weblogic o IBM Websphere, requiere algunos pasos extra. Esto está relacionado con la forma en que se publican los componentes en Weblogic. Este, a diferencia de los demás servidores de aplicaciones, no descomprime el WAR o el EAR durante la publicación. A saber, existen 3 modalidades para publicar componentes en Weblogic.

*Stage: el componente se publica comprimido y el servidor copia el componente a cada nodo de forma automática.
*Nostage: el componente se publica descomprimido manualmente. Los nodos acceden al mismo filesystem para leer el componente.
*Nostage-external: Ídem anterior pero con pasos adicionales de validación.

Axis 2 está preparado solamente leer archivos del filesystem, por lo que no puede interpretar referencias a recursos dentro de un paquete. Esta es la razón por la cual si se despliega un EAR o un WAR en modalidad Stage, los Webservices no funcionarán.

Existen 2 soluciones posibles:

1. Descomprimir el paquete (WAR o EAR) y publicarlo con la modalidad NoStage. Ventaja: funciona como en los demás servidores de aplicaciones, sin necesidad de cambios. Desventaja: en el escenario de despliegue en cluster, la caida del filesystem donde está desplegado el componente causa la no disponibilidad en todos los nodos (ya que todos los nodos leen el componente de ese único filesystem).

2. Aprovechar las características de publicación externa de Axis 2 y guardar en una carpeta local del filesystem la configuración de los servicios de Axis 2. Ventaja: permite la publicación en modalidad Stage; tiene alta disponibilidad en cluster. Desventaja: desarrollo más complejo; replicación innecesaria de recursos.

== Publicación Externa ==

Dado que Axis 2 solo puede tomar archivos del filesystem, como primer paso, antes que se inicialice Axis, vamos a copiar los archivos de configuración a una carpeta creada por nosotros en el filesystem.

Para ello vamos a tener que hacer 3 pasos: 1. Configurar en el archivo web.xml, un parametro de inicio para el AxisServlet, de forma que quede así.

<servlet>
<display-name>Apache-Axis Servlet</display-name>
<servlet-name>AxisServlet</servlet-name>
<servlet-class>org.apache.axis2.transport.http.AxisServlet</servlet-class>
'''<init-param>'''
'''<param-name>axis2.repository.path</param-name>'''
'''<param-value>''directorio a publicar''</param-value>'''
'''</init-param>'''
</servlet>

2. Crear una clase que haga la copia de los archivos de configuración de servicio antes que se inicie Axis, aprovechando la incorporación de Spring al proyecto.

/**
*
* @author ejgarcia
*/
public class Axis2ServiceDeployer implements InitializingBean, ApplicationContextAware {
/** Carpeta donde se van a desplegar los servicios.
* Debe coincidir la propiedad axis2.repository.path, declarada como
* init-param en la definición del AxisServlet en el archivo web.xml
*/
protected String servicesDeploymentFolder = null;
/** Nombre del servicio. El nombre debe coincidir con el wsdl */
protected String serviceName = null;
private WebApplicationContext ctx;

public void afterPropertiesSet() {
/** creo la estructura de directorios default */
File servicesDeploymentFolderFile = new File(servicesDeploymentFolder);
servicesDeploymentFolderFile.mkdirs();

File serviceFolderFile =
new File(servicesDeploymentFolderFile, "services" +
File.separator + serviceName + File.separator + "META-INF");
serviceFolderFile.mkdirs();

/** Copio los recursos al directorio */
String serviceFileResourcePath = "services/" + serviceName + "/META-INF/services.xml";
String serviceWsdlResourcePath = "services/" + serviceName + "/META-INF/" + serviceName + ".wsdl";

String serviceFileClassPath = "/WEB-INF/" + serviceFileResourcePath;
String serviceWsdlClassPath = "/WEB-INF/" + serviceWsdlResourcePath;
//ClassLoader cl = this.getClass().getClassLoader();
InputStream serviceIn = ctx.getServletContext().getResourceAsStream(serviceFileClassPath);
InputStream wsdlIn = ctx.getServletContext().getResourceAsStream(serviceWsdlClassPath);
System.err.println("Recurso 2: " + serviceFileClassPath + " : " + serviceIn);
System.err.println("Recurso 2: " + serviceWsdlClassPath + " : " + wsdlIn);
copyInputStreamToFile(serviceIn, new File(servicesDeploymentFolderFile, serviceFileResourcePath));
copyInputStreamToFile(wsdlIn, new File(servicesDeploymentFolderFile, serviceWsdlResourcePath));
}

private void copyInputStreamToFile(InputStream in, File file) {
if (in == null){System.err.println("No se pudo encontrar... "); return;}
FileOutputStream outToFile = null;
ByteArrayOutputStream out = null;
try {
byte[] buffer = new byte[10000];
out = new ByteArrayOutputStream();
outToFile = new FileOutputStream(file);
//int counter = 0;
int bytesRead = 0;
while ((bytesRead = in.read(buffer, 0, buffer.length)) > 0) {
System.err.println("bytes leidos: " + bytesRead);
out.write(buffer, 0, bytesRead);
//counter += bytesRead;
//if (bytesRead < buffer.length) break;
}
out.writeTo(outToFile);

in.close();
out.close();
outToFile.close();
} catch (FileNotFoundException ex) {
ex.printStackTrace();
} catch (IOException ex) {
ex.printStackTrace();
} finally {
try {
if (in != null) in.close();
if (outToFile != null) outToFile.close();
if (out != null) out.close();
} catch (IOException ex) {
ex.printStackTrace();
}
}
}
}

La clase Axis2ServiceDeployer implementa 2 intefases: InitializingBean y ApplicationContextAware. Spring, al detectar la interfaz InitializingBean, ejecuta el método afterPropertiesSet luego de la carga de las propiedades. Dado que Spring se inicia antes que Axis, basta con eso para que inicie el proceso. La otra interfaz, ApplicationContextAware, la necesitamos para obtener el contexto del servlet y de ahí poder acceder a la carpeta WEB-INF, dentro de la cual está la configuración de nuestro servicio. La implementación del método es sencilla. Se crean las carpetas en el filesystem local, se obtienen los recursos de dentro del WAR y se copian al filesystem, respetando la misma estructura de archivos, que es la predeterminada para Axis 2, que es:

WEB-INF/services/<nombre servicio>/META-INF/services.xml

WEB-INF/services/<nombre servicio>/META-INF/<nombre servicio>.wsdl

3. Por último se debe configurar en la clase de despliegue en Spring.

<bean id="axis2Servicedeployer" class="com.dosideas.spring.Axis2ServiceDeployer">
<property name="servicesDeploymentFolder" value="''directorio a publicar''" />
<property name="serviceName" value="''Nombre Servicio''" />
</bean>

El directorio a publicar debe coincidir con el declarado en web.xml

Para descargar la clase completa, haga click en el siguiente enlace: [[Axis2ServiceDeployer]].

==Ver también==
* [[Web Service]]
* [[Web Service con Axis 2]]
* [[Web Service Con Spring]]
* [http://ws.apache.org/axis2/ Apache Axis 2]

[[Category:Java]]
[[Category:Web Service]]
[[Category:Weblogic]]

WSDL de Servicio Calculadora

2010-02-08T13:11:04Z

Esteban: WSDL de ejemplo

<?xml version="1.0" encoding="UTF-8"?>
<s0:definitions name="CalculadoraServiceDefinitions"
targetNamespace="http://www.dosideas.com/cursos/calculadora"
xmlns:s0="http://schemas.xmlsoap.org/wsdl/"
xmlns:s1="http://www.dosideas.com/cursos/calculadora"
xmlns:p="http://www.w3.org/2001/XMLSchema"
xmlns:s3="http://schemas.xmlsoap.org/wsdl/soap/">
<s0:types>
<xs:schema attributeFormDefault="unqualified"
elementFormDefault="qualified"
targetNamespace="http://www.dosideas.com/cursos/calculadora"
xmlns:s0="http://schemas.xmlsoap.org/wsdl/"
xmlns:xs="http://www.w3.org/2001/XMLSchema">
<xs:element name="divisionSolicitud">
<xs:complexType>
<xs:sequence>
<xs:element name="dividendo" type="xs:int"/>
<xs:element name="divisor" type="xs:int"/>
</xs:sequence>
</xs:complexType>
</xs:element>
<xs:element name="divisionRespuesta">
<xs:complexType>
<xs:sequence>
<xs:element name="cociente" type="xs:int"/>
<xs:element name="resto" type="xs:int"/>
</xs:sequence>
</xs:complexType>
</xs:element>
<xs:element name="divisionPorCeroErrorType">
<xs:sequence>
<xs:element name="descripcionError" type="xs:string"/>
</xs:sequence>
</xs:element>
<xs:element name="sumaSolicitud">
<xs:complexType>
<xs:sequence>
<xs:element name="numero1" type="xs:int"/>
<xs:element name="numero2" type="xs:int"/>
</xs:sequence>
</xs:complexType>
</xs:element>
<xs:element name="sumaRespuesta">
<xs:complexType>
<xs:sequence>
<xs:element name="numero" type="xs:int"/>
</xs:sequence>
</xs:complexType>
</xs:element>
</xs:schema>
</s0:types>
<s0:message name="divisionSolicitud">
<s0:part name="parameters" element="s1:divisionSolicitud">
</s0:part>
</s0:message>
<s0:message name="divisionRespuesta">
<s0:part name="parameters" element="s1:divisionRespuesta">
</s0:part>
</s0:message>
<s0:message name="DivisionPorCeroError">
<s0:part name="DivisionPorCeroError" element="s1:divisionPorCeroErrorType">
</s0:part>
</s0:message>
<s0:message name="sumarResponse">
<s0:part name="parameters" element="s1:sumaRespuesta">
</s0:part>
</s0:message>
<s0:message name="sumarRequest">
<s0:part name="parameters" element="s1:sumaSolicitud">
</s0:part>
</s0:message>
<s0:portType name="Calculadora">
<s0:operation name="dividir" parameterOrder="parameters">
<s0:input message="s1:divisionSolicitud">
</s0:input>
<s0:output message="s1:divisionRespuesta">
</s0:output>
<s0:fault name="DivisionPorCeroError" message="s1:DivisionPorCeroError">
</s0:fault>
</s0:operation>
<s0:operation name="sumar">
<s0:input message="s1:sumarRequest">
</s0:input>
<s0:output message="s1:sumarResponse">
</s0:output>
</s0:operation>
</s0:portType>
<s0:binding name="CalculadoraServiceSoapBinding" type="s1:Calculadora">
<s3:binding style="document" transport="http://schemas.xmlsoap.org/soap/http"/>
<s0:operation name="dividir">
<s3:operation soapAction="" style="document"/>
<s0:input>
<s3:body parts="parameters" use="literal"/>
</s0:input>
<s0:output>
<s3:body parts="parameters" use="literal"/>
</s0:output>
<s0:fault name="DivisionPorCeroError">
<s3:fault name="DivisionPorCeroError" use="literal"/>
</s0:fault>
</s0:operation>
<s0:operation name="sumar">
<s3:operation soapAction="http://www.dosideas.com/cursos/calculadora/sumar"/>
<s0:input>
<s3:body use="literal"/>
</s0:input>
<s0:output>
<s3:body use="literal"/>
</s0:output>
</s0:operation>
</s0:binding>
<s0:service name="CalculadoraService">
<s0:port name="CalculadoraSoapPort" binding="s1:CalculadoraServiceSoapBinding">
<s3:address location="http://localhost:7001/DosIdeas-Axis2/services/CalculadoraService/"/>
</s0:port>
</s0:service>
</s0:definitions>

Web Service con Axis 2

2010-02-08T13:08:08Z

Esteban: Se agrega el link al WSDL de calculadora

Web Service con Axis 2

2010-02-04T20:28:10Z

Esteban: Se agregaron links

Web Service con Axis 2

2010-02-04T20:27:23Z

Esteban: Se agregaron links

Web Service con Axis 2

2010-02-04T20:25:18Z

Esteban: /* Configurar web.xml */

Web Service con Axis 2

2010-02-04T20:24:39Z

Esteban: /* Modificar services.xml para que use Spring */

Web Service con Axis 2

2010-02-04T20:24:10Z

Esteban: /* Modificar services.xml para que use Spring */

Web Service con Axis 2

2010-02-04T20:23:37Z

Esteban: Como crear Webservice con Axis 2 y spring

Web Service con Axis 2 para Weblogic y Websphere

2010-02-04T19:09:39Z

Esteban: Agregado de links

Hacer un webservice con Axis 2 para Weblogic o IBM Websphere, requiere algunos pasos extra. Esto está relacionado con la forma en que se publican los componentes en Weblogic. Este, a diferencia de los demás servidores de aplicaciones, no descomprime el WAR o el EAR durante la publicación. A saber, existen 3 modalidades para publicar componentes en Weblogic.

*Stage: el componente se publica comprimido y el servidor copia el componente a cada nodo de forma automática.
*Nostage: el componente se publica descomprimido manualmente. Los nodos acceden al mismo filesystem para leer el componente.
*Nostage-external: Ídem anterior pero con pasos adicionales de validación.

Axis 2 está preparado solamente leer archivos del filesystem, por lo que no puede interpretar referencias a recursos dentro de un paquete. Esta es la razón por la cual si se despliega un EAR o un WAR en modalidad Stage, los Webservices no funcionarán.

Existen 2 soluciones posibles:

1. Descomprimir el paquete (WAR o EAR) y publicarlo con la modalidad NoStage. Ventaja: funciona como en los demás servidores de aplicaciones, sin necesidad de cambios. Desventaja: en el escenario de despliegue en cluster, la caida del filesystem donde está desplegado el componente causa la no disponibilidad en todos los nodos (ya que todos los nodos leen el componente de ese único filesystem).

2. Aprovechar las características de publicación externa de Axis 2 y guardar en una carpeta local del filesystem la configuración de los servicios de Axis 2. Ventaja: permite la publicación en modalidad Stage; tiene alta disponibilidad en cluster. Desventaja: desarrollo más complejo; replicación innecesaria de recursos.

== Publicación Externa ==

Dado que Axis 2 solo puede tomar archivos del filesystem, como primer paso, antes que se inicialice Axis, vamos a copiar los archivos de configuración a una carpeta creada por nosotros en el filesystem.

Para ello vamos a tener que hacer 3 pasos: 1. Configurar en el archivo web.xml, un parametro de inicio para el AxisServlet, de forma que quede así.

<servlet>
<display-name>Apache-Axis Servlet</display-name>
<servlet-name>AxisServlet</servlet-name>
<servlet-class>org.apache.axis2.transport.http.AxisServlet</servlet-class>
'''<init-param>'''
'''<param-name>axis2.repository.path</param-name>'''
'''<param-value>''directorio a publicar''</param-value>'''
'''</init-param>'''
</servlet>

2. Crear una clase que haga la copia de los archivos de configuración de servicio antes que se inicie Axis, aprovechando la incorporación de Spring al proyecto.

/**
*
* @author ejgarcia
*/
public class Axis2ServiceDeployer implements InitializingBean, ApplicationContextAware {
/** Carpeta donde se van a desplegar los servicios.
* Debe coincidir la propiedad axis2.repository.path, declarada como
* init-param en la definición del AxisServlet en el archivo web.xml
*/
protected String servicesDeploymentFolder = null;
/** Nombre del servicio. El nombre debe coincidir con el wsdl */
protected String serviceName = null;
private WebApplicationContext ctx;

public void afterPropertiesSet() {
/** creo la estructura de directorios default */
File servicesDeploymentFolderFile = new File(servicesDeploymentFolder);
servicesDeploymentFolderFile.mkdirs();

File serviceFolderFile =
new File(servicesDeploymentFolderFile, "services" +
File.separator + serviceName + File.separator + "META-INF");
serviceFolderFile.mkdirs();

/** Copio los recursos al directorio */
String serviceFileResourcePath = "services/" + serviceName + "/META-INF/services.xml";
String serviceWsdlResourcePath = "services/" + serviceName + "/META-INF/" + serviceName + ".wsdl";

String serviceFileClassPath = "/WEB-INF/" + serviceFileResourcePath;
String serviceWsdlClassPath = "/WEB-INF/" + serviceWsdlResourcePath;
//ClassLoader cl = this.getClass().getClassLoader();
InputStream serviceIn = ctx.getServletContext().getResourceAsStream(serviceFileClassPath);
InputStream wsdlIn = ctx.getServletContext().getResourceAsStream(serviceWsdlClassPath);
System.err.println("Recurso 2: " + serviceFileClassPath + " : " + serviceIn);
System.err.println("Recurso 2: " + serviceWsdlClassPath + " : " + wsdlIn);
copyInputStreamToFile(serviceIn, new File(servicesDeploymentFolderFile, serviceFileResourcePath));
copyInputStreamToFile(wsdlIn, new File(servicesDeploymentFolderFile, serviceWsdlResourcePath));
}

private void copyInputStreamToFile(InputStream in, File file) {
if (in == null){System.err.println("No se pudo encontrar... "); return;}
FileOutputStream outToFile = null;
ByteArrayOutputStream out = null;
try {
byte[] buffer = new byte[10000];
out = new ByteArrayOutputStream();
outToFile = new FileOutputStream(file);
//int counter = 0;
int bytesRead = 0;
while ((bytesRead = in.read(buffer, 0, buffer.length)) > 0) {
System.err.println("bytes leidos: " + bytesRead);
out.write(buffer, 0, bytesRead);
//counter += bytesRead;
//if (bytesRead < buffer.length) break;
}
out.writeTo(outToFile);

in.close();
out.close();
outToFile.close();
} catch (FileNotFoundException ex) {
ex.printStackTrace();
} catch (IOException ex) {
ex.printStackTrace();
} finally {
try {
if (in != null) in.close();
if (outToFile != null) outToFile.close();
if (out != null) out.close();
} catch (IOException ex) {
ex.printStackTrace();
}
}
}
}

La clase Axis2ServiceDeployer implementa 2 intefases: InitializingBean y ApplicationContextAware. Spring, al detectar la interfaz InitializingBean, ejecuta el método afterPropertiesSet luego de la carga de las propiedades. Dado que Spring se inicia antes que Axis, basta con eso para que inicie el proceso. La otra interfaz, ApplicationContextAware, la necesitamos para obtener el contexto del servlet y de ahí poder acceder a la carpeta WEB-INF, dentro de la cual está la configuración de nuestro servicio. La implementación del método es sencilla. Se crean las carpetas en el filesystem local, se obtienen los recursos de dentro del WAR y se copian al filesystem, respetando la misma estructura de archivos, que es la predeterminada para Axis 2, que es:

WEB-INF/services/<nombre servicio>/META-INF/services.xml

WEB-INF/services/<nombre servicio>/META-INF/<nombre servicio>.wsdl

3. Por último se debe configurar en la clase de despliegue en Spring.

<bean id="axis2Servicedeployer" class="com.dosideas.spring.Axis2ServiceDeployer">
<property name="servicesDeploymentFolder" value="''directorio a publicar''" />
<property name="serviceName" value="''Nombre Servicio''" />
</bean>

El directorio a publicar debe coincidir con el declarado en web.xml

Para descargar la clase completa, haga click aquí.

==Ver también==
* [[Web Service]]
* [[Web Service con Axis 2]]
* [[Web Service Con Spring]]
* [http://ws.apache.org/axis2/ Apache Axis 2]

[[Category:Java]]
[[Category:Web Service]]
[[Category:Weblogic]]

Cliente Web Service con Ant y Axis2

2010-02-04T19:08:36Z

Esteban:

Crear un cliente Web Service con Axis2 es relativamente sencillo. Crear un cliente Web Service con Ant solo hay que saber algo de Ant, una herramienta indispensable ahora o en un futuro.

El proceso consiste en ejecutar la herramienta WSDL2Java de Axis2 sobre un fichero WSDL para generar el código Java del Stub y las clases OXM (mapeador objeto-XML) de los mensajes del servicio web para posteriormente copiar el código generado al proyecto. Y todo con un simple script de Ant.

==Requisitos==
Será necesario tener instalado Axis2, basta con bajarse la versión Standard y descomprimirla, y Ant.

==Definición de propiedades==
El script usará las siguientes propiedades:

* axis2.home: directorio donde está instalado Axis2.
* output.wsdl2java.dir: directorio donde el wsdl2java generará el código.
* src.dir: directorio dentro del proyecto donde se copiará el código generado.
* wsdl.uri: ruta hasta el fichero wsdl.
* stub.package.name: nombre del paquete para la clase Stub.
* xsd.namespacetopackages: equivalencia entre los namespaces de los schemas xsd que definen los mensajes y los correspondientes paquetes donde generar las clases OXM.
* synconly: booleano para indicar si queremos generar un Stub sólo para peticiones síncronas y no asíncronas.

Las propiedades pueden definirse en el propio script o externalizarse a un fichero de propiedades (todas menos src.dir). Un ejemplo de lo primero:

<code>
<property name="axis2.home" value="/deps/axis2-1.4.1" />
<property name="output.wsdl2java.dir" value="build/codegen" />
<property name="src.dir" value="src" />
<property name="wsdl.uri" value="resources/wsdl/myWsdl.wsdl" />
<property name="stub.package.name" value="ws.client" />
<property name="xsd.namespacetopackages" value="http://myService/xsd=ws.client.xsd" />
<property name="synconly" value="true" />
</code>

==Definición del task wsdl2java==
El task wsdl2java no es un task incluido en la distribución de Ant, por tanto hay que importar su definición. Para ello hay que cargar en el classpath los jars de Axis2 y luego hacer la definición.

<code>
<path id="axis2.classpath">
<fileset dir="${axis2.home}/lib">
<include name="**/*.jar" />
</fileset>
</path>

<taskdef name="wsdl2java" classname="org.apache.axis2.tool.ant.AntCodegenTask"
classpathref="axis2.classpath" />
</code>

== Ejecutar WSDL2Java ==

Finalmente llega el momento de definir el target que ejecutará el wsdl2java. Antes preparará el directorio de salida y después copiará el código generado al proyecto. Aquí está:

<code>
<target name="run-wsdl2java-client"
description="Genera un cliente webservice apartir de un wsdl">

<mkdir dir="${output.wsdl2java.dir}" />
<delete dir="${output.wsdl2java.dir}" includeemptydirs="true" />

<wsdl2java
output="${output.wsdl2java.dir}"
wsdlfilename="${wsdl.uri}"
synconly="${synconly}"
unpackClasses="true"
serverSide="false"
databindingName="adb"
packageName="${stub.package.name}"
testcase="true"
namespacetopackages="${xsd.namespacetopackages}"
/>

<copy todir="${src.dir}" overwrite="true">
<fileset dir="${output.wsdl2java.dir}/src">
<include name="**/*.java"/>
</fileset>
</copy>
</target>
</code>

El parámetro unpackClasses="true" indica que las clases OXM deben generarse como clases independientes y no como clases internas de la clase Stub. El parámetro serverSide="true" indica que queremos generar un cliente webservice. El parámetro databindingName="adb" indica el motor databinding XML a usar para generar las clases OXM. En este caso es ADB (Axis DataBinding). No está parametrizado, este script sólo funciona con ADB.

Se le puede indicar también que genere una clase de test de JUnit para probar el cliente web service con el parámetro testcase="true".

Si se usa XMLBeans se genera además código Java para todos los tipos de datos XSD y unos ficheros binarios usados por las clases OXM. Cada cosa va en un directorio diferente y todos deben incluise en el classpath del proyecto. Lo ideal es compilar tanto las clases OXM como las clases de tipos XSD y crear un jar con los fuentes, los class y estos ficheros binarios para añadirlo al directorio lib del proyecto.

Ha sido fácil y rápido, ¿no? Ya sólo queda probarlo. En el directorio samples del Axis2 encontrareis varios ficheros wsdl para probar.

==Ver también==
* [[Web Service]]
* [[Clientes De Web Service]]
* [[Web Service con Axis 2]]
* [[Web Service con Axis 2 para Weblogic y Websphere]]
* [[Web Service Con Spring]]
* [http://ws.apache.org/axis2/ Apache Axis 2]

[[Category:Java]]
[[Category:Web Service]]

Cliente Web Service con Ant y Axis2

2010-02-04T19:06:10Z

Esteban: /* Ver también */

[[Category:Java]]
[[Category:Web Service]]
Crear un cliente Web Service con Axis2 es relativamente sencillo. Crear un cliente Web Service con Ant solo hay que saber algo de Ant, una herramienta indispensable ahora o en un futuro.

El proceso consiste en ejecutar la herramienta WSDL2Java de Axis2 sobre un fichero WSDL para generar el código Java del Stub y las clases OXM (mapeador objeto-XML) de los mensajes del servicio web para posteriormente copiar el código generado al proyecto. Y todo con un simple script de Ant.

==Requisitos==
Será necesario tener instalado Axis2, basta con bajarse la versión Standard y descomprimirla, y Ant.

==Definición de propiedades==
El script usará las siguientes propiedades:

* axis2.home: directorio donde está instalado Axis2.
* output.wsdl2java.dir: directorio donde el wsdl2java generará el código.
* src.dir: directorio dentro del proyecto donde se copiará el código generado.
* wsdl.uri: ruta hasta el fichero wsdl.
* stub.package.name: nombre del paquete para la clase Stub.
* xsd.namespacetopackages: equivalencia entre los namespaces de los schemas xsd que definen los mensajes y los correspondientes paquetes donde generar las clases OXM.
* synconly: booleano para indicar si queremos generar un Stub sólo para peticiones síncronas y no asíncronas.

Las propiedades pueden definirse en el propio script o externalizarse a un fichero de propiedades (todas menos src.dir). Un ejemplo de lo primero:

<code>
<property name="axis2.home" value="/deps/axis2-1.4.1" />
<property name="output.wsdl2java.dir" value="build/codegen" />
<property name="src.dir" value="src" />
<property name="wsdl.uri" value="resources/wsdl/myWsdl.wsdl" />
<property name="stub.package.name" value="ws.client" />
<property name="xsd.namespacetopackages" value="http://myService/xsd=ws.client.xsd" />
<property name="synconly" value="true" />
</code>

==Definición del task wsdl2java==
El task wsdl2java no es un task incluido en la distribución de Ant, por tanto hay que importar su definición. Para ello hay que cargar en el classpath los jars de Axis2 y luego hacer la definición.

<code>
<path id="axis2.classpath">
<fileset dir="${axis2.home}/lib">
<include name="**/*.jar" />
</fileset>
</path>

<taskdef name="wsdl2java" classname="org.apache.axis2.tool.ant.AntCodegenTask"
classpathref="axis2.classpath" />
</code>

== Ejecutar WSDL2Java ==

Finalmente llega el momento de definir el target que ejecutará el wsdl2java. Antes preparará el directorio de salida y después copiará el código generado al proyecto. Aquí está:

<code>
<target name="run-wsdl2java-client"
description="Genera un cliente webservice apartir de un wsdl">

<mkdir dir="${output.wsdl2java.dir}" />
<delete dir="${output.wsdl2java.dir}" includeemptydirs="true" />

<wsdl2java
output="${output.wsdl2java.dir}"
wsdlfilename="${wsdl.uri}"
synconly="${synconly}"
unpackClasses="true"
serverSide="false"
databindingName="adb"
packageName="${stub.package.name}"
testcase="true"
namespacetopackages="${xsd.namespacetopackages}"
/>

<copy todir="${src.dir}" overwrite="true">
<fileset dir="${output.wsdl2java.dir}/src">
<include name="**/*.java"/>
</fileset>
</copy>
</target>
</code>

El parámetro unpackClasses="true" indica que las clases OXM deben generarse como clases independientes y no como clases internas de la clase Stub. El parámetro serverSide="true" indica que queremos generar un cliente webservice. El parámetro databindingName="adb" indica el motor databinding XML a usar para generar las clases OXM. En este caso es ADB (Axis DataBinding). No está parametrizado, este script sólo funciona con ADB.

Se le puede indicar también que genere una clase de test de JUnit para probar el cliente web service con el parámetro testcase="true".

Si se usa XMLBeans se genera además código Java para todos los tipos de datos XSD y unos ficheros binarios usados por las clases OXM. Cada cosa va en un directorio diferente y todos deben incluise en el classpath del proyecto. Lo ideal es compilar tanto las clases OXM como las clases de tipos XSD y crear un jar con los fuentes, los class y estos ficheros binarios para añadirlo al directorio lib del proyecto.

Ha sido fácil y rápido, ¿no? Ya sólo queda probarlo. En el directorio samples del Axis2 encontrareis varios ficheros wsdl para probar.

==Ver también==
* [[Web Service]]
* [[Clientes De Web Service]]
* [[Web Service con Axis 2]]
* [[Web Service con Axis 2 para Weblogic y Websphere]]
* [[Web Service Con Spring]]
* [http://ws.apache.org/axis2/ Apache Axis 2]

Web Service con Axis 2 para Weblogic y Websphere

2010-02-04T18:55:30Z

Esteban:

Web Service con Axis 2 para Weblogic y Websphere

2010-02-04T18:54:23Z

Esteban: Como publicar un Webservice hecho con Axis 2 en Weblogic

Hacer un webservice con Axis 2 para Weblogic o IBM Websphere, requiere algunos pasos extra. Esto está relacionado con la forma en que se publican los componentes en Weblogic. Este, a diferencia de los demás servidores de aplicaciones, no descomprime el WAR o el EAR durante la publicación. A saber, existen 3 modalidades para publicar componentes en Weblogic.

*Stage: el componente se publica comprimido y el servidor copia el componente a cada nodo de forma automática.
*Nostage: el componente se publica descomprimido manualmente. Los nodos acceden al mismo filesystem para leer el componente.
*Nostage-external: Ídem anterior pero con pasos adicionales de validación.

Axis 2 está preparado solamente leer archivos del filesystem, por lo que no puede interpretar referencias a recursos dentro de un paquete. Esta es la razón por la cual si se despliega un EAR o un WAR en modalidad Stage, los Webservices no funcionarán.

Existen 2 soluciones posibles:

1. Descomprimir el paquete (WAR o EAR) y publicarlo con la modalidad NoStage. Ventaja: funciona como en los demás servidores de aplicaciones, sin necesidad de cambios. Desventaja: en el escenario de despliegue en cluster, la caida del filesystem donde está desplegado el componente causa la no disponibilidad en todos los nodos (ya que todos los nodos leen el componente de ese único filesystem).

2. Aprovechar las características de publicación externa de Axis 2 y guardar en una carpeta local del filesystem la configuración de los servicios de Axis 2. Ventaja: permite la publicación en modalidad Stage; tiene alta disponibilidad en cluster. Desventaja: desarrollo más complejo; replicación innecesaria de recursos.

== Publicación Externa ==

Dado que Axis 2 solo puede tomar archivos del filesystem, como primer paso, antes que se inicialice Axis, vamos a copiar los archivos de configuración a una carpeta creada por nosotros en el filesystem.

Para ello vamos a tener que hacer 3 pasos: 1. Configurar en el archivo web.xml, un parametro de inicio para el AxisServlet, de forma que quede así.

<servlet>
<display-name>Apache-Axis Servlet</display-name>
<servlet-name>AxisServlet</servlet-name>
<servlet-class>org.apache.axis2.transport.http.AxisServlet</servlet-class>
'''<init-param>'''
'''<param-name>axis2.repository.path</param-name>'''
'''<param-value>''directorio a publicar''</param-value>'''
'''</init-param>'''
</servlet>

2. Crear una clase que haga la copia de los archivos de configuración de servicio antes que se inicie Axis, aprovechando la incorporación de Spring al proyecto.

/**
*
* @author ejgarcia
*/
public class Axis2ServiceDeployer implements InitializingBean, ApplicationContextAware {
/** Carpeta donde se van a desplegar los servicios.
* Debe coincidir la propiedad axis2.repository.path, declarada como
* init-param en la definición del AxisServlet en el archivo web.xml
*/
protected String servicesDeploymentFolder = null;
/** Nombre del servicio. El nombre debe coincidir con el wsdl */
protected String serviceName = null;
private WebApplicationContext ctx;

public void afterPropertiesSet() {
/** creo la estructura de directorios default */
File servicesDeploymentFolderFile = new File(servicesDeploymentFolder);
servicesDeploymentFolderFile.mkdirs();

File serviceFolderFile =
new File(servicesDeploymentFolderFile, "services" +
File.separator + serviceName + File.separator + "META-INF");
serviceFolderFile.mkdirs();

/** Copio los recursos al directorio */
String serviceFileResourcePath = "services/" + serviceName + "/META-INF/services.xml";
String serviceWsdlResourcePath = "services/" + serviceName + "/META-INF/" + serviceName + ".wsdl";

String serviceFileClassPath = "/WEB-INF/" + serviceFileResourcePath;
String serviceWsdlClassPath = "/WEB-INF/" + serviceWsdlResourcePath;
//ClassLoader cl = this.getClass().getClassLoader();
InputStream serviceIn = ctx.getServletContext().getResourceAsStream(serviceFileClassPath);
InputStream wsdlIn = ctx.getServletContext().getResourceAsStream(serviceWsdlClassPath);
System.err.println("Recurso 2: " + serviceFileClassPath + " : " + serviceIn);
System.err.println("Recurso 2: " + serviceWsdlClassPath + " : " + wsdlIn);
copyInputStreamToFile(serviceIn, new File(servicesDeploymentFolderFile, serviceFileResourcePath));
copyInputStreamToFile(wsdlIn, new File(servicesDeploymentFolderFile, serviceWsdlResourcePath));
}

private void copyInputStreamToFile(InputStream in, File file) {
if (in == null){System.err.println("No se pudo encontrar... "); return;}
FileOutputStream outToFile = null;
ByteArrayOutputStream out = null;
try {
byte[] buffer = new byte[10000];
out = new ByteArrayOutputStream();
outToFile = new FileOutputStream(file);
//int counter = 0;
int bytesRead = 0;
while ((bytesRead = in.read(buffer, 0, buffer.length)) > 0) {
System.err.println("bytes leidos: " + bytesRead);
out.write(buffer, 0, bytesRead);
//counter += bytesRead;
//if (bytesRead < buffer.length) break;
}
out.writeTo(outToFile);

in.close();
out.close();
outToFile.close();
} catch (FileNotFoundException ex) {
ex.printStackTrace();
} catch (IOException ex) {
ex.printStackTrace();
} finally {
try {
if (in != null) in.close();
if (outToFile != null) outToFile.close();
if (out != null) out.close();
} catch (IOException ex) {
ex.printStackTrace();
}
}
}
}

La clase Axis2ServiceDeployer implementa 2 intefases: InitializingBean y ApplicationContextAware. Spring, al detectar la interfaz InitializingBean, ejecuta el método afterPropertiesSet luego de la carga de las propiedades. Dado que Spring se inicia antes que Axis, basta con eso para que inicie el proceso. La otra interfaz, ApplicationContextAware, la necesitamos para obtener el contexto del servlet y de ahí poder acceder a la carpeta WEB-INF, dentro de la cual está la configuración de nuestro servicio. La implementación del método es sencilla. Se crean las carpetas en el filesystem local, se obtienen los recursos de dentro del WAR y se copian al filesystem, respetando la misma estructura de archivos, que es la predeterminada para Axis 2, que es:

WEB-INF/services/<nombre servicio>/META-INF/services.xml

WEB-INF/services/<nombre servicio>/META-INF/<nombre servicio>.wsdl

3. Por último se debe configurar en la clase de despliegue en Spring.

<bean id="axis2Servicedeployer" class="com.dosideas.spring.Axis2ServiceDeployer">
<property name="servicesDeploymentFolder" value="''Carpeta Física''" />
<property name="serviceName" value="''Nombre Servicio''" />
</bean>

Para descargar la clase completa, haga click aquí.

Cliente Web Service con Ant y Axis2

2010-02-04T17:39:55Z

Esteban: /* Ver también */

[[Category:Java]]
[[Category:Web Service]]
Crear un cliente Web Service con Axis2 es relativamente sencillo. Crear un cliente Web Service con Ant solo hay que saber algo de Ant, una herramienta indispensable ahora o en un futuro.

El proceso consiste en ejecutar la herramienta WSDL2Java de Axis2 sobre un fichero WSDL para generar el código Java del Stub y las clases OXM (mapeador objeto-XML) de los mensajes del servicio web para posteriormente copiar el código generado al proyecto. Y todo con un simple script de Ant.

==Requisitos==
Será necesario tener instalado Axis2, basta con bajarse la versión Standard y descomprimirla, y Ant.

==Definición de propiedades==
El script usará las siguientes propiedades:

* axis2.home: directorio donde está instalado Axis2.
* output.wsdl2java.dir: directorio donde el wsdl2java generará el código.
* src.dir: directorio dentro del proyecto donde se copiará el código generado.
* wsdl.uri: ruta hasta el fichero wsdl.
* stub.package.name: nombre del paquete para la clase Stub.
* xsd.namespacetopackages: equivalencia entre los namespaces de los schemas xsd que definen los mensajes y los correspondientes paquetes donde generar las clases OXM.
* synconly: booleano para indicar si queremos generar un Stub sólo para peticiones síncronas y no asíncronas.

Las propiedades pueden definirse en el propio script o externalizarse a un fichero de propiedades (todas menos src.dir). Un ejemplo de lo primero:

<code>
<property name="axis2.home" value="/deps/axis2-1.4.1" />
<property name="output.wsdl2java.dir" value="build/codegen" />
<property name="src.dir" value="src" />
<property name="wsdl.uri" value="resources/wsdl/myWsdl.wsdl" />
<property name="stub.package.name" value="ws.client" />
<property name="xsd.namespacetopackages" value="http://myService/xsd=ws.client.xsd" />
<property name="synconly" value="true" />
</code>

==Definición del task wsdl2java==
El task wsdl2java no es un task incluido en la distribución de Ant, por tanto hay que importar su definición. Para ello hay que cargar en el classpath los jars de Axis2 y luego hacer la definición.

<code>
<path id="axis2.classpath">
<fileset dir="${axis2.home}/lib">
<include name="**/*.jar" />
</fileset>
</path>

<taskdef name="wsdl2java" classname="org.apache.axis2.tool.ant.AntCodegenTask"
classpathref="axis2.classpath" />
</code>

== Ejecutar WSDL2Java ==

Finalmente llega el momento de definir el target que ejecutará el wsdl2java. Antes preparará el directorio de salida y después copiará el código generado al proyecto. Aquí está:

<code>
<target name="run-wsdl2java-client"
description="Genera un cliente webservice apartir de un wsdl">

<mkdir dir="${output.wsdl2java.dir}" />
<delete dir="${output.wsdl2java.dir}" includeemptydirs="true" />

<wsdl2java
output="${output.wsdl2java.dir}"
wsdlfilename="${wsdl.uri}"
synconly="${synconly}"
unpackClasses="true"
serverSide="false"
databindingName="adb"
packageName="${stub.package.name}"
testcase="true"
namespacetopackages="${xsd.namespacetopackages}"
/>

<copy todir="${src.dir}" overwrite="true">
<fileset dir="${output.wsdl2java.dir}/src">
<include name="**/*.java"/>
</fileset>
</copy>
</target>
</code>

El parámetro unpackClasses="true" indica que las clases OXM deben generarse como clases independientes y no como clases internas de la clase Stub. El parámetro serverSide="true" indica que queremos generar un cliente webservice. El parámetro databindingName="adb" indica el motor databinding XML a usar para generar las clases OXM. En este caso es ADB (Axis DataBinding). No está parametrizado, este script sólo funciona con ADB.

Se le puede indicar también que genere una clase de test de JUnit para probar el cliente web service con el parámetro testcase="true".

Si se usa XMLBeans se genera además código Java para todos los tipos de datos XSD y unos ficheros binarios usados por las clases OXM. Cada cosa va en un directorio diferente y todos deben incluise en el classpath del proyecto. Lo ideal es compilar tanto las clases OXM como las clases de tipos XSD y crear un jar con los fuentes, los class y estos ficheros binarios para añadirlo al directorio lib del proyecto.

Ha sido fácil y rápido, ¿no? Ya sólo queda probarlo. En el directorio samples del Axis2 encontrareis varios ficheros wsdl para probar.

==Ver también==
* [[Web Service]]
* [[Clientes De Web Service]]
* [[Web Service con Axis 2 para Weblogic y Websphere]]
* [[Web Service Con Spring]]
* [http://ws.apache.org/axis2/ Apache Axis 2]

Cliente Web Service con Ant y Axis2

2010-02-04T17:38:39Z

Esteban: Link al nuevo articulo sobre Axis 2

[[Category:Java]]
[[Category:Web Service]]
Crear un cliente Web Service con Axis2 es relativamente sencillo. Crear un cliente Web Service con Ant solo hay que saber algo de Ant, una herramienta indispensable ahora o en un futuro.

El proceso consiste en ejecutar la herramienta WSDL2Java de Axis2 sobre un fichero WSDL para generar el código Java del Stub y las clases OXM (mapeador objeto-XML) de los mensajes del servicio web para posteriormente copiar el código generado al proyecto. Y todo con un simple script de Ant.

==Requisitos==
Será necesario tener instalado Axis2, basta con bajarse la versión Standard y descomprimirla, y Ant.

==Definición de propiedades==
El script usará las siguientes propiedades:

* axis2.home: directorio donde está instalado Axis2.
* output.wsdl2java.dir: directorio donde el wsdl2java generará el código.
* src.dir: directorio dentro del proyecto donde se copiará el código generado.
* wsdl.uri: ruta hasta el fichero wsdl.
* stub.package.name: nombre del paquete para la clase Stub.
* xsd.namespacetopackages: equivalencia entre los namespaces de los schemas xsd que definen los mensajes y los correspondientes paquetes donde generar las clases OXM.
* synconly: booleano para indicar si queremos generar un Stub sólo para peticiones síncronas y no asíncronas.

Las propiedades pueden definirse en el propio script o externalizarse a un fichero de propiedades (todas menos src.dir). Un ejemplo de lo primero:

<code>
<property name="axis2.home" value="/deps/axis2-1.4.1" />
<property name="output.wsdl2java.dir" value="build/codegen" />
<property name="src.dir" value="src" />
<property name="wsdl.uri" value="resources/wsdl/myWsdl.wsdl" />
<property name="stub.package.name" value="ws.client" />
<property name="xsd.namespacetopackages" value="http://myService/xsd=ws.client.xsd" />
<property name="synconly" value="true" />
</code>

==Definición del task wsdl2java==
El task wsdl2java no es un task incluido en la distribución de Ant, por tanto hay que importar su definición. Para ello hay que cargar en el classpath los jars de Axis2 y luego hacer la definición.

<code>
<path id="axis2.classpath">
<fileset dir="${axis2.home}/lib">
<include name="**/*.jar" />
</fileset>
</path>

<taskdef name="wsdl2java" classname="org.apache.axis2.tool.ant.AntCodegenTask"
classpathref="axis2.classpath" />
</code>

== Ejecutar WSDL2Java ==

Finalmente llega el momento de definir el target que ejecutará el wsdl2java. Antes preparará el directorio de salida y después copiará el código generado al proyecto. Aquí está:

<code>
<target name="run-wsdl2java-client"
description="Genera un cliente webservice apartir de un wsdl">

<mkdir dir="${output.wsdl2java.dir}" />
<delete dir="${output.wsdl2java.dir}" includeemptydirs="true" />

<wsdl2java
output="${output.wsdl2java.dir}"
wsdlfilename="${wsdl.uri}"
synconly="${synconly}"
unpackClasses="true"
serverSide="false"
databindingName="adb"
packageName="${stub.package.name}"
testcase="true"
namespacetopackages="${xsd.namespacetopackages}"
/>

<copy todir="${src.dir}" overwrite="true">
<fileset dir="${output.wsdl2java.dir}/src">
<include name="**/*.java"/>
</fileset>
</copy>
</target>
</code>

El parámetro unpackClasses="true" indica que las clases OXM deben generarse como clases independientes y no como clases internas de la clase Stub. El parámetro serverSide="true" indica que queremos generar un cliente webservice. El parámetro databindingName="adb" indica el motor databinding XML a usar para generar las clases OXM. En este caso es ADB (Axis DataBinding). No está parametrizado, este script sólo funciona con ADB.

Se le puede indicar también que genere una clase de test de JUnit para probar el cliente web service con el parámetro testcase="true".

Si se usa XMLBeans se genera además código Java para todos los tipos de datos XSD y unos ficheros binarios usados por las clases OXM. Cada cosa va en un directorio diferente y todos deben incluise en el classpath del proyecto. Lo ideal es compilar tanto las clases OXM como las clases de tipos XSD y crear un jar con los fuentes, los class y estos ficheros binarios para añadirlo al directorio lib del proyecto.

Ha sido fácil y rápido, ¿no? Ya sólo queda probarlo. En el directorio samples del Axis2 encontrareis varios ficheros wsdl para probar.

==Ver también==
* [[Web Service]]
* [[Clientes De Web Service]]
* [[Web Service con Axis 2]]
* [[Web Service Con Spring]]
* [http://ws.apache.org/axis2/ Apache Axis 2]