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:

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 el explorador de servicios web 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.
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: twsanbuejb.html