JMS, (Java Message Service), est la spécification de Sun pour la gestion des messages de la plate-forme Java EE

Le provider JMS inclus dans Geronimo est ActiveMQ. On définit les ressources JMS dans la console de Geronimo. Ces ressources sont ensuite référencées, notamment via JNDI, dans les applications (J2EE déployées sur Geronimo ou même standalone externe).

Voici le lien entre les différentes ressources / références

Ressources Geronimo

• JMS Resource Group (Resource Adapter?): epims_jms (1a)
  • ConnectionFactory epims_cf (1b)
  • Queue : MyTestQueue avec PhysicalName MyTestQueue (1c)
  • Queue : QueueDiffPN avec PhysicalName PhysNameQueue (1c)
  • Queue : QueueNoPhyName sans PhysicalName (1c)

Application EAR

• EAR
  • dépendance vers console.jms epims_jms (1a) (dans geronimo-application.xml)

• application Web (incluse dans le EAR)
  • définition d'un mapping dans geronimo-web.xml

   <nam:resource-ref>
      <nam:ref-name> jms/epims </nam:ref-name>            (2)
      <nam:resource-link> epims_cf </nam:resource-link>  (1b)
   </nam:resource-ref>

• utilisation de la référence jms/epims de type javax.jms.ConnectionFactory dans web.xml
• définition des messages utilisés dans web.xml

   <message-destination-ref>
      <message-destination-ref-name> MyRefQueue </message-destination-ref-name>    (3)
      <message-destination-type>javax.jms.Queue</message-destination-type>
      <message-destination-usage>Produces</message-destination-usage>
      <message-destination-link>QueueDiffPN</message-destination-link>             (1c)
   </message-destination-ref>

• dans le code (servlet envoyant un msg par exemple) accès via jndi(lookup) à java:comp/env/MyRefQueue (3)

• application standalone / Spring Core
  • accès au context via JNDI (SpringCore) java:comp/env/jms/epims (2)
  • accès à l'objet Queue via le nom physique : PhysNameQueue par exemple (1c)