springboot排除某些bean_Spring、Spring Boot 和 TestNG 测试指南 ( 2 )

本文介绍了如何在Spring Boot测试中排除某些Bean,通过使用Spring和Spring Boot的测试工具,如AbstractTestNGSpringContextTests、@ContextConfiguration、@SpringBootTest等,并提供了多种加载配置和扫描Bean的方法。此外,还强调了在测试配置中保持与生产配置一致的重要性,以避免出现配置差异导致的错误。
摘要由CSDN通过智能技术生成

引言

本项目所有的项目均采用Maven的标准目录结构:

  • src/main/java,程序java文件目录
  • src/main/resource,程序资源文件目录
  • src/test/java,测试代码目录
  • src/test/resources,测试资源文件目录

并且所有Maven项目都可以使用mvn clean test方式跑单元测试,特别需要注意,只有文件名是*Test.java才会被执行,一定要注意这一点哦。

认识TestNG

先认识一下TestNG,这里有一个FooServiceImpl,里面有两个方法,一个是给计数器+1,一个是获取当前计数器的值:

59cbb58c5db29accc61bf40108e311e1.png

然后我们针对它有一个FooServiceImplTest作为UT:

01faa8daf1562d452b502b7fd7af9245.png

注意看代码里的assertEquals(…),我们利用它来判断Foo.getCount方法是否按照预期执行。所以,所谓的测试其实就是给定输入、执行一些方法,assert结果是否符合预期的过程。

使用Spring Testing工具

既然我们现在开发的是一个Spring项目,那么肯定会用到Spring Framework的各种特性,这些特性实在是太好用了,它能够大大提高我们的开发效率。那么自然而然,你会想在测试代码里也能够利用Spring Framework提供的特性,来提高测试代码的开发效率。这部分我们会讲如何使用Spring提供的测试工具来做测试。

例子1

ebf373a78214b470c7e0f6477a32db58.png

在上面的源代码里我们要注意三点:

  1. 测试类继承了AbstractTestNGSpringContextTests,如果不这么做测试类是无法启动Spring容器的
  2. 使用了[@ContextConfiguration][javadoc-ContextConfiguration]来加载被测试的Bean:FooServiceImpl
  3. FooServiceImpl是@Component

以上三点缺一不可。

例子2

在这个例子里,我们将@Configuration作为nested static class放在测试类里,根据@ContextConfiguration的文档,它会在默认情况下查找测试类的nested static @Configuration class,用它来导入Bean。

ffa3de4325a75c518c51f21733a911e6.png

例子3

在这个例子里,我们将@Configuration放到外部,并让@ContextConfiguration去加载。

97c928de1a412789b69e5131f1f1046c.png
d09fdf9040132e663ab08ec6f641f917.png

需要注意的是,如果@Configuration是专供某个测试类使用的话,把它放到外部并不是一个好主意,因为它有可能会被@ComponentScan扫描到,从而产生一些奇怪的问题。

使用Spring Boot Testing工具

前面一个部分讲解了如何使用Spring Testing工具来测试Spring项目,现在我们讲解如何使用Spring Boot Testing工具来测试Spring Boot项目。

在Spring Boot项目里既可以使用Spring Boot Testing工具,也可以使用Spring Testing工具。 在Spring项目里,一般使用Spring Testing工具,虽然理论上也可以使用Spring Boot Testing,不过因为Spring Boot Testing工具会引入Spring Boot的一些特性比如AutoConfiguration,这可能会给你的测试带来一些奇怪的问题,所以一般不推荐这样做。

例子1:直接加载Bean

使用Spring Boot Testing工具只需要将@ContextConfiguration改成@SpringBootTest即可,

b363db7ff4421ac05c1c2b3f353b5cf1.png

例子2:使用内嵌@Configuration加载Bean

92b45958c8a132cf68bba1b56911bc26.png

例子3:使用外部@Configuration加载Bean

f66a52636b6adbdbced14c975117b94e.png
b0243f7da7a55180254d3ea18fbc955d.png

这个例子和例子2差不多,只不过将@Configuration放到了外部。

例子4:使用@SpringBootConfiguration

前面的例子@SpringBootTest的用法和@ContextConfiguration差不多。不过根据@SpringBootTest的文档:

  1. 它会尝试加载@SpringBootTest(classes=…)的定义的Annotated classes。Annotated classes的定义在ContextConfiguration中有说明。
  2. 如果没有设定@SpringBootTest(classes=…),那么会去找当前测试类的nested @Configuration class
  3. 如果上一步找到,则会尝试查找@SpringBootConfiguration,查找的路径有:1)看当前测试类是否@SpringBootConfiguration,2)在当前测试类所在的package里找。

所以我们可以利用这个特性来进一步简化测试代码。

be57b21da77e2a5a39dd89aa6d735cef.png
ee32d5545e4aa63ec60e6536f551e01c.png

例子5:使用@ComponentScan扫描Bean

前面的例子我们都使用@Import来加载Bean,虽然这中方法很精确,但是在大型项目中很麻烦。

在常规的Spring Boot项目中,一般都是依靠自动扫描机制来加载Bean的,所以我们希望我们的测试代码也能够利用自动扫描机制来加载Bean。

efd322fbc71ec81717a8e516a9891a76.png
c64672f3280f88ad010eb49a05884870.png

例子6:使用@SpringBootApplication

也可以在测试代码上使用@SpringBootApplication,它有这么几个好处:

  1. 自身SpringBootConfiguration
  2. 提供了@ComponentScan配置,以及默认的excludeFilter,有了这些filter Spring在初始化ApplicationContext的时候会排除掉某些Bean和@Configuration
  3. 启用了EnableAutoConfiguration,这个特性能够利用Spring Boot来自动化配置所需要的外部资源,比如数据库、JMS什么的,这在集成测试的时候非常有用。
3a3ed1cf8a46ec3ade25c032b5d144d1.png
59b43c22f3b3add32e66f068fc44b331.png

避免@SpringBootConfiguration冲突

当@SpringBootTest没有定义(classes=…,且没有找到nested @Configuration class的情况下,会尝试查询@SpringBootConfiguration,如果找到多个的话则会抛出异常:

Caused by: java.lang.IllegalStateException: Found multiple @SpringBootConfiguration annotated classes [Generic bean: class [...]; scope=; abstract=false; lazyInit=false; autowireMode=0; dependencyCheck=0; autowireCandidate=true; primary=false; factoryBeanName=null; factoryMethodName=null; initMethodName=null; destroyMethodName=null; defined in file [/Users/qianjia/workspace-os/spring-test-examples/basic/target/test-classes/me/chanjar/basic/springboot/ex7/FooServiceImplTest1.class], Generic bean: class [me.chanjar.basic.springboot.ex7.FooServiceImplTest2]; scope=; abstract=false; lazyInit=false; autowireMode=0; dependencyCheck=0; autowireCandidate=true; primary=false; factoryBeanName=null; factoryMethodName=null; initMethodName=null; destroyMethodName=null; defined in file [...]]

比如以下代码就会造成这个问题:

d9db165ec9d41013f9cf7faca6df668c.png

解决这个问题的方法有就是避免自动查询@SpringBootConfiguration:

  1. 定义@SpringBootTest(classes=…)
  2. 提供nested @Configuration class

最佳实践

除了单元测试(不需要初始化ApplicationContext的测试)外,尽量将测试配置和生产配置保持一致。比如如果生产配置里启用了AutoConfiguration,那么测试配置也应该启用。因为只有这样才能够在测试环境下发现生产环境的问题,也避免出现一些因为配置不同导致的奇怪问题。

在测试代码之间尽量做到配置共用,这么做的优点有3个:

  1. 能够有效利用Spring TestContext Framework的缓存机制,ApplicationContext只会创建一次,后面的测试会直接用已创建的那个,加快测试代码运行速度。
  2. 当项目中的Bean很多的时候,这么做能够降低测试代码复杂度,想想如果每个测试代码都有一套自己的@Configuration或其变体,那得多吓人。
105c50a69abd139dcbb726da21d42e5f.png
评论
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

当前余额3.43前往充值 >
需支付:10.00
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值