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.
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.
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". |
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.
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.
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.