Desarrollo de un archivo WSDL para aplicaciones JAX-RPC

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

  1. [IBM i]Ejecute el mandato Iniciar Qshell (STRQSH) para iniciar el Qshell.
  2. [IBM i]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
  3. [AIX Solaris HP-UX Linux Windows][z/OS]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>".
  4. Ejecute el mandato Java2WSDL seiInterface. Se habrá creado un archivo WSDL denominado seiInterface.wsdl.
    Supported configurations 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.
  5. 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.
  6. (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.

Icon that indicates the type of topic Task topic



Timestamp icon Last updated: last_date
http://www14.software.ibm.com/webapp/wsbroker/redirect?version=cord&product=was-nd-mp&topic=twbs_wsdl
File name: twbs_wsdl.html