定義期望

斷言的使用方式與任何 AssertJ 斷言相同。該支援為 MvcTestResult 的各個部分提供了專用的斷言物件，如下例所示

Java
Kotlin

assertThat(mockMvc.get().uri("/hotels/{id}", 42))
		.hasStatusOk()
		.hasContentTypeCompatibleWith(MediaType.APPLICATION_JSON)
		.bodyJson().isLenientlyEqualTo("sample/hotel-42.json");

assertThat(mockMvc.get().uri("/hotels/{id}", 42))
	.hasStatusOk()
	.hasContentTypeCompatibleWith(MediaType.APPLICATION_JSON)
	.bodyJson().isLenientlyEqualTo("sample/hotel-42.json")

如果請求失敗，exchange 不會丟擲異常。相反，您可以斷言 exchange 的結果已失敗。

Java
Kotlin

assertThat(mockMvc.get().uri("/hotels/{id}", -1))
		.hasFailed()
		.hasStatus(HttpStatus.BAD_REQUEST)
		.failure().hasMessageContaining("Identifier should be positive");

assertThat(mockMvc.get().uri("/hotels/{id}", -1))
	.hasFailed()
	.hasStatus(HttpStatus.BAD_REQUEST)
	.failure().hasMessageContaining("Identifier should be positive")

請求也可能意外失敗，即 handler 丟擲的異常未經處理而直接丟擲。您仍然可以使用 .hasFailed() 和 .failure()，但由於 exchange 未完成，任何訪問結果一部分的嘗試都將丟擲異常。

JSON 支援

MvcTestResult 的 AssertJ 支援透過 bodyJson() 提供 JSON 支援。

如果 JSONPath 可用，您可以在 JSON 文件上應用表示式。返回值提供了便捷的方法，可返回各種受支援的 JSON 資料型別的專用斷言物件。

Java
Kotlin

assertThat(mockMvc.get().uri("/family")).bodyJson()
		.extractingPath("$.members[0]")
		.asMap()
		.contains(entry("name", "Homer"));

assertThat(mockMvc.get().uri("/family")).bodyJson()
	.extractingPath("$.members[0]")
	.asMap()
	.contains(entry("name", "Homer"))

只要訊息轉換器配置正確，您還可以將原始內容轉換為您的任何資料型別。

Java
Kotlin

assertThat(mockMvc.get().uri("/family")).bodyJson()
		.extractingPath("$.members[0]")
		.convertTo(Member.class)
		.satisfies(member -> assertThat(member.name).isEqualTo("Homer"));

assertThat(mockMvc.get().uri("/family")).bodyJson()
	.extractingPath("$.members[0]")
	.convertTo(Member::class.java)
	.satisfies(ThrowingConsumer { member: Member ->
		assertThat(member.name).isEqualTo("Homer")
	})

轉換為目標 Class 會提供一個通用斷言物件。對於更復雜的型別，您可能需要使用 AssertFactory 來返回專用斷言型別（如果可能）。

Java
Kotlin

assertThat(mockMvc.get().uri("/family")).bodyJson()
		.extractingPath("$.members")
		.convertTo(InstanceOfAssertFactories.list(Member.class))
		.hasSize(5)
		.element(0).satisfies(member -> assertThat(member.name).isEqualTo("Homer"));

assertThat(mockMvc.get().uri("/family")).bodyJson()
	.extractingPath("$.members")
	.convertTo(InstanceOfAssertFactories.list(Member::class.java))
	.hasSize(5)
	.element(0).satisfies(ThrowingConsumer { member: Member ->
		assertThat(member.name).isEqualTo("Homer")
	})

也支援 JSONAssert。響應體可以與 Resource 或內容匹配。如果內容以 `.json` 結尾，我們會在 classpath 中查詢同名檔案。

Java
Kotlin

assertThat(mockMvc.get().uri("/family")).bodyJson()
		.isStrictlyEqualTo("sample/simpsons.json");

assertThat(mockMvc.get().uri("/family")).bodyJson()
	.isStrictlyEqualTo("sample/simpsons.json")

如果您傾向於使用其他庫，可以提供一個 JsonComparator 的實現。