Creación de un esqueleto de bean Java a partir de un documento WSDL utilizando el entorno de ejecución JAX-WS de WebSphere

El asistente de servicio web le ayuda a crear un bean de esqueleto a partir de un documento WSDL existente. El bean de esqueleto contiene un conjunto de métodos que se corresponden con las operaciones descritas en el documento WSDL. Cuando se crea el bean, cada método tiene una implementación trivial que se sustituye editando el bean.

Antes de empezar

Requisitos previos:

Acerca de esta tarea

Para crear un bean Java™ de esqueleto a partir de un documento WSDL utilizando el entorno de ejecución JAX-WS de WebSphere:

Procedimiento

  1. Pase a la perspectiva Java EE (Ventana > Abrir perspectiva > Java EE).
  2. En la vista Explorador empresarial, seleccione el archivo WSDL que ha creado o importado.
  3. Pulse Archivo > Nuevo > Otros. Seleccione Servicios web para visualizar los distintos asistentes de servicio web. Seleccione el asistente Servicio web. Pulse Siguiente.
  4. Página Servicios web: seleccione Servicio web de bean Java descendente como tipo de servicio web. También puede hacer lo siguiente:
    1. Seleccione las etapas de desarrollo de servicios web que desea completar utilizando el control deslizante. Se establecerán varios valores predeterminados en los restantes paneles del asistente:
      • Desarrollo: esto desarrollará la definición WSDL y la implementación del 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: esto asegura que el proyecto que albergará el servicio web o el cliente se asociará a un EAR cuando lo necesite por el servidor de aplicaciones destino.
      • Despliegue: creará el código de despliegue del servicio.
      • Instalación: instalará y configurará el módulo web y los EAR en el servidor de destino. Si se requieren cambios en los puntos finales del archivo WSDL, deberán realizarse en esta etapa.
      • Inicio: iniciará el servidor una vez que el servicio se haya instalado en él.
      • Prueba: proporcionará varias opciones para probar el servicio como, por ejemplo, el uso del cliente de servicios genérico, Web Service Explorer o JSP de ejemplo.
    2. Seleccione el tiempo de ejecución del servidor: se visualiza el servidor predeterminado. Si desea desplegar el servicio en un servidor distinto, pulse el enlace de servidor y especifique 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 del servicio web: se visualiza el tiempo de ejecución predeterminado. Para desplegar el servicio en el tiempo de ejecución JAX-WS de IBM® WebSphere, pulse el enlace de tiempo de ejecución y selecciónelo en la ventana que se abre.
    4. Seleccione el proyecto de servicio y el proyecto EAR de servicio: se visualizará el proyecto seleccionado en el espacio de trabajo. Sólo están soportados los proyectos web con la faceta Java 5.0, Java 6.0 o Java 7.0 habilitada. Para seleccionar un EAR y un proyecto diferente, pulse el enlace del proyecto, o especifique un nombre y permita que el asistente cree el proyecto automáticamente. 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. Si desea crear un cliente, seleccione el tipo de proxy que se va a generar y repita los pasos del 1 al 4 para el cliente. El cliente puede crearse más adelante utilizando los pasos que se describen en: 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
    6. Supervise el servicio web: de esta forma, el tráfico del servicio web se enviará 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.
  5. Página Configuración de servicio web descendente de JAX-WS de WebSphere:
    • Carpeta de salida: especifique la ubicación donde se genera el esqueleto Java generado o acepte el valor predeterminado.
    • Paquete de destino: especifique el nombre de paquete del Java generado o acepte el valor predeterminado.
    • Habilitar estilo de envoltura: habilita la correlación de estilos de envoltura de WSDL con Java. Para los documentos WSDL que implementan un patrón envuelto de documento/literal, se declara un elemento raíz en el esquema XML y se utiliza como una envoltura de operación para un flujo de mensajes. Existen diferentes definiciones de elementos de envoltura para la solicitud y la respuesta. El elemento cuyo nombre es el mismo que el de la operación (el elemento de envoltura) se separa, para que cada uno de sus elementos de contenido se convierta en un parámetro de la firma de método Java generada.
    • Generar clases JAXB serializables: en WebSphere Application Server y WebSphere(r) Application Server Liberty Profile V8.5.5, cuando habilita la faceta Java 6, puede elegir generar clases JAXB que implementan java.io.Serializable. El estado de las clases que no implementan esta interfaz no se serializa ni deserializa.
    • Habilitar soporte MTOM: si selecciona este recuadro de selección, se habilita el mecanismo de optimización de transmisión de mensajes SOAP para optimizar la transmisión de contenido binario. Para obtener más información sobre MTOM, consulte Visión general de MTOM
    • Versión de código JAX-WS que se va a generar: WebSphere Application Server V7.0 da soporte al código compatible con JAX-WS 2.0 o 2.1. WebSphere Application Server V8.0, V8.5 y WebSphere(r) Application Server Liberty Profile V8.5.5 dan soporte al código compatible con JAX-WS 2.0, 2.1 o 2.2.
    • Copiar WSDL en el proyecto: seleccione esta opción para copiar el archivo WSDL en el proyecto de servicio, o el tiempo de ejecución generará dinámicamente el WSDL cuando sea necesario. Esta es una opción conveniente si tiene previsto crear el cliente más adelante o publicar el WSDL para otros usuarios.
    • Generar clases JAXB serializables: en WebSphere Application Server y WebSphere(r) Application Server Liberty Profile V8.5.5, cuando habilita la faceta Java 6, puede elegir generar clases JAXB que implementan java.io.Serializable. El estado de las clases que no implementan esta interfaz no se serializa ni deserializa.
    • 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. Si selecciona este recuadro de selección, la página siguiente del asistente permite navegar a los archivos de declaración de enlace personalizado.
    • Personalizar nombre de clase de implementación de servicio: seleccione este recuadro de selección si desea cambiar la correlación predeterminada de nombres de puerto con nombres de clase de implementación de servicio.
    • Generar biblioteca de esquemas: permite generar un código de esquema en una biblioteca de esquemas. Si selecciona una biblioteca de esquemas, en una página más adelante puede personalizar las correlaciones entre los documentos XSD o los grupos de documentos XSD con un proyecto.
    • 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.
  6. Dependiendo de las opciones elegidas en la página anterior, puede que deba personalizar la implementación de servicio web en las páginas siguientes:
    1. Página Declaraciones de enlace personalizado: si ha seleccionado especificar archivos de enlace JAX-WS o JAXB, puede examinar los archivos en esta página.
    2. Página Configuración de implementación de servicio: para cada puerto definido en el archivo WSDL, puede especificar un nombre para la clase de implementación de servicio o aceptar el valor predeterminado.
    3. Página Configuración de proyecto de esquema: si ha seleccionado generar una biblioteca de esquemas, utilice esta página para personalizar las correlaciones entre los proyectos y los documentos XSD. Esta característica sólo funciona si todas las dependencias de esquema están en targetNamespaces diferentes; de lo contrario, hay errores de compilación en ObjectFactory.java.
  7. Página Probar servicio web: si ha seleccionado probar el servicio web, seleccione el recurso de prueba para el servicio web generado y pulse Iniciar. El servicio web se abre en el explorador de servicios web o en el cliente de servicios genérico. Seleccione la operación que desea probar, especifique la información necesaria y pulse Ir. El resultado aparece en el panel Estado. Pulse Siguiente.
  8. Página Configuración de cliente de servicios web JAX-WS de WebSphere: si ha seleccionado generar un cliente, puede especificar las siguientes opciones para él en esta página:
    • Carpeta de salida: la ubicación donde se genera el código de cliente
    • Paquete de destino: el asistente de cliente de servicios web genera varios archivos Java. 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.
    • Generar cliente portátil: seleccione este recuadro de selección para mover el código de cliente del servicio web de una máquina a otra o de una instancia de WebSphere Application Server o WebSphere Application Server Liberty Profile V8.5.5 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 el cliente de servicio web. Si selecciona este recuadro de selección, la página siguiente del asistente le permitirá navegar a los archivos de declaración de enlace personalizado.
    • Personalizar nombre de clase de proxy del cliente: seleccione este recuadro de selección si desea cambiar la correlación predeterminada de nombres de puerto con nombres de clase de implementación de servicio
  9. Página Declaraciones de enlace personalizado: si ha seleccionado especificar archivos de enlace JAX-WS o JAXB, puede examinar los archivos en esta página.
  10. Página Configuración de implementación de servicio: página Configuración de generación de proxy: para cada puerto definido, puede especificar un nombre para la clase de proxy o aceptar el valor predeterminado.
  11. 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 muestran los métodos asíncronos.
    • Ejecutar prueba en el servidor: inicia el servidor automáticamente.

Resultados

Una vez creado el servicio web, puede ocurrir lo siguiente dependiendo de las opciones que haya seleccionado:
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: tsklwsdljaxws.html