Você pode migrar um serviço JMS para uma Importação do SCA com Ligação JMS.
Nota: Se a mensagem JMS estiver sendo enviada para um WebSphere Business Integration Adapter,
consulte a seção "Migrando Interações com o WebSphere Business Integration Adapter".
Para migrar um projeto de serviço JMS para uma migração de serviço de saída, siga estas etapas:
- Primeiro, você precisará importar o projeto de serviço utilizando o assistente de Migração. Isto resultará na criação de um módulo do Business Integration
com Mensagens, PortTypes, Ligações e Serviços do WSDL gerados
no WebSphere Studio
Application Developer Integration Edition.
- Na
perspectiva Business Integration, expanda o módulo para que seja possível ver
seu conteúdo. Abra o Editor de Montagem dando um clique duplo no primeiro item no projeto do módulo (ele terá o mesmo nome que o projeto).
- Em seguida, inclua uma Importação que permitirá que o aplicativo interaja com uma fila JMS de acordo com o modelo de programação SCA.
- No Editor de Montagem, expanda o projeto de módulo migrado, a categoria Interfaces e localize PortType do WSDL que descreve o serviço da Web que o aplicativo chamará. Arraste-o e solte-o sobre o Editor de Montagem.
- Um diálogo Criação de Componente permitirá que você selecione o tipo de componente que irá criar. Escolha Importar sem Ligação.
- Você verá que uma nova Importação foi criada no Editor de Montagem e se selecioná-la e for para a visualização Propriedades na guia Descrição, poderá alterar o nome da importação e o nome de exibição para algo mais significativo.
- Você pode consultar a ligação WSDL 5.1 e arquivos de serviço para obter detalhes
sobre o serviço JMS que está sendo migrado e utilizá-los para preencher os detalhes
da "Importação com Ligação JMS" 6.0. Localize a ligação JMS 5.1 e os arquivos
WSDL de serviço no projeto de serviço 5.1 (geralmente, eles são denominados *JMSBinding.wsdl
e *JMSService.wsdl). Examine as informações de ligação e de serviço capturadas lá.
A partir da ligação,
você pode determinar se as mensagens de texto ou de objeto foram utilizadas e se as ligações
de formato de dados customizadas foram utilizadas. Se houver alguma, também será necessário considerar a gravação de uma ligação de dados customizada para "Importação
com Ligação JMS" 6.0. A partir do serviço, é possível localizar o depósito de informações do provedor de contexto inicial, o nome da connection
factory JNDI, o nome do destino JNDI e o estilo do destino (fila).
- Clique com o botão direito do mouse na importação e selecione Gerar Ligação e, em seguida, Ligação do JMS. Você será solicitado a digitar os seguintes parâmetros:
- Selecionar domínio do sistema de mensagens JMS:
- Ponto-a-Ponto
- Publicação-Assinatura
- Independente do Domínio
- Selecione como os dados são serializados entre o Objeto de Negócios e a Mensagem JMS:
- Texto
- Objeto
- Fornecido pelo usuário
- Se Fornecido pelo Usuário for selecionado:
- Especifique o nome completo da classe de implementação com.ibm.websphere.sca.jms.data.JMSDataBinding. Será necessário especificar uma ligação de dados definida pelo usuário se seu aplicativo
precisar configurar quaisquer propriedades de cabeçalho JMS que, normalmente, não estão disponíveis
na Ligação de Importação JMS. Neste caso, é possível criar uma classe de ligação de dados customizada que estende a ligação de dados JMS padrão "com.ibm.websphere.sca.jms.data.JMSDataBinding"
e incluir código customizado para acessar JMSMessage diretamente. Consulte exemplos de JMS em "Criando e Modificando Ligações para Componentes de Importação e Exportação" no link abaixo.
- A conectividade de entrada está utilizando a classe do seletor de função JMS padrão:
- <selecionado> ou <seleção cancelada>
- Selecione a importação que acabou de criar. Na visualização Propriedades, vá para a guia Ligação. Você pode preencher manualmente todas as informações sobre ligação listadas lá para os mesmos valores que especificou antes no WebSphere Studio Application Developer
Integration Edition. A informações de ligação que você poderá especificar são:
- Ligação de Importação do JMS (a mais importante)
- Conexão
- Adaptador de Recursos
- Destinos de JMS
- Ligações de Método
Depois de concluir isso, você deverá religar o serviço:
- Se esse serviço for chamado por um processo de negócios no mesmo módulo, então, crie uma ligação da referência do processo de negócios adequada para essa Importação.
- Se esse serviço for chamado por um processo de negócios em outro módulo, crie uma Exportação com Ligação SCA e, a partir do outro módulo, arraste e solte essa exportação no Editor de Montagem desse módulo para criar a Importação com Ligação SCA correspondente. Ligue a referência do processo de negócios adequada àquela Importação.
- Salve o diagrama de montagem.