A árvore de mensagens é uma parte de uma árvore de mensagem lógica na qual o broker 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 é passada 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 tiver sido recebida por meio do WebSphere MQ Enterprise Transport ou WebSphere MQ Mobile Transport, o primeiro cabeçalho (o segundo elemento) deve 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 na seção a seguir. 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.
A árvore Body é uma estrutura de elementos filhos 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 da árvore analisada é de um dos três tipos:
Para obter informações sobre como a árvore de mensagens é ocupada, consulte Como a Árvore de Mensagem É Preenchida.
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 modelo de mensagem, nome da mensagem e formato físico da mensagem. Esses valores são armazenados na pasta Propriedades como MessageSet, MessageType e MessageFormat. Para acessar esses valores usando ESQL ou Java™ nos nós de processamento de mensagens, consulte esses valores na pasta Propriedades; não consulte diretamente nos campos nos cabeçalhos dos quais eles são derivados.
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.