WIP: Driving the initial version from this README, please feel free to provide feedback through issues.
Coming in 2024: support only for the latest Spring Boot CURRENT version.
Build safer and more resilient distributed services. Get the benefits of an always async approach to data exchange. Ensure decoupling of components. Be better prepared for system evolution. Create more scalable solutions. Change the way you think and design, by using Query/Response for Spring AMQP.
Query/Response provides tools to allow developers to monitor, measure, explore and discover the capabilities of their runtime system. Metrics and interactive utilities, built-in. See ui for more information.
The Query/Response library can easily be added to any Spring Boot® project, as a single dependency.
<dependency>
<!-- From Jitpack-repo -->
<groupId>com.github.olle</groupId>
<artifactId>query-response-spring-amqp</artifactId>
<version>${SOME-TAG}</version>
</dependency>At the current time we recommend using Jitpack to resolve the dependency. Query/Response will however be published to the Sonatype OSS repository and Maven Central in the future.
To initialize the Query/Response library resources, and load the
QueryResponseConfiguration class, the
@EnableQueryResponse annotation can simply be added to any Spring Boot
application starter.
@SpringBootApplication
@EnableQueryResponse
public class App {
...
}The configuration will try to connect to an AMQP message broker, using the
common configurations for Spring AMQP. The default setup will try to connect
to a local broker with the username and password guest/guest.
Please see the provided examples/ for a simple setup with
RabbitMQ as a docker container, to get you started.
The fluid Query/Response API makes it easy for developers to understand and decide on a strategy for service integration. Timeouts are first-class citizens in the API and protect against surprises.
var authors = queryBuilder.queryFor("authors", String.class)
.waitingFor(800)
.orEmpty();To create responding services we provide a really effective and expressive fluid-API. Developers benefit from the declarative style, and won’t have to write any boilerplate code. It is easy to understand, work with and explore.
Very simple scenarios can quickly be created, for tests or proof of concept work.
responseBuilder.respondTo("authors", String.class)
.withAll()
.from("William Gibson", "Isaac Asimov", "J.R.R. Tolkien");Read more and learn how to use Query/Response, and how it works, in the online documentation.
Also make sure to check out the working examples to get started quickly with Query/Response.
Under the docs folder there are RFC documents, which provide a way for anyone to introduce ideas and trigger a discussion, as well as ADR documents that describe which important decisions were made, and why.
This project is very much an extension and amalgamation of the AMQP features provided in Spring Boot. Therefore, there needs to be a living relationship between the generational release versions of Spring Boot and this project.
We will build and tag an initial version 0.9.x as a preliminary working
version of Query/Response. This version is tracked in branches supporting the
active Spring Boot versions, as well as the main branch.
-
main→ Spring Boot 3.0.x -
spring-boot-2.7.x→ Spring Boot 2.7.x -
spring-boot-2.6.x→ Spring Boot 2.6.x -
spring-boot-2.5.x→ Spring Boot 2.5.x
From each branch there will be tagged releases, denoting the version of Spring
Boot that it is built against. For example 0.9.0-SB2_3_6 means it was built
with the Spring Boot 2.3.6.RELEASE dependency.
There will be no other minor version increment under the initial major version
0.x.x. The 0.9.x version will be used to iron out bugs and gather feedback
for an upcoming 1.0.0 version.
The following branches and versions are no longer actively supported or back-ported to. The intent is to never linger behind the list of active Spring Boot versions.
-
spring-boot-2.4.x→ Spring Boot 2.4.x -
spring-boot-2.3.x→ Spring Boot 2.3.x.RELEASE -
spring-boot-2.2.x→ Spring Boot 2.2.x.RELEASE -
spring-boot-2.1.x→ Spring Boot 2.1.x.RELEASE -
spring-boot-1.5.x→ Spring Boot 1.5.x.RELEASE
Happy coding!
Spring and Spring Boot are trademarks of Pivotal Software, Inc. in the U.S. and other countries.