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

Para criar as definições de mensagens, é necessário criar o seguinte:

  1. 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.
  2. 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.
  3. 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.

  1. 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.
    1. 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.
  2. 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.
    1. 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).
    2. 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.
    3. 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".
  3. Visualize as configurações do espaço de nomes para o conjunto de mensagens:
    1. Na visualização Desenvolvimento do Intermediário, dê um clique duplo em messageSet.mset para abri-lo.
    2. 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>
  4. 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:

  1. Na visualização Desenvolvimento do Intermediário, dê um clique duplo em Address.mxsd para abri-lo.
  2. 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.
  3. 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.
  4. 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:

  1. 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.
  2. 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:

  1. Na visualização Desenvolvimento do Intermediário, dê um clique duplo em Customer.mxsd para abri-lo.
  2. No editor de definição de mensagens, clique em Customer.mxsd, clique na guia Propriedades.
  3. 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.
  4. 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:

  1. Na visualização Desenvolvimento do Broker, dê um clique duplo no arquivo Customer.mxsd para abri-lo e clique na guia Visão Geral.
  2. 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.
  3. Clique com o botão direito do mouse em Grupos e clique em Incluir Grupo. Adicione um grupo denominado IdGroup.
  4. 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:
    1. No editor Message Definition, clique na guia Visão Geral.
    2. Destaque a linha na qual o elemento é mostrado.
    3. 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
  5. 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:

  1. Na visualização Tópicos, expanda Grupos.
  2. Clique com o botão direito do mouse em IdGroup e clique em Incluir Referência de Elemento. Adicione referências aos seguintes elementos:

Para incluir referências a elementos e atributos ao NameType:

  1. Na visualização Tópicos, expanda Tipos.
  2. 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:
    1. Title
    2. FirstName
  3. 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.

  1. Na visualização Tópicos, expanda Tipos.
  2. 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.
  3. 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:
  4. 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:

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