Anotar un bean EJB para crear un servicio web

Puede anotar tipos, métodos, campos y parámetros en el bean EJB para especificar un servicio web.

Antes de empezar

Requisitos previos:
  • El espacio de trabajo contiene un bean de sesión EJB 3.x que tiene al menos un método público.
  • Este bean EJB está en un proyecto EJB habilitado para JAX-WS.
  • El tiempo de ejecución del destino del proyecto es WebSphere Application Server v7.0 o posterior.

Acerca de esta tarea

Los pasos necesarios para crear un servicio web a partir de un bean EJB utilizando anotaciones son los siguientes:
  1. Anote el bean EJB con la anotación @WebService y otras anotaciones que sean necesarias para su implementación.
  2. Cree módulos de direccionador JMS o HTTP para el servicio web, como se describe en: Creación de módulos de direccionador de servicio web. Como novedad en WebSphere Application Server v8, si empaqueta la aplicación EJB en un módulo WAR, no es necesario crear módulos de direccionador.
  3. Publique la aplicación en un servidor, como se describe en: Crear un servicio web a partir de un bean EJB anotado mediante la publicación en un servidor
Para anotar el bean EJB:

Procedimiento

  1. En la vista Explorador empresarial, efectúe una doble pulsación en el bean Java™ para abrir el archivo en el editor Java.
  2. En la clase Java que implementa el servicio web, especifique la anotación @WebService, así como una anotación @Stateless, @Stateful o @Singleton. Asimismo, especifique los atributos que desea que tenga la anotación, si hay alguno.
    • La mayoría de errores que aparecen cuando se añaden anotaciones pueden resolverse utilizando los arreglos rápidos recomendados. Para ver los arreglos rápidos, pulse el marcador de errores.
    • Para añadir anotaciones o atributos a las anotaciones existentes, puede utilizar la vista Anotaciones, en lugar de añadir manualmente esta información a la clase. Esta vista proporciona una validación y una orientación básicas cuando se trabaja con las anotaciones.
  3. Opcional: utilice estas y otras anotaciones para continuar personalizando el servicio web:
    • En la clase Java que implementa el servicio web, especifique la anotación @WebMethod en cada uno de los métodos que desee personalizar para el servicio. Puede utilizar esta anotación para excluir un método del servicio. De forma predeterminada, se exponen todos los métodos públicos en un servicio, incluidos los métodos heredados que están bajo la clase de objeto.
    • En los métodos que se exponen en el servicio web, utilice las anotaciones @WebParam y @WebResult para personalizar la correlación de los parámetros y los resultados con las partes de los mensajes y los elementos XML.
    • En una clase de excepción, especifique la anotación @WebFault para correlacionar la clase con un error de WSDL.

Resultados

Una vez añadidas las anotaciones al bean, la vista Servicios debe mostrar el servicio web debajo de la cabecera JAX-WS. En esta vista, para probar el servicio web, púlselo con el botón derecho y seleccione Probar con Web Services Explorer o Probar con cliente de servicio genérico. También puede generar descriptores de despliegue y gestionar los conjuntos de políticas asociados con el servicio desde esta vista.
Icon that indicates the type of topic Task topic
Timestamp icon Last updated: last_date

File name: twsanbuejb.html