É possível usar o assistente Novo Arquivo de
Definições de Mensagens no WebSphere Message Broker Toolkit para criar
uma definição de mensagem a partir de um arquivo IDL.
Antes de começar:Conclua as seguintes tarefas:
- Conjuntos de Mensagens: Criando um Conjunto de Mensagens
- Importando Arquivos do Sistema de Arquivos para o WebSphere Message Broker Toolkit
- Assegure que você tenha um arquivo IDL válido. Se você selecionar um arquivo IDL
que não é válido, você verá uma mensagem de erro e não puder concluir o assistente. Quando
você importa um arquivo IDL, as operações suportadas e não suportadas são listadas. Você pode
importar um arquivo IDL que contenha operações com tipos que não são suportados pelo WebSphere Message Broker,
mas se você tentar chamar uma operação não suportada, você verá uma mensagem de erro. O arquivo IDL CORBA
deve conter pelo menos uma interface que possui uma operação. Para obter informações adicionais sobre as operações IDL suportadas,
consulte Suporte CORBA.
- Para obter
mais informações sobre como os tipos IDL correspondem aos tipos de esquema XML,
consulte Tipos de Dados IDL.
As etapas a seguir descrevem como
usar um arquivo IDL para criar um arquivo de definições de mensagens ou sobrescrever
o conteúdo de um arquivo existente.
- Clique com o botão direito do mouse no conjunto de mensagens, em seguida, clique em para abrir o assistente Novo Arquivo de Definições de Mensagens a Partir de.
- Conclua o assistente seguindo as instruções na tela.
- Selecione um arquivo IDL na lista de arquivos em
sua área de trabalho ou usando Navegar para procurar
fora de sua área de trabalho. Se você tiver importado um arquivo IDL que contenha inclusões, selecione o arquivo IDL de nível superior.
- Assegure que a caixa de opção para incluir o domínio DataObject
no conjunto de mensagens esteja selecionada. Por padrão, essa caixa de opções está selecionada.
- Opcional: É possível fornecer um espaço de nomes de destino.
- Por padrão, o nome do arquivo de definições de mensagens é igual
ao nome do arquivo IDL. É possível alterar o nome do arquivo de definições
de mensagens.
- Se o IDL ou o arquivo de definições de mensagens existirem, clique em Avançar.
Para renomear ou sobrescrever os arquivos existentes, selecione-os.
- Clique em Concluir.
- Após ter importado o arquivo IDL, verifique os erros.
- Verifique os erros no relatório criado quando o arquivo é
importado. Este relatório pode ser localizado no diretório log
do projeto que contém a nova definição de mensagem. O relatório
é denominado <idl-file-name>.idl.report.txt, em que <idl-file-name> é
o nome do arquivo IDL que está sendo importado.
- Verifique os erros na lista de tarefas do WebSphere Message Broker Toolkit.
Quando você tiver concluído a importação do
arquivo IDL, a definição de mensagem será aberta. Uma cópia somente leitura do arquivo IDL
é armazenada na pasta IDLs CORBA.
Para cada arquivo IDL, uma única definição de mensagem é criada. (Se tiver importado um arquivo IDL que contenha inclusões, todos os elementos e tipos nos arquivos IDL serão gerados em uma única definição de mensagem).
Na
definição de mensagem, duas mensagens são criadas para cada operação no arquivo IDL (uma mensagem para o pedido e uma para a resposta),
e uma mensagem é criada para cada exceção definida pelo usuário. O pedido possui um elemento filho para cada parâmetro in e inout; a
resposta possui um elemento filho para cada parâmetro inout e out e
um elemento filho denominado “_return” para o tipo de retorno da operação.
O nome destes elementos é baseado no nome da interface e no nome da
operação; por exemplo, para a operação sayHello na
Interface Hello, o elemento do pedido é chamado Hello.sayHello
e o elemento de resposta é chamado Hello.sayHelloResponse.
Se a interface estiver contida em um módulo, os nomes de elementos request e response
são qualificados com os nomes dos módulos. Por exemplo, se a operação sayHello na Interface Hello estiver contida em ModuleB que, por sua vez, estiver contida em ModuleA, o elemento response seria chamada de ModuleA.ModuleB.Hello.sayHelloResponse.
Outra definição de mensagem é criada com uma mensagem para cada exceção do sistema CORBA.
Próximo: Desenvolva um fluxo de mensagens,
conforme descrito em Desenvolvendo um Fluxo de Mensagens com um Nó CORBARequest.