A API JMS permite interações com acoplamento livre, confiáveis e assíncronas entre os componentes Java EE e os sistemas legados compatíveis com serviço de mensagens. É possível adicionar novo comportamento a uma aplicação Java EE que tem eventos empresariais adicionando um novo message-driven bean para operar em eventos específicos. Os componentes Java EE que utilizam a API JMS nos recipientes EJB ou da Web não devem ter mais de uma sessão JMS por conexão JMS. Para obter mais informações, consulte Sobre os message-driven beans.
A API JMS utiliza dois tipos de objetos de recursos administrados:
Fábricas de conexão (Recurso conector). Esses objetos são usados para criar uma conexão ao sistema de mensagens JMS e para encapsular os parâmetros da conexão.
Recursos de destino (Recurso de objeto de administração). Esses objetos são especificados como destinos e origens das mensagens. Ao criar um recurso de destino, cria-se dois objetos:
Um destino físico
Um recurso de destino que se refere ao destino físico usando o nome JNDI
As aplicações JMS geralmente usam ao menos uma fábrica de conexões e um destino. A ordem em que os recursos são criados não importa.
Para criar um recurso JMS:
Selecione Arquivo > Novo (Ctrl-N).
Na lista suspensa Projeto, selecione o módulo EJB ou da Web.
Selecione GlassFish no painel Categorias, Recurso JMS no painel Tipos de arquivos e clique em Próximo.
(obrigatório) Insira um nome JNDI para o recurso. Os objetos JMS administrados são geralmente colocados com o subcontexto de nomeação jms (por exemplo, jms/MinhaOrigemDeMensagem).
Ative ou desative o recurso selecionando verdadeiro ou falso.
Insira uma descrição.
Para criar um recurso de destino, selecione um destes tipos de recurso de objeto de administração:
javax.jms.Queue - usado para comunicação ponto-a-ponto
javax.jms.Queue - usado para comunicação "publish-subscribe" (publicação-inscrição)
Para criar uma fábrica de conexões, selecione um destes tipos de recurso conector:
javax.jms.QueueConnectionFactory - usado para comunicação ponto-a-ponto
javax.jms.TopicConnectionFactory - usado para comunicação "publish-subscribe" (publicação-inscrição)
javax.jms.ConnectionFactory - usado para comunicação ponto-a-ponto
Com a introdução da especificação JMS 1.1, recomendamos que você use javax.jms.ConnectionFactory
caso não precise suportar o código existente.
Clique em Próximo.
Insira as propriedades do recurso, se houver alguma.
Clique em Finalizar.
Quando você concluir o assistente, as propriedades são adicionadas a sun-resources.xml.
Se precisar editar as propriedades do recurso, você poderá abrir sun-resources.xml no Editor de código-fonte, expandindo o nó Recursos do servidor do projeto na janela Projetos e clicando duas vezes no arquivo.
Quando você tiver criado o objeto em seu projeto, o recurso precisará ser registrado no servidor antes de você usá-lo.
O recurso é registrado automaticamente quando você implanta seu projeto.
Recursos do conector
Quando recursos JMS são registrados,o IDE registra automaticamente os recursos conectores. O recurso conector é um objeto de programa que fornece ao aplicativo conexão a um EIS. Vários recursos conectores podem especificar um único agrupamento de conexões. Os aplicativos localizam um recurso conector usando seu nome JNDI.
Quando você cria os recursos JMS usando o assistente, o IDE realiza automaticamente as seguintes tarefas:
Para cada fábrica de conexões JMS registrada, o IDE registra um agrupamento de conexões e um recurso do conector.
Para cada destino JMS registrado, o IDE registra um recurso objeto de administração.
Os recursos conectores ficam visíveis no nó Conectores na janela Serviços.
Para obter mais informações sobre esses tipos de comunicação e outros aspectos do JMS, consulte o capítulo 32, O serviço de mensagens Java, no Tutorial Java EE: