web server - Borland Technical Publications

Chapter
23
23Using JMS
Chapter
Important
Resource related objects such as JMS connection factories and JMS Queue/Topic
destinations are obtained in a portable J2EE mandated way through JNDI. A JMS
resource object is resolved by performing a JNDI lookup of a J2EE Resource
Reference defined in the deployment descriptors of an application component.
Resource Reference definitions involve both standard J2EE and Borland's proprietary
deployment descriptors. In the standard deployment descriptor, a Resource Reference
specifies a logical name relative to the application's JNDI environment naming context,
java:comp/env/. Borland's deployment descriptor complements the standard descriptor
by associating the Resource Reference logical name with the actual JNDI location of
the JMS resource definition. For example, in an EJB Jar component, the standard
J2EE deployment descriptor, ejb-jar.xml, specifies Resource References for an EJB
using a element for a JMS connection factory and
elements for JMS Topics and Queues. In BES, a JNDI lookup of a Resource Reference
involves retrieval of the JMS resource definition from which the desired JMS object is
created and returned to caller of lookup. The property values present in the JMS
resource definition determine the type and characteristics of resource object created.
Before a Resource Reference look up can be attempted, the required resource
definition must first be bound to its physical JNDI location. In BES, JMS resource
definitions are bound into a JNDI service provider during deployment of a Definitions
ARchive (DAR) module. By default, these objects are bound to the partitions Naming
Service, the JNDI CosNaming service provider in BES. This chapter describes how to
define JMS resource object definitions in a DAR module and delves into the details of
how to get a handle to a JMS resource object from a J2EE application. A discussion of
JMS activity and how it relates transactions is also provided.
For documentation updates, go to www.borland.com/techpubs/bes.
Chapter 23: Using JMS 209