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:
- Si está utilizando WebSphere Application Server, se recomienda iniciar el servidor antes de ejecutar el asistente de servicio web, porque puede tardar varios minutos en iniciar WebSphere Application Server, dependiendo de la velocidad del sistema. Para iniciar el servidor, selecciónelo en la vista Servidores (Ventana > Mostrar vista > Servidores), pulse con el botón derecho y seleccione Iniciar.
- Descubra o importe un documento WSDL en el espacio de trabajo. Puede utilizar un archivo WSDL que contenga un elemento de servicio. Puede utilizar un archivo WSDL estático del espacio de trabajo, un archivo WSDL que reside en un URL o, si tiene un bean anotado que actúa como un servicio web JAX-WS en el espacio de trabajo, el archivo WSDL dinámico producido por el tiempo de ejecución de WebSphere Application Server Feature Pack for Web Services. Este WSDL puede encontrarse en el URL: http://localhost:puerto/nombre_proyecto_servicio/nombre_servicioService?wsdl. Por ejemplo, en el servicio web JAX-WS de libreta de direcciones que se crea en la guía de aprendizaje y los ejemplos que acompañan al paquete de características de servicios web, el archivo WSDL dinámico se encuentra en este URL: http://localhost:9082/jwsAddressBook/AddressBookService?wsdl.
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
- Pase a la perspectiva Java EE (Ventana > Abrir perspectiva > Java EE).
- Pulse Archivo > Nuevo > Otros. Seleccione Servicios web para visualizar los distintos asistentes de servicio web. Seleccione el asistente Cliente de servicio web. Pulse Siguiente.
- Página Servicios web: seleccione el archivo WSDL que utiliza para generar el cliente. También puede hacer lo siguiente:
- 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.
- 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
- 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.
- 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.
- 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.
- 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.
- 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.
- 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.
- 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.
- 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.
- Si ha seleccionado probar el servicio web utilizando el explorador de servicios web, se abre el explorador. Seleccione la operación que desea probar, especifique la información necesaria y pulse Ir. El resultado aparece en el panel Estado.
- Si ha seleccionado probar un cliente ligero Java, la salida del sistema de la ejecución del cliente ligero Java aparece en la vista Consola. Puede ejecutar el cliente ligero Java pulsando Ejecutar en el recuadro de diálogo Ejecutar configuraciones . Como una simple aplicación Java, el cliente utiliza un JAR de contenedor de tiempo de ejecución del cliente ligero de WebSphere Application Server.