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

Você pode anotar tipos, métodos, campos e parâmetros em seu Java™ bean para especificar um serviço da web.

Antes de Iniciar

Pré-requisitos:
  • Sua área de trabalho contém um Java bean que possui pelo menos um método público.
  • Este Java bean está em um projeto da web ou projeto Java básico.

Sobre Esta Tarefa

Para anotar seu Java bean:

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 o serviço da web, especifique a anotação @WebService. Além disso, especifique os atributos, se houver, que você deseja que a anotação possua.
    • 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 para 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 básica e orientação ao trabalhar com anotações.
  3. Opcional: Use estas e outras anotações para customizar seu serviço da web adicionalmente:
    • 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. Você pode 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 seus 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

Depois que as anotações foram incluídas no bean, a visualização Serviços deve listar o serviço da web sob o título JAX-WS. A partir dessa visualização, você pode testar o serviço da web clicando com o botão direito nele e selecionando Testar com o Web Services Explorer ou Testar com o Generic Service Client. Você pode também gerar descritores de implementação e gerenciar os conjuntos de políticas 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: twsandoc001.html