Suporte de Web Services Addressing
O suporte ao Endereçamento de Serviços da Web (WS-Addressing) neste produto fornece o ambiente para os serviços da Web que usam as especificações World Wide Web Consortium (W3C) WS-Addressing. Esta família de especificações fornece mecanismos de transporte neutro para endereçar serviços da Web e para facilitar o endereçamento de ponta a ponta.
- Um desenvolvedor de serviço da Web que precisa usar as interfaces de programação de aplicativos de WS-Addressing (APIs) para criar referência de terminal dentro de um aplicativo, e então utiliza esses referências para destinar as instâncias do recurso do serviço da Web.
- Um programador de sistema que precisa usar as interfaces de programação do sistema (SPIs) do WS-Addressing proprietário da IBM para executar operações mais avançadas do WS-Addressing, como a especificação de propriedades message-addressing em mensagens de serviços da Web.
- Um administrador que está configurando conjuntos de políticas para aplicativos JAX-WS.
O suporte WS-Addressing para desenvolvedores consiste de dois conjuntos de interfaces de programação: as interfaces padrão JAX-WS e a implementação de proprietário da IBM da especificação do WS-Addressing.
Recursos do Suporte ao WS-Addressing JAX-WS
Esse produto fornece suporte para as APIs do WS-Addressing JAX-WS, que podem ser usadas para a execução de funções de endereçamento básicas, como a criação de uma referência de terminal, a ativação do suporte ao WS-Addressing e a especificação de URIs de ação, associadas às operações WSDL do serviço da Web. Utilize as APIs se você quiser executar as funções simples de WS-Addressing e criar os aplicativos do JAX-WS móveis.
- Representações Java™ de referências do terminal do WS-Addressing.
- É possível criar instâncias de referência de terminal Java para o terminal de aplicativos ou outros terminais no mesmo aplicativo, no tempo de execução. Não é necessário especificar o URI da referência de terminal.
- É possível criar instâncias de referência de terminal Java para terminais em outros aplicativos especificando o URI da referência de terminal.
- Nos serviços, você pode utilizar anotações para especificar se o suporte de WS-Addressing está ativado, se ele é necessário e qual padrão de troca de mensagem (síncrono, assíncrono ou ambos) utilizar.
- Em clientes, você pode utilizar recursos para especificar se o suporte do WS-Addressing está ativado e se ele é necessário.
- É possível configurar o proxy de cliente ou objetos de dispatch usando as referências de terminal.
- Suporte ao Java para referências de terminal que representam instâncias do WS-Resource (Web Services Resource).
- É possível associar parâmetros de referência com uma referência de terminal no tempo de sua criação, para correlacioná-la com uma instância de recurso específica.
- Em serviços da Web de destino, você pode extrair parâmetro de referência de uma mensagem recebida, de maneira que o serviço da Web pode rotear a mensagem para a instância do WS-Resource apropriado.
- É possível especificar informações adicionais sobre ligações nos metadados de uma referência de terminal como parte da especificação do JAX-WS 2.2. Esta funcionalidade foi incluída no WebSphere Application Server na Versão 7, no entanto, como ela não era parte da especificação JAX-WS 2.1, você pode ter experimentado problemas de incompatibilidade ao interoperar com servidores não WebSphere Application Server que não ofereciam suporte para metadados adicionais nas referências de terminal. O JAX-WS 2.2 suporta metadados WSDL em referências de terminal, portanto, os aplicativos serão compatíveis com outras implementações desta especificação. Consulte o tópico "Visão Geral de Endereçamento dos Serviços da Web" para obter informações adicionais.
- É possível ativar e configurar o WS-Addressing em um cliente ou servidor incluindo asserções do WS-Policy no documento WSDL. O WebSphere Application Server processa informações de WS-Addressing mantidas dentro do aspecto de WS-Policy de um documento WSDL e as usa na configuração desse aplicativo. Consulte o tópico "Ativando o Suporte do Endereçamento de Serviços da Web para Aplicativos JAX-WS Usando WS-Policy" para obter informações adicionais.
- É possível especificar a necessidade de um padrão de troca de mensagens síncrono ou assíncrono para um aplicativo de serviço da Web usando a anotação de endereçamento ou AddressingFeature. Use o parâmetro responses nas anotações de endereçamento ou a classe AddressingFeature no código. Consulte o tópico "Ativando o Suporte de Endereçamento de Serviços da Web para Aplicativos JAX-WS Usando Anotações de Endereçamento" e o tópico "Ativando o Suporte de Endereçamento de Serviços da Web para Aplicativos JAX-WS Usando Recursos de Endereçamento" para obter informações adicionais.
- É possível configurar o WS-Addressing usando descritores de implementação. Inclua um elemento <addressing> e elementos filhos opcionais no arquivo descritor de implementação para o aplicativo. Consulte o tópico "Ativando o Suporte de Endereçamento de Serviços da Web para Aplicativos JAX-WS Usando Descritores de Implementação" para obter informações adicionais.
- É possível gerar o código a partir de um documento WSDL e o WebSphere Application Server insere automaticamente as anotações @Action e @FaultAction no código Java gerado. Consulte o tópico "Anotações de Endereçamento de Serviços da Web" para obter informações adicionais.
Recursos do Suporte do WS-Addressing Proprietário da IBM
Este produto fornece uma implementação proprietária da IBM da especificação WS-Addressing, que pode ser utilizada com aplicativos JAX-RPC e também aplicativos JAX-WS, para executar funções mais avançadas, como a criação de referências de terminal que representam objetos altamente disponíveis ou configurando diretamente propriedades de endereçamento de mensagem no cabeçalho SOAP. Use essas APIs e SPIs se desejar criar aplicativos JAX-RPC que usam endereçamento ou se desejar executar funções mais avançadas e que não são possíveis com as APIs do JAX-WS.
- É possível criar com facilidade as instâncias de referência de terminal Java para representar qualquer terminal no servidor, com base no ambiente de implementação do aplicativo. Não é necessário especificar o URI da referência de terminal. Além disso, as referências de terminal podem representar objetos altamente disponíveis ou gerenciados por carga de trabalho.
- É possível configurar objetos de contexto de pedido BindingProvider do JAX-WS ou objetos Stub ou Call do JAX-RPC, com uma referência de terminal de WS-Addressing. As chamadas futuras desses objetos são destinadas ao terminal representado pela referência de terminal. As chamadas também ficam em conformidade automaticamente com a especificação WS-Addressing (espaço de nomes) associada a essa referência de terminal.
- Argumentação e manipulação de referências de terminal além do que está
disponível no nível de programação de aplicativo.
- Você pode manipular o conteúdo da referência de terminal, conforme determinado pela especificação WS-Addressing.
- É possível associar um espaço de nomes de WS-Addressing e, portanto, o comportamento da especificação, com uma referência de terminal.
- Representações Java
das propriedades de endereçamento de mensagens do WS-Addressing.
- É possível especificar propriedades de endereçamento da mensagem do WS-Addressing para mensagens de saída dos serviços da Web No serviço da Web de destino, você pode extrair propriedades de endereçamento da mensagem das mensagens de serviço da web de entrada.
- É possível especificar o espaço de nomes de WS-Addressing de uma mensagem de saída de WS-Addressing, embora na maioria dos casos isso seja derivado automaticamente, com base na referência de terminal de destino. Em um serviço da Web de destino, você pode adquirir o espaço de nome do WS-Addressing de uma mensagem recebida.
Suporte para Especificações e Interoperabilidade de WS-Addressing
Por padrão, este produto suporta as especificações W3C WS-Addressing 1.0 Core e SOAP identificadas pelo espaço de nomes http://www.w3.org/2005/08/addressing. A menos que indicado de outra maneira, a semântica do WS-Addressing descrita nesta documentação refere-se a essas especificações.
Para interoperabilidade, outros níveis da especificação WS-Addressing são suportados nesta versão do produto; em particular, a submissão de W3C de WS-Addressing com o espaço de nomes http://schemas.xmlsoap.org/ws/2004/08/addressing.
Para aplicativos JAX-WS, este produto suporta a especificação dos metadados do WS-Addressing identificada pelo espaço de nomes http://www.w3.org/2007/05/addressing/metadata namespace. Essa especificação substituir a especificação de ligação WSDL (Web Services Description Language) do WS-Addressing pelo namespace http://www.w3.org/2006/05/addressing/wsdl.
- O elemento de extensibilidade wsaw:UsingAddressing, apenas no elemento de Ligação do WSDL. Os espaços de nomes para este elemento são http://www.w3.org/2006/05/addressing/wsdl e http://www.w3.org/2006/02/addressing/wsdl (reprovado).
- O elemento de extensibilidade wsaw:Action. Os espaços de nomes suportados para esse elemento são http://www.w3.org/2006/05/addressing/wsdl, http://www.w3.org/2006/02/addressing/wsdl (reprovado) e http://schemas.xmlsoap.org/ws/2004/08/addressing.