原文:Testing improvements in Spring Boot 1.4
作者:PHIL WEBB 译者:杰微刊兼职翻译张迪
对Pivotal团队来说,工作上的好事情是他们拥有一个被叫做Pivotal Labs的灵活发展部门,拥有Labs团队的Lean 和 XP程序设计方法学的强大支持,例如结对编程和测试驱动开发。他们对于测试的酷爱已经对Spring Boot 1.4产生独特的影响,正如我们已经开始通过获取重大的反馈来对事物本身进行改善。这篇文章重点介绍了一些新的测试功能,这些功能刚刚使用在M2最新的版本中。
一、没有Spring的实验测试
单元测试任何Spring @Component的最简单的方式就是不要涉及到Spring的任何方面。
这个方法同时也是尝试和建构代码的最好方式,所以classes可以被实例化和直接测试。通常,归结为几方面:
1、用干净的注点分离组织你的代码,以便于每个部分都可以被单元测试。TDD是一种不错的实现方式。2、使用constructor injection(构造子注入)确保目标对象可以直接被实例化的。不要使用field injection,因为它只会让你的测试更难写。使用Spring框架4.3会让编写组件变得很容易,就好像你不再需要使用@Autowired就可以使用constructor injections了。只要你有一个单独的构造函数,Spring会暗中将它当做一个自动配置的目标:
@Componentpublic class MyComponent {
private final SomeService service;
public MyComponent(SomeService service) {
this.service = service;
}
}
现在,测试mycomponent,就像直接创建它一样简单,调用一些方法:
@Testpublic void testSomeMethod() {
SomeService service = mock(SomeService.class);
MyComponent component = new MyComponent(service);
// setup mock and class component methods
}
二、Spring Boot 1.3概括
当然,你经常需要将堆栈稍微提升,开始编写包含Spring的综合测试。幸运的是,Spring框架提供spring测试模块的帮助,不幸的是,通过Spring Boot 1.3,大家有很多不同的方式来使用它。你可能会使用@ContextConfiguration注释和SpringApplicationContextLoader的组合:
@RunWith(SpringJUnit4ClassRunner.class)
@ContextConfiguration(classes=MyApp.class, loader=SpringApplicationContextLoader.class)public class MyTest {
// ...
}
你可能已经选择了
@SpringApplicationConfiguration:
@RunWith(SpringJUnit4ClassRunner.class)
@SpringApplicationConfiguration(MyApp.class)
public class MyTest {
// ...
}
你可能会通过@IntegrationTest结合其中任何一个:@RunWith(SpringJUnit4ClassRunner.class)
@SpringApplicationConfiguration(MyApp.class)
@IntegrationTestpublic class MyTest {
// ...
}或者是利用
@WebIntegrationTest(或者可能是@IntegrationTest + @WebAppConfiguration):
@RunWith(SpringJUnit4ClassRunner.class)
@SpringApplicationConfiguration(MyApp.class)
@WebIntegrationTestpublic class MyTest {
// ...
}
你也可以到混合随机端口上运行的服务器中(@WebIntegrationTest(randomPort=true))添加属性(使用@IntegrationTest("myprop=myvalue")或者@TestPropertySource(properties="myprop=myvalue"))。
你有很多选择可以选。
三、Spring Boot 1.4简单化使用
Spring Boot 1.4之后,事情就会变得简单多了。这里是一个用于常规测试的@SpringBootTest注释,与你应用程序中测试插件的一些特定变体一样(稍后将详细介绍)。下面展示的是一个Spring Boot 1.4综合测试的典型案例:@RunWith(SpringRunner.class)
@SpringBootTest(webEnvironment=WebEnvironment.RANDOM_PORT)
public class MyTest {
// ...
}
以下是发生了的一个故障:
1、@RunWith(SpringRunner.class) 告诉JUnit运行使用Spring的测试支持。SpringRunner是SpringJUnit4ClassRunner的新名字,这个名字只是让名字看起来简单些。
2、@SpringBootTest的意思是“带有Spring Boot支持的引导程序”(例如,加载应用程序、属性,为我们提供Spring Boot的所有精华部分)。
3、webEnvironment属性允许为测试配置特定的“网络环境”。你可以利用一个MOCK小服务程序环境开始你的测试,或者使用一个运行在RANDOM_PORT 或者 DEFINED_PORT上的真正的HTTP服务器。
4、如果我们想要加载一个特定的配置,我们可以用@SpringBootTest class属性。在这个实例中,我们省略classes就意味着测试要首次尝试从任意一个inner-classes中加载@ configuration,如果这个尝试失败了,它会在你主要的@SpringBootApplicationclass中进行搜索。
特性现在都以相同的方式加载,如同Spring的常规@TestPropertySource 注释。
@SpringBootTest注释通常含有特性属性,这个属性可以被用来指定任何应该在环境中定义的额外特性。这是一个更具体的例子,真正REST末端实际上的采样数:@RunWith(SpringRunner.class)
@SpringBootTest(webEnvironment=WebEnvironment.RANDOM_PORT)
public class MyTest {
@Autowired
private TestRestTemplate restTemplate;
@Test
public void test() {
this.restTemplate.getForEntity(
"/{username}/vehicle", String.class, "Phil");
}
}
请注意,TestRestTemplate现在是随意使用的,就像@SpringBootTest随时都能使用bean一样。这是预配置解决http://localhost:${local.server.port}的相对路径。
我们也可以使用@LocalServerPort注释注入实际的端口,这样服务器就能在测试领域上运行。四、模仿和侦查当你开始测试真正的系统时,你经常会发现它有助于模拟特定的beans。模仿的常见场景包括模拟服务,这个服务在你测试或者测试失败场景的时候是不可用的,因为这很难在同一个系统中触发。使用Spring Boot 1.4你可以轻松地建造一个Mockito mocks,可以取代现有的bean,或者创建一个新的:@RunWith(SpringRunner.class)
@SpringBootTest(webEnvironment = WebEnvironment.RANDOM_PORT)public class SampleTestApplicationWebIntegrationTests {
@Autowired private TestRestTemplate restTemplate;
@MockBean private VehicleDetailsService vehicleDetailsService;
@Before public void setup() {
given(this.vehicleDetailsService.
getVehicleDetails("123")
).willReturn(
new VehicleDetails("Honda", "Civic"));
}
@Test
public void test() {
this.restTemplate.getForEntity("/{username}/vehicle",
String.class, "sframework");
}
}
以下是一些例子:?为 VehicleDetailsService创建一个 Mockito mock。?将它如同bean一样注入ApplicationContext。?将它注入到在测试领域。?在?设置方法上存根。?触发最终会调用mock的东西。测试模拟将自动重置。它们还会形成一部分Spring Test使用的缓存键(所以,没有必要添加@DirtiesContext)。Spies以类似的方式工作。
用@SpyBean简单地注释一个测试领域来让spy隐藏所有ApplicationContext中现有的bean。五、JSON断言如果你使用pring-boot-starter-test POM来导入测试依赖关系,从1.4开始,你将有很好的AssertJ文库。AssertJ 提供了一个流畅的assertion API 来代替JUnit的基础org.junit.Assert class。如果你之前没有遇到过,哪买看下面的实例,一个基础的AssertJcall看起来就是这样的:
assertThat(library.getName()).startsWith("Spring").endsWith("Boot");Spring Boot
1.4 提供了扩展的断言,这样你就能用它来检查JSON marshalling 和 unmarshalling。
public class VehicleDetailsJsonTests {
private JacksonTesterjson;
@Before
public void setup() {
ObjectMapper objectMappper = new ObjectMappper();
// Possibly configure the mapper
JacksonTester.initFields(this, objectMappper);
}
@Test
public void serializeJson() {
VehicleDetails details =
new VehicleDetails("Honda", "Civic"); assertThat(this.json.write(details))
.isEqualToJson("vehicledetails.json"); assertThat(this.json.write(details))
.hasJsonPathStringValue("@.make"); assertThat(this.json.write(details)) .extractingJsonPathStringValue("@.make")
.isEqualTo("Honda"); }
@Test
public void deserializeJson() {
String content = "{\"make\":\"Ford\",\"model\":\"Focus\"}"; assertThat(this.json.parse(content))
.isEqualTo(new VehicleDetails("Ford", "Focus")); assertThat(this.json.parseObject(content).getMake())
.isEqualTo("Ford");
}
}
JSON的比较实际上是使用JSONassert执行的,所以只有JSON的逻辑结构需要匹配。您还可以在上面的示例中看到,JsonPath表达式是如何用于测试或提取数据中的。
六、测试应用程序插件
Spring Boot的自动配置功能对配置应用程序所需要运行的一切是很有用的。
不幸的是,完整的自动配置有时候对于自动测试来说有点多余。
有时候你只是想为应用程序配置一个“插件”——Jackson配置正确吗?我的MVC控制器返回正确的状态代码吗?我的JPA查询运行吗?
使用Spring Boot 1.4这些常见的场景现在很容易被测试。我们也能很容易构建自己的注释,这个注释仅应用了你需要的自动配置classes。
七、测试JPA插件测试
您应用程序的JPA插件(Hibernate +Spring数据)可以使用@DataJpaTest注释。@DataJpaTest将会这样:
1、配置一个内存数据库。
2、自动配置Hibernate,Spring数据和数据源。
3、执行@EntityScan。
4、打开SQL日志记录。以下是一个典型的测试:@RunWith(SpringRunner.class)
@DataJpaTestpublic class UserRepositoryTests {
@Autowired
private TestEntityManager entityManager;
@Autowired private UserRepository repository;
@Test public void findByUsernameShouldReturnUser() { this.entityManager.persist(new User("sboot", "123"));
User user = this.repository.findByUsername("sboot"); assertThat(user.getUsername()).isEqualTo("sboot"); assertThat(user.getVin()).isEqualTo("123");
}
}以上实验中的TestEntityManager是由Spring Boot支持的。一个标准JPA EntityManager选择所提供的方法通常会在编写测试的过程中使用。
八、测试Spring MVC插件
你可以使用@WebMvcTest注解来测试应用程序的Spring MVC插件。
像这样:
1、自动配置Spring MVC、Jackson,Gson,消息转换器等。
2、加载相关的组件(@Controller, @RestController, @JsonComponent等)。
3、配置MockMVC。
下面是一个测试单个控制器的典型实例:@RunWith(SpringRunner.class)
@WebMvcTest(UserVehicleController.class)public class UserVehicleControllerTests {
@Autowired private MockMvc mvc;
@MockBean private UserVehicleService userVehicleService;
@Test public void getVehicleShouldReturnMakeAndModel() { given(this.userVehicleService.getVehicleDetails("sboot"))
.willReturn(new VehicleDetails("Honda", "Civic")); this.mvc.perform(get("/sboot/vehicle")
.accept(MediaType.TEXT_PLAIN))
.andExpect(status().isOk())
.andExpect(content().string("Honda Civic"));
}
}
如果你偏爱HtmlUnit,你可以是用WebClient 来代替 MockMvc。如果你更喜欢selenium,你可以切换到WebDriver。
九、测试JSON插件
如果你需要测试JSON 序列化是否如预期般运营,你可以使用 @JsonTest。
像这样:
1、自动配置Jackson和/或Gson。
2、添加你可以定义的任一模块或者 @JsonComonent beans。
3、触发任何JacksonTester或GsonTester字段的初始化。
以下是实例:
@RunWith(SpringRunner.class)
@JsonTestpublic class VehicleDetailsJsonTests {
private JacksonTesterjson;
@Test
public void serializeJson() {
VehicleDetails details = new VehicleDetails(
"Honda", "Civic");
assertThat(this.json.write(details))
.extractingJsonPathStringValue("@.make")
.isEqualTo("Honda");
}
}
总结
如果你想尝试Spring Boot 1.4中新的测试特性,你可以从http://repo.spring.io/snapshot/上抓取M2。还有一个GitHub上的示例项目以及更新的文档可以用。如果你有任何我们应该支持的,关于添加“插件”的建议或者改进,请提出及时提出。