Ativando o Suporte do Web Services Addressing para Aplicativos JAX-WS Usando Anotações de Endereçamento
Para aplicativos JAX-WS, é possível ativar o suporte do WS-Addressing durante o desenvolvimento de um aplicativo de serviço, usando anotações de endereçamento no código. Também é possível usar este método em um aplicativo cliente que usa uma referência de proxy do serviço da Web injetada.
Sobre Esta Tarefa
- Addressing - use esta anotação se você deseja usar a especificação 2005/08 WS-Addressing.
- SubmissionAddressing - use esta anotação se desejar usar a especificação 2004/08 WS-Addressing.
As configurações de anotação substituem as configurações no documento WSDL. As configurações de anotação poderão diferir das configurações do WSDL se você criar o documento WSDL manualmente em vez de gerá-lo do código.
Nome do parâmetro | Valores possíveis | Description |
---|---|---|
ativada | true (padrão) |
Se o suporte do WS-Addressing está ativado. |
obrigatório | verdadeiro |
Se cabeçalhos do WS-Addressing são necessários. |
respostas | Responses.All (padrão) |
Se usar um padrão de troca de mensagens síncrono ou assíncrono. Especifique
Responses.ANONYMOUS para enviar mensagens em um padrão de mensagem síncrona; use
Responses.NON_ANONYMOUS para enviar mensagens em um padrão de troca de mensagens assíncronas. Nota: Este
parâmetro não é suportado na anotação SubmissionAddressing.
|
Procedimento
Resultados
Se você usar uma anotação de endereçamento no aplicativo de serviço, o servidor processará quaisquer cabeçalhos WS-Addressing que estiverem em conformidade com a especificação relevante nas mensagens SOAP de entrada. Se você especificar que o WS-Addressing é necessário, e uma mensagem SOAP de entrada não incluir nenhum cabeçalho do WS-Addressing, ou incluir cabeçalhos do WS-Addressing que não estão em conformidade com a especificação indicada pela anotação, o servidor retornará uma mensagem de falha. Por exemplo, se um cliente enviar uma mensagem que inclui cabeçalhos 2004/08 WS-Addressing, e o servidor exigir cabeçalhos 2005/08, o servidor retornará uma mensagem de falha.
Se você usar a anotação Addressing e gerar um documento WSDL a partir do código, um elemento UsingAddressing e as asserções WS-Policy são criados no documento WSDL. Clientes que utilizam esse documento WSDL incluirão informações do WS-Addressing em suas mensagens. A anotação SubmissionAddressing não é entendida pelas ferramentas de geração WSDL atuais. No entanto, o documento WSDL não distingue entre a especificação 2005/08 e a especificação 2004/08, portanto, se desejar gerar um documento WSDL a partir do código que contém uma anotação SubmissionAddressing, use as anotações Addressing e SubmissionAddressing juntas.
Se você especificar o atributo de respostas, o padrão de troca de mensagens correspondente será usado.