TestContext怎么使用

這篇文章主要介紹“TestContext怎么使用”，在日常操作中，相信很多人在TestContext怎么使用問題上存在疑惑，小編查閱了各式資料，整理出簡單好用的操作方法，希望對大家解答”TestContext怎么使用”的疑惑有所幫助！接下來，請跟著小編一起來學習吧！

Spring TestContext 框架（位于org.springframework.test.context包中）提供了通用的、注解驅動的單元和集成測試支持，這些支持與所使用的測試框架無關。TestContext框架還非常重視約定優于配置，你可以通過基于注解的配置覆蓋合理的默認值。

除了通用測試基礎結構之外，TestContext框架還為JUnit 4，JUnit Jupiter（AKA JUnit 5）和TestNG提供了顯式支持。對于JUnit 4和TestNG，Spring提供了抽象支持類。此外，Spring為JUnit 4提供了自定義JUnit Runner和自定義JUnit規則，以及JUnit Jupiter的自定義擴展，可讓你編寫所謂的POJO測試類。不需要POJO測試類來擴展特定的類層次結構，例如抽象支持類。下一節概述了TestContext框架的內部。如果你僅對使用框架感興趣，而對使用自己的自定義監聽器或自定義加載程序進行擴展不感興趣，請直接轉到配置（上下文管理 、依賴項注入、事務管理、支持類和注解支持部分。

3.5.1 關鍵抽象

該框架的核心由TestContextManager類和TestContext，TestExecutionListener和SmartContextLoader接口組成。為每個測試類創建一個TestContextManager（例如，用于在JUnit Jupiter中的單個測試類中執行所有測試方法）。反過來，TestContextManager管理包含當前測試上下文的TestContext。隨著測試的進行，TestContextManager還更新了TestContext的狀態，并委托給TestExecutionListener實現，該實現通過提供依賴項注入，管理事務等來檢測實際的測試執行。SmartContextLoader負責為給定的測試類加載ApplicationContext。有關更多信息和各種實現的示例，請參見javadoc和Spring測試套件。

TestContext

TestContext封裝了在其中執行測試的上下文（與使用中的實際測試框架無關），并為其負責的測試實例提供了上下文管理和緩存支持。如果需要，TestContext還委托給SmartContextLoader來加載ApplicationContext。

TestContextManager

TestContextManager是Spring TestContext 框架的主要入口點，并負責管理單個TestContext并在定義良好的測試執行點向每個注冊的TestExecutionListener發出事件信號：

• 在任何before類之前或在特定測試框架的所有方法之前。

• 測試實例后處理。

• 在任何before或在每個特定測試框架的方法之前。

• 在執行測試方法之前但在測試設置之后。

• 在測試方法執行之后，但在測試拆卸之前。

• 之后的任何方法或之后的每一個特定的測試框架。

• 在特定測試框架的任何類后或所有方法之后。

TestExecutionListener

TestExecutionListener定義用于對由注冊監聽器的TestContextManager發布的測試執行事件做出反應的API。請參閱TestExecutionListener配置。

上下文加載器

ContextLoader是一個策略接口，用于為Spring TestContext 框架管理的集成測試加載ApplicationContext。你應該實現SmartContextLoader而不是此接口，以提供對組件類，激活的bean定義配置文件、測試屬性源、上下文層次結構和WebApplicationContext支持的支持。

SmartContextLoader是ContextLoader接口的擴展，它取代了原始的最小ContextLoader SPI。具體來說，SmartContextLoader可以選擇處理資源位置、組件類或上下文初始化器。此外，SmartContextLoader可以在其加載的上下文中設置激活Bean定義配置文件并測試屬性源。

Spring提供了以下實現：

• DelegatingSmartContextLoader: 它是兩個默認加載器之一，它在內部委派給AnnotationConfigContextLoader、GenericXmlContextLoader或GenericGroovyXmlContextLoader，具體取決于為測試類聲明的配置或默認位置或默認配置類的存在。僅當Groovy在類路徑上時才啟用Groovy支持。

• WebDelegatingSmartContextLoader: 它是兩個默認加載器之一，它在內部委派給AnnotationConfigWebContextLoader、GenericXmlWebContextLoader或GenericGroovyXmlWebContextLoader，具體取決于為測試類聲明的配置或默認位置或默認配置類的存在。僅當測試類上存在@WebAppConfiguration時，才使用Web ContextLoader。僅當Groovy在類路徑上時才啟用Groovy支持。

• AnnotationConfigContextLoader:從組件類加載標準ApplicationContext。

• AnnotationConfigWebContextLoader: 從組件類加載WebApplicationContext。

• GenericGroovyXmlContextLoader: 從Groovy腳本或XML配置文件的資源位置加載標準ApplicationContext。

• GenericGroovyXmlWebContextLoader: 從Groovy腳本或XML配置文件的資源位置加載WebApplicationContext。

• GenericXmlContextLoader: 從XML資源位置加載標準ApplicationContext。

• GenericXmlWebContextLoader: 從XML資源位置加載WebApplicationContext。

• GenericPropertiesContextLoader：從Java屬性文件加載標準ApplicationContext。

3.5.2 引導TestContext框架

Spring TestContext 框架內部的默認配置足以滿足所有常見用例。但是，有時開發團隊或第三方框架希望更改默認的ContextLoader，實現自定義的TestContext或ContextCache，擴展默認的ContextCustomizerFactory和TestExecutionListener實現等等。為了對TestContext框架的運行方式進行低級別控制，Spring提供了引導策略。

TestContextBootstrapper定義了用于引導TestContext框架的SPI。TestContextManager使用TestContextBootstrapper加載當前測試的TestExecutionListener實現并構建它管理的TestContext。你可以直接使用@BootstrapWith或作為元注解，為測試類（或測試類層次結構）配置自定義引導策略。如果沒有通過使用@BootstrapWith顯式配置引導程序，則根據@WebAppConfiguration的存在，使用DefaultTestContextBootstrapper或WebTestContextBootstrapper。

由于TestContextBootstrapper SPI將來可能會更改（以適應新的需求），我們強烈建議實現者不要直接實現此接口，而應擴展AbstractTestContextBootstrapper或其具體子類之一。

3.5.3 TestExecutionListener配置

Spring提供了以下TestExecutionListener實現，這些實現默認情況下按以下順序注冊：

• ServletTestExecutionListener:為WebApplicationContext配置Servlet API模擬。

• DirtiesContextBeforeModesTestExecutionListener:處理before模式的@DirtiesContext注解。

• DependencyInjectionTestExecutionListener: 為測試實例提供依賴項注入。

• DirtiesContextTestExecutionListener: 處理after模式的@DirtiesContext注解。

• TransactionalTestExecutionListener: 提供具有默認回滾語義的事務測試執行。

• SqlScriptsTestExecutionListener: 運行使用@Sql注釋配置的SQL腳本。

• EventPublishingTestExecutionListener: 將測試執行事件發布到測試的ApplicationContext中（請參閱測試執行事件）。

注冊TestExecutionListener實現

你可以使用@TestExecutionListeners注解為測試類及其子類注解TestExecutionListener實現。有關詳細信息和示例，請參見注解支持和@TestExecutionListeners的javadoc。

默認TestExecutionListener實現自動發現

通過使用@TestExecutionListeners注冊TestExecutionListener實現適用于有限測試方案中使用的自定義監聽器。但是，如果需要在整個測試套件中使用自定義監聽器，則會變得很麻煩。通過SpringFactoriesLoader機制支持自動發現默認的TestExecutionListener實現，可以解決這個問題。

具體來說，spring-test模塊在其META-INF/spring.factories屬性文件中的key為org.springframework.test.context.TestExecutionListener下聲明所有核心默認TestExecutionListener實現。第三方框架和開發人員可以通過自己的META-INF/spring.factories屬性文件以相同的方式將自己的TestExecutionListener實現貢獻到默認監聽器列表中。

TestExecutionListener順序實現

當TestContext框架通過上述SpringFactoriesLoader機制發現默認TestExecutionListener實現時，實例化的監聽器將使用Spring的AnnotationAwareOrderComparator進行排序，該類將使用Spring的Ordered接口和@Order注解進行排序。Spring提供的AbstractTestExecutionListener和所有默認的TestExecutionListener實現以適當的值實現Ordered。因此，第三方框架和開發人員應通過實施Ordered或聲明@Order來確保按默認順序注冊其默認的TestExecutionListener實現。請參閱javadoc以獲取核心默認TestExecutionListener實現的getOrder()方法，以獲取有關為每個核心監聽器分配哪些值的詳細信息。

TestExecutionListener合并實現

如果通過@TestExecutionListeners注冊了自定義TestExecutionListener，則不會注冊默認監聽器。在大多數常見的測試方案中，這有效地迫使開發人員手動聲明除任何自定義監聽器之外的所有默認監聽器。

下面的清單演示了這種配置樣式：

@ContextConfiguration
@TestExecutionListeners({
    MyCustomTestExecutionListener.class,
    ServletTestExecutionListener.class,
    DirtiesContextBeforeModesTestExecutionListener.class,
    DependencyInjectionTestExecutionListener.class,
    DirtiesContextTestExecutionListener.class,
    TransactionalTestExecutionListener.class,
    SqlScriptsTestExecutionListener.class
})
class MyTest {
    // class body...
}

這種方法的挑戰在于，它要求開發人員確切地知道默認情況下注冊了哪些監聽器。此外，默認的監聽器集可以隨版本的不同而變化-例如，在Spring框架4.1中引入了SqlScriptsTestExecutionListener，在Spring框架4.2中引入了DirtiesContextBeforeModesTestExecutionListener。此外，諸如Spring Boot和Spring Security之類的第三方框架通過使用上述自動發現機制注冊了自己的默認TestExecutionListener實現。

為避免必須了解并重新聲明所有默認監聽器，可以將@TestExecutionListeners的mergeMode屬性設置為MergeMode.MERGE_WITH_DEFAULTS。MERGE_WITH_DEFAULTS表示應將本地聲明的監聽器與默認監聽器合并。合并算法可確保從列表中刪除重復項，并確保根據AnnotationAwareOrderComparator的語義對合并后的監聽器集進行排序，如Ordering TestExecutionListener實現中所述。如果監聽器實現Ordered或使用@Order進行注解，則它可以影響將其與默認值合并的位置。否則，合并時，本地聲明的監聽器將追加到默認偵聽器列表中。

例如，如果上一個示例中的MyCustomTestExecutionListener類將順序值（例如500）配置為小于ServletTestExecutionListener的順序（恰好是1000），則MyCustomTestExecutionListener可以自動與默認列表合并。在ServletTestExecutionListener前面，并且前面的示例可以替換為以下示例：

@ContextConfiguration
@TestExecutionListeners(
    listeners = MyCustomTestExecutionListener.class,
    mergeMode = MERGE_WITH_DEFAULTS
)
class MyTest {
    // class body...
}

3.5.4 測試執行事件

Spring框架5.2中引入的EventPublishingTestExecutionListener提供了一種實現自定義TestExecutionListener的替代方法。測試的ApplicationContext中的組件可以監聽EventPublishingTestExecutionListener發布的以下事件，每個事件都與TestExecutionListener API中的方法相對應。

• BeforeTestClassEvent

• PrepareTestInstanceEvent

• BeforeTestMethodEvent

• BeforeTestExecutionEvent

• AfterTestExecutionEvent

• AfterTestMethodEvent

• AfterTestClassEvent

只有當ApplicationContext已經加載時，才會發布這些事件。

這些事件可能由于各種原因被使用，例如重置模擬bean或跟蹤測試執行。使用測試執行事件而不是實現自定義TestExecutionListener的一個優勢是，測試執行事件可以由在測試ApplicationContext中注冊的任何Spring bean所使用，并且此類bean可以直接受益于依賴項注入和ApplicationContext的其他功能。相反，TestExecutionListener在ApplicationContext中不是bean。

為了監聽測試執行事件，Spring Bean可以選擇實現org.springframework.context.ApplicationListener接口。或者，可以使用@EventListener注解監聽器方法，并將監聽方法配置為監聽上面列出的特定事件類型之一（請參閱基于注解的事件監聽器）。由于這種方法的流行，Spring提供了以下專用的@EventListener注解，以簡化測試執行事件監聽器的注冊。這些注解駐留在org.springframework.test.context.event.annotation包中。

• @BeforeTestClass

• @PrepareTestInstance

• @BeforeTestMethod

• @BeforeTestExecution

• @AfterTestExecution

• @AfterTestMethod

• @AfterTestClass

異常處理

默認情況下，如果測試執行事件監聽器在使用事件時拋出異常，則該異常將傳播到使用中的基礎測試框架（例如JUnit或TestNG）。例如，如果使用BeforeTestMethodEvent導致異常，則相應的測試方法將因異常而失敗。相反，如果異步測試執行事件監聽器引發異常，則該異常不會傳播到基礎測試框架。有關異步異常處理的更多詳細信息，請查閱@EventListener類級javadoc。

異步監聽器

如果你希望特定的測試執行事件監聽器異步處理事件，你可以使用Spring的常規@Async支持。有關更多詳細信息，請查閱@EventListener的類級javadoc。

到此，關于“TestContext怎么使用”的學習就結束了，希望能夠解決大家的疑惑。理論與實踐的搭配能更好的幫助大家學習，快去試試吧！若想繼續學習更多相關知識，請繼續關注億速云網站，小編會繼續努力為大家帶來更多實用的文章！