Criando o Modelo de Mensagem
Este tópico descreve como criar o modelo de mensagem e inclui as seguintes seções:
- Criando as Definições de Mensagens
- Incluindo Elementos, Tipos e Grupos
Criando as Definições de Mensagens
Para criar as definições de mensagens, é necessário criar o seguinte:
- Um projeto de conjunto de mensagens e um conjunto de mensagens; consulte
Projetos de Conjuntos de Mensagens e
Visão Geral de Conjuntos de Mensagens na documentação
do WebSphere Message Broker.
- Três arquivos de definição de mensagem, um para cada espaço de nomes usado na amostra Video
Rental; consulte
Arquivos de Definição de Mensagens e
Espaços de Nomes no Modelo de Mensagens na
documentação do WebSphere Message Broker.
- Uma mensagem chamada Cliente.
Utilize as seguintes instruções para criar as definições de mensagens.
Vincula mais instruções detalhadas sobre algumas das seguintes etapas fornecidas no final da etapa.
- Crie um novo conjunto de mensagens chamado Conjuntos de Mensagens de Vídeo.
Para obter instruções, consulte
Criando um conjunto de mensagens na
documentação do WebSphere Message Broker.
- Selecione as opções para criar formatos físicos CWF, XML e TDS.
Utilize os nomes padrão (CWF1, XML1 e TDS1).
Quando usar o assistente para criar um novo projeto do conjunto de mensagens, o
assistente cria um novo conjunto de mensagens ao mesmo tempo.
- Crie os seguintes arquivos de definição de mensagens no projeto Conjuntos de Mensagens de Vídeo.
Para obter instruções, consulte
Criando um Arquivo de Definições de Mensagens
na documentação do WebSphere Message Broker.
- Crie um arquivo de definição de mensagem chamado Cliente, aceitando os valores padrão.
Quando você clica em Concluir, um arquivo chamado Customer.mxsd
é exibido na visualização de Desenvolvimento do Intermediário, sob
Vídeo > (padrão).
- Crie um arquivo de definição de mensagem chamado Address.
Clique em Utilizar espaço de nomes de destino.
Digite http://www.ibm.com.addressdetails no campo
Espaço de nomes e addr no campo
Prefixo.
Quando você clica em Concluir, um espaço de nomes chamado com.ibm.www.addressdetails
é exibido sob o conjunto de mensagens de Vídeo na visualização Desenvolvimento do Intermediário.
Um campo chamado Address.mxsd é exibido sob com.ibm.www.addressdetails.
- Crie um arquivo de definições de mensagens chamado Borrowed.
Selecione o botão de opções Usar espaço de nomes de destino.
Digite http://www.ibm.com.borroweddetails no campo
Espaço de nomes e brw no campo
Prefixo.
Quando você clicar em Concluir, um espaço de nomes chamado www.ibm.com.borroweddetails
é exibido sob o conjunto de mensagens Vídeo na visualização Desenvolvimento do Intermediário.
Um arquivo chamado Borrowed.mxsd é exibido sob "borroweddetails".
- Visualize as configurações do espaço de nomes para o conjunto de mensagens:
- Na visualização Desenvolvimento do Intermediário, dê um clique duplo em messageSet.mset para abri-lo.
- No editor de Conjunto de Mensagens, em Hierarquia de Propriedades, clique em XML1.
Expanda configurações de Espaço de Nomes.
Agora
você pode visualizar as configurações feitas nas etapas anteriores>
- Adicione uma nova mensagem, chamada Customer, ao arquivo de definição de mensagem Customer.
Para obter instruções, consulte Incluindo uma
Mensagem na documentação do WebSphere Message Broker.
Um tipo de complexo chamado ComplexType1 é criado automaticamente para mensagem.
Renomeie esse tipo complexo como CustomerType.
Observe que você não precisa incluir mensagens em outros arquivos de definição da
mensagem nesse momento.
Os elementos de Address e Borrowed são incluídos na mensagem do Cliente na seguinte seção.
Incluindo Elementos, Tipos e Grupos
Depois de criar as definições de mensagens, adicione elementos, tipos e grupos
a essas definições de mensagens.
Inicie incluindo elementos, tipos e grupos às
definições de mensagem Address e Borrowed.
Importe os espaços de nomes borroweddetails e addressdetails no espaço de nomes padrão.
Essa ação é necessária para que você possa incluir os elementos Address e Borrowed
na definição de mensagem do Cliente.
Há várias maneiras pelas quais é possível incluir tipos e elementos à sua mensagem e
ainda obter o mesmo resultado.
A sequência mostrada aqui é uma forma de criar uma mensagem, mas incluir
elementos e tipos na ordem a seguir pode ajudar a ver como a mensagem é estruturada.
Incluindo Elementos e Tipos aos Arquivos de Definição de Mensagem Address
Para incluir elementos e tipos no arquivo de definições de mensagens Address, crie um elemento
global chamado Address e, em seguida, um tipo complexo local. Então você
pode incluir mais elementos no arquivo de definições de mensagens Address,.
Para criar um elemento global chamado Address e um tipo complexo local:
- Na visualização Desenvolvimento do Intermediário, dê um clique duplo em Address.mxsd para abri-lo.
- Na visualização Tópicos, clique com o botão direito do mouse em Elementos e Atributos e clique em Incluir Elemento Global.
Um elemento chamado globalElement1, do tipo cadeia, é incluído.
Renomeie esse elemento como Address.
- No editor de Definição de Mensagens, realce a linha na qual Address é mostrado; consulte
Editor de Definição de Mensagens na
documentação do WebSphere Message Broker.
Na coluna Tipo, clique na célula que exibe o valor padrão
cadeia, para ver um menu de tipos disponíveis.
Selecione New
Complex Type.
A propriedade "Create a local complex type" é selecionada por padrão.
- Clique em OK.
Na visualização Tópicos, um tipo chamado {Local complexType} aparece sob Endereço.
Agora, você pode incluir mais elementos à definição de mensagem Address.
Crie os elementos
listados na tabela a seguir. Por exemplo, para incluir HouseNo:
- Clique com o botão direito do mouse em {Local complexType} e clique em Incluir Elemento Local.
Um elemento chamado localElement1 do tipo cadeia é incluído em {Local complexType}.
Renomeie este elemento como HouseNo.
- No editor de Definição de mensagens, destaque a linha na qual está mostrado HouseNo.
Na coluna Tipo, clique na célula que exibe o valor padrão
cadeia para ver um menu de tipos disponíveis. Selecione int.
Elemento |
Type |
HouseNo |
int |
Rua |
cadeia |
Cidade |
cadeia |
Incluindo Elementos e Tipos aos Arquivos de Definição de Mensagem Borrowed
Para incluir elementos e tipos no arquivo de definições de mensagens Borrowed,
crie um elemento global chamado Borrowed, crie um tipo complexo local, e inclua os
elementos relacionados na seguinte tabela.
Utilize as instruções da seção anterior.
Elemento |
Type |
VideoTitle |
cadeia |
DueDate |
dateTime |
Custo |
decimal |
Importando os Espaços de Nomes borroweddetails e addressdetails para o Espaço de Nomes Padrão
Antes de incluir os elementos Borrowed e Address (dos espaços de nomes borroweddetails e addressdetails)
na mensagem do Cliente, é necessário importar os espaços de nomes borroweddetails e addressdetails no espaço de nomes padrão:
- Na visualização Desenvolvimento do Intermediário, dê um clique duplo em Customer.mxsd para abri-lo.
- No editor de definição de mensagens, clique em Customer.mxsd,
clique na guia Propriedades.
- Em Hierarquia de Propriedades, clique com o botão direito do mouse em Importações e clique em Incluir Importação.
A janela Selecionar Arquivo de Definição de Mensagem para Importação será
aberta.
- Expanda a árvore até atingir Address.mxsd,
e clique em Concluir.
Repita as etapas acima para Borrowed.mxsd.
Os arquivos Address.mxsd e Borrowed.mxsd
são exibidos na Hierarquia de propriedades sob Importações.
Clique em Address.mxsd e em Borrowed.mxsd
para ver as configurações.
O campo Prefixo exibe o valor que você
especificou no campo Prefixo quando criou o arquivo de
definições de mensagens.
O campo Espaço de Nomes exibe o valor que você
especificou no campo Espaço de Nomes.
Incluindo Elementos, Tipos e Grupos ao Arquivo de Definição de Mensagem Customer
É necessário incluir elementos, tipos e grupos ao arquivo de definição de
mensagem Customer e, em seguida, incluir referências a elementos,
atributos e grupos para tipos e grupos.
Incluir Elementos, Tipos e Grupos
Para incluir elementos, tipos e grupos:
- Na visualização Desenvolvimento do Broker, dê um clique duplo no arquivo
Customer.mxsd para abri-lo e clique na guia
Visão Geral.
- Na visualização Tópicos, clique com o botão direito do mouse em
Tipos, e clique em Incluir Tipo
de Elemento.
Adicione um tipo complexo denominado NameType.
- Clique com o botão direito do mouse em Grupos e clique em Incluir Grupo.
Adicione um grupo denominado IdGroup.
- Clique com o botão direito do mouse em Elementos e Atributos e clique em Incluir Elemento Global.
Inclua
os elementos relacionados na seguinte tabela, e altere os tipos de acordo:
- No editor Message Definition, clique na guia Visão Geral.
- Destaque a linha na qual o elemento é mostrado.
- Na coluna Tipo, clique na célula que aparece no valor padrão,
cadeia para ver um menu de tipos disponíveis e selecione o tipo necessário.
Além dos tipos simples (como cadeia, número inteiro ou booleano), uma linha de
menu também contém tipos complexos que você incluiu na etapa 3. Consequentemente, você
agora pode alterar o tipo do elemento Nome para NameType.
Para incluir NameType, primeiro você pode precisar selecionar (Mais...) no menu suspenso.
Elemento |
Type |
Title |
cadeia |
FirstName |
cadeia |
ID |
cadeia |
PassportNo |
cadeia |
DrivingLicenseNo |
cadeia |
CreditCardNo |
cadeia |
Nome |
NameType |
Magazine |
Booleano |
- Clique com o botão direito do mouse em Elementos e Atributos e clique em Incluir Atributo Global.
Adicione o seguinte atributo global:
Atributo Global |
Type |
LastName |
cadeia |
Incluir Referências a Elementos, Atributos e Grupos
Para incluir referências a elementos ao IdGroup:
- Na visualização Tópicos, expanda Grupos.
- Clique com o botão direito do mouse em IdGroup e clique em Incluir Referência de Elemento.
Adicione
referências aos seguintes elementos:
- PassportNo
- DrivingLicenseNo
- CreditCardNo
Para incluir referências a elementos e atributos ao NameType:
- Na visualização Tópicos, expanda Tipos.
- Clique com o botão direito do mouse em NameType e clique em Incluir Referência de Elemento.
Adicione referências aos seguintes elementos, na seguinte ordem:
- Title
- FirstName
- Clique com o botão direito do mouse em NameType e clique em Incluir Referência de Atributo.
Adicione uma referência ao atributo global denominado LastName.
A posição de LastName sob NameType não é significativa porque ele é
um atributo e, como tal, não é tratado da mesma maneira que os elementos no
tempo de execução.
Para incluir elemento, atributo e referências de grupo em CustomerType, use as
seguintes instruções:
É importante incluir as referências na ordem em que elas
são apresentadas aqui.
- Na visualização Tópicos, expanda Tipos.
- Clique com o botão direito do mouse em CustomerType e clique em Incluir Referência de Elemento.
Adicione
referências aos seguintes elementos:
O elemento addr:Address é do espaço de nomes addressdetails.
Esse elemento está disponível a você para incluir em CustomerType porque
você já importou os espaços de nomes addressdetails e borroweddetails no espaço
de nomes padrão.
Essa referência de elemento é incluída exatamente da mesma maneira que qualquer outra referência de
elemento, mas pode-se ver que tem como prefixo o valor do URI do Espaço de Nome configurado ao criar o
arquivo de definições de mensagens Address.
- Clique com o botão direito do mouse em CustomerType e clique em Incluir Referência de Grupo.
Adicione uma referência ao seguinte grupo:
- Clique com o botão direito do mouse em CustomerType e clique em Incluir Referência de Elemento.
Inclua uma referência nos seguintes elementos:
- brw:Borrowed (Esse elemento é do espaço de nomes borroweddetails)
- Magazine
Quando tiver concluído as tarefas nessa página e tiver incluído todos os elementos, tipos e grupos
necessários nos arquivos de definições de mensagens, é possível
Configurar o Modelo de Mensagem.
Voltar para Home da Amostra