RESTEasy MOM Configuration

RESTEasy MOM has only been used/tested with JBoss MQ on JBoss 4.2.2.  It should work with other JMS providers and on other application servers, but you may have to do some tweaking.  RESTEasy MOM is deployed as a WAR file.  To configure you will have to modify its web.xml file.

ConnectionFactory setup

By default, RESTEasy MOM will try to lookup and use a ConnectionFactory stored under the JNDI name "java:/ConnectionFactory".  You can configure it to look into another JNDI location by setting the context param:

resteasy.mom.connection.factory

Dead Letter Queue is requred!

When RESTEasy MOM cannot deliver a message it tries to send the message to a dead letter queue.  It looks for this in JNDI, by default, under "queue/DLQ".  You can configure this setting via

resteasy.mom.dlq.jndi

Default JBoss queue/topic destination Lookup

Every RESTEasy MOM URI path is prefaced with

/queues/{queue-name} 

or

/topics/{topic-name} 

By default, RESTEasy MOM will try and lookup destinations as follows:

Destination dest = (Destination)jndi.lookup("queue/" + {queue-name});

or

Destination dest = (Destination)jndi.lookup("topic/" + {topic-name});

If you are using JBoss MQ and you have not defined a specific JNDIName for your queue or topic, then this will just work, if not, read further.

Configured queue/topic JNDI locations

You can use the resteasy.mom.queues.jndi or resteasy.mom.topics.jndi web.xml context-params to specify a name/jndiName mapping of the form:

name ':' jndi-name

As many as these as you want separate by a ','.  For example:

<context-param>
   <param-name>resteasy.mom.queues.jndi</param-name>
   <param-value>
       queueA : java:comp/env/jms/MyQueue,
       queueB : jboss/queues/B
   </param-value>
</context-param>

Manual configuration

If you cannot obtain JMS ConnectionFactory or destinations from JNDI, then you must write your own RestasyMomBootstrap class.  Download the RESTEasy MOM src and checkout the implementation of this class.  Its pretty straightforward.