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
- Na visualização Enterprise Explorer, dê um clique duplo em seu Java bean para abrir o arquivo no editor Java.
- 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.
- 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.