Puede desarrollar un archivo WSDL (Web Services Description Language) que describa las características de la aplicación de servicios web JAX-RPC (Java™ API for XML-based RPC), que incluya la
ubicación donde reside el servicio y cómo invocar el servicio con un formato XML.
Antes de empezar
En función de la vía de acceso de desarrollo, desarrolle una interfaz de punto final de servicio
desde una implementación JavaBeans o desarrolle una interfaz de punto final de servicio
desde una implementación de enterprise bean.
Acerca de esta tarea
Necesita un archivo WSDL para utilizar servicios web. Puede desarrollar
su propio archivo WSDL u obtenerlo de un proveedor de servicios web mediante correo
electrónico, bajándolo o a través de un URL (Uniform Resource Locator). En esta documentación se asume que ésta creando su propio archivo WSDL.
Desarrolle un archivo WSDL siguiendo las acciones siguientes:
Procedimiento
Ejecute el mandato Iniciar Qshell (STRQSH)
para iniciar el Qshell.
Actualice la variable de entorno CLASSPATH para que
incluya la ubicación de la clase de interfaz de punto final de servicio y otras
clases referenciadas, por ejemplo: export -s CLASSPATH=/myapp/myclass.class:/myapp/myjar.jar
![[AIX Solaris HP-UX Linux Windows]](../images/dist.gif)
Configure la clase de interfaz de punto final de servicio y las clases a
las que se hace referencia en la variable CLASSPATH. - En los sistemas Windows , establezca CLASSPATH="%CLASSPATH%;<liste la aplicación Java archive los archivos (JAR) y clases>".
- En los sistemas UNIX y Linux, exporte
CLASSPATH="$CLASSPATH: <liste los archivos JAR y las clases de su aplicación>".
- Ejecute el mandato Java2WSDL seiInterface. Se habrá creado un archivo WSDL denominado
seiInterface.wsdl.
Supported configurations: La herramienta de línea de mandatos
Java2WSDL no está soportada en la plataforma z/OS. Esta función la proporcionan las herramientas de ensamblaje suministradas con la versión z/OS del producto. Consulte la información acerca de la herramienta de línea de mandatos
Java2WSDL para las aplicaciones JAX-RPC (API de Java para RPC basado en XML) para obtener más información acerca de esta herramienta.
sptcfg
- Coloque el archivo WSDL en el subdirectorio META-INF/wsdl si está
utilizando EJB (Enterprise JavaBeans).
- Coloque el archivo WSDL en el subdirectorio WEB-INF/wsdl si está
utilizando JavaBeans.
- Edite el archivo WSDL generado y observe los nombres de
partes. Las partes WSDL tienen nombres tales como arg_0_0.
Modifique el archivo WSDL para utilizar los nombres reales de los
parámetros Java.
- (Opcional) Utilice la herramienta de mandatos
Java2WSDL para generar los nombres de partes correctos del
archivo WSDL. Puede generar y establecer automáticamente los nombres de componente
correctos utilizando la herramienta de mandatos Java2WSDL. La generación y
establecimiento de nombres de partes se lleva a cabo proporcionando información
adicional a la herramienta de mandatos Java2WSDL en forma de una clase de
implementación Java que implemente los mismos métodos que la interfaz de punto final
de servicio y que se haya compilado con la información de depuración activada. Los nombres de parámetros se almacenan en el archivo .class
con la información de depuración. Si se ha compilado la clase de implementación con
la depuración activada, puede utilizar el mandato Java2WSDL -implClass seiImpl
seiInterface para generar archivos WSDL con los nombres de parte correctos.
Resultados
Se habrá creado un archivo WSDL que define los servicios web descritos mediante
la interfaz de punto final de servicio.
Ejemplo
Este ejemplo utiliza el nombre de archivo JAR AddressBook.jar
que contiene una clase denominada archivo de clase AddressBook.class.
Debe añadir el archivo
AddressBook.jar a la CLASSPATH para crear el archivo WSDL. El archivo JAR
contiene una clase de implementación de EJB que se ha compilado sin la depuración
activada. Ejecute el mandato Java2WSDL -implClass addr.AddressBookBean
addr.AddressBook para crear el archivo AddressBook.wsdl.
Qué hacer a continuación
En función de la vía de acceso de desarrollo, desarrolle plantillas del descriptor de despliegue de
servicios web para JavaBeans o
desarrolle plantillas del descriptor de despliegue de servicios web para una implementación
enterprise beans.