WebSphere Message Broker, Versão 8.0.0.5 Sistemas operacionais: AIX, HP-Itanium, Linux, Solaris, Windows, z/OS

Consulte as informações sobre a versão mais recente do produto em IBM Integration Bus, Versão 9.0

EndpointLookup

Use o nó EndpointLookup para recuperar informações do terminal em serviço mantidas no WebSphere Service Registry and Repository (WSRR). As entidades que correspondem aos critérios de procura especificados são armazenadas no ambiente local. Dependendo da configuração do nó, o destino da URL de serviço da Web usado pelos nós de pedido SOAP e HTTP também pode ser configurado. A mensagem de entrada não é modificada.

Propósito

O nó EndpointLookup recupera informações do terminal em serviço relacionadas a um serviço de WSRR descrito pelo WSDL. Uma definição de WSDL define um serviço em termos de uma interface (referida como um portType) se tornar disponível em uma porta especificada. A porta WSDL define as informações de terminal necessárias para acessar o serviço. Os terminais são recuperados de acordo com critérios de procura definidos pelas propriedades do nó, opcionalmente suplementados ou substituídos pelas definições de ambiente local no tempo de execução. Consulte Substituições de LocalEnvironment para obter detalhes adicionais.

Os dados recuperados são colocados na árvore de ambiente local, tornando-os disponíveis nos nós subsequentes. A mensagem de entrada recebida pelo nó é propagada ao terminal de saída inalterada. Além disso, o nó EndpointLookup pode configurar automaticamente a URL de destino a ser usada por um nó SOAPRequest, SOAPAsyncRequest ou HTTPRequest subsequente, dependendo do valor da propriedade Política de Correspondência, consulte Processamento do Nó EndpointLookup. Isto é feito pelo nó configurando as substituições de ambiente local que são usadas por esses nós.

Processamento do Nó EndpointLookup

O nó EndpointLookup está contido no repositório de Serviços da Web da paleta do nó do fluxo de mensagens e é representado no WebSphere Message Broker Toolkit pelo seguinte ícone:

Ícone do nó EndpointLookup
Quando o nó EndpointLookup recebe uma mensagem, as etapas seguintes ocorrem em sequência.
  1. O nó EndpointLookup recupera os dados de serviço do WSRR usando os critérios de procura especificados.
  2. Se uma ou mais correspondências forem localizadas, o nó EndpointLookup incluirá uma representação desses terminais na árvore de ambiente local.
    • Se a Política de Correspondência estiver configurada como Um, uma única entidade será retornada pelo WSRR e incluída na árvore de ambiente local. Uma entidade diferente pode ser retornada toda vez que a consulta for emitida. Além disso, o valor do terminal recuperado é configurado como a substituição do ambiente local para a URL de destino usada pelos nós SOAPRequest, SOAPAsyncRequest ou HTTPRequest. Se o registro contiver mais de uma entidade que corresponda aos critérios de procura especificados, não será possível determinar qual será retornada pelo WSRR.
    • Se a Política de Correspondência for configurada como Todos, todas as entidades correspondentes serão incluídas na árvore de ambiente local. A ordem das entidades é determinada pelo WSRR e pode variar entre as consultas. A URL de destino usada pelos nós SOAPRequest, SOAPAsyncRequest ou HTTPRequest não é configurada. Em vez disso, você deve incluir um nó de cálculo para seu fluxo de mensagens para selecionar o endereço necessário e para definir as configurações de ambiente local necessárias para esses nós de pedido.

    A mensagem de entrada é propagada inalterada para o terminal de Saída. A árvore de ambiente local é propagada ao terminal de Saída, onde ela fica disponível para processamento adicional por nós de transformação. Consulte Saída do Nó EndpointLookup para obter detalhes da árvore de saída de ambiente local.

  3. Se nenhuma correspondência for localizada, o nó EndpointLookup propaga a mensagem de entrada para o terminal NoMatch.
  4. Se ocorrer um erro de processamento, por exemplo se o servidor WSRR configurado no objeto do serviço configurável DefaultWSRR não puder ser conectado, ou o tempo de conexão se esgotar, o nó EndpointLookup propagará a mensagem de entrada inalterada para o terminal de Falha. A ExceptionList é preenchida com detalhes do erro.

Amostra

Examine a amostra a seguir para ver como utilizar esse nó:

Você só pode visualizar informações sobre amostras quando usa o centro de informações que está integrado ao WebSphere Message Broker Toolkit ou o centro de informações on-line. Você só poderá executar amostras quando usar o centro de informações que está integrado ao WebSphere Message Broker Toolkit.

Substituições de LocalEnvironment

É possível substituir as propriedades do nó RegistryLookup usando as configurações do ambiente local. Consulte o Definindo Dinamicamente os Critérios de Procura.

Terminais e Propriedades

Quando tiver colocado uma instância do nó EndpointLookup em um fluxo de mensagens, você poderá configurá-lo; consulte Configurando um Nó do Fluxo de Mensagens. As propriedades do nó são exibidas na visualização Propriedades.

Os terminais do nó EndpointLookup são descritos na tabela a seguir.

Terminal Descrição
Entrada O terminal de entrada que aceita a mensagem para processamento pelo nó.
Failure O terminal de saída para o qual a mensagem é roteada se um erro ocorrer no processamento do nó.
Saída O terminal de saída para o qual a mensagem de entrada não-modificada e o ambiente local atualizado contendo os dados de registro correspondidos são enviados.
NoMatch O terminal para o qual a mensagem de entrada é enviada se nenhuma entidade de correspondência for localizada com base nos critérios de procura especificados.

As tabelas a seguir descrevem as propriedades do nó. A coluna com cabeçalho M indica se a propriedade é obrigatória (marcada com um asterisco caso seja necessário digitar um valor quando nenhum padrão for definido); a coluna com cabeçalho C indica se a propriedade é configurável (você poderá alterar o valor quando incluir o fluxo de mensagens ao arquivo BAR para implementá-lo).

As propriedades Descrição do nó EndpointLookup são descritas na tabela a seguir.

Propriedade M P Padrão Descrição
Nome do Nó Não Não O tipo de nó: EndpointLookup O nome do nó.
Short description Não Não Nenhum Uma breve descrição do nó.
Descrição Longa Não Não Nenhum Texto que descreve a finalidade do nó no fluxo de mensagens.

As propriedades Básicas do nó EndpointLookup são descritas na tabela a seguir.

Propriedade M P Padrão Descrição Propriedade do Comando mqsiapplybaroverride
Nome do Tipo de Porta Não Sim Nenhum Registro de nome que identifica de forma exclusiva um portType de serviço WSL definido pelo WebSphere Service Registry and Repository. Pelo menos uma das propriedades é necessária. Se você deixar todos os três valores da propriedade em branco, uma mensagem de erro será mostrada quando você tentar salvar. nome
Espaço de Nomes do Tipo de Porta Não Sim Nenhum espaço de nomes
Versão do Tipo de Porta Não Sim Nenhum portVersion
Propriedades do Usuário Não Não Nenhum Permite que uma consulta especifique propriedades definidas pelo usuário. Inclua Propriedades do Usuário clicando em Incluir. Propriedades de Usuário se referem às Propriedades Adicionais que são usadas para catalogar as entidades no WSRR. Insira valores para Nome da Propriedade, que é a correspondência de letras maiúsculas e minúsculas da propriedade adicional no WSRR, Tipo de Propriedade e Valor da Propriedade. O Tipo de Propriedade pode ser:
  • uma Cadeia (o padrão), nesse caso o Valor da Propriedade é uma cadeia de caracteres a ser correspondida com o valor da propriedade adicional presente no WSRR
  • XPATH, ou ESQL, nesse caso o Valor da Propriedade é uma expressão XPath ou ESQL que localiza um campo na árvore de mensagens que contém a cadeia de caracteres a ser correspondida com o valor da propriedade adicional presente no WSRR.

Estas propriedades Propriedades de Usuário e Classificação são usadas na consulta para identificar exclusivamente a porta de serviço de WSDL.

 
Classificação Não Não Nenhum

A propriedade de sistema de classificação de OWL (Web Ontology Language). Cada classificador é um classe em OWL e tem um URI (Uniform Resource Identifier). Utilizar as classificações no registro pode ajudar a tornar os objetos mais fáceis de encontrar e também pode incluir significado nos objetos customizados que são exclusivos a um determinado sistema.

Inclua uma Classificação clicando em Incluir e digitando o URI de OWL completo para a classificação de OWL. Por exemplo, isto pode definir um estado do ciclo de vida do terminal em serviço específico.

Estas propriedades Propriedades de Usuário e Classificação são usadas na consulta para identificar exclusivamente a porta de serviço de WSDL.

 
Política de Correspondência Sim Não Um O WSRR pode conter múltiplas entidades que correspondem aos critérios de procura especificados pelas propriedades anteriores. Se Política de Correspondência estiver configurada como Um, no máximo uma entidade de correspondência será retornada. Se Política de Correspondência estiver configurada como Todos, todas as entidades correspondentes serão retornadas. Consulte o Saída do Nó EndpointLookup.

Se você solicitar uma única entidade correspondente configurando Política de Correspondência como Um, o valor do terminal recuperado será configurado como a substituição do ambiente local para a URL de destino usada pelos nós SOAPRequest, SOAPAsyncRequest ou HTTPRequest.

 
As propriedades Monitoramento do nó são descritas na tabela a seguir.
Propriedade M P Default Descrição
Eventos Não Não Nenhum Eventos definidos para o nó são exibidos nesta guia. Por padrão, nenhum evento de monitoramento é definido em um nó do fluxo de mensagens. Utilize Incluir, Editar, e Excluir para criar, alterar ou excluir eventos de monitoração no nó; consulte Configurando fontes de eventos de monitoramento utilizando propriedades de monitoramento para detalhes.

É possível ativar e desativar eventos mostrados aqui selecionando ou desmarcando a caixa de opções Ativado.

Avisos | Marcas Registradas | Downloads | Biblioteca | Suporte | Feedback

Copyright IBM Corporation 1999, 2014Copyright IBM Corporation 1999, 2014.

        
        Última atualização:
        
        Última atualização: 2015-02-28 18:28:44


Tópico de ReferênciaTópico de Referência | Versão 8.0.0.5 | ac55830_