CQRS最大的好處之一，尤其是事件溯源就事件和命令而言，單純地表達測試是可能的。這兩個功能組件，事件和命令對領(lǐng)域?qū)＜一驑I(yè)務(wù)所有者都有明確的含義。這不僅意味著測試表達就事件和命令而言有明確的功能含義，這也意味著他們不依靠任何實現(xiàn)選擇。

本章描述的特性需要axon-test模塊,可通過配置maven依賴(使用<artifactId>axon-test</artifactId> 和<scope>test</scope)或通過完整包下載。

本章中描述的固件可用于任何測試框架，如JUnit和TestNG。

命令組件測試

在任何CQRS基礎(chǔ)架構(gòu)中命令處理組件通常是最復(fù)雜的。比其他組件更復(fù)雜，這也意味著該組件有額外的與測試相關(guān)的需求。

雖然更復(fù)雜，但是命令的API處理組件相當容易。它有一個命令進來，然后事件出去。在某些情況下，可能有一個查詢作為命令執(zhí)行的一部分。除此之外，命令和事件是API的唯一部分。這意味著可以在事件和命令的基礎(chǔ)上完整地定義測試場景。典型地，以：
? given過去的某些事件，
? when 執(zhí)行這個命令，
? expect 這些事件將被發(fā)布和/或存儲

Axon Framework提供了一個測試固件，使你能夠做到這一點。AggregateTestFixture允許你配置某些基礎(chǔ)設(shè)施，包括必要的命令處理器和存儲庫，并以given-when-then形式的事件和命令來表達你的場景。

下面的示例展示了用JUnit 4對given-when-then測試固件的使用：

public class MyCommandComponentTest {
 private FixtureConfiguration fixture;
 @Before
 public void setUp() {
     fixture = new AggregateTestFixture(MyAggregate.class);
 }

 @Test
 public void testFirstFixture() {
     fixture.given(new MyEvent(1))
            .when(new TestCommand())
            .expectSuccessfulHandlerExecution()
            .expectEvents(new MyEvent(2));
     /*
     These four lines define the actual scenario and its expected
     result. The first line defines the events that happened in the
     past. These events define the state of the aggregate under test.
     In practical terms, these are the events that the event store
     returns when an aggregate is loaded. The second line defines the
     command that we wish to execute against our system. Finally, we
     have two more methods that define expected behavior. In the
     example, we use the recommended void return type. The last method
     defines that we expect a single event as result of the command
     execution.
     /*
 }
}

given-when-then測試固件定義了三個階段：配置、執(zhí)行和驗證。每個階段由不同的接口表示：分別是，F(xiàn)ixtureConfiguration, TestExecutor 和 ResultValidator。固件類的靜態(tài)newGivenWhenThenFixture()方法提供了對第一個的引用，進而可能提供驗證，等等。

注意
為了最好地利用這些階段之間的遷移，最好使用這些方法提供的流式接口，如上面的示例所示。

在配置階段（即在提供第一個“given”之前），你提供了執(zhí)行測試所需的構(gòu)件。作為固件的一部分提供事件總線、命令總線和事件存儲的專用版本。有accessor方法來獲得對它們的引用。任何命令處理器不直接在聚合上注冊，需要顯式地使用registerAnnotatedCommandHandler 方法配置。除了帶注解的命令處理器外，你還可以配置各種組件和設(shè)置，定義應(yīng)該如何設(shè)置測試周圍的基礎(chǔ)設(shè)施。

一旦固件配置好，你就可以定義“given”事件。測試固件將用DomainEventMessage包裝這些事件。如果“given”事件實現(xiàn)消息，消息的有效負載和元數(shù)據(jù)將被納入DomainEventMessage，否則given事件作為有效負載。DomainEventMessage 的序列號順序，從0開始。

或者，你也可以為“given”場景提供命令。在這種情況下，在執(zhí)行實際的測試命令時，這些命令生成的事件將被用于事件源聚合。使用“givenCommands(…)”方法提供命令對象。

執(zhí)行階段允許你提供一個針對命令處理組件執(zhí)行的命令。對調(diào)用處理程序的行為(無論是在聚合或外部處理程序)進行監(jiān)控，并與在驗證階段注冊的預(yù)期進行比較。

注意
在執(zhí)行測試過程中，Axon試圖檢測測試中的所有在聚合上的非法狀態(tài)的更改。它通過將聚合的狀態(tài)與命令執(zhí)行后的聚合狀態(tài)進行比較，如果它從所有“given”和存儲的事件溯源。如果狀態(tài)不相同，這意味著狀態(tài)變化發(fā)生在聚合事件處理器方法之外。比較時將忽略靜態(tài)和瞬態(tài)字段，因為它們通常包含對資源的引用。
可以使用setReportIllegalStateChange方法在固件的配置中切換檢測。

最后一個階段是驗證階段，允許你檢查命令處理組件的活動。這完全是根據(jù)返回值和事件來完成的。

測試固件允許你驗證命令處理程序的返回值。你可以顯式地定義預(yù)期的返回值，或者簡單地要求成功返回該方法。你也可以表達任何你期望的CommandHandler拋出的異常。

另一個組件是對已發(fā)布事件的驗證。有兩種匹配預(yù)期事件的方法。

第一是通過事件實例，它需要與實際的事件是行逐字的比較。將預(yù)期事件的所有屬性與實際事件中的對應(yīng)對象進行比較（使用equals()）。如果其中一個屬性不相等，則測試失敗，并生成一個廣泛的錯誤報告。

表達期望的另一種方式是使用的匹配器(Hamcrest庫提供的)。匹配器接口規(guī)定了兩個方法matches(Object)和describeTo(Description)。第一個返回一個布爾值，指示是否匹配或不匹配。第二個讓你表達你的期望。例如，一個“GreaterThanTwoMatcher”可以添加“任何值大于2的事件“的描述。描述允許創(chuàng)建關(guān)于測試用例失敗的錯誤消息。

創(chuàng)建事件列表的匹配器可能是繁瑣和容易出錯的工作。為了簡化問題，Axon提供了一組匹配器允許你提供一組特定于事件的匹配器，并告訴Axon應(yīng)該如何匹配列表。

下面是可用的事件列表匹配器和他們的目的的概述：

• List with all of: Matchers.listWithAllOf(event matchers...)
  如果所有的事件匹配器與真實事件列表中至少一個事件匹配，該匹配器將成功。不管是否有多個匹配器匹配相同的事件，或如果列表中一個事件不匹配任何匹配器。

• List with any of: Matchers.listWithAnyOf(event matchers...)
  如果一個或多個事件匹配器與實際的事件列表中一個或多個事件匹配，該匹配器將成功。一些匹配器甚至一個也不匹配，而另一個匹配多個。

• Sequence of Events: Matchers.sequenceOf(event matchers...)
  使用此匹配器來驗證實際事件匹配器和提供的事件匹配器有相同的順序。如果匹配器與后一個事件相匹配，與前一個匹配器匹配的事件相匹配，該匹配器將成功。這意味著可能出現(xiàn)不匹配事件的“gaps”。
  如果評估事件之后，更多的匹配器是可用的，他們都是匹配“null”。它是由事件的匹配器來決定是否接受。

• Exact sequence of Events: Matchers.exactSequenceOf(event matchers...)
  “事件的序列”匹配器的變化不允許不匹配事件的空隙。這意味著每個匹配器必須與事件后面的事件相匹配，與前一個匹配器匹配的事件相匹配。每個匹配器都應(yīng)該與它前一個匹配器相對應(yīng)的事件的后續(xù)一個事件相匹配

為了方便起見,提供了一些普遍需要的事件匹配器。他們與單個事件實例相匹配:

• Equal Event: Matchers.equalTo(instance...)
  驗證given對象在語義上等于given事件，這個匹配器將比較實際和預(yù)期的對象的所有字段的值使用一個null-safe相等方法。這意味著可以比較事件，即使它們不實現(xiàn)equals方法。存儲在given參數(shù)字段上的對象用equals進行比較，要求他們正確實現(xiàn)。

• No More Events: Matchers.andNoMore() or Matchers.nothing()
  僅與空值匹配，這個匹配器可以作為最后一個匹配器添加到事件的準確順序匹配器,以確保沒有不匹配的事件依然存在。

由于匹配器傳遞一個事件消息列表，有時你只是想驗證消息的有效負載。有匹配器來幫助你:

• Payload Matching: Matchers.messageWithPayload(payload matcher)
  驗證消息的有效負載匹配給定的有效載荷匹配器。

• Payloads Matching: Matchers.payloadsMatching(list matcher)
  驗證消息的有效負載匹配給定的有效載荷匹配器。給定的匹配器必須匹配列表包含的每個消息的有效負載。有效負載匹配匹配器通常用作外匹配器,以防止重復(fù)有效負載匹配器。

下面是一個簡單的代碼示例，以顯示這些匹配器的使用。在這個例子中,我們預(yù)期共有兩個事件發(fā)布。第一個事件必須是一個“ThirdEvent”，第二個是“aFourthEventWithSomeSpecialThings”。可能沒有第三個事件，因為那樣"andNoMore"匹配器會失敗。

fixture.given(new FirstEvent(), new SecondEvent())
       .when(new DoSomethingCommand("aggregateId"))
       .expectEventsMatching(exactSequenceOf(
           // we can match against the payload only:
           messageWithPayload(equalTo(new ThirdEvent())),
           // this will match against a Message
           aFourthEventWithSomeSpecialThings(),
           // this will ensure that there are no more events
           andNoMore()
       ));

// or if we prefer to match on payloads only:
       .expectEventsMatching(payloadsMatching(
               exactSequenceOf(
                   // we only have payloads, so we can equalTo directly
                   equalTo(new ThirdEvent()),
                   // now, this matcher matches against the payload too
                   aFourthEventWithSomeSpecialThings(),
                   // this still requires that there is no more events
                   andNoMore()
               )
       ));