Skip to content

Convenient library that allows an embedded JMS (ActiveMQ) JMS broker to be set up as a JUnit @rule

License

Notifications You must be signed in to change notification settings

zapodot/embedded-jms-junit

Repository files navigation

embedded-jms-junit

Build Status Maven Central Apache V2 License Libraries.io for GitHub Coverage Status DepShield Badge

JUnit extension that provides a ActiveMQ Embedded in-memory JMS Broker. It should be compatible with all the usual JMS integration tools such as Apache Camel and Spring JMS Template. Inspired by the Embedded DB JUnit Rule project.

Why?

  • because you want to test your JMS integration code without being dependent on a running external JMS Broker
  • setting up the broker manually for all your tests requires a lot of boilerplate code
  • I found myself repeating myself and decided that creating this library would make my life easier :-)

Status

This library is distributed through the Sonatype OSS repo and should thus be widely available. Java 8 or higher is required. Feedback is more than welcome. Feel free to create issues if you find bugs or have feature requests for future releases :-)

Changelog

  • version 0.2: rewritten core and added support for JUnit 5 Jupiter
  • version 0.1: initial release

Usage

JUnit 5 (v. 0.2+)

More information on JMS support is found in the project WIKI

Add dependency

<dependency>
    <groupId>org.zapodot</groupId>
    <artifactId>embedded-jms-junit5</artifactId>
    <version>0.2</version>
    <scope>test</scope>
</dependency>

Use ExtendWith to enable the extension and inject the connection factory using @EmbeddedJms

@ExtendWith(EmbeddedJmsBroker.class)
class EmbeddedJmsBrokerRequestReplySpringTest {

    private static final String TEST_MESSAGE = "Test message";

    private static final String DESTINATION = "queue:destination";

    /**
    *  The type of property must be either ConnectionFactory, ActiveMQFactory or URI.
    *  If it is a URI to the broker is injected
    */
    @EmbeddedJms 
    private ConnectionFactory connectionFactory;

    @DisplayName("My test")
    @Test
    void testJmsLogic() throws Exception {
       // make JMS magic
    }
    
    @DisplayName("parameterized test")
    @Test
    void connectionFactoryParameter(@EmbeddedJms ConnectionFactory connectionFactory) {
        // perform JMS magic
    }

}

JUnit 4

Add dependency

<dependency>
    <groupId>org.zapodot</groupId>
    <artifactId>embedded-jms-junit</artifactId>
    <version>0.2</version>
    <scope>test</scope>
</dependency>

Add to JUnit4 test

    @Rule
    public EmbeddedJmsRule embeddedJmsRule = EmbeddedJmsRule.builder().build();

    @Test
    public void jmsTest() throws Exception {
        final ConnectionFactory connectionFactory = embeddedJmsRule.connectionFactory();
        
        // work your JMS magic

    }

For more examples check the JUnit tests in this project