Creación de un esqueleto de enterprise bean (EJB) 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 EJM 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: 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: garantiza que el proyecto que alojará el servicio web o el cliente se asocie con un EAR cuando lo necesite 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 servidor: se visualiza el servidor predeterminado. Si desea desplegar el servicio en un servidor distinto, pulse el enlace de servidor y especifique otro servidor.
    3. Seleccione el tiempo de ejecución: se visualiza el tiempo de ejecución predeterminado. Para desplegar el servicio en el tiempo de ejecución JAX-WS de IBM®, pulse el enlace de tiempo de ejecución y selecciónelo en la ventana que se abre.
      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
    4. Seleccione el proyecto de servicio: se visualizará el proyecto seleccionado en el espacio de trabajo. Sólo se da soporte a los proyectos EJB. 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 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.
    7. Publique el servicio web.
  5. Página Configuración de servicio web EJM descendente de JAX-WS de WebSphere:
    • Carpeta de salida: especifique la ubicación donde se generará el esqueleto EJB generado o acepte el valor predeterminado.
    • Paquete de destino: especifique el nombre de paquete del Java generado o acepte el valor predeterminado.
    • Enlace de servicio web EJB: seleccione si el servicio web utilizará enlaces HTTP o JMS.
    • 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. Para simplificar, 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.
    • 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 serializará ni deserializará.
    • 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 esta opción, la página siguiente del asistente le permitirá 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 generará.
    • 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 Configuración de enlace JMX de JAX-WS de WebSphere: si ha seleccionado que el servicio web utilice JMS como método de transporte, deberá especificar la información sobre el enlace en esta página.
      • Destino JMS: seleccione una cola o un tema como tipo de destino.
      • Nombre JNDI de destino: el nombre JNDI de la cola o tema de destino.
      • Fábrica de conexiones JMS: el nombre JNDI de la fábrica de conexiones.
      • Nombre de fábrica de contexto inicial: el nombre de la fábrica de contexto inicial que se va a utilizar. Se correlaciona con la propiedad java.naming.factory.initial.
      • URL de proveedor JNDI: se correlaciona con la propiedad java.naming.provider.url.
      • Modalidad de entrega: indica si el mensaje de solicitud debe ser persistente o no.
      • Tiempo de vida de mensaje de solicitud: el tiempo de vida en milisegundos del mensaje de solicitud. Un valor 0 indica un tiempo de vida infinito.
      • Prioridad de mensaje de solicitud JMS: la prioridad JMS asociada con el mensaje de solicitud. 0 es la prioridad más baja y 9 es la prioridad más alta.
      • Nombre de respuesta: el nombre del componente de puerto al que se asignará la solicitud.
      • ID de usuario de fábrica de conexiones: el ID de usuario que se va a utilizar para obtener acceso a la fábrica de conexiones.
      • Contraseña de fábrica de conexiones: la contraseña que se va a utilizar para obtener acceso a la fábrica de conexiones.
      • Utilizar protocolo de interoperatividad SOAP/JMS: la selección de esta opción garantiza que el servicio web cumpla el protocolo indicado por el grupo de trabajo de enlace SOAP-JMS de W3C. Para obtener más información, consulte este sitio web: Documento funcional del grupo de trabajo de enlace SOAP-JMS
      • Definir propiedades JMS personalizadas: si selecciona esta opción, se iniciará una página que permite especificar pares de valor de propiedad.
    2. 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.
    3. 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.
    4. 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 funcionará si todas las dependencias de esquema están en targetNamespaces diferentes; de lo contrario, habrá errores de compilación en ObjectFactory.java.
  7. Página Configuración de proyecto de direccionador JAX-WS de WebSphere: Esta página aparece cuando se selecciona como destino el entorno de ejecución de WebSphere Application Server, pero no WebSphere Application Server Liberty Profile V8.5.5.
    • Direccionador HTTP: especifique el nombre del proyecto que desea utilizar como módulo de direccionador. Un módulo de direccionador proporciona un punto final de servicio web para un determinado transporte.
    • Direccionador JMS: especifique el nombre del proyecto que desea utilizar como módulo de direccionador. Un módulo de direccionador proporciona un punto final de servicio web para un determinado transporte.
    • Mecanismo de despliegue de MDB: seleccione la especificación de activación JMS o el puerto de escucha como el mecanismo de despliegue de beans controlados por mensaje.
    • Nombre JNDI de ActivationSpec: escriba el nombre de JNDI de la especificación de activación que debe utilizarse para desplegar este bean gestionado por mensajes. Este nombre debe coincidir con el nombre de una especificación de activación que ha definido en WebSphere Application Server
    • Nombre de puerto de entrada de escucha: especifique el nombre de puerto de escucha del módulo de direccionador.
  8. Página Probar servicio web: si ha seleccionado probar el servicio web en el paso 4a, seleccione el recurso de prueba para el servicio web generado y pulse Iniciar. El servicio web se abrirá en el explorador de servicios web o en el cliente de servicios genérico. Tenga en cuenta que sólo puede utilizar el explorador de servicios web para probar los servicios web que utilizan los transportes HTTP. Seleccione la operación que desea probar, especifique la información necesaria y pulse Ir. El resultado se mostrará en el panel Estado. Pulse Siguiente.
  9. 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: esta es la ubicación donde se generará el código de cliente
    • Paquete de destino: el asistente de cliente de servicios web genera varios archivos Java. De forma predeterminada, creará 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: 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 o WebSphere(r) 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 copiarán en el proyecto de cliente, en WEB-INF/wsdl, y un file:relativeURL que apunte a esta copia se inyectará 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 adicionales 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 esta opció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
    • 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 generará.
    • Versión de código JAX-WS que se va a generar: para WebSphere Application Server V7.0, tiene l a opción de generar un código compatible con JAX-WS 2.0 o 2.1. Para WebSphere Application Server V8.0, V8.5 y WebSphere Application Server Liberty Profile V8.5.5, tiene la opción de generar un código compatible con JAX-WS 2.0, 2.1 o 2.2.
  10. 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.
  11. 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.
  12. Página Prueba de cliente de servicio web:
    • Probar el proxy generado: si selecciona esta opción, el cliente de ejemplo se iniciará en un navegador web, lo que permite probar la funcionalidad.
    • 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 ubicará el JSP y los métodos que se incluirán 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: iniciará 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: tsklejbjaxws.html