Skip to content

Commit 133081b

Browse files
committed
Rename Implementations to Infrastructure
Command/Implementations can still be slightly vague. Adjust the title of this page to Infrastructure to state this is about the CommandBus you would use
1 parent 7525313 commit 133081b

File tree

6 files changed

+11
-10
lines changed

6 files changed

+11
-10
lines changed

Diff for: SUMMARY.md

+1-1
Original file line numberDiff line numberDiff line change
@@ -39,7 +39,7 @@
3939
* [Conflict Resolution](axon-framework/axon-framework-commands/modeling/conflict-resolution.md)
4040
* [Command Dispatchers](axon-framework/axon-framework-commands/command-dispatchers.md)
4141
* [Command Handlers](axon-framework/axon-framework-commands/command-handlers.md)
42-
* [Implementations](axon-framework/axon-framework-commands/implementations.md)
42+
* [Infrastructure](axon-framework/axon-framework-commands/infrastructure.md)
4343
* [Configuration](axon-framework/axon-framework-commands/configuration.md)
4444
* [Events](axon-framework/events/README.md)
4545
* [Event Dispatchers](axon-framework/events/event-dispatchers.md)

Diff for: axon-framework/axon-framework-commands/README.md

+1-1
Original file line numberDiff line numberDiff line change
@@ -8,7 +8,7 @@ A summary of the various sub-sections is given below.
88
| :--- | :--- |
99
| [Modeling](modeling/) | Axon Framework provided components to address Aggregate Modeling concerns |
1010
| [Command Dispatchers](command-dispatchers.md)/ [Command Handlers](command-handlers.md) | Functional Development concerns for Command Messages using the Axon Framework |
11-
| [Implementations](implementations.md) | Non-Functional Development concerns for Command Messages using the Axon Framework |
11+
| [Infrastructure](infrastructure.md) | Non-Functional Development concerns for Command Messages using the Axon Framework |
1212
| [Configuration](configuration.md) | Configuration concerns for Command Messages using the Axon Framework |
1313

1414
This guide is complemented by a video tutorial which gives a practical demonstration of the concepts explained in this section. The tutorial is available at -> [Axon Coding Tutorial - Command Messages](https://www.youtube.com/watch?v=7oy4w5THFEU&feature=youtu.be)

Diff for: axon-framework/axon-framework-commands/command-dispatchers.md

+1-1
Original file line numberDiff line numberDiff line change
@@ -5,7 +5,7 @@ The [Command Handlers](command-handlers.md) pages provide the background on how
55
1. The Command Bus, and
66
2. The Command Gateway
77

8-
This page will show how and when to use the command gateway and bus. How to configure and specifics on the the command gateway and bus implementations are discussed [here](implementations.md)
8+
This page will show how and when to use the command gateway and bus. How to configure and specifics on the command gateway and bus implementations are discussed in the [infrastructure](infrastructure.md) section.
99

1010
## The Command Bus
1111

Diff for: axon-framework/axon-framework-commands/implementations.md renamed to axon-framework/axon-framework-commands/infrastructure.md

+6-5
Original file line numberDiff line numberDiff line change
@@ -1,4 +1,4 @@
1-
# Implementations
1+
# Infrastructure
22

33
Command dispatching, as exemplified in the [Dispatching Commands](command-dispatchers.md) page, has a number of advantages. First of all, there is a single object that clearly describes the intent of the client. By logging the command, you store both the intent and related data for future reference. Command handling also makes it easy to expose your command processing components to remote clients, via web services for example. Testing also becomes a lot easier. You could define test scripts by just defining the starting situation \(given\), command to execute \(when\) and expected results \(then\) by listing a number of events and commands \(see [Testing](../testing/) for more on this\). The last major advantage is that it is very easy to switch between synchronous and asynchronous as well as local versus distributed command processing.
44

@@ -142,13 +142,14 @@ MyGateway myGateway = factory.createGateway(MyGateway.class);
142142

143143
## The Command Bus
144144

145-
The Command Bus is the mechanism that dispatches commands to their respective command handlers within an Axon application. Suggestions on how to use the `CommandBus` can be found [here](command-dispatchers.md#the-command-bus). Several flavors of the command bus, with differing characteristics, exist within the framework:
145+
The Command Bus is the mechanism that dispatches commands to their respective command handlers within an Axon application.
146+
Suggestions on how to use the `CommandBus` can be found [here](command-dispatchers.md#the-command-bus). Several flavors of the command bus, with differing characteristics, exist within the framework:
146147

147148
### AxonServerCommandBus
148149

149150
Axon provides a command bus out of the box, the `AxonServerCommandBus`. It connects to the [AxonIQ AxonServer Server](../../axon-server-introduction.md) to submit and receive Commands.
150151

151-
`AxonServerCommandBus` is a [distributed command bus](command-dispatchers.md#the-command-bus). It uses a [`SimpleCommandBus`](implementations.md) to handle incoming commands on different JVM's by default.
152+
`AxonServerCommandBus` is a [distributed command bus](command-dispatchers.md#the-command-bus). It uses a [`SimpleCommandBus`](infrastructure.md) to handle incoming commands on different JVM's by default.
152153

153154
{% tabs %}
154155
{% tab title="Axon Configuration API" %}
@@ -190,7 +191,7 @@ By simply declaring dependency to `axon-spring-boot-starter`, Axon will automati
190191

191192
> **Excluding the Axon Server Connector**
192193
>
193-
> If you exclude `axon-server-connector` dependency you will fallback to 'non-axon-server' command bus options, the `SimpleCommandBus` \(see [below](implementations.md)\).
194+
> If you exclude `axon-server-connector` dependency you will fallback to 'non-axon-server' command bus options, the `SimpleCommandBus` \(see [below](infrastructure.md)\).
194195
{% endtab %}
195196
{% endtabs %}
196197

@@ -419,7 +420,7 @@ Sometimes, you want multiple instances of command buses in different JVMs to act
419420

420421
That is where the concept of 'distributing the command bus' comes in. The default implementation of a distributed command bus is the `AxonServerCommandBus`. It connects to the [AxonIQ AxonServer Server ](../../axon-server-introduction.md)to submit and receive Commands. Unlike the other `CommandBus` implementations, the `AxonServerCommandBus` does not invoke any handlers at all. All it does is form a "bridge" between command bus implementations on different JVM's.
421422

422-
By default, [`SimpleCommandBus`](implementations.md) is configured to handle incoming commands on the different JVM's. You can configure `AxonServerCommandBus` to use other command bus implementations for this purposes: [`AsynchronousCommandBus`](implementations.md), [`DisruptorCommandBus`](implementations.md).
423+
By default, [`SimpleCommandBus`](infrastructure.md) is configured to handle incoming commands on the different JVM's. You can configure `AxonServerCommandBus` to use other command bus implementations for this purposes: [`AsynchronousCommandBus`](infrastructure.md), [`DisruptorCommandBus`](infrastructure.md).
423424

424425
### DistributedCommandBus
425426

Diff for: extensions/kotlin.md

+1-1
Original file line numberDiff line numberDiff line change
@@ -17,7 +17,7 @@ This section describes the additional functionality attached to Axon's [command
1717

1818
### CommandGateway
1919

20-
An inlined method has been introduced on the `CommandGateway` which allows the introduction of a dedicated function to be invoked upon success or failure of handling the command. As such it provides a short hand instead of using the [`CommandCallback`](../axon-framework/axon-framework-commands/implementations.md) directly yourself.
20+
An inlined method has been introduced on the `CommandGateway` which allows the introduction of a dedicated function to be invoked upon success or failure of handling the command. As such it provides a shorthand instead of using the [`CommandCallback`](../axon-framework/axon-framework-commands/infrastructure.md) directly yourself.
2121

2222
Here is a sample of how this can be utilized within your own project:
2323

Diff for: extensions/spring-cloud.md

+1-1
Original file line numberDiff line numberDiff line change
@@ -48,7 +48,7 @@ There are decorators present for the `CapabilityDiscoveryMode`, providing two ad
4848
The `Registration`, `DiscoveryClient` and `CapabilityDiscoveryMode` are arguably the heart of the `SpringCloudCommandRouter`.
4949
There are, however, a couple of additional things you can configure for this router, which are the following:
5050

51-
* `RoutingStrategy` - The component in charge of deciding which of the nodes receives the commands consistently. By default a `AnnotationRoutingStrategy` is used (see [Distributing the Command Bus](../axon-framework/axon-framework-commands/implementations.md#distributedcommandbus) for more).
51+
* `RoutingStrategy` - The component in charge of deciding which of the nodes receives the commands consistently. By default, a `AnnotationRoutingStrategy` is used (see [Distributing the Command Bus](../axon-framework/axon-framework-commands/infrastructure.md#distributedcommandbus) for more).
5252
* A `ServiceInstance` filter - This `Predicate` is used to filter out `ServiceInstance`s retrieved through the `DiscoveryClient`. For example, it allows the removal of instances which are known to not handle any command messages. This might be useful if you have several services within the Spring Cloud Discovery Service set up, which you do not ever want to take into account for command handling.
5353
* `ConsistentHashChangeListener` - Adding a consistent hash change listener provides you with the opportunity to perform a specific task if new nodes have been added to the known command handlers set.
5454

0 commit comments

Comments
 (0)