Java EE MDB Message Selector Example

This example shows you how to send a message to an MDB that is configured to use a message selector

The example will send deploy a simple MDB and demonstrate sending a message and the MDB consuming only the message that matches the message selector.

The example leverages the JBoss Arquillian framework to run a WildFly instance and deploy the MDB.

Example step-by-step

download WildFly 8.0.0.Final from here and install.

set the JBOSS_HOME property to point to the WildFly install directory

type mvn verify from the example directory to run

1. First we need to get an initial context so we can look-up the JMS connection factory and destination objects from JNDI. This initial context will get it's properties from the jndi.properties file in the directory config

           final Properties env = new Properties();

           env.put(Context.INITIAL_CONTEXT_FACTORY, "org.jboss.naming.remote.client.InitialContextFactory");

           env.put(Context.PROVIDER_URL, "http-remoting://localhost:8080");

           initialContext = new InitialContext(env);
        

2. We look up the JMS queue object from JNDI

           Queue queue = (Queue)initialContext.lookup("jms/queues/testQueue");
        

3. We look up the JMS connection factory object from JNDI

           ConnectionFactory cf = (ConnectionFactory)initialContext.lookup("/jms/RemoteConnectionFactory");
        

4. We create a JMS connection

           connection = cf.createConnection("guest", "password");
        

5. We create a JMS session. The session is created as non transacted and will auto acknowledge messages.

           Session session = connection.createSession(false, Session.AUTO_ACKNOWLEDGE);
        

6. We create a JMS message producer on the session. This will be used to send the messages.

          MessageProducer messageProducer = session.createProducer(queue);
       

7. We create a JMS text messages that we are going to send.

            TextMessage blueMessage = session.createTextMessage("This is a text message");
        

8. Set the color property on the message to 'BLUE'.

            blueMessage.setStringProperty("color", "BLUE");
        

9. We send messages to the queue

           messageProducer.send(blueMessage);
        

10. We create a second JMS text message that we are going to send.

            TextMessage redMessage = session.createTextMessage("This is a text message");
        

11. Set the color property on the message to 'RED'.

            redMessage.setStringProperty("color", "RED");
        

12. We send messages to the queue

           messageProducer.send(redMessage);
        

13. The MDB receives the message
    We know the message is a TextMessage so we cast to it.

           TextMessage tm = (TextMessage)message;
        

14. We get the color property to check it

           String color = textMessage.getStringProperty("color");
        

15. The MDB gets the text and color and print it

            String text = tm.getText();
            System.out.println("message " + text + " received color=" + color);
            
        

16. And finally, always remember to close your JMS connections and resources after use, in a finally block. Closing a JMS connection will automatically close all of its sessions, consumers, producer and browser objects

           finally
           {
              if (initialContext != null)
              {
                initialContext.close();
              }
              if (connection != null)
              {
                 connection.close();
              }
           }