Estrutura em Árvore de Mensagens

A árvore de mensagens é uma parte de uma árvore de mensagem lógica na qual o intermediário armazena sua representação interna do corpo da mensagem.

A raiz de uma árvore de mensagens é chamada de Raiz. A árvore de mensagens está sempre presente e é transmitida de nó para nó em uma única instância de um fluxo de mensagens.

A árvore de mensagens inclui todos os cabeçalhos que estão presentes na mensagem, além do corpo da mensagem. A árvore também inclui a subárvore Propriedades (descrita em Analisadores), se for criada pelo analisador. Se um analisador fornecido tiver criado a árvore de mensagens, o elemento que representa a subárvore Propriedades será seguido por zero ou mais cabeçalhos.

Se a mensagem foi recebida pelo WebSphere MQ Enterprise Transport, WebSphere MQ Mobile Transport ou pelo WebSphere MQ Telemetry Transport, o primeiro cabeçalho (o segundo elemento) deverá ser o MQMD. Os cabeçalhos adicionais incluídos na mensagem aparecem na árvore na mesma ordem que na mensagem. O último elemento abaixo da raiz da árvore de mensagens é sempre o corpo da mensagem.

Se um analisador definido pelo usuário tiver criado a árvore de mensagens, a árvore Properties, se presente, será seguida pelo corpo da mensagem.

A estrutura da árvore de mensagens é mostrada abaixo. Se a mensagem de entrada não for uma mensagem WebSphere MQ, os cabeçalhos mostrados podem não estar presentes. Se o analisador que criou essa árvore for um analisador definido pelo usuário, a árvore Propriedades poderá não estar presente.

Estrutura de árvore de mensagens criada por um nó input e analisador para uma mensagem recebida em um transporte que utiliza WebSphere MQ.

A árvore Corpo é uma estrutura de elementos filhos (descritos abaixo) que representa o conteúdo da mensagem (dados) e reflete a estrutura lógica desse conteúdo. A árvore Corpo é criada por um analisador de corpo (um analisador fornecido ou um analisador definido pelo usuário), como descrito em Analisadores.

Cada elemento na árvore analisada representa um de três tipos:

Elemento de Nome
Um elemento de nome possui uma cadeia associada a ele, que é o nome do elemento. Um exemplo de um elemento de nome é XMLElement, conforme descrito em Elemento XML. Um elemento de nome também tem uma segunda cadeia associada a ele, que é o espaço de nomes do elemento; essa cadeia pode estar vazia.
Elemento de Valor
Um elemento de valor possui um valor associado a ele. Um exemplo de um elemento de valor é XMLContent, conforme descrito em Conteúdo XML.
Elemento Nome-Valor
Um elemento de nome/valor é uma otimização do caso em que um elemento nome contém apenas um elemento valor e nada mais. O elemento contém um nome e um valor. Um exemplo de um elemento nome-valor é XMLAttribute, conforme descrito em Atributo XML.

Para obter informações sobre como a árvore de mensagens é ocupada, consulte Como a Árvore de Mensagem É Ocupada.

Pasta Properties

A pasta Propriedades é o primeiro elemento da árvore de mensagens e mantém informações sobre as características da mensagem.

A raiz da pasta Propriedades é chamada Propriedades. É o primeiro elemento sob Raiz. Todas as árvores de mensagens que são geradas pelos analisadores incorporados incluem uma pasta Propriedades para a mensagem. Se você criar seu próprio analisador definido pelo usuário, poderá escolher se o analisador criará ou não uma pasta Propriedades. No entanto, para consistência, você deve incluir esta ação no analisador definido pelo usuário.

A pasta Propriedades contém um conjunto de propriedades padrão que você pode manipular nos nós do fluxo de mensagens da mesma forma que qualquer outra propriedade. Alguns desses campos mapeiam para campos em cabeçalhos WebSphere MQ suportados, se houver um, e são transmitidos para o analisador apropriado quando uma mensagem é fornecida de um ou nó para outro.

Por exemplo, o cabeçalho MQRFH2 contém informações sobre o conjunto de mensagens, o tipo de mensagem e o formato da mensagem. Esses valores são armazenados na pasta Propriedades como MessageSet, MessageType e MessageFormat. Para acessar esses valores utilizando ESQL ou Java dentro dos nós de processamento de mensagens, consulte esses valores na pasta Propriedades; não consulte diretamente os campos nos cabeçalhos dos quais elas são derivadas.

O analisador de Propriedades garante que os valores nos campos de cabeçalho correspondam aos valores na pasta Propriedades na entrada para, e na saída de, cada nó. Para qualquer campo, se somente um cabeçalho for alterado (o cabeçalho Propriedades ou um cabeçalho de mensagem específico), esse valor é utilizado. Se o cabeçalho Propriedades e o cabeçalho de mensagem específico forem alterados, o valor da pasta Propriedades é utilizado.

Quando o processamento do fluxo de mensagens estiver concluído, a pasta Propriedades será descartada.

Referências relacionadas
Nós Internos
Referência de ESQL
Avisos | Marcas Registradas | Downloads | Biblioteca | Suporte | Feedback

Copyright IBM Corporation 1999, 2009Copyright IBM Corporation 1999, 2009.
Última atualização : 2009-02-13 16:11:48

ac12610_