Skip to content

Update anchor id and add JUnit section #3249

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Open
ngocnhan-tran1996 wants to merge 1 commit into
base: main
Choose a base branch
from
+32 −3
Open

Update anchor id and add JUnit section #3249

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
1 commit
Select commit
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
31 changes: 30 additions & 1 deletion ...ra/modules/ROOT/pages/appendix/previous-whats-new/changes-in-1-7-since-1-6.adoc
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -51,7 +51,7 @@ The framework is no longer compatible with previous versions.
== JUnit `@Rules`

Rules that have previously been used internally by the framework have now been made available in a separate jar called `spring-rabbit-junit`.
See xref:testing.adoc#junit-rules[JUnit4 `@Rules`] for more information.
See <<junit4-rules>> for more information.

[[container-conditional-rollback]]
== Container Conditional Rollback
Expand All @@ -74,3 +74,32 @@ See xref:amqp/connections.adoc[Connection and Resource Management] for more info
You can now configure message re-queue on transaction rollback to be consistent, regardless of whether or not a transaction manager is configured.
See xref:amqp/transactions.adoc#transaction-rollback[A note on Rollback of Received Messages] for more information.

[[junit4-rules]]
== JUnit4 `@Rules`

Spring AMQP version 1.7 and later provide an additional jar called `spring-rabbit-junit`.
This jar contains a couple of utility `@Rule` instances for use when running JUnit4 tests.
See xref:testing.adoc#junit5-conditions[JUnit5 Conditions] for JUnit5 testing.

[[using-brokerrunning]]
=== Using `BrokerRunning`

`BrokerRunning` provides a mechanism to let tests succeed when a broker is not running (on `localhost`, by default).

It also has utility methods to initialize and empty queues and delete queues and exchanges.

The following example shows its usage:

[source, java]
----

@ClassRule
public static BrokerRunning brokerRunning = BrokerRunning.isRunningWithEmptyQueues("foo", "bar");

@AfterClass
public static void tearDown() {
brokerRunning.removeTestQueues("some.other.queue.too"); // removes foo, bar as well
}
----

There are several `isRunning...` static methods, such as `isBrokerAndManagementRunning()`, which verifies the broker has the management plugin enabled.
4 changes: 2 additions & 2 deletions ...ra/modules/ROOT/pages/appendix/previous-whats-new/changes-in-2-2-since-2-1.adoc
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -21,7 +21,7 @@ JUnit (4) is now an optional dependency and will no longer appear as a transitiv

The `spring-rabbit-junit` module is now a *compile* dependency in the `spring-rabbit-test` module for a better target application development experience when with only a single `spring-rabbit-test` we get the full stack of testing utilities for AMQP components.

[[-breaking-api-changes]]
[[breaking-api-changes]]
== "Breaking" API Changes

the JUnit (5) `RabbitAvailableCondition.getBrokerRunning()` now returns a `BrokerRunningSupport` instance instead of a `BrokerRunning`, which depends on JUnit 4.
Expand Down Expand Up @@ -87,7 +87,7 @@ See xref:logging.adoc[Logging Subsystem AMQP Appenders] for more information.
The `MessageListenerAdapter` provides now a new `buildListenerArguments(Object, Channel, Message)` method to build an array of arguments to be passed into target listener and an old one is deprecated.
See xref:amqp/receiving-messages/async-consumer.adoc#message-listener-adapter[`MessageListenerAdapter`] for more information.

[[exchange/queue-declaration-changes]]
[[exchange-queue-declaration-changes]]
== Exchange/Queue Declaration Changes

The `ExchangeBuilder` and `QueueBuilder` fluent APIs used to create `Exchange` and `Queue` objects for declaration by `RabbitAdmin` now support "well known" arguments.
Expand Down