O WSDL pode ser usado para configurar fluxos de mensagens.
Os fluxos de mensagens que funcionam com serviços da Web geralmente usam os nós SOAP. Para obter detalhes sobre os nós SOAP, consulte WebSphere Message Broker e Serviços da Web.
No modo WSDL, os nós SOAP são configurados usando o WSDL que foi previamente importado ou gerado em um conjunto de mensagens e são exibidos em WSDL Implementável no ambiente de trabalho. É possível arrastar o WSDL para um nó SOAP, ou especificá-lo utilizando a propriedade Nome do Arquivo WSDL no nó.
Você pode alterar o modo de operação dos nós SOAP para que eles ajam no modo de gateway. No modo de gateway, um WSDL não é necessário para configurar os nós, já que eles identificam solicitação/resposta genérica e mensagens SOAP unidirecionais que não estão vinculadas a um WSDL específico. Para obter mais detalhes, consulte Modo de Operação de Gateway para Nós SOAP.
Quando você importa o WSDL arrastando-o para um nó SOAP, as propriedades do nó são configuradas a partir das propriedades na URI de endereço do WSDL. As propriedades de transporte no nó SOAP são preenchidas de acordo com a primeira ligação importada do arquivo WSDL. Dessa forma, se a primeira ligação importada descrever um transporte JMS, as propriedades do Transporte JMS são preenchidas. Se a primeira ligação importada descrever um transporte HTTP, as propriedades do Transporte HTTP são preenchidas. Se você selecionar outra ligação importada, as propriedades de transporte são preenchidas adequadamente. O portType aparece diferentemente dependendo do transporte selecionado.
O URI do elemento address do WSDL pode existir em dois formatos diferentes, W3C ou IBM® (descontinuado). O formato da URI do WSDL afeta os nomes das propriedades do WSDL que o analisar procura para preencher as propriedades do nó SOAP. Por exemplo, a tabela de parâmetros de contexto do JNDI não é preenchida quando você importa um WSDL de estilo IBM, pois ela não suporta essas propriedades na URI de endereço do WSDL. A tabela é preenchida somente se os parâmetros de contexto do JNDI estiverem presentes em um WSDL de estilo W3C. Veja detalhes na seção Formatos de URI WSDL para JMS.
Se você fornecer uma definição de serviço, as propriedades do terminal serão configuradas automaticamente, mas também será possível configurar ou substituir estas propriedades manualmente.
Opcionalmente, as definições WSDL podem ser divididas em vários arquivos. A disposição típica é que um arquivo de definição de serviço de nível superior importe um arquivo de ligação, o arquivo de ligação importe um arquivo de interface e este arquivo de interface importe ou inclua arquivos de definição de esquema.
Uma WSDL portType (a interface WSDL lógica) não é suficiente para sozinha configurar um nó SOAP; é necessária uma ligação específica para que a carga útil SOAP seja bem-definida no tempo de execução.
Uma ligação define um uso, que pode ser document (o padrão) ou rpc. Se o uso for document, a carga útil SOAP será descrita por um elemento de Esquema XML na WSDL. Se o uso for rpc, a carga útil SOAP será o nome da operação WSDL em um espaço de nomes especificado.
Se desejar criar seu próprio fluxo de mensagens, configure os nós conforme descrito. No entanto, você pode criar um novo fluxo de mensagens modelo, arrastando uma definição WSDL para uma tela do Editor de Fluxo de Mensagens em branco e selecionando uma ligação WSDL específica. Também pode escolher o tipo de fluxo (provedor ou consumidor de serviços) e as operações a serem manipuladas pelo fluxo.
Os nós chaves e as propriedades no fluxo de mensagens gerado são configurados, mas você deve concluir a configuração e e incluir todos os outros nós que precisar antes de implementar o fluxo. Para obter detalhes sobre como configurar um novo serviço da Web usando o assistente, consulte Configurar Novo Assistente de Uso de Serviço da Web.
Um nó de SOAPReply é sempre utilizado com um nó de SOAPInput. Para obter detalhes de cenários de serviço da Web, consulte Cenários de Serviços da Web.
Um nó de SOAPAsyncResponse é sempre utilizado com um nó de SOAPAsyncRequest , associado à propriedade Identificador Exclusivo. Para padrões de uso de nós SOAP, consulte Cenários de Serviços da Web.
Um cliente de serviço da Web pode enviar um pedido HTTP GET com um cadeia de consultas ?wsdl aos fluxos de mensagens que implementam serviços da Web e receber uma representação do WSDL que foi usado para configurar o nó de entrada que fornece o terminal para o serviço. É possível fazer isso apenas para nós de entrada que utilizam HTTP e não transporte JMS. O protocolo do pedido HTTP GET deve corresponder ao protocolo do fluxo. Dessa forma, se o fluxo utilizar SSL, o pedido HTTP GET deve começar com https://.
O cliente iniciar o envio de uma consulta ?wsdl simples e recupera a definição completa do WSDL seguindo uma cadeia de importações referenciadas ou inclusões. Por exemplo, se o terminal de serviço da Web for http://localhost:7800/test1, o pedido do cliente inicial será:
GET http://localhost:7800/test1?wsdl
Esse pedido retorna a definição de serviço do WSDL de nível superior, que pode incluir importações para seções adicionais da definição do WSDL. Por exemplo, se o WSDL retornado possuir uma linha:
<wsdl:import ... location="http://localhost:7800/test1?wsdl=wsdl0"/>
então o cliente enviará um pedido correspondente para recuperar essa seção do WSDL:
GET http://localhost:7800/test1?wsdl=wsdl0
Uma ou mais seções WSDL também podem ter importações para dados de Esquema XML como, por exemplo:
<xsd:import ... schemaLocation="http://localhost:7800/test1?xsd=xsd0"/>
O cliente novamente envia um pedido corresponder para recuperar esses dados:
GET http://localhost:7800/test1?xsd=xsd0
A definição WSDL retornada é logicamente equivalente ao WSDL implementável no kit de ferramentas, com o esquema sequencial externo. Ela pode não ser fisicamente idêntica à definição original do WSDL importado. Apesar de um SOAPInput estar configurado com uma ligação WSDL específica, o WSDL retornado também inclui outras ligações que não são utilizadas pelo fluxo se fizerem parte da definição do WSDL original que foi importado.