Ativando o Suporte de Endereçamento de Serviços da Web para Aplicativos JAX-WS

O suporte do Web Services Addressing (WS-Addressing) fornece mecanismos para endereçar serviços da Web e fornece informações de endereçamento em mensagens. Para aplicativos JAX-WS, você pode ativar o suporte WS-Addressing de várias maneiras diferentes, como configurar conjuntos de política ou usar anotações em código.

Sobre Esta Tarefa

Desempenhe esta tarefa para ativar o suporte do WS-Addressing, como um fornecedor de serviços ou como um cliente de um serviço fornecido por outra parte.

Para provedores de serviços, o suporte do WS-Addressing é ativado por padrão, de forma que você não precisa executar nenhuma ação para ativar o suporte. Entretanto, é possível utilizar os mecanismos de ativação para modificar outro comportamento do WS-Addressing para o serviço, por exemplo, se as informações do WS-Addressing são obrigatórias, e o que é incluído no documento WSDL gerado.
  • Modifique o comportamento do suporte do WS-Addressing depois que o aplicativo for implementado anexando um conjunto de política ao aplicativo. No conjunto de política, é possível configurar o tipo de política do WS-Addressing para especificar se as informações do WS-Addressing são obrigatórias nas mensagens que chegam, e se utiliza o sistema de mensagens síncronas ou assíncronas. É possível comunicar a configuração de política WS-Addressing para outros servidores e clientes que suportam o WS-Policy, ativando o compartilhamento de política no servidor e aplicando a política de provedor no cliente. Este método substitui outros métodos.
  • Use elementos do descritor de implementação dentro de um elemento port-component.
  • Modifique o comportamento do suporte do WS-Addressing durante o desenvolvimento do serviço, usando as anotações Addressing ou SubmissionAddressing no código de serviço. Dentro de cada anotação é possível especificar se o WS-Addressing está ativado no servidor, se o servidor requer informações do WS-Addressing nas mensagens recebidas e o padrão de troca de mensagem que o servidor usará. A presença da anotação Endereçamento no código inclui um elemento UsingAddressing e uma asserção WS-Policy em qualquer documento WSDL que seja gerado para o serviço.
  • Modifique o comportamento do suporte WS-Addressing durante o desenvolvimento do serviço ao incluir os elementos UsingAddressing ou as asserções WS-Policy no documento WSDL. Se você fornecer seu próprio documento WSDL, em vez de depender do ambiente de tempo de execução JAX-WS para gerar um, e seu documento WSDL estiver sendo consumido por aplicativos não JAX-WS 2.2, poderá desejar incluir o elemento UsingAddressing já que os clientes não processarão as asserções WS-Policy.
Para clientes de serviço, o suporte do WS-Addressing é desativado por padrão. Use um dos seguintes métodos para ativar o suporte do WS-Addressing: A lista a seguir está em ordem descendente de precedência porque é possível aplicar diversos métodos. Por exemplo, o método do descritor de implementação substitui o uso de anotações ou recursos, mas ele próprio é substituído pelo uso de conjuntos de política.
  • Anexe um conjunto de política ao artefato do cliente e execute uma das seguintes ações:
    • Especifique na política se o WS-Addressing é obrigatório.
    • Aplique políticas do cliente e do provedor. Neste caso, o suporte do WS-Addressing será ativado no cliente apenas se o compartilhamento de política estiver ativado no provedor de serviços e a configuração de política para o provedor especificar que o WS-Addressing é obrigatório.
    Este método substitui outros métodos.
  • Configure a propriedade com.ibm.websphere.webservices.use.async.mep no contexto do pedido do cliente.
  • Use o WS-Addressing SPI proprietário da IBM® para incluir propriedades de endereçamento de mensagens para o contexto de pedido de mensagem.
  • Use elementos do descritor de implementação dentro de um elemento port-component-ref.
  • Use a anotação Addressing em combinação com a anotação WebServiceRef no código do cliente (quando estiver usando uma referência proxy de serviços da Web injetada).
  • Utilize os recursos de endereçamento no código do cliente. Propriedades configuradas usando esse método substituem essa configuração no documento WSDL para o serviço.
  • Use as asserções WS-Policy no documento WSDL para especificar o suporte do WS-Addressing. Se incluir anotações Addressing no seu código do aplicativo cliente, o documento WSDL gerado conterá as asserções do WS-Policy.
  • Especifique o elemento UsingAddressing no documento WSDL para o serviço. Se o serviço usar a anotação Addressing e você gerar o documento WSDL a partir do código, o elemento UsingAddressing já existirá.

As tabelas a seguir resumem o comportamento do suporte do WS-Addressing. Use essa tabela para determinar se uma mensagem de solicitação é aceita para as configurações do cliente para que não envolvam a configuração de política.

Essa é uma tabela complexa contendo títulos da coluna estendidos. Há uma coluna de título denominada "Configurações do cliente", que especifica se o suporte ao WS-Addressing está ativado no cliente e também qual estilo de sistema de mensagens é configurado. A segunda coluna principal mostra as configurações de política no provedor, com duas subcolunas para verificar se o WS-Addressing é opcional ou obrigatório. Essas duas subcolunas ainda se dividem em três subcolunas para o estilo do sistema de mensagens (síncrono, assíncrono ou ambos). A terceira coluna mostra as configurações do WSDL no provedor, com duas subcolunas para verificar se o WS-Addressing é opcional ou obrigatório.
Tabela 1. Como as Configurações do Cliente e do Provedor Interagem para Determinar se uma Mensagem de Solicitação é Aceita. O parágrafo anterior descreve essa tabela.
Configurações do Cliente Configurações de política do provedor Configurações de WSDL do provedor (atributo UsingAddressing required)
O WS-Addressing é opcional WS-Addressing é obrigatório1
Síncrono e assíncrono Apenas síncrono Apenas assíncrono Síncrono e assíncrono Apenas síncrono Apenas assíncrono false (WS-Addressing é opcional) true (WS-Addressing é obrigatório1)
Suporte ao WS-Addressing ativado e estilo de sistema de mensagens síncrono Mensagem aceita Mensagem aceita Falha Mensagem aceita Mensagem aceita Falha Mensagem aceita Mensagem aceita
Suporte ao WS-Addressing ativado e estilo de sistema de mensagens assíncrono Mensagem aceita Falha Mensagem aceita Mensagem aceita Falha Mensagem aceita Mensagem aceita Mensagem aceita
Suporte ao WS-Addressing não ativado e estilo de sistema de mensagens síncrono Mensagem aceita Mensagem aceita Mensagem aceita2 Falha Falha Falha Mensagem aceita Falha
Suporte ao WS-Addressing não ativado e estilo de sistema de mensagens assíncrono 3 Falha Falha Falha Falha Falha Falha Falha Falha
Notas:
  1. Se o WS-Addressing for obrigatório, todos os pedidos sem cabeçalhos do WS-Addressing serão rejeitados.
  2. O estilo do sistema de mensagens será aplicado apenas se os cabeçalhos do WS-Addressing estiverem presentes no pedido.
  3. O sistema de mensagens assíncrono não é possível sem cabeçalhos do WS-Addressing.

Use a tabela a seguir para determinar se uma mensagem de solicitação é aceita quando o cliente e o provedor tiverem ambos uma configuração de política do WS-Addressing; o cliente possui provedor, as políticas do cliente são aplicadas e o compartilhamento de política é ativado no servidor.

Essa é uma tabela complexa contendo títulos da coluna estendidos. Há uma coluna de título denominada "Configurações do cliente", que especifica se o suporte ao WS-Addressing é opcional ou obrigatório no cliente e também qual estilo de sistema de mensagens é configurado. A segunda coluna principal mostra as configurações de política no provedor, com duas subcolunas para verificar se o WS-Addressing é opcional ou obrigatório. Essas duas subcolunas ainda se dividem em três subcolunas para o estilo do sistema de mensagens (síncrono e assíncrono, somente síncrono ou somente assíncrono).
Tabela 2. Como as Configurações de Política do Cliente e do Provedor Interagem para Determinar se uma Mensagem de Solicitação é Aceita. O parágrafo anterior descreve essa tabela.
Configurações de política do cliente Configurações de política do provedor
WS-Addressing é opcional O WS-Addressing é Obrigatório
Síncrono e assíncrono Apenas síncrono Apenas assíncrono Síncrono e assíncrono Apenas síncrono Apenas assíncrono
WS-Addressing opcional e estilo do sistema de mensagens síncrono e assíncrono Mensagem aceita Mensagem aceita Mensagem aceita Mensagem aceita Mensagem aceita Mensagem aceita
WS-Addressing opcional e estilo do sistema de mensagens somente síncrono Mensagem aceita Mensagem aceita Mensagem aceita1 Mensagem aceita Mensagem aceita Falha
WS-Addressing opcional e estilo do sistema de mensagens somente assíncrono2 Falha Falha Falha Mensagem aceita Falha Mensagem aceita
WS-Addressing obrigatório e estilo do sistema de mensagens síncrono e assíncrono Mensagem aceita Mensagem aceita Mensagem aceita Mensagem aceita Mensagem aceita Mensagem aceita
WS-Addressing obrigatório e estilo do sistema de mensagens somente síncrono Mensagem aceita Mensagem aceita Falha Mensagem aceita Mensagem aceita Falha
WS-Addressing obrigatório e estilo do sistema de mensagens somente assíncrono Mensagem aceita Falha Mensagem aceita Mensagem aceita Falha Mensagem aceita
Notas:
  1. O estilo do sistema de mensagens será aplicado apenas se os cabeçalhos do WS-Addressing estiverem presentes no pedido.
  2. O sistema de mensagens assíncrono não é possível sem cabeçalhos do WS-Addressing.
Se as políticas do provedor e do cliente não forem compartilhadas, o cliente não enviará cabeçalhos do WS-Addressing (a menos que você ative o WS-Addressing no cliente por outro método). Neste caso, se a política do provedor especificar que o WS-Addressing é obrigatório, o servidor gerará uma falha, independentemente do estilo do sistema de mensagens.

Procedimento

Resultados

As propriedades do WS-Addressing estão agora incluídas no cabeçalho da mensagem SOAP e são processadas pelo servidor no recebimento da mensagem.


Ícone que indica o tipo de tópico Tópico de Tarefa



Ícone de registro de data e hora Última atualização: last_date
http://www14.software.ibm.com/webapp/wsbroker/redirect?version=cord&product=was-nd-mp&topic=twbs_wsa_dep_jaxws
Nome do arquivo: twbs_wsa_dep_jaxws.html