Configurando a Amostra SOAP Nodes para Usar o Transporte JMS

Antes de iniciar:

Se você estiver executando a amostra no Linux, deverá concluir as seguintes etapas:

  1. Inclua a classe JMSAdmin no caminho de classe ao incluir o seguinte arquivo no seu caminho de classe:
    >mq_install_directory</java/lib/com.ibm.mqjms.jar
  2. Inclua o local do Java na variável PATH ao incluir o seguinte código no caminho de classe:
    >JAVA_HOME</bin

Criando os Objetos Administrados Usando JMSAdmin

As seguintes instruções são baseadas na suposição de que o WebSphere MQ esteja instalado no diretório mq_install_dir. A ferramenta JMSAdmin e o arquivo de configuração JMSAdmin estão nos seguintes locais:

No projeto do fluxo de amostras de nós SOAP, você deve usar o arquivo SOAPJMSSample.defs com a ferramenta JMSAdmin.

Antes de poder usar a ferramenta JMSAdmin, você deve modificar o arquivo JMSAdmin.config.

Modificando o arquivo JMSAdmin.config

Para modificar o arquivo JMSAdmin.config:

  1. No editor de texto, abra o arquivo JMSAdmin.config.
  2. Para comentar qualquer opção que não seja necessária, inclua um sinal numérico (#). Para remover o comentário de qualquer opção, remova o sinal de número (#).
    # A seguinte linha especifica que o fornecedor de serviços JNDI está em uso.
    #  Ela atualmente indica um Contexto do Sistema de Arquivos. Se um provedor de serviços diferente
    # for usado, esta linha deve ser comentada e o comentário deve ser removido da linha adequada.
    #
    #  com.sun.jndi.fscontext.RefFSContextFactory is the FileSystem JNDI Context
    #
    #INITIAL_CONTEXT_FACTORY=com.sun.jndi.ldap.LdapCtxFactory
    INITIAL_CONTEXT_FACTORY=com.sun.jndi.fscontext.RefFSContextFactory
    #INITIAL_CONTEXT_FACTORY=com.ibm.ejs.ns.jndi.CNInitialContextFactory
    #INITIAL_CONTEXT_FACTORY=com.ibm.websphere.naming.WsnInitialContextFactory
    #
    #  A linha a seguir especifica a URL do contexto inicial
    #  para o provedor de serviço. Ela atualmente refere-se a um Contexto do Sistema de Arquivos. 
    #  Exemplos de uma URL de contexto raiz LDAP e o espaço de nomes JNDI para o WebSphere
    #  também são mostrados, comentados.
    #
    	#PROVIDER_URL=ldap://localhost/o=ibm,c=us
    	PROVIDER_URL=file:/C:/SOAPJNDIBindings
    	#PROVIDER_URL=iiop://localhost/	
    
  3. Certifique-se de que PROVIDER_URL esteja configurado para /C:/SOAPJNDIBindings, ou um local equivalente no Linux e de que INITIAL_CONTEXT_FACTORY esteja configurado para com.sun.jndi.fscontext.RefFSContextFactory.
  4. Salve o arquivo.

Agora você pode criar os objetos.

Criando os Objetos

Executando a ferramenta WebSphere MQ JMSAdmin, você cria os objetos administrados por JNDI para configurar Connection Factories e Destinos de JMS que são usados na amostra.

Crie os objetos executando a ferramenta JMSAdmin e usando o arquivo SOAPJMSSample.defs como entrada.

Na linha de comandos, digite os seguintes comandos:

Em que o WebSphere MQ está instalado no seguinte local: mq_install_dir, e workspace_path é o caminho completo para o diretório da área de trabalho do WebSphere Message Broker Toolkit.

Os objetos e o arquivo .bindings são criados.

Configurando os Nós SOAP para Usar JMS

  1. Abra o fluxo de mensagens SOAPNodesSampleFlows.SOAPNodesSampleProviderFlow no editor de fluxo de mensagens.
  2. Clique com o botão direito do mouse no nó SOAPInput no fluxo de mensagens e clique em Propriedades para mostrar a visualização Propriedades.
  3. Na visualização Propriedades, selecione a guia Básicas.
  4. O valor do campo Ligação Importada é configurado como OrderServiceSOAP e o valor de Transporte é configurado como HTTP. Altere o valor de Ligação Importada para OrderServiceSOAPJMSBinding. O valor da propriedade Transporte é alterado para JMS.
  5. Abra o fluxo de mensagens SOAPNodesSampleFlows.SOAPNodesSampleConsumerFlow no Editor do Fluxo de Mensagens e configure o campo Ligação Importada para o nó SOAPRequest usando as etapas anteriores.

Configurando o Caminho JNDI no Fluxo de Mensagens

Configurando os nós SOAP com o local do arquivo .bindings:

  1. Abra o fluxo de mensagens SOAPNodesSampleFlows.SOAPNodesSampleProviderFlow no editor de fluxo de mensagens.
  2. Clique com o botão direito do mouse no nó SOAPInput no fluxo de mensagens e clique em Propriedades para mostrar a visualização Propriedades.
  3. Na visualização Propriedades, selecione a guia Transporte JMS .
  4. No campo Ligações da URL de JNDI de Local, insira o caminho que está especificado na linha PROVIDER_URL do arquivoJMSAdmin.config.
  5. Certifique-se de que o caminho inserido nas propriedades do nó corresponda ao caminho no arquivo JMSAdmin.config. Se os dois caminhos não corresponderem, os fluxos de mensagens não funcionarão.
  6. Salve o fluxo de mensagens.
  7. Abra o fluxo de mensagens SOAPNodesSampleFlows.SOAPNodesSampleConsumerFlow no editor de Fluxo de Mensagens e configure o nó SOAPRequest com o local do arquivo .bindings usando as etapas anteriores.
  8. Os fluxos de mensagens estão agora configurados e prontos para serem implementados no intermediário.

Recriando o Arquivo BAR e Implementando os Fluxos de Mensagens

Para implementar os fluxos modificados SOAPNodesSampleConsumer e SOAPNodesSampleProvider, reconstrua um arquivo broker archive (BAR) que contenha ambos os fluxos de mensagens.

Crie o arquivo BAR:

  1. Clique duas vezes no arquivo BAR SOAPNodesSampleFlows.SOAPNodesSampleBAR.bar.
  2. Na guia Gerenciar, clique em Construir para reconstruir o arquivo BAR.
  3. Salve o arquivo BAR criado.
  4. Clique no arquivo BAR e arraste-o para o grupo de execução padrão na visualização Brokers. Esta ação implementa os fluxos no intermediário.

Agora é possível executar a amostra. Consulte Executando a Amostra SOAP Nodes. É possível usar o Teste de Fluxo, porque o fluxo de cliente é conduzido por uma fila do WebSphere MQ.

Voltar para Home da Amostra