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-se um arquivo WSDL importado anteriormente para um aplicativo ou uma biblioteca, ou gerado em um conjunto de mensagens. É possível arrastar o arquivo WSDL para um nó SOAP, ou especificá-lo usando a propriedade Nome do arquivo WSDL no nó.
É possível alterar o modo de operação dos nós SOAP para que eles ajam no modo de gateway. No modo de gateway, não é necessário um WSDL para configurar os nós, porque eles manipulam solicitações/respostas genéricas 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ê arrasta um arquivo WSDL para um nó SOAP, as propriedades do nó são configuradas a partir das propriedades no 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. Portanto, se a primeira ligação importada descrever um transporte JMS, as propriedades do Transporte JMS serão preenchidas; se a primeira ligação importada descrever um transporte HTTP, as propriedades do Transporte HTTP serão preenchidas. Se você selecionar outra ligação importada, as propriedades de transporte são preenchidas adequadamente. O portType aparece de forma diferente, 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, porque ela não suporta essas propriedades no 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 diversos 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.
Para criar seu próprio fluxo de mensagens, configure os nós conforme descrito. No entanto, é possível criar um novo fluxo de mensagens esqueleto, arrastando uma definição WSDL até uma tela em branco no editor de Fluxo de Mensagens e selecionando uma ligação WSDL específica. Também é possível escolher o tipo de fluxo (provedor ou consumidor de serviços) e as operações a serem manipuladas pelo fluxo.
Os nós e as propriedades principais no fluxo de mensagens gerado estão configurados, mas você deve concluir a configuração e incluir outros nós necessários antes da implementação do 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.