Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/meliorartefacts/service-harness-jms-activemq
An easy to use, auto-configuring ActiveMQ client with connection pooling and automatic object mapping.
https://github.com/meliorartefacts/service-harness-jms-activemq
active-mq connection-pool spring-boot spring-client
Last synced: about 2 months ago
JSON representation
An easy to use, auto-configuring ActiveMQ client with connection pooling and automatic object mapping.
- Host: GitHub
- URL: https://github.com/meliorartefacts/service-harness-jms-activemq
- Owner: MeliorArtefacts
- Created: 2022-06-03T10:17:37.000Z (over 2 years ago)
- Default Branch: main
- Last Pushed: 2023-01-24T20:09:04.000Z (almost 2 years ago)
- Last Synced: 2023-12-04T19:59:17.877Z (about 1 year ago)
- Topics: active-mq, connection-pool, spring-boot, spring-client
- Language: Java
- Homepage:
- Size: 146 KB
- Stars: 2
- Watchers: 2
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# Melior Service Harness :: JMS : ActiveMQ
## Artefact
Get the artefact and the POM file in the *artefact* folder.
```
org.melior
melior-harness-jms-activemq
2.3
```
## Client
Create a bean to instantiate the ActiveMQ client. The ActiveMQ client uses connection pooling to improve performance.
```
@Bean("myclient")
@ConfigurationProperties("myclient")
public ActiveMQClient client() {
return ActiveMQClientBuilder.create().async().build();
}
```
The ActiveMQ client is auto-configured from the application properties.
```
myclient.url=tcp://some.service:61616
myclient.username=user
myclient.password=password
myclient.queue=myQueue
myclient.request-timeout=30
myclient.inactivity-timeout=300
```
Map the attributes in the JSON message to the fields in the JAVA class.
```
public class Message {
@JsonProperty("category")
private String category;
@JsonProperty("type")
private String type;
@JsonProperty("description")
private String description;
@JsonProperty("volume")
private double volume;
@JsonProperty("balance")
private double balance;
...
}
```
Wire in and use the ActiveMQ client. There is no need to convert the JAVA object to JSON before using the ActiveMQ client to send the message. The ActiveMQ client performs the object mapping automatically.
```
@Autowired
private ActiveMQClient client;
public void foo(Message message) throws RemotingException {
client.send(message)
}
```
The ActiveMQ client may be configured using these application properties.
|Name|Default|Description|
|:---|:---|:---|
|`url`||The URL of the ActiveMQ server|
|`username`||The user name required by the ActiveMQ server|
|`password`||The password required by the ActiveMQ server|
|`minimum-connections`|0|The minimum number of connections to open to the ActiveMQ server|
|`maximum-connections`|1000|The maximum number of connections to open to the ActiveMQ server|
|`connection-timeout`|30 s|The amount of time to allow for a new connection to open to the ActiveMQ server|
|`validate-on-borrow`|false|Indicates if a connection must be validated when it is borrowed from the JDBC connection pool|
|`validation-timeout`|5 s|The amount of time to allow for a connection to be validated|
|`request-timeout`|60 s|The amount of time to allow for a request to the ActiveMQ server to complete|
|`backoff-period`|1 s|The amount of time to back off when the circuit breaker trips|
|`backoff-multiplier`|1|The factor with which to increase the backoff period when the circuit breaker trips repeatedly|
|`backoff-limit`||The maximum amount of time to back off when the circuit breaker trips repeatedly|
|`inactivity-timeout`|300 s|The amount of time to allow before surplus connections to the ActiveMQ server are pruned|
|`maximum-lifetime`|unlimited|The maximum lifetime of a connection to the ActiveMQ server|
|`prune-interval`|60 s|The interval at which surplus connections to the ActiveMQ server are pruned|
## References
Refer to the [**Melior Service Harness :: Core**](https://github.com/MeliorArtefacts/service-harness-core) module for detail on the Melior logging system and available utilities.