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

Saída do Nó RegistryLookup

Use o nó RegistryLookup para recuperar qualquer tipo de entidade mantida no WebSphere Service Registry and Repository (WSRR). As entidades que correspondem aos critérios de procura especificados são armazenadas no ambiente local. A mensagem de entrada não é modificada.

Este tópico contém as seguintes seções:

Configurando a Propriedade Política de Profundidade

A propriedade Política de Profundidade no nó RegistryLookup especifica quantos dados são retornados para cada entidade correspondida. A tabela a seguir mostra os valores válidos.
Valor da propriedade Política de Profundidade Valor de substituição do ambiente local Dados retornados
Retornar apenas correspondência (Profundidade = 0) MatchOnly Apenas as entidades correspondidas
Retornar correspondência mostrando relacionamentos imediatos (Apenas para compatibilidade) MatchShowRel As entidades correspondidas e referências adicionais
Retornar correspondência mais entidades relacionadas imediatas (Profundidade = 1) MatchPlusImmediate As entidades correspondidas e as entidades filhas relacionadas imediatas
Retornar correspondência mais todas as entidades relacionadas (Profundidade = -1) MatchPlusAll As entidades correspondidas e todas as entidades filhas relacionadas

Use MatchShowRel para compatibilidade com versões do WebSphere Message Broker anteriores à Versão 6.1.0.4. A saída do ambiente local para MatchShowRel é mostrada no Exemplo 1 e segue o formato que foi usado nessas versões anteriores. Entretanto, a opção MatchShowRel está reprovada e é fornecida apenas para compatibilidade com versões anteriores. Não use MatchShowRel se você estiver criando um novo fluxo de mensagens e considere migrar fluxos de mensagens existentes para usar uma das outras opções.

Use a opção MatchOnly para recuperar apenas as entidades individuais correspondidas pelos critérios de procura. Esta opção é eficiente, entretanto, a saída do ambiente local não contém nenhuma informação sobre entidades relacionadas às entidades correspondidas.

Use a opção MatchPlusImmediate para recuperar as entidades correspondidas pelos critérios de procura e as entidades filhas relacionadas. Esta opção oferece um ajuste útil, permitindo que você acesse as relações imediatas das entidades correspondidas, enquanto ainda restringe a quantidade total de dados recuperados.

Use uma das opções MatchOnly ou MatchPlusImmediate ao migrar um fluxo de mensagens que usa a opção MatchShowRel reprovada. Se seu fluxo de mensagens original usou as informações de relacionamento nas entidades correspondidas, use a opção MatchPlusImmediate. Consulte o Migrando um Fluxo de Mensagens que Usa a Opção MatchShowRel.

Use a opção MatchPlusAll para recuperar as entidades correspondidas pelos critérios de procura e todas as entidades filhas relacionadas. Use esta opção somente se seu fluxo de mensagens precisar de acesso a mais do que as relações imediatas das entidades correspondidas, porque ela recupera consideravelmente mais dados do que a opção MatchPlusImmediate, consulte Árvore de Saída do Ambiente Local.

Árvore de Saída do Ambiente Local

A árvore de saída do ambiente local possui um formato diferente quando a opção MatchShowRel reprovada da propriedade Política de Profundidade é usada. A tabela a seguir descreve as diferenças no formato de árvore de saída do ambiente local.

Opções MatchOnly, MatchPlusImmediate e MatchPlusAll Opção MatchShowRel
O elemento da pasta ServiceRegistry pertence ao compilador XMLNSC. Nenhum analisador proprietário no elemento de pasta ServiceRegistry e cada elemento Entity pertence ao analisador XMLNS
A árvore ServiceRegistry não usa espaços de nomes desnecessários. Os espaços de nomes são conectados a todos os elementos de pasta UserDefined, significando que o caminho especificado deve declarar e usar o espaço de nomes relevante para acessar campos nestas pastas.
A árvore ServiceRegistry é otimizada através do uso do analisador XMLNSC. A árvore de saída contém vários elemento XML de declaração, pcdata, e de espaço em branco que não têm importância para os negócios.
No WSRR, dados binários são representados como um GenericDocument com um atributo content. O atributo content é representado no ambiente local como tipo de XMLNSC Attribute+base64Binary, (0x03000160). É possível acessar os dados binários não-codificados diretamente como Entity.content. Entretanto, devido ao tipo de elemento XMLNSC especial, os dados são automaticamente codificados em base64 se a árvore for serializada. O conteúdo binário é representado como uma cadeia de caracteres codificada em base64 no atributo content. O fluxo de mensagens deve invocar um método Java™ para decodificar o valor se os dados binários originais forem necessários.
As entidades recuperadas não são modificadas para incluir quaisquer propriedades de usuário. As Entidades correspondidas aparecem no ambiente local com uma propriedade de usuário chamada WSRREncoding. Esta propriedade não tem importância específica para o processamento do fluxo de mensagens. Se houver uma propriedade de usuário chamada WSRREncoding definida para a entidade, o valor definido será usado, caso contrário, a propriedade WSRREncoding será incluída com value="DEFAULT".
As opções MatchPlusImmediate e MatchPlusAll resultam em um gráfico de entidades sendo retornado quando o WSRR executa a consulta. Cada entidade no gráfico pode referir-se a outras entidades. Existem dois tipos de relacionamento que não podem ser expressos diretamente em uma árvore hierárquica:
  • Referências cíclicas - um gráfico pode conter uma entidade a partir da qual você pode seguir relacionamentos que retornam na mesma entidade.
  • Múltiplas referências - um gráfico pode conter uma entidade que é referenciada por múltiplas entidades.
A representação destes relacionamentos na árvore de saída do ambiente local é descrita no texto a seguir.
O gráfico WSRR é representado na árvore de saída do ambiente local conforme a seguir:
  • As entidades correspondidas que são retornadas no gráfico do WSRR são representadas como elementos Entity como os primeiros filhos de LocalEnvironment.ServiceRegistry. As propriedades das entidades correspondidas são representadas como elementos filhos.
  • Uma entidade correspondida pode conter referências a outras entidades. Se MatchPlusImmediate estiver configurado, estas referências serão representadas como elementos filhos de Entity da entidade correspondida. Se MatchPlusAll estiver configurado, a mesma regra será aplicada recursivamente nestes filhos.
  • Referências cíclicas - se uma entidade referencia outra entidade que é uma de suas anteriores no gráfico do WSRR, a entidade referenciada é representada como um elemento EntityRef. Um elemento EntityRef não representa a entidade de destino diretamente, mas fornece informações para identificá-la. Isto evita a possibilidade de entrar em loops cíclicos ao navegar pela árvore.

    O diagrama a seguir mostra referências da entidade D1 no gráfico para entidades C1 e A que são anteriores; portanto, Entity D1 na árvore de mensagens contém elementos EntityRef para A e C1.

    Gráfico mostrando referências cíclicas, que são descritas no texto circundante.
  • Múltiplas referências - se uma entidade no gráfico de SDO do WSRR for referenciada por mais de uma outra entidade, ela será representada como um elemento Entity separado na árvore de mensagens cada vez que for referenciada. O elemento Entity é clonado, juntamente com quaisquer entidades às quais ele se refere.

    O diagrama a seguir mostra que a entidade X1 no gráfico é referenciada por entidades Y1 e Y2, portanto, Entity X1 e Entity W1 que ela referencia são modeladas duas vezes na árvore de mensagens.

    Gráfico mostrando múltiplas referências

Migrando um Fluxo de Mensagens que Usa a Opção MatchShowRel

Quando você migrar um fluxo de mensagens existente que usa a opção MatchShowRel reprovada da propriedade Política de Profundidade, a árvore de saída do ambiente local terá um formato diferente. A tabela mostrada anteriormente descreve as diferenças nos formatos de árvore de saída do ambiente local e indica o que você deve modificar no fluxo de mensagens para acessar os dados no formato atualizado; consulte Árvore de Saída do Ambiente Local.

Exemplos

Os exemplos a seguir mostram a saída típica do nó RegistryLookup:
  • O Exemplo 1 mostra a saída do nó RegistryLookup integral em dois casos para uma consulta que retorna duas versões de uma entidade de conceito. Em ambos os casos a propriedade Política de Correspondência é configurada como Todos. No primeiro caso, a propriedade Política de Profundidade é configurada como Retornar entidades correspondidas mais entidades relacionadas imediatas (Profundidade = 1) e, no segundo caso, a propriedade Política de Profundidade é configurada como Retornar somente correspondência, mostrando relacionamentos imediatos (Apenas para compatibilidade). Este exemplo também mostra ESQL de exemplo para ler elementos da saída. Consulte o Saída de Nó do RegistryLookup: Exemplo 1
  • O Exemplo 2 mostra a estrutura da saída do nó RegistryLookup para todos os valores possíveis da propriedade Política de Profundidade para uma consulta em uma entidade de conceito que possui vários relacionamentos de usuários com outras entidades de conceito. Consulte o Saída do Nó RegistryLookup: Exemplo 2
  • O Exemplo 3 mostra a estrutura da saída do nó RegistryLookup para uma consulta em uma entidade que possui relacionamentos de metadados e relacionamentos definidos pelo usuário, usando um valor da propriedade Política de Profundidade igual a Retornar correspondência mais todas as entidades relacionadas (Profundidade = -1) . Consulte o Saída do Nó RegistryLookup: Exemplo 3.
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:48


Tópico de ConceitoTópico de Conceito | Versão 8.0.0.5 | ac56330_