Chapter 7. Remote JNDI Lookup

The Java Naming and Directory Interface (JNDI) is a Java API for a directory service that allows Java software clients to discover and look up objects using a name. To look up an object, you must first register that object to JNDI using the java:jboss/exported context.

The following is an example of how to register a JMS queue to JNDI in the messaging subsystem so that it can be looked up by remote JNDI clients.

java:jboss/exported/jms/queue/myTestQueue

Remote JNDI clients can then look up the object using the above name; however, it is not necessary to specify the java:jboss/exported/ prefix when looking up a remote client. The remote JNDI clients can look up the remote object up using the following name.

jms/queue/myTestQueue

<subsystem xmlns="urn:jboss:domain:messaging:1.4">
   <hornetq-server>
      ...
      <jms-destinations>
         <jms-queue name="myTestQueue">
            <entry name="java:jboss/exported/jms/queue/myTestQueue"/>
         </jms-queue>
      </jms-destinations>
   </hornetq-server>
</subsystem>