`@TestBean`

@TestBean 用於測試類中的非靜態欄位，透過工廠方法提供的例項覆蓋測試的 ApplicationContext 中的特定 bean。

相關的工廠方法名稱來源於帶註解欄位的名稱，或者在指定時來源於 bean 名稱。工廠方法必須是 static，不接受任何引數，並且返回型別必須與要覆蓋的 bean 的型別相容。為了使其更明確，或者如果你想使用不同的名稱，該註解允許提供特定的方法名稱。

預設情況下，帶註解欄位的型別用於搜尋要覆蓋的候選 bean。如果有多個候選 bean 匹配，可以提供 @Qualifier 來縮小要覆蓋的候選範圍。或者，bean 名稱與欄位名稱匹配的候選 bean 將匹配。

如果不存在相應的 bean，則將建立一個 bean。但是，如果你希望在相應的 bean 不存在時測試失敗，可以將 enforceOverride 屬性設定為 true，例如 @TestBean(enforceOverride = true)。

要使用按名稱覆蓋而不是按型別覆蓋，請指定註解的 name 屬性。

限定符（包括欄位名稱）用於確定是否需要建立單獨的 ApplicationContext。如果你使用此功能在多個測試中覆蓋相同的 bean，請確保一致地命名欄位，以避免建立不必要的上下文。

將 @TestBean 與 @ContextHierarchy 結合使用可能會導致不良結果，因為預設情況下每個 @TestBean 將應用於所有上下文層次級別。為確保特定的 @TestBean 應用於單個上下文層次級別，請將 contextName 屬性設定為與配置的 @ContextConfiguration 名稱匹配，例如 @TestBean(contextName = "app-config")。

有關更多詳細資訊和示例，請參閱使用 bean 覆蓋的上下文層次結構。

對 @TestBean 欄位或工廠方法的可見性沒有限制。

因此，這些欄位和方法可以是 public、protected、包私有（預設可見性）或 private，具體取決於專案的需求或編碼實踐。

以下示例展示瞭如何使用 @TestBean 註解的預設行為

Java

class OverrideBeanTests {
	@TestBean (1)
	CustomService customService;

	// test case body...

	static CustomService customService() { (2)
		return new MyFakeCustomService();
	}
}

1	標記一個欄位以覆蓋型別為 `CustomService` 的 bean。
2	此靜態方法的結果將用作例項並注入到欄位中。

在上面的示例中，我們正在覆蓋型別為 CustomService 的 bean。如果存在多個該型別的 bean，則會考慮名為 customService 的 bean。否則，測試將失敗，你將需要提供某種限定符來標識要覆蓋的 CustomService bean。

以下示例使用按名稱查詢，而不是按型別查詢

Java

class OverrideBeanTests {
	@TestBean(name = "service", methodName = "createCustomService") (1)
	CustomService customService;

	// test case body...

	static CustomService createCustomService() { (2)
		return new MyFakeCustomService();
	}
}

1	標記一個欄位以覆蓋名為 `service` 的 bean，並指定工廠方法名為 `createCustomService`。
2	此靜態方法的結果將用作例項並注入到欄位中。

要查詢要呼叫的工廠方法，Spring 會在宣告 @TestBean 欄位的類中、其超類之一或任何已實現的介面中進行搜尋。如果 @TestBean 欄位宣告在 @Nested 測試類中，也將搜尋封閉類層次結構。

或者，可以透過其完全限定方法名引用外部類中的工廠方法，遵循語法 <fully-qualified class name>#<method name>，例如 methodName = "org.example.TestUtils#createCustomService"。

當覆蓋非單例 bean 時，非單例 bean 將替換為與 @TestBean 工廠方法返回的值對應的單例 bean，並且相應的 bean 定義將轉換為 singleton。因此，如果 @TestBean 用於覆蓋 prototype 或作用域 bean，則被覆蓋的 bean 將被視為 singleton。

類似地，當覆蓋由 FactoryBean 建立的 bean 時，FactoryBean 將被替換為與 @TestBean 工廠方法返回的值對應的單例 bean。