Anotando um bean EJB para criar um serviço da web

É possível anotar tipos, métodos, campos e parâmetros em seu bean EJB para especificar um serviço da web.

Antes de Iniciar

Pré-requisitos:
  • Sua área de trabalho contém um bean de Sessão EJB 3.x que possui pelo menos um método público.
  • Esse bean EJB está em um projeto EJB ativado por JAX-WS.
  • O Tempo de Execução de Destino do projeto é WebSphere Application Server v7.0 ou superior.

Sobre Esta Tarefa

As etapas para criação de um serviço da web a partir de um bean EJB usando anotações são as seguintes:
  1. Anote o bean EJB com a anotação @WebService, e quaisquer outras anotações necessárias para a sua implementação.
  2. Crie os módulos roteadores JMS ou HTTP para o serviço da web conforme descrito em: Criando módulos roteadores do serviço da web. Novo no WebSphere Application Server v8, se você empacotar seu aplicativo EJB em um módulo WAR, não será necessário criar módulos roteadores.
  3. Publique o aplicativo em um servidor conforme descrito em: Criando um serviço da web a partir de um bean EJB anotado, publicando em um servidor
Para anotar seu bean EJB:

Procedimento

  1. Na visualização Enterprise Explorer, dê um clique duplo em seu Java™ bean para abrir o arquivo no editor Java.
  2. Na classe Java que implementa seu serviço da web, especifique a anotação @WebService, bem como uma anotação @Stateless, @Stateful ou @Singleton. Além disso, especifique os atributos, se houver, que você deseja que a anotação tenha.
    • A maioria dos erros que são exibidos ao incluir anotações pode ser resolvida usando as correções rápidas sugeridas. Para exibir as correções rápidas, clique no marcador de erro.
    • Para incluir anotações ou atributos em anotações existentes, você pode usar a visualização Anotações, em vez de incluir manualmente essas informações na classe. Esta visualização fornece validação e orientação básicas ao trabalhar com anotações.
  3. Opcional: Use estas e outras anotações para customizar seu serviço da web ainda mais:
    • Na classe Java que implementa seu serviço da web, especifique a anotação @WebMethod em cada método que você deseja customizar para o serviço. É possível usar essa anotação para excluir um método a partir de seu serviço. Por padrão, todos os métodos públicos serão expostos em um serviço, incluindo os métodos herdados que estão sob a classe de Objeto.
    • Nos métodos que são expostos em seu serviço da web, use as anotações @WebParam e @WebResult para customizar o mapeamento de parâmetros e resultados para partes da mensagem e elementos XML.
    • Em uma classe de exceção, especifique a anotação @WebFault para mapear sua classe para uma falha WSDL.

Resultados

Assim que as anotações tiverem sido incluídas no bean, a visualização Serviços deverá listar o serviço da web sob o título do JAX-WS. A partir dessa visualização, é possível testar o serviço da web clicando nele e selecionando Testar com o Web Services Explorer ou Testar com o Generic Service Client. Também é possível gerar descritores de implementação e gerenciar os conjuntos de política associados ao serviço a partir dessa visualização.
Icon that indicates the type of topic Task topic
Timestamp icon Last updated: last_date

File name: twsanbuejb.html