Generación de un cliente de servicio web a partir de un documento WSDL utilizando el entorno de ejecución JAX-WS de IBM® WebSphere

El asistente de cliente de servicios web permite generar un proxy de bean Java™ y una aplicación de ejemplo. La aplicación web de ejemplo muestra cómo codificar un archivo de proxy.

Antes de empezar

Requisitos previos:
Restricción: Si desea ejecutar un cliente de servicio web Java simple fuera de un contenedor J2EE (Java Platform, Enterprise Edition), debe generar el cliente de servicio web en un proyecto Java simple. El asistente de servicio web no puede crear un proyecto Java simple. Lo más próximo es un proyecto de utilidad, aunque la ejecución de un cliente de servicio web Java simple (sin contenedor) a partir de un proyecto de utilidad no está soportada. Debe crear un proyecto Java simple antes de ejecutar el asistente de cliente de servicios web.

Acerca de esta tarea

Para generar un proxy de cliente Java y una aplicación de ejemplo a partir de un documento WSDL descubierto:

Procedimiento

  1. Pase a la perspectiva Java EE (Ventana > Abrir perspectiva > Java EE).
  2. Pulse Archivo > Nuevo > Otros. Seleccione Servicios web para visualizar los distintos asistentes de servicio web. Seleccione el asistente Cliente de servicio web. Pulse Siguiente.
  3. Página Servicios web: seleccione el archivo WSDL que utiliza para generar el cliente. También puede hacer lo siguiente:
    1. Seleccione las etapas de desarrollo de clientes de servicio web que desea completar utilizando el control deslizante. Se establecen varios valores predeterminados en los restantes paneles del asistente.
      • Desarrollo: desarrolla la definición WSDL y la implementación del cliente de servicio web. Esto incluye tareas como crear los módulos que contienen el código generado, los archivos WSDL, los descriptores de despliegue y los archivos Java cuando corresponda.
      • Ensamblaje: garantiza que el proyecto que aloja el cliente de servicio web se asocie con un EAR cuando lo necesite el servidor de aplicaciones destino.
      • Despliegue: crea el código de despliegue del cliente.
      • Instalación: instala y configura el módulo web y los EAR en el servidor de destino. Si se requieren cambios en los puntos finales del archivo WSDL, deben realizarse en esta etapa.
      • Inicio: inicia el servidor una vez que el cliente se ha instalado en él.
      • Prueba: proporciona varias opciones para probar el servicio como, por ejemplo, el uso de Web Service Explorer o JSP de ejemplo.
    2. Seleccione el servidor: se visualiza el servidor predeterminado. Si desea desplegar el servicio en un servidor distinto, pulse el enlace para especificar otro servidor.
      Esta tarea da soporte a los siguientes entornos de ejecución del servidor:
      • WebSphere Application Server V7.0 o posteriores
      • WebSphere Application Server Liberty Profile V8.5.5
    3. Seleccione el tiempo de ejecución: se visualiza el tiempo de ejecución predeterminado. Si desea desplegar el servicio en un entorno de tiempo de ejecución distinto, pulse el enlace para especificar otro entorno de tiempo de ejecución.
    4. Seleccione el proyecto de cliente: se visualiza el proyecto seleccionado en el espacio de trabajo. Para seleccionar un EAR y un proyecto diferente, pulse el enlace del proyecto. Puede seleccionar un proyecto web, un proyecto EJB, un proyecto Java o un proyecto de aplicación cliente Java EE como la ubicación del código de cliente. Compruebe que el proyecto seleccionado como proyecto web de cliente sea distinto del proyecto web de servicio, o los artefactos generados del cliente sobrescribirán el servicio. Para los servicios web JAX-WS, los proyectos de servidor y cliente pueden compartir el mismo EAR.
    5. Supervise el servicio web: el tráfico del servicio web se envía a través del supervisor TCP/IP, lo que permite observar el tráfico SOAP generado por el servicio web y comprobar si el tráfico es compatible con WS-I. También puede configurar manualmente un supervisor TCP/IP como se describe en Utilización del supervisor TCP/IP para probar servicios web.
  4. Página Configuración de cliente de servicio web JAX-WS de WebSphere:
    • Carpeta de salida: seleccione la carpeta donde desea que se generen las clases Java del cliente o acepte el valor predeterminado.
    • Paquete de destino: el asistente de cliente de servicios web genera varios archivos Java a partir del WSDL especificado. De forma predeterminada, crea un nombre de paquete basándose en el espacio de nombres especificado en el archivo WSDL. Para alterar temporalmente este comportamiento predeterminado, puede especificar su propio nombre de paquete para el espacio de nombres en el archivo WSDL.
    • Generar cliente portátil: si selecciona este recuadro de selección, podrá mover el código de cliente del servicio web de una máquina a otra o de una instancia de WebSphere Application Server a otra. Si selecciona esta opción, el documento WSDL y todos los esquemas XML y otros documentos WSDL de los que depende se copian en el proyecto de cliente, en WEB-INF/wsdl, y un file:relativeURL que apunte a esta copia se inyecta en el bloque de inicialización estática de la clase de servicio JAX-WS.
    • Habilitar la invocación asíncrona para el cliente generado: si selecciona habilitar un cliente asíncrono, se crean dos métodos más para cada método en el servicio web. Son los métodos de sondeo y devolución de llamada que permiten al cliente funcionar de forma asíncrona.
    • Especificar archivos de enlace JAX-WS o JAXB: si ha creado archivos de enlace personalizados JAX-WS o JAXB, seleccione este recuadro de selección para utilizarlos para crear este servicio web.
    • Personalizar nombre de clase de proxy del cliente: puede aceptar el nombre de proxy predeterminado o especificar el suyo propio.
    • Generar descriptor de despliegue de servicio web: para los servicios web JAX-WS, el tiempo de ejecución genera dinámicamente la información de despliegue; ya no son necesarios los descriptores de despliegue estáticos. La selección de este recuadro de selección los genera.
    • Permitir extensiones de proveedores: si selecciona este recuadro de selección, se añade la opción -extension al mandato wsgen o wsimport. La opción -extension especifica si se van a habilitar o aceptar las extensiones personalizadas para la funcionalidad no especificada por la especificación JAX-WS. Si se utilizan extensiones, es posible que las aplicaciones no sean portátiles o no puedan interactuar con otras implementaciones. Para obtener más detalles, consulte los temas Mandato wsgen para las aplicaciones JAX-WS y Mandato wsimport para las aplicaciones JAX-WS, que están disponibles en el Information Center de WebSphere Application Server.
  5. Página Declaración de enlace personalizado: Si ha seleccionado suministrar un archivo de enlace JAX-WS o JAXB en la página anterior, puede navegar hasta su ubicación.
  6. Página Configuración de generación de proxy: Si ha seleccionado personalizar el nombre de clase de proxy de cliente, utilice esta página para especificar un nombre de clase de proxy para cada puerto.
  7. Página Prueba de cliente de servicio web:
    • Probar el proxy generado: si selecciona esta opción, el cliente de ejemplo se inicia en un navegador web que permite probar la función.
    • Seleccione el recurso de prueba. Puede probar el proxy generado en el cliente de servicio genérico o el explorador de servicios web, o puede generar y utilizar el JSP de ejemplo de JAX-WS 2.0.
    • Carpeta: si ha seleccionado probar el proxy a través de un JSP, puede seleccionar la carpeta donde se ubica el JSP y los métodos que se incluyen en el JSP.
    • Métodos: seleccione los métodos que desee exponer. Si ha seleccionado habilitar la invocación asíncrona, también se mostrarán los métodos asíncronos.
    • Ejecutar prueba en el servidor: inicia el servidor automáticamente.
  8. Pulse Finalizar. Si ha seleccionado probar el proxy, el cliente de prueba se abre en una ventana del navegador.

Resultados

El proxy de bean Java generado proporciona una interfaz de llamada a procedimiento remoto al servicio web. La aplicación web de ejemplo demuestra cómo codificar el archivo de proxy.

Una vez que haya creado el cliente proxy de Java, puede probar los métodos del servicio web mediante el proxy utilizando los JSP de ejemplo para servicios web o el Explorador de servicios web.

Icono que indica el tipo de tema Tema de tarea
Términos y condiciones para centros de información | Comentarios

Icono de indicación de fecha y hora Última actualización: 22 de abril de 2014

Nombre de archivo: tsampappjaxws.html