Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/zapodot/embedded-jms-junit
Convenient library that allows an embedded JMS (ActiveMQ) JMS broker to be set up as a JUnit @Rule
https://github.com/zapodot/embedded-jms-junit
activemq jms junit junit-rule junit4
Last synced: about 2 months ago
JSON representation
Convenient library that allows an embedded JMS (ActiveMQ) JMS broker to be set up as a JUnit @Rule
- Host: GitHub
- URL: https://github.com/zapodot/embedded-jms-junit
- Owner: zapodot
- License: apache-2.0
- Created: 2017-08-28T11:38:23.000Z (over 7 years ago)
- Default Branch: master
- Last Pushed: 2024-07-27T11:19:10.000Z (5 months ago)
- Last Synced: 2024-07-27T12:34:40.309Z (5 months ago)
- Topics: activemq, jms, junit, junit-rule, junit4
- Language: Java
- Size: 164 KB
- Stars: 12
- Watchers: 2
- Forks: 1
- Open Issues: 33
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
embedded-jms-junit
=================
[](https://github.com/zapodot/embedded-jms-junit/actions?query=workflow%3A%22Java+CI%22)
[](https://maven-badges.herokuapp.com/maven-central/org.zapodot/embedded-jms-junit)
[](//github.com/zapodot/embedded-jms-junit/blob/master/LICENSE)
[](https://libraries.io/github/zapodot/embedded-db-junit)
[](https://coveralls.io/github/zapodot/embedded-jms-junit?branch=master)
[](https://depshield.github.io)
[JUnit](http://junit.org/) extension that provides a [ActiveMQ Embedded in-memory JMS Broker](http://activemq.apache.org/).
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](//github.com/zapodot/embedded-db-junit) 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](https://oss.sonatype.org/) 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](//github.com/zapodot/embedded-jms-junit/wiki/Using-with-JUnit-5-Jupiter)
### Add dependency
```xml
org.zapodot
embedded-jms-junit5
0.2
test
```
### Use ExtendWith to enable the extension and inject the connection factory using @EmbeddedJms
```java
@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
```xml
org.zapodot
embedded-jms-junit
0.2
test
```
### Add to JUnit4 test
```java
@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