Recebendo Cabeçalhos SOAP Implícitos com JAX-RPC

É possível ativar um cliente de serviços da Web JAX-RPC (Java™ API for XML-based RPC) existente para receber os valores dos cabeçalhos SOAP implícitos. Ao modificar seu código de cliente para receber cabeçalhos SOAP implícitos, você pode receber informações específicas dentro de uma resposta de serviço da Web recebida.

Antes de Iniciar

Para concluir essa tarefa, você precisa de um cliente de serviços da Web que você possa ativar para receber cabeçalhos SOAP implícitos.

Um cabeçalho SOAP implícito é um cabeçalho SOAP que cabe em uma das seguintes descrições:
  • Uma parte da mensagem que é declarada como um cabeçalho SOAP na ligação no arquivo WSDL (Web Services Description Language), mas a definição da mensagem não é referenciada por um elemento portType em um arquivo WSDL.
  • Um elemento não está contido no arquivo WSDL.

Manipuladores e terminais de serviço podem manipular cabeçalhos SOAP implícitos ou explícitos utilizando o SOAP com a API Attachments para o modelo de dados Java (SAAJ).

Você não pode manipular os cabeçalhos SOAP protegidos. Um cabeçalho SOAP que é declarado como protegido por seu componente de propriedade, por exemplo, Segurança de Serviços da Web, não pode ser acessado pelos aplicativos do cliente. Ocorrerá uma exceção, se você tentar manipular os cabeçalhos SOAP protegidos.

Sobre Esta Tarefa

O aplicativo cliente configura as propriedades no objeto Stub ou Call para enviar e receber cabeçalhos SOAP implícitos.

Procedimento

  1. Crie um objeto java.util.HashMap
  2. Inclua uma entrada no objeto HashMap para cada cabeçalho SOAP implícito que o cliente quiser receber. A chave de entrada HashMap é o QName do cabeçalho SOAP. O valor de entrada HashMap é null.
  3. Configure a entrada HashMap no objeto Stub ou Call. O nome da propriedade é com.ibm.websphere.webservices.Constants.RESPONSE_SOAP_HEADERS. O valor da propriedade é HashMap.
  4. Emita as chamadas de método remoto no objeto Stub ou Call. O mecanismo de serviços da Web extrai os cabeçalhos de resposta especificados da mensagem de resposta de serviços da Web e insere-os no HashMap. Depois que o método remoto é retornado, os cabeçalhos de resposta podem ser acessados a partir do objeto HashMap.
    Um erro JAXRPCException poderá ocorrer se alguma das seguintes situações for verdadeira:
    • O HashMap contiver uma chave que não seja QName.
    • O HashMap contém uma chave que representa um cabeçalho SOAP que é declarado protegido pelo componente de propriedade.

Resultados

Você tem um cliente de serviços da Web JAX-RPC que pode receber valores de cabeçalhos SOAP implícitos.


Í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_retrievesoaphead
Nome do arquivo: twbs_retrievesoaphead.html