Cliente Web Service con Ant y Axis2 - Historial de revisiones

Esteban en 19:08 4 feb 2010

2010-02-04T19:08:36Z

Esteban: /* Ver también */

2010-02-04T19:06:10Z

‎Ver también

Esteban: /* Ver también */

2010-02-04T17:39:55Z

‎Ver también

Esteban: Link al nuevo articulo sobre Axis 2

2010-02-04T17:38:39Z

Link al nuevo articulo sobre Axis 2

201.251.185.130 en 15:04 27 oct 2009

2009-10-27T15:04:36Z

Admin en 15:29 26 ago 2009

2009-08-26T15:29:17Z

190.172.80.223: /* Ver también */

2008-09-21T23:27:21Z

‎Ver también

190.172.80.223: /* Ver también */

2008-09-21T23:26:14Z

‎Ver también

190.172.80.223: Página nueva: 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 futu...

2008-09-21T23:25:00Z

Página nueva: 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 futu...

Página nueva

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}"
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.

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 Con Spring]]
* [http://ws.apache.org/axis2/ Apache Axis 2]

@@ Línea 88: / Línea 88: @@
 * [[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]

@@ Línea 88: / Línea 88: @@
 * [[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]

@@ Línea 88: / Línea 88: @@
 * [[Web Service]]
 * [[Clientes De Web Service]]
 * [[Web Service Con Spring]]
 * [http://ws.apache.org/axis2/ Apache Axis 2]

← Revisión anterior		Revisión del 15:29 26 ago 2009
Línea 1:		Línea 1:
		+	[[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.		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.

@@ Línea 1: / Línea 1: @@
 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.
@@ Línea 92: / Línea 90: @@
 * [[Web Service Con Spring]]
 * [http://ws.apache.org/axis2/ Apache Axis 2]

@@ Línea 46: / Línea 46: @@
 </code>
-==Ejecutar WSDL2Java==
+== 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>
@@ Línea 64: / Línea 65: @@
 databindingName="adb"
 packageName="${stub.package.name}"
 namespacetopackages="${xsd.namespacetopackages}"
 />
@@ Línea 73: / Línea 75: @@
 </copy>
 </target>
 </code>
-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.
+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.
-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.
+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".
 ==Ver también==