Desarrollo de enlaces de cliente a partir de un archivo WSDL para un cliente de servicios web JAX-RPC

Puede desarrollar enlaces de cliente a partir de un archivo WSDL (Web Services Description Language) para un cliente de servicios web JAX-RPC.

Antes de empezar

Para desarrollar los enlaces de cliente a partir de un archivo WSDL para aplicaciones de servicio web JAX-RPC, debe obtener el URL (localizador universal de recursos) del archivo WSDL que se va a utilizar. Necesita enlaces y descriptores de despliegue para que un cliente pueda utilizar un servicio web.

[Windows][z/OS]Si el archivo WSDL es un archivo local, el URL se parecerá al siguiente ejemplo: archivo:unidad:\víaacceso\nombre_archivo.wsdl.

[Linux][AIX][HP-UX][Solaris][IBM i]Si el archivo WSDL es un archivo local, el URL se parecerá al siguiente ejemplo: archivo:/víaacceso/nombre_archivo.wsdl.

También se pueden especificar los archivos locales con la vía de acceso del archivo absoluta o relativa.

Los enlaces de cliente se generan utilizando la opción -role develop-client junto con la opción -container del mandato WSDL2Java. La opción -container toma los parámetros siguientes:
  • -container client

    Genera enlaces y descriptores de despliegue para un cliente que reside en el contenedor de clientes de aplicaciones.

  • -container ejb

    Genera descriptores de despliegue y enlaces para un cliente que es un enterprise bean del módulo EJB (Enterprise JavaBeans).

  • -container web

    Genera enlaces y descriptores de despliegue para un cliente que reside en el contenedor web.

[z/OS]La herramienta de línea de mandatos WSDL2Java 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 WSDL2Java para las aplicaciones JAX-RPC (Java™ API for XML-based RPC) para obtener más información acerca de esta herramienta.

Acerca de esta tarea

Desarrolle los enlaces de cliente de un archivo WSDL ejecutando el mandato adecuado.

Best practice Best practice: Se recomienda utilizar espacios de nombres absolutos en el WSDL o el esquema. De manera predeterminada, la herramienta WSDL2Java no permite el uso de espacios de nombres relativos. XML Plenary Interest Group ha dejado de utilizar los espacios de nombres relativos y el uso de dichos espacios de nombres hace que la firma digital XML falle, tal como indica la especificación Canonical XML Versión 1.0. Puede convertir los espacios de nombres relativos en espacios de nombres absolutos. Para obtener más información sobre el uso de espacios de nombres con la herramienta WSDL2Java, consulte el mandato WSDL2Java en la documentación de aplicaciones JAX-RPC. bprac

Procedimiento

Ejecute el mandato WSDL2Java -verbose -role develop-client -container tipo wsdlURL

donde tipo es ejb para un cliente de EJB de enterprise, web para un cliente de JavaBeans o client para un cliente de aplicaciones.

Puede utilizar las siguientes combinaciones en la línea de mandatos:
  • -container web
  • -container ejb
  • -container client
Dado que se ha especificado la opción verbose, se mostrará una lista de todos los archivos generados cuando se ejecuta el mandato.

Resultados

Tiene los enlaces y descriptores de despliegue que necesita un cliente para utilizar un servicio web.

Ejemplo

En el siguiente ejemplo se utiliza el enterprise bean AddressBook, el archivo AddressBook.wsdl. Una vez generados los enlaces con mandato WSDL2Java -verbose -role develop-client -container client AddressBook.wsdl se generan los archivos siguientes:
Analizando archivo XML:  archivo:e:/example/app/topdown/step1/AddressBook.wsdl 
WSWS3185I: Información: Analizando archivo XML: AddressBook.wsdl
WSWS3282I: Información: Generando addr\Address.java.
WSWS3282I: Información: Generando addr\Phone.java.
WSWS3282I: Información: Generando addr\StateType.java.
WSWS3282I: Información: Generando addr\AddressBook.java.
WSWS3282I: Info: Generando addr\AddressBookService.java.
WSWS3282I: Información: Generando META-INF\ibm-webservicesclient-bnd.xmi.
WSWS3282I: Información: Generando META-INF\AddressBook_mapping.xml.
WSWS3282I: Info: Generando META-INF\ibm-webservicesclient-ext.xmi.

Qué hacer a continuación

Complete la implementación del cliente escribiendo su aplicación cliente y luego ensamble los artefactos de cliente.

.

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_devclientbindings
File name: twbs_devclientbindings.html