Embedded Example

This examples shows how to setup and run HornetQ embedded.

HornetQ was designed to use POJOs (Plain Old Java Objects), what makes embedding HornetQ as simple as instantiating a few objects.

On this example, we only one jars (hornetq-core.jar, hornetq-jms.jar and jboss-javaee.jar).

HornetQ Embedded could be used from very simple use cases with only InVM support to very complex cases with clustering, persistence and fail over.

Example step-by-step

To run the example, simply type ant from this directory

In this we don't use any configuration files. (Everything is embedded). We simply instantiate ConfigurationImpl, HornetQServer, start it and operate on JMS regularly

1. Create the Configuration, and set the properties accordingly

         Configuration configuration = new ConfigurationImpl();
         configuration.setEnablePersistence(false);
         configuration.setSecurityEnabled(false);
         configuration.getAcceptorConfigurations().add(new TransportConfiguration(InVMAcceptorFactory.class.getName()));

2. Create and start the server

           HornetQServer server = HornetQ.newHornetQServer(configuration);
           server.start();

3. As we are not using a JNDI environment we instantiate the objects directly

           Queue queue = new HornetQQueue("exampleQueue");
           HornetQConnectionFactory cf = new HornetQConnectionFactory (new TransportConfiguration(InVMConnectorFactory.class.getName()));
        

4. Create a JMS Destination by using the Core API

           
         ClientSession coreSession = cf.getCoreFactory().createSession(false, false, false);
         coreSession.createQueue("jms.queue.exampleQueue", "jms.queue.exampleQueue", true);
         coreSession.close();
        

5. Create the JMS objects

           
            connection = cf.createConnection();
            Session session = connection.createSession(false, Session.AUTO_ACKNOWLEDGE);
            MessageProducer producer = session.createProducer(queue);
        

6. Create and send a TextMessage

            TextMessage message = session.createTextMessage("Hello sent at " + new Date());
            System.out.println("Sending the message.");
            producer.send(message);

7. Create the message consumer and start the connection

            MessageConsumer messageConsumer = session.createConsumer(queue);
            connection.start();

8. Receive the message

            TextMessage messageReceived = (TextMessage)messageConsumer.receive(1000);
            System.out.println("Received TextMessage:" + messageReceived.getText());

9. Be sure to close our resources!

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

10. Stop the server

           
           server.stop();