Spring 5 中文解析核心篇-集成测试之TestContext(中)
###### 3.5.5 上下文管理
每个为其负责的测试实例提供上下文管理和缓存支持。测试实例不会自动接收对配置的的访问。但是，如果测试类实现接口，则将对的引用提供给测试实例。请注意，和实现了，因此可以自动提供对的访问。
** **
>
作为实现接口的替代方法，你可以通过字段或方法上的注解为测试类注入应用程序上下文，如以下示例所示：
>
```java
@SpringJUnitConfig
class MyTest {
@Autowired //1
ApplicationContext applicationContext;
// class body...
}
```
>
1. 注入。
>
同样，如果将测试配置为加载，则可以将Web应用程序上下文注入到测试中，如下所示：
>
```java
@SpringJUnitWebConfig //1
class MyWebAppTest {
@Autowired //2
WebApplicationContext wac;
// class body...
}
```
>
1. 配置
2. 注入
>
使用框架的测试类不需要扩展任何特定的类或实现特定的接口来配置其应用程序上下文。而是通过在类级别声明注解来实现配置。如果你的测试类未明确声明应用程序上下文资源位置或组件类，则配置的将确定如何从默认位置或默认配置类加载上下文。除了上下文资源位置和组件类之外，还可以通过应用程序上下文初始化程序配置应用程序上下文。
以下各节说明如何使用Spring的注解通过XML配置文件、脚本、组件类（通常为类）或上下文初始化器来配置测试。另外，你可以为高级用例实现和配置自己的自定义。
通过XML资源配置上下文
若要使用XML配置文件为测试加载，请使用注解测试类，并使用包含XML配置元数据的资源位置的数组配置属性。简单路径或相对路径（例如）被视为相对于定义测试类的程序包的类路径资源。以斜杠开头的路径被视为绝对类路径位置（例如:）。照原样使用表示资源URL的路径（即以、、等开头的路径）。
@ExtendWith(SpringExtension.class)
// ApplicationContext从根路径加载"/app-config.xml" 和
// "/test-config.xml"
@ContextConfiguration(locations={"/app-config.xml", "/test-config.xml"}) //1
class MyTest {
// class body...
}通过标准Java值属性为属性支持别名。因此，如果不需要在中声明其他属性，你可以使用以下示例中演示的格式，省略属性名称的声明并声明资源位置。
@ExtendWith(SpringExtension.class)
@ContextConfiguration({"/app-config.xml", "/test-config.xml"}) //1
class MyTest {
// class body...
}如果你从注解中省略了位置和值属性，则框架将尝试检测默认的XML资源位置。具体而言，和根据测试类的名称检测默认位置。如果你的类名为则将加载应用程序上下文。以下示例显示了如何执行此操作：
@ExtendWith(SpringExtension.class)
// ApplicationContext will be loaded from
// "classpath:com/example/MyTest-context.xml"
@ContextConfiguration //1
class MyTest {
// class body...
}通过Groovy脚本配置上下文
要通过使用的Groovy脚本为测试加载，可以使用注解测试类，并使用包含Groovy脚本资源位置的数组配置或属性。Groovy脚本的资源查找语义与针对[XML配置文件](https://docs.spring.io/spring/docs/5.2.7.RELEASE/spring-framework-reference/testing.html#testcontext-ctx-management-xml)描述的语义相同。
激活Groovy脚本支持
>
如果类路径中有Groovy，那么就会自动启用使用Groovy脚本在Spring 框架中加载的支持。
下面的示例显示如何指定Groovy配置文件：
@ExtendWith(SpringExtension.class)
// ApplicationContext will be loaded from "/AppConfig.groovy" and
// "/TestConfig.groovy" in the root of the classpath
@ContextConfiguration({"/AppConfig.groovy", "/TestConfig.Groovy"})
class MyTest {
// class body...
}如果你从注解中省略了和属性，则框架将尝试检测默认的Groovy脚本。具体来说，和根据测试类的名称检测默认位置。如果你的类名为则Groovy上下文加载器将从加载应用程序上下文。下面的示例演示如何使用默认值：
@ExtendWith(SpringExtension.class)
// ApplicationContext will be loaded from
// "classpath:com/example/MyTestContext.groovy"
@ContextConfiguration //1
class MyTest {
// class body...
}同时声明XML配置和Groovy脚本
>
你可以使用的或属性同时声明XML配置文件和Groovy脚本。如果到配置的资源位置的路径以结尾，则使用加载该路径。否则，将使用加载它。
>
以下清单显示了如何在集成测试中将两者结合起来：
>
```java
@ExtendWith(SpringExtension.class)
// ApplicationContext将从
// "/app-config.xml" 和 "/TestConfig.groovy"加载上下文
@ContextConfiguration({ "/app-config.xml", "/TestConfig.groovy" })
class MyTest {
// class body...
}
```
通过组件类配置上下文
要使用组件类（请参见）为测试加载，可以使用注解测试类，并使用包含对组件类的引用的数组来配置属性。以下示例显示了如何执行此操作：
@ExtendWith(SpringExtension.class)
// ApplicationContext将从AppConfig和TestConfig加载上下文
@ContextConfiguration(classes = {AppConfig.class, TestConfig.class}) //1
class MyTest {
// class body...
}组件类
>
术语可以指以下任何一种：
>
* 用注解的类。
* 组件（即，用、、或其他构造型注解注释的类）。
* 与JSR-330兼容的类，该类使用注解进行了注释。
* 包含方法的任何类。
* 打算注册为Spring组件的任何其他类（即中的Spring bean），可能利用单个自动构造函数的自动装配而无需使用Spring注解。
>
有关组件类的配置和语义的更多信息，请参见和[@Bean](https://docs.spring.io/spring-framework/docs/5.2.7.RELEASE/javadoc-api/org/springframework/context/annotation/Bean.html)的javadoc，尤其要注意 Lite模式的讨论。
如果你从注解中省略了属性，则框架将尝试检测默认配置类的存在。具体来说，和检测到满足配置类实现要求的测试类的所有静态嵌套类，如 javadoc中所指定。请注意，配置类的名称是任意的。另外，如果需要，一个测试类可以包含多个静态嵌套配制类。在以下示例中，类声明一个名为的静态嵌套配置类，该配置类将自动用于为测试类加载：
@SpringJUnitConfig //1
// ApplicationContext将从内部潜逃静态累加载
class OrderServiceTest {
@Configuration
static class Config {
// this bean will be injected into the OrderServiceTest class
@Bean
OrderService orderService() {
OrderService orderService = new OrderServiceImpl();
// set properties, etc.
return orderService;
}
}
@Autowired
OrderService orderService;
@Test
void testOrderService() {
// test the orderService
}
}XML、Groovy脚本、组件类混合
有时可能需要混合使用XML配置文件、Groovy脚本和组件类(通常为类)来为测试配置。如果在生产中使用XML配置，则可以决定要使用类为测试配置特定的Spring托管组件，反之亦然。
此外，某些第三方框架（例如Spring Boot）提供了一流的支持，可以同时从不同类型的资源（例如XML配置文件、Groovy脚本和类）中加载。过去，Spring框架不支持此标准部署。因此，Spring框架在模块中提供的大多数实现对于每个测试上下文仅支持一种资源类型。但是，这并不意味着你不能同时使用两者。通用规则的一个例外是和同时支持XML配置文件和Groovy脚本。此外，第三方框架可以选择通过支持位置和类的声明，并且，借助框架中的标准测试支持，你可以选择以下选项。
如果要使用资源位置（例如XML或Groovy）和类的配置测试，则必须选择一个作为入口点，并且其中一个必须包含或导入另一个。例如，在XML或Groovy脚本中，可以通过使用组件扫描或将它们定义为普通的Spring bean来包括类，而在类中，可以使用导入XML配置文件或Groovy脚本。请注意，此行为在语义上等同于你在生产环境中配置应用程序的方式：在生产配置中，你定义了一组XML或Groovy资源位置或一组类，从中加载了生产，但是你仍然包含或导入其他类型的配置的自由。
通过上下文初始化器配置上下文
若要使用上下文初始化程序为你的测试配置，请使用注解测试类，并使用包含对实现的类的引用的数组配置初始化程序属性。然后，使用声明的上下文初始值设定项来初始化为测试加载的。请注意，每个声明的初始化程序支持的具体类型必须与使用中的创建的类型（通常是）兼容。此外，初始化程序的调用顺序取决于它们是实现Spring的接口还是以Spring的注解或标准的注解进行注释。下面的示例演示如何使用初始化程序：
@ExtendWith(SpringExtension.class)
// ApplicationContext将从TestConfig
// 和 通过TestAppCtxInitializer初始化
@ContextConfiguration(
classes = TestConfig.class,
initializers = TestAppCtxInitializer.class) //1
class MyTest {
// class body...
}你还可以完全省略中的XML配置文件、Groovy脚本或组件类的声明，而仅声明类，然后这些类负责在上下文中注册Bean（例如，通过编程方式从XML文件加载Bean定义）或配置类。以下示例显示了如何执行此操作：
@ExtendWith(SpringExtension.class)
// ApplicationContext will be initialized by EntireAppInitializer
// which presumably registers beans in the context
@ContextConfiguration(initializers = EntireAppInitializer.class) //1
class MyTest {
// class body...
}参考代码：
上下文配置继承
支持 和属性，它们表示是否应该继承由超类声明的资源位置或组件类和上下文初始化器。这两个标志的默认值为。这意味着测试类将继承资源位置或组件类以及任何超类申明的上下文初始化器。具体来说，将测试类的资源位置或组件类附加到由超类申明的资源位置或带注解的类的列表中。同样，将给定测试类的初始化程序添加到由测试超类定义的初始化程序集。因此，子类可以选择扩展资源位置、组件类或上下文初始化程序。
如果中的或属性被设置为，则测试类的资源位置或组件类和上下文初始化器将分别有效地替代超类定义的配置。
在下一个使用XML资源位置的示例中，从和次加载的。因此，中定义的Bean可以覆盖（即替换）中定义的那些。以下示例显示了一个类如何扩展另一个类并使用其自己的配置文件和超类的配置文件：
@ExtendWith(SpringExtension.class)
// ApplicationContext将从类路径根目录加载"/base-config.xml"
@ContextConfiguration("/base-config.xml") //1
class BaseTest {
// class body...
}
// ApplicationContext将从类路径根目录加载"/base-config.xml" 和
// "/extended-config.xml"
@ContextConfiguration("/extended-config.xml") //2
class ExtendedTest extends BaseTest {
// class body...
}同样，在下一个使用组件类的示例中，从和类按该顺序加载的。因此，在中定义的Bean可以覆盖（即替换）在中定义的Bean。下面的示例显示一个类如何扩展另一个类，并同时使用自己的配置类和超类的配置类：
// ApplicationContext从BaseConfig加载
@SpringJUnitConfig(BaseConfig.class) //1
class BaseTest {
// class body...
}
// ApplicationContext将从BaseConfig和ExtendedConfig加载
@SpringJUnitConfig(ExtendedConfig.class) //2
class ExtendedTest extends BaseTest {
// class body...
}在使用上下文初始化程序的下一个示例中，通过使用和初始化的。但是请注意，初始化程序的调用顺序取决于它们是实现Spring的接口还是以Spring的注解或标准的注解进行注释。以下示例显示了一个类如何扩展另一个类并使用其自己的初始化程序和超类的初始化程序：
// ApplicationContext将通过BaseInitializer初始化
@SpringJUnitConfig(initializers = BaseInitializer.class) //1
class BaseTest {
// class body...
}
// ApplicationContext将通过BaseInitializer
// 和 ExtendedInitializer初始化
@SpringJUnitConfig(initializers = ExtendedInitializer.class) //2
class ExtendedTest extends BaseTest {
// class body...
}使用环境配置文件进行上下文配置
Spring框架对环境和配置文件(又名“bean定义配置文件”)的概念提供了一流的支持，可以配置集成测试来激活针对各种测试场景的特定bean定义配置文件。这可以通过使用注解测试类并提供在加载测试的时应激活的配置文件列表来实现。
你可以将与 SPI的任何实现一起使用，但较早的 SPI的实现不支持。
考虑两个带有XML配置和类的示例：
@ExtendWith(SpringExtension.class)
// ApplicationContext will be loaded from "classpath:/app-config.xml"
@ContextConfiguration("/app-config.xml")
@ActiveProfiles("dev")
class TransferServiceTest {
@Autowired
TransferService transferService;
@Test
void testTransferService() {
// test the transferService
}
}运行时，会从类路径根目录中的配置文件中加载其。如果检查，可以看到accountRepository bean对 bean有依赖性。但是，未被定义为顶级bean。相反，定义了三次：在生产配置文件中、在开发配置文件中以及在默认配置文件中。
通过使用注解，我们指示Spring 框架加载具有设置为的激活配置文件的。结果，创建了一个嵌入式数据库，并用测试数据填充了数据库，并用对开发的引用来连接 bean。这可能是我们在集成测试中想要的。
有时将bean分配给默认配置文件很有用。只有在没有特别激活其他配置文件时，才会包含缺省配置文件中的bean。你可以使用它来定义在应用程序的默认状态中使用的后备bean。例如，你可以显式提供和的数据源，但是当两者都不处于活动状态时，将内存中数据源定义为默认值。
以下代码清单演示了如何使用类而不是XML实现相同的配置和集成测试：
@Configuration
@Profile("dev")
public class StandaloneDataConfig {
@Bean
public DataSource dataSource() {
return new EmbeddedDatabaseBuilder()
.setType(EmbeddedDatabaseType.HSQL)
.addScript("classpath:com/bank/config/sql/schema.sql")
.addScript("classpath:com/bank/config/sql/test-data.sql")
.build();
}
}@Configuration
@Profile("production")
public class JndiDataConfig {
@Bean(destroyMethod="")
public DataSource dataSource() throws Exception {
Context ctx = new InitialContext();
return (DataSource) ctx.lookup("java:comp/env/jdbc/datasource");
}
}@Configuration
@Profile("default")
public class DefaultDataConfig {
@Bean
public DataSource dataSource() {
return new EmbeddedDatabaseBuilder()
.setType(EmbeddedDatabaseType.HSQL)
.addScript("classpath:com/bank/config/sql/schema.sql")
.build();
}
}@Configuration
public class TransferServiceConfig {
@Autowired DataSource dataSource;
@Bean
public TransferService transferService() {
return new DefaultTransferService(accountRepository(), feePolicy());
}
@Bean
public AccountRepository accountRepository() {
return new JdbcAccountRepository(dataSource);
}
@Bean
public FeePolicy feePolicy() {
return new ZeroFeePolicy();
}
}@SpringJUnitConfig({
TransferServiceConfig.class,
StandaloneDataConfig.class,
JndiDataConfig.class,
DefaultDataConfig.class})
@ActiveProfiles("dev")
class TransferServiceTest {
@Autowired
TransferService transferService;
@Test
void testTransferService() {
// test the transferService
}
}在此变体中，我们将XML配置分为四个独立的类：
: 通过使用进行依赖项注入来获取数据源。
: 为适合开发人员测试的嵌入式数据库定义数据源。
: 定义在生产环境中从JNDI检索的数据源。
: 如果没有配置文件处于激活状态，则为默认的嵌入式数据库定义一个数据源。
与基于XML的配置示例一样，我们仍然使用注解，但是这次我们使用注解指定所有四个配置类。测试类的主体本身保持完全不变。
在一个给定项目中，跨多个测试类使用一组配置文件是很常见的。因此，为避免注解的重复声明，可以在基类中声明一次，子类会自动从基类继承配置。在以下示例中，的声明（以及其他注解）已移至抽象超类：
@SpringJUnitConfig({
TransferServiceConfig.class,
StandaloneDataConfig.class,
JndiDataConfig.class,
DefaultDataConfig.class})
@ActiveProfiles("dev")
abstract class AbstractIntegrationTest {
}// "dev"配置集成父类
class TransferServiceTest extends AbstractIntegrationTest {
@Autowired
TransferService transferService;
@Test
void testTransferService() {
// test the transferService
}
}还支持可用于禁用激活配置文件的继承的属性，如以下示例所示：
// "dev"配置被"production"覆盖
@ActiveProfiles(profiles = "production", inheritProfiles = false)
class ProductionTransferServiceTest extends AbstractIntegrationTest {
// test body
}此外，有时有必要以编程方式而不是声明方式来解析测试的激活配置文件，例如，基于：
当前的操作系统。
是否在持续集成构建服务器上执行测试。
存在某些环境变量。
自定义类级别注释的存在。
其他问题。
要以编程方式解析活动bean定义配置文件，可以实现自定义并使用的属性对其进行注册。有关更多信息，请参见相应的。下面的示例演示如何实现和注册自定义的：
// "dev"配置通过自定义解析器编程式地覆盖
@ActiveProfiles(
resolver = OperatingSystemActiveProfilesResolver.class,
inheritProfiles = false)
class TransferServiceTest extends AbstractIntegrationTest {
// test body
}public class OperatingSystemActiveProfilesResolver implements ActiveProfilesResolver {
@Override
public String[] resolve(Class testClass) {
String profile = ...;
// determine the value of profile based on the operating system
return new String[] {profile};
}
}通过测试属性源配置上下文
Spring框架对具有属性源层次结构的环境概念提供了一流的支持，你可以使用特定于测试的属性源配置集成测试。与类上使用的注解相反，可以在测试类上声明注解，以声明测试属性文件或内联属性的资源位置。这些测试属性源被添加到环境中为带注解的集成测试加载的的集合中。
你可以将与 SPI的任何实现一起使用，但是较早的 SPI的实现不支持。
>
的实现可通过中的和方法访问合并的测试属性源值。
声明测试属性源
你可以使用或属性来配置测试属性文件。
支持传统属性文件格式和基于XML的属性文件格式，例如： 或。
每个路径都被解析为Spring资源。普通路径（例如）被视为相对于定义测试类的程序包的类路径资源。以斜杠开头的路径被视为绝对类路径资源（例如：）。通过使用指定的资源协议加载引用URL的路径（例如，以、或为前缀的路径）。不允许使用资源位置通配符（例如）每个位置都必须精确评估为一个或资源。
以下示例使用测试属性文件：
@ContextConfiguration
@TestPropertySource("/test.properties") //1
class MyIntegrationTests {
// class body...
}你可以使用的属性，以键/值对的形式配置内联属性，如下例所示。所有键值对都作为优先级最高的单个测试添加到封闭环境中。
键值对支持的语法与为Java属性文件中的条目定义的语法相同：
下面的示例设置两个内联属性：
@ContextConfiguration
@TestPropertySource(properties = {"timezone = GMT", "port: 4242"}) //1
class MyIntegrationTests {
// class body...
}
从Spring框架5.2开始，可以用作可重复注解。这意味着你可以在单个测试类上具有的多个声明，其后的注解中的和将覆盖先前的注解中的和。
>
此外，你可以在一个测试类上声明多个组合注解，每个注解都用进行元注解，所有这些声明都将贡献给你的测试属性源。直接呈现的总是优先于元呈现的注解。换句话说，直接存在的注解中的和将覆盖注解中用作元注解的和。
默认属性文件检测
如果被声明为空注解（即，没有或的显式值），则尝试检测相对于声明该注解的类的默认属性文件。例如，如果带注解的测试类是，则相应的对应属性文件是。如果无法检测到默认值，则抛出。
优先顺序
测试属性的优先级高于在操作系统环境、Java系统属性或应用程序通过使用声明性地或以编程方式添加的属性源中定义的属性。因此，测试属性可用于有选择地覆盖从系统和应用程序属性源加载的属性。此外，内联属性优先于从资源位置加载的属性。但是请注意，通过注册的属性比通过加载的属性具有更高的优先级。
在下一个示例中，和属性以及在中定义的任何属性都将覆盖在系统和应用程序属性源中定义的同名属性。此外，如果文件定义了和属性的条目，则这些条目将被使用属性声明的内联属性所覆盖。
@ContextConfiguration
@TestPropertySource(
locations = "/test.properties",
properties = {"timezone = GMT", "port: 4242"}
)
class MyIntegrationTests {
// class body...
}继承和覆盖测试属性源
支持布尔型的和属性，它们表示属性文件的资源位置和超类声明的内联属性是否应该被继承。这两个标志的默认值为。这意味着测试类将继承任何超类声明的位置和内联属性。具体来说，测试类的位置和内联属性附加到父类声明的位置和内联属性。因此，子类可以选择扩展位置和内联属性。注意，后面出现的属性会隐藏(即覆盖)前面出现的同名属性。此外，前面提到的优先规则也适用于继承的测试属性源。
如果中的或属性设置为，则分别为测试类设置位置或内联属性，并有效替换超类定义的配置。
在下一个示例中，的是通过只使用加载的。属性文件作为测试属性源。相反，的是通过使用加载的属性和扩展。属性文件作为测试属性源位置。下面的示例演示如何使用属性文件在子类及其超类中定义属性：
```java
@TestPropertySource("base.properties")
@ContextConfiguration
class BaseTest {
// ...
}
@TestPropertySource("extended.properties")
@ContextConfiguration
class ExtendedTest extends BaseTest {
// ...
}
```
在下一个示例中，仅使用内联的属性来加载的。相反，使用内联的和属性来加载的。下面的示例演示如何通过使用内联属性在子类及其父类中定义属性：
@TestPropertySource(properties = "key1 = value1")
@ContextConfiguration
class BaseTest {
// ...
}
@TestPropertySource(properties = "key2 = value2")
@ContextConfiguration
class ExtendedTest extends BaseTest {
// ...
}通过动态属性源配置上下文
从Spring框架5.2.5开始，框架通过注解提供对动态属性的支持。此注解可用于需要向为集成测试加载的的环境中的集添加带有动态值的属性的集成测试。
注解及其支持的基础结构最初旨在使基于的测试中的属性易于暴露于Spring集成测试。但是，此功能还可以用于其生命周期在测试的之外维护的任何形式的外部资源。
与在类级别应用注解相反，必须应用于接受单个参数的静态方法，该参数用于向环境添加对。值是动态的，并通过提供，只有在解析属性时才调用。通常，方法引用被用来提供值，如下面的例子所示，它使用项目在Spring 之外管理一个Redis容器。通过和属性，测试的中的组件可以使用托管Redis容器的IP地址和端口。这些属性可以通过Spring的环境抽象访问，或者直接注入到Spring管理的组件中，例如分别通过和。
@SpringJUnitConfig(/* ... */)
@Testcontainers
class ExampleIntegrationTests {
@Container
static RedisContainer redis = new RedisContainer();
@DynamicPropertySource
static void redisProperties(DynamicPropertyRegistry registry) {
registry.add("redis.host", redis::getContainerIpAddress);
registry.add("redis.port", redis::getMappedPort);
}
// tests ...
}优先顺序
动态属性的优先级高于、操作系统的环境、Java系统属性或应用程序通过声明性地或以编程方式添加的属性源中加载的属性。因此，动态属性可用于有选择地覆盖通过、系统属性源和应用程序属性源加载的属性。
**加载**
若要指示框架加载而不是标准，可以使用注解各自的测试类。
测试类上的存在指示框架（TCF）应该为集成测试加载（WAC）。TCF在后台确保创建了并将其提供给测试的WAC。默认情况下，你的的基本资源路径设置为。这被解释为相对于JVM根目录的路径(通常是项目的路径)。如果你熟悉Maven项目中Web应用程序的目录结构，则知道是WAR根目录的默认位置。如果需要覆盖此默认值，则可以提供注解的替换路径(例如，。如果你希望从类路径而不是文件系统中引用基本资源路径，则可以使用Spring的前缀。
请注意，Spring对实现的测试支持与其对标准实现的支持相当。使用进行测试时，可以使用声明XML配置文件、Groovy脚本或类。你还可以自由地使用任何其他测试注解，如、、、和其他。
本节的其余示例展示了加载的一些不同配置选项。以下示例显示了框架对配置约定的支持：
@ExtendWith(SpringExtension.class)
// defaults to "file:src/main/webapp"
@WebAppConfiguration
// detects "WacTests-context.xml" in the same package
// or static nested @Configuration classes
@ContextConfiguration
class WacTests {
//...
}如果使用注解测试类而未指定资源基本路径，则资源路径实际上默认为。同样，如果在声明时未指定资源位置、组件类或上下文初始化程序，则Spring会尝试使用约定（也就是说，与类或静态嵌套类位于同一包中）。
以下示例显示如何使用显式声明资源基本路径和使用显式声明XML资源位置：
@ExtendWith(SpringExtension.class)
// file system resource
@WebAppConfiguration("webapp")
// classpath resource
@ContextConfiguration("/spring/test-servlet-config.xml")
class WacTests {
//...
}这里要注意的重要一点是具有这两个注解的路径的语义不同。默认情况下，资源路径基于文件系统，而资源位置基于类路径。下面的示例显示，我们可以通过指定Spring资源前缀来覆盖两个注解的默认资源语义：
@ExtendWith(SpringExtension.class)
// classpath resource
@WebAppConfiguration("classpath:test-web-resources")
// file system resource
@ContextConfiguration("file:src/main/webapp/WEB-INF/servlet-config.xml")
class WacTests {
//...
}将本示例中的注解与上一个示例进行对比。
使用Web Mock工作
为了提供全面的Web测试支持，框架具有默认启用的。在针对进行测试时，此会在每个测试方法之前使用Spring Web的来设置默认的线程本地状态，并根据通过配置的基本资源路径创建、和。
还确保可以将和注入到测试实例中，并且一旦测试完成，它将清除线程本地状态。
一旦为测试加载了，你可能会发现你需要与Web模拟进行交互，例如，在调用Web组件之后设置测试或执行断言。以下示例显示可以将哪些模拟自动装配到你的测试实例。请注意，和都缓存在测试套件中，而其他模拟则由针对每个测试方法进行管理。
@SpringJUnitWebConfig
class WacTests {
@Autowired
WebApplicationContext wac; // cached
@Autowired
MockServletContext servletContext; // cached
@Autowired
MockHttpSession session;
@Autowired
MockHttpServletRequest request;
@Autowired
MockHttpServletResponse response;
@Autowired
ServletWebRequest webRequest;
//...
}上下文缓存
一旦框架为测试加载了（或），该上下文将被缓存并重新用于在同一测试套件中声明相同唯一上下文配置的所有后续测试。要了解缓存的工作原理，重要的是要了解和的含义。
可以通过用于加载它的配置参数的组合来唯一标识。因此，使用配置参数的唯一组合来生成一个键，在该键下缓存上下文。框架使用以下配置参数来构建上下文缓存键：
(来自)
(来自)
(来自)
(来自)其中包括方法，以及Spring Boot测试支持中的各种功能，例如和。
(来自)
(来自)
(来自)
(来自)
(来自)
(来自)
例如，如果为的（或）属性指定，则框架将加载相应的并将其存储在静态上下文缓存中仅基于那些位置的key下。因此，如果还为其位置（通过继承显式或隐式）定义了，但未定义、不同的、不同的激活配置文件、不同的上下文初始化程序、不同的测试属性源或不同的父上下文，则两个测试类将共享相同的。这意味着（每个测试套件）仅需加载一次加载应用程序上下文的设置成本，并且随后的测试执行要快得多。
测试套件和分支流程
>
Spring 框架将应用程序上下文存储在静态缓存中。这意味着上下文实际上是存储在静态变量中的。换句话说，如果测试是在单独的进程中执行的，则在每个测试执行之间都会清除静态缓存，从而有效地禁用了缓存机制。
>
为了从缓存机制中受益，所有测试必须在同一进程或测试套件中运行。这可以通过在IDE中以组的形式执行所有测试来实现。同样，在使用诸如Ant、Maven或Gradle之类的构建框架执行测试时，确保该构建框架不会在测试之间进行派生(fork多个进程)很重要。例如，如果将Maven Surefire插件的forkMode设置为always或pertest，则框架将无法在测试类之间缓存应用程序上下文，因此，构建过程的运行速度将大大降低。
上下文缓存的大小以默认的最大32为界。只要达到最大大小，就会使用最近最少使用（LRU）驱逐策略来驱逐和关闭旧的上下文。你可以通过设置名为的JVM系统属性，从命令行或构建脚本中配置最大大小。或者，你可以使用 API以编程方式设置相同的属性。
由于在给定的测试套件中加载大量的应用程序上下文会导致该套件花费不必要的长时间来执行，因此准确地知道已加载和缓存了多少个上下文通常是有益的。要查看基础上下文缓存的统计信息，可以将日志记录类别的日志级别设置为。
在不太可能的情况下，测试破坏了应用程序上下文并需要重新加载（例如，通过修改bean定义或应用程序对象的状态），你可以使用注解测试类或测试方法（请参阅中对的讨论）。这指示Spring在运行需要相同应用程序上下文的下一个测试之前，从缓存中删除上下文并重建应用程序上下文。请注意，默认情况下启用的和提供了对注解的支持。
上下文层级
在编写依赖于已加载的Spring 的集成测试时，通常足以针对单个上下文进行测试。但是，有时需要对实例的层次结构进行测试是有益的，甚至是必要的。例如，如果你正在开发Spring MVC Web应用程序，则通常由Spring的加载根，由Spring的加载子。这将导致父子上下文层次结构，其中共享组件和基础设施配置在根上下文中声明，并由特定于web的组件在子上下文中使用。在Spring Batch应用程序中可以找到另一个用例，在该应用程序中，你通常具有一个父上下文，该上下文为共享批处理基础结构提供配置，而子上下文则为特定批处理作业的配置提供配置。
你可以通过在单个测试类上或在测试类层次结构中使用注解声明上下文配置来编写使用上下文层次结构的集成测试。如果在测试类层次结构中的多个类上声明了上下文层次结构，则还可以合并或覆盖上下文层次结构中特定命名级别的上下文配置。合并层次结构中给定级别的配置时，配置资源类型（即XML配置文件或组件类）必须一致。否则，在使用不同资源类型配置的上下文层次结构中具有不同级别是完全可以接受的。
本节中其余的基于JUnit Jupiter的示例显示了需要使用上下文层次结构的集成测试的常见配置方案。
具有上下文层次结构的单个测试类
通过声明一个上下文层次结构来代表Spring MVC Web应用程序的典型集成测试场景，该上下文层次结构包含两个级别，一个层次用于根（通过使用 @Configuration类加载），一个层次用于调度程序Servlet （通过使用 类加载）。自动装配到测试实例的是用于子上下文（即，层次结构中的最低上下文）的。
以下清单显示了此配置方案：
@ExtendWith(SpringExtension.class)
@WebAppConfiguration
@ContextHierarchy({
@ContextConfiguration(classes = TestAppConfig.class),
@ContextConfiguration(classes = WebConfig.class)
})
class ControllerIntegrationTests {
@Autowired
WebApplicationContext wac;
// ...
}参考代码：
具有隐式父上下文的类层次结构
本示例中的测试类在测试类层次结构中定义了上下文层次结构。在Spring驱动的Web应用程序中声明根的配置。但是请注意，不会声明。因此，的子类可以选择参与上下文层次结构或遵循的标准语义。和都扩展了并使用定义了上下文层次结构。结果是，加载了三个应用程序上下文（每个声明一个），并且基于中的配置加载的应用程序上下文被设置为具体子类加载的每个上下文的父上下文。
@ExtendWith(SpringExtension.class)
@WebAppConfiguration
@ContextConfiguration("file:src/main/webapp/WEB-INF/applicationContext.xml")
public abstract class AbstractWebTests {}
@ContextHierarchy(@ContextConfiguration("/spring/soap-ws-config.xml"))
public class SoapWebServiceTests extends AbstractWebTests {}
@ContextHierarchy(@ContextConfiguration("/spring/rest-ws-config.xml"))
public class RestWebServiceTests extends AbstractWebTests {}参考代码：
合并上下文层次结构配置的类层次结构
此示例中的类显示了使用命名层次结构级别的目的，以及合并上下文层次结构中特定级别的配置。在层次结构中定义了两个级别，和。扩展并指示Spring 框架合并子层次结构级别的上下文配置，方法是确保在的name属性中声明的名称均为子元素。结果是加载了三个应用程序上下文：一个用于、一个用于、一个用于， 。与前面的示例一样，将从加载的应用程序上下文设置为从和加载的上下文的父上下文（合并配置文件）。以下清单显示了此配置方案：
@ExtendWith(SpringExtension.class)
@ContextHierarchy({
@ContextConfiguration(name = "parent", locations = "/app-config.xml"),
@ContextConfiguration(name = "child", locations = "/user-config.xml")
})
class BaseTests {}
@ContextHierarchy(
@ContextConfiguration(name = "child", locations = "/order-config.xml")
)
class ExtendedTests extends BaseTests {}参考代码：
具有覆盖的上下文层次结构配置的类层次结构
与前面的示例相反，此示例演示了如何通过将中的标志设置为来覆盖上下文层次结构中给定命名级别的配置。因此，的应用程序上下文仅从加载，并且其父级设置为从加载的上下文。以下清单显示了此配置方案：
@ExtendWith(SpringExtension.class)
@ContextHierarchy({
@ContextConfiguration(name = "parent", locations = "/app-config.xml"),
@ContextConfiguration(name = "child", locations = "/user-config.xml")
})
class BaseTests {}
@ContextHierarchy(
@ContextConfiguration(
name = "child",
locations = "/test-user-config.xml",
inheritLocations = false
))
class ExtendedTests extends BaseTests {}清除上下文层次结构中的上下文
>
如果你在一个测试中使用@DirtiesContext，该测试的上下文被配置为上下文层次结构的一部分，那么你可以使用hierarchyMode标志来控制如何清除上下文缓存。有关更多详细信息，请参见中的@DirtiesContext和[@DirtiesContext](https://docs.spring.io/spring-framework/docs/5.2.7.RELEASE/javadoc-api/org/springframework/test/annotation/DirtiesContext.html) javadoc的讨论。
参考代码：
###### 3.5.6 测试装置的依赖注入
当使用（默认配置）时，测试实例的依赖项是从使用或相关注解配置应用程序上下文中的bean注入的。你可以使用注入、字段注入、或同时使用这两种方法，具体取决于你选择的注解以及是否将它们放在方法或字段上。如果你使用的是JUnit Jupiter，则还可以选择使用构造函数注入（请参阅带有）。为了与Spring基于注解的注入支持保持一致，你还可以将Spring的注解或JSR-330中的注解用于字段注入和setter 注入。
对于JUnit Jupiter以外的测试框架，框架不参与测试类的实例化。因此，将或用于构造函数对测试类无效。
尽管在生产代码中不鼓励使用字段注入，但是在测试代码中字段注入实际上是很自然的。理由是你永远不会直接实例化测试类。因此，不需要在测试类上调用公共构造函数或方法。
因为用于按类型执行自动装配，所以如果你具有多个相同类型的Bean定义，那么对于那些特定的Bean，你将不能依靠这种方法。在这种情况下，可以将与结合使用。你也可以选择将与结合使用。或者，如果你的测试类可以访问其，则可以通过使用（例如）对的调用来执行显式查找。
如果你不希望将依赖项注入应用于测试实例，请不要使用或注解字段或设置器方法。或者，你可以通过显式地用配置你的类，并从监听器列表中忽略来禁用依赖注入。
考虑测试类的场景，如部分所述。接下来的两个代码清单演示了在字段和方法上的用法。在所有示例代码清单之后显示了应用程序上下文配置。
以下代码清单中的依赖项注入行为并非特定于JUnit Jupiter。相同的技术可以与任何受支持的测试框架结合使用。
>
以下示例对静态断言方法（例如）进行了调用，但没有在声明前添加。在这种情况下，假定该方法是通过示例中未显示的声明正确导入的。
第一个代码清单显示了使用进行字段注入的测试类的基于JUnit Jupiter的实现：
@ExtendWith(SpringExtension.class)
// specifies the Spring configuration to load for this test fixture
@ContextConfiguration("repository-config.xml")
class HibernateTitleRepositoryTests {
// this instance will be dependency injected by type
@Autowired
HibernateTitleRepository titleRepository;
@Test
void findById() {
Title title = titleRepository.findById(new Long(10));
assertNotNull(title);
}
}或者，你可以将类配置为使用进行注入，如下所示：
@ExtendWith(SpringExtension.class)
// specifies the Spring configuration to load for this test fixture
@ContextConfiguration("repository-config.xml")
class HibernateTitleRepositoryTests {
// this instance will be dependency injected by type
HibernateTitleRepository titleRepository;
@Autowired
void setTitleRepository(HibernateTitleRepository titleRepository) {
this.titleRepository = titleRepository;
}
@Test
void findById() {
Title title = titleRepository.findById(new Long(10));
assertNotNull(title);
}
}前面的代码清单使用注解引用的相同XML上下文文件（即，）。下面显示了此配置：
如果你是从Spring提供的测试基类扩展而来的，而该基类恰巧在其方法之一上使用，则可能在应用程序上下文中定义了多个受影响类型的Bean（例如，多个 Bean）。在这种情况下，你可以覆盖setter方法，并使用注解指示特定的目标bean，如下所示（但请确保也委托给超类中的重写方法）：
>
```java
// ...
@Autowired
@Override
public void setDataSource(@Qualifier("myDataSource") DataSource dataSource) {
super.setDataSource(dataSource);
}
// ...
```
>
指定的限定符值指示要注入的特定 Bean，从而将类型匹配的范围缩小到特定Bean。其值与相应的
定义中的 声明匹配。Bean名称用作后备限定符值，因此你也可以在该名称中有效地指向特定的Bean（如先前所示，假设是Bean ）。
作者
个人从事金融行业，就职过易极付、思建科技、某网约车平台等重庆一流技术团队，目前就职于某银行负责统一支付系统建设。自身对金融行业有强烈的爱好。同时也实践大数据、数据存储、自动化集成和部署、分布式微服务、响应式编程、人工智能等领域。同时也热衷于技术分享创立公众号和博客站点对知识体系进行分享。关注公众号：青年IT男 获取最新技术文章推送！
博客地址： http://youngitman.tech
CSDN： https://blog.csdn.net/liyong1028826685
微信公众号：
技术交流群：
