WebSphere Message Broker, Versão 8.0.0.5 Sistemas operacionais: AIX, HP-Itanium, Linux, Solaris, Windows, z/OS

Consulte as informações sobre a versão mais recente do produto em IBM Integration Bus, Versão 9.0

CORBARequest

Use o nó CORBARequest para chamar um aplicativo CORBA externo sobre Internet Inter-Orb Protocol (IIOP).

Propósito

É possível usar o CORBARequest para conectar WebSphere® Message Broker aos aplicativos CORBA. CORBA é um padrão para distribuir objetos em redes para que as operações nesses objetos possam ser chamadas remotamente. Os objetos CORBA são descritos em arquivos Interface Definition Language (IDL). É possível criar um fluxo de mensagens que contém um nó CORBARequest, que chama um servidor CORBA. O fluxo de mensagens usa o arquivo IDL para configurar qual operação é chamada em qual interface. Usando um fluxo de mensagens que inclui um nó CORBARequest, é possível fornecer aos aplicativos CORBA existentes uma nova interface externa; por exemplo, uma interface SOAP. O arquivo IDL é armazenado em um projeto do conjunto de mensagens dentro de uma pasta chamada IDLs CORBA e é usado para configurar o nó CORBARequest no fluxo de mensagens.

Utilizando Este Nó em um Fluxo de Mensagens

Um uso possível de um nó CORBARequest é conectar um aplicativo de serviço da Web baseado em SOAP a um aplicativo IIOP CORBA existente usando um estilo síncrono do fluxo de mensagens. É possível conseguir essa conexão criando o seguinte fluxo de mensagens:

O diagrama mostra como é possível utilizar um nó CORBARequest para se conectar a um serviço da Web baseado em SOAP.
Neste exemplo, o nó SOAPInput recebe um pedido de serviço da Web, o nó de Mapeamento transforma os dados na mensagem SOAP em um pedido CORBA, e um pedido é feito ao servidor CORBA. O segundo nó Mapeamento transforma a mensagem de resposta de volta em uma resposta SOAP, que é propagada pelo nó SOAPReply.

O nó CORBARequest não está transacional. Após o nó ter feito um pedido, ele não pode retroceder o pedido. Os nós CORBA usam o domínio DataObject.

O nó CORBARequest está contido no repositório CORBA da paleta do nó do fluxo de mensagens e é representado no WebSphere Message Broker Toolkit pelo seguinte ícone:

Ícone do nó SOAPRequest

Examine a amostra a seguir para ver como utilizar esse nó: Você só pode visualizar informações sobre amostras quando usa o centro de informações que está integrado ao WebSphere Message Broker Toolkit ou o centro de informações on-line. Você só poderá executar amostras quando usar o centro de informações que está integrado ao WebSphere Message Broker Toolkit.

Configurando o Nó CORBARequest

Quando tiver colocado uma instância do nó CORBARequest em um fluxo de mensagens, você poderá configurá-lo; consulte Configurando um Nó do Fluxo de Mensagens. As propriedades do nó são exibidas na visualização Propriedades.

Todas as propriedades obrigatórias para as quais é necessário inserir um valor (propriedades que não possuem um valor-padrão definido) são marcadas com um asterisco.

Terminais e Propriedades

Os terminais do nó CORBARequest são descritos na tabela a seguir.
Terminal Descrição
In O terminal de entrada que aceita a mensagem para processamento pelo nó. Os dados são obtidos da árvore de mensagens e enviados ao servidor CORBA.
Out O terminal de saída a partir do qual parâmetros de retorno são propagados.
Falha O terminal de saída para o qual uma mensagem é roteada se uma falha é detectada.
Erro As mensagens de exceção CORBA que são recebidas em resposta ao pedido enviado são enviadas ao terminal Error. Se o terminal Error não estiver conectado e um erro for recebido, nenhum processamento adicional ocorrerá no fluxo de mensagens. O erro é registrado como um aviso no rastreio do usuário.

As tabelas a seguir descrevem as propriedades do nó. A coluna com cabeçalho M indica se a propriedade é obrigatória (marcada com um asterisco se você precisar inserir um valor quando nenhum padrão for definido; a coluna com cabeçalho C indica se a propriedade é configurável (é possível alterar o valor quando você incluir o fluxo de mensagens no arquivo BAR para implementá-lo).

As propriedades Descrição do nó CORBARequest são descritas na tabela a seguir.
Propriedade M A O padrão Descrição
Nome de nó Não Não O nome de nó O nome do nó.
Descrição curta Não Não Nenhum Uma breve descrição do nó.
Descrição Longa Não Não Nenhum Texto que descreve a finalidade do nó no fluxo de mensagens.
As propriedades Básicas do nó CORBARequest são descritas na tabela a seguir.
Propriedade M A O padrão Descrição Propriedade do Comando mqsiapplybaroverride
Serviço de Nomenclatura SIM SIM   O local do serviço de nomenclatura que contém o objeto que você está chamando. Para esta propriedade, é possível especificar o nome do host do serviço de nomenclatura ou um serviço configurável CORBA.
  • Especifique o nome do host do serviço de nomenclatura a partir do qual obter a referência do objeto no formato host:porta, em que porta é opcional. Por exemplo, localhost:2809. Se você não especificar um número da porta, o valor-padrão será 2809. É possível obter este valor a partir do administrador do aplicativo CORBA que você está chamando.
  • Especifique o nome de um serviço configurável de tipo CORBA. Se você especificar um nome de serviço configurável, é possível utilizar o serviço configurável para substituir as propriedades Serviço de nomenclatura e Nome de referência do objeto.

    Para obter informações adicionais sobre o uso de um serviço configurável para especificar um serviço de nomenclatura, consulte Definindo Onde o Nó CORBARequest Obtém a Referência do Objeto.

namingService
Nome de Referência do Objeto SIM SIM   O nome da referência para o objeto no serviço de nomenclatura. É possível obter este valor a partir do servidor CORBA que você está chamando.

Para obter informações adicionais sobre como especificar o nome de referência do objeto, consulte Serviço de Nomenclatura CORBA.

Também é possível utilizar um serviço configurável para especificar um nome de referência do objeto. Para obter informações adicionais, consulte Definindo Onde o Nó CORBARequest Obtém a Referência do Objeto.

referenceName
Arquivo IDL SIM Não   O arquivo IDL em um projeto do conjunto de mensagens que é usado para configurar o nó CORBARequest. Clique em Procurar para selecionar um arquivo IDL em um conjunto de mensagens referenciado. Se você arrastou um arquivo IDL importado no canvas ou no nó CORBARequest, a propriedade Arquivo IDL será configurada com o nome do arquivo IDL.

Quando especificar um arquivo IDL, a propriedade Nome da Interface será preenchida com uma lista de interfaces disponíveis.

 
Nome da Interface SIM Não   A interface do arquivo IDL que o nó chama. Digite um nome de interface válido ou clique em Selecionar interface e selecione uma interface na lista. Se a lista contiver um grande número de interfaces, é possível filtrar os resultados.

Os valores que são listados para esta propriedade são as interfaces no arquivo IDL selecionado que possuem uma ou mais operações. Esta lista é preenchida apenas quando um arquivo IDL é especificado. Se você tiver arrastado um arquivo IDL importado na tela ou no nó CORBARequest, a propriedade Nome da Interface será configurada de acordo com o arquivo IDL.

Se o nome da interface estiver contido em um módulo no arquivo IDL, o nome da interface será qualificado com o nome do módulo. Se o módulo estiver aninhado em outro módulo, o nome da interface é qualificado com todos os nomes de módulo, iniciando a partir do módulo root, como:

ModuleNameA.ModuleNameB.InterfaceName

Quando especificar um nome da interface, a propriedade Nome da Operação será preenchida com uma lista de operações disponíveis.

 
Nome da operação SIM Não   A operação a chamar a partir da interface.

Os valores listados para essa propriedade são as operações suportadas disponíveis na interface selecionada. Esta lista é preenchida apenas quando um nome da interface é especificado. Se você tiver arrastado um arquivo IDL importado na tela ou no nó CORBARequest, a propriedade Nome da Operação será configurada de acordo com o arquivo IDL.

É possível substituir essa propriedade no ambiente local especificando um valor no local a seguir:
$LocalEnvironment/Destination/CORBA/Request/OperationName
 
As propriedades Análise de Mensagem de Resposta do nó CORBARequest são descritas na tabela a seguir.
Propriedade M A O padrão Descrição
Domínio de mensagem Não Não DataObject O domínio que é utilizado para analisar a mensagem de resposta. Por padrão, a mensagem propagada do nó CORBARequest está no domínio DataObject. Você não pode especificar um domínio diferente.
Conjunto de Mensagens Não Não Configurar automaticamente O nome do conjunto de mensagens no qual a mensagem que chega é definida. O nó detecta o conjunto de mensagens automaticamente.
Tipo de mensagem Não Não   O nome da mensagem de resposta. O nó detecta o tipo de mensagem automaticamente. Você não pode configurar esta propriedade.
Formato de Mensagem Não Não   O nome do formato físico da mensagem de resposta. Você não pode configurar esta propriedade.
As propriedades Pedido do nó CORBARequest especificam como fazer um pedido e estão descritas na tabela a seguir.
Propriedade M A O padrão Descrição
Local dos dados SIM Não $Body O local na árvore de mensagens recebidas a partir das quais os dados são recuperados para e a partir do pedido que é enviado pelo nó CORBARequest.
As propriedades Resultado do nó CORBARequest especificam onde armazenar a resposta e estão descritas na tabela a seguir.
Propriedade M A O padrão Descrição
Local de dados de saída Não Não $OutputRoot O local da árvore de mensagens para o qual o nó CORBARequest envia saída.

Consulte o Combinando uma Mensagem de Resultado com uma Mensagem Recebida.

Copiar ambiente local Não Não Selecionados Essa propriedade controla como o ambiente local é copiado para a mensagem de saída. Se você selecionar esta caixa de opção, uma nova cópia do ambiente local será criada na árvore (em cada nó no fluxo de mensagens) e ela será preenchida com o conteúdo do ambiente local do nó precedente. Portanto, se um nó alterar o ambiente local, os nós anteriores no fluxo não verão essas alterações porque eles possuem suas próprias cópias. Esse comportamento pode ser um problema se você estiver utilizando um nó FlowOrder, ou se você utilizar o comando propagate em um nó Compute.

Se você desmarcar a caixa de opção, cada nó não gera sua própria cópia do ambiente local, mas utiliza o ambiente local que é transmitido a ele pelo nó anterior. Portanto, se um nó alterar o ambiente local, essas alterações serão vistas pelos nós de envio de dados.

As propriedades Monitoramento do nó são descritas na tabela a seguir.
Propriedade M P Default Descrição
Eventos Não Não Nenhum Eventos definidos para o nó são exibidos nesta guia. Por padrão, nenhum evento de monitoramento é definido em um nó do fluxo de mensagens. Utilize Incluir, Editar, e Excluir para criar, alterar ou excluir eventos de monitoração no nó; consulte Configurando fontes de eventos de monitoramento utilizando propriedades de monitoramento para detalhes.

É possível ativar e desativar eventos mostrados aqui selecionando ou desmarcando a caixa de opções Ativado.

Avisos | Marcas Registradas | Downloads | Biblioteca | Suporte | Feedback

Copyright IBM Corporation 1999, 2014Copyright IBM Corporation 1999, 2014.

        
        Última atualização:
        
        Última atualização: 2015-02-28 18:30:49


Tópico de ReferênciaTópico de Referência | Versão 8.0.0.5 | bc22370_