文章目录* 1. WebMvcTest概述* 2. 创建Spring Boot项目* 3. 创建主页控制器类* 4. 准备图片素材* 5. 创建主页模板视图* 6. 主页控制器测试类* * 6.1 创建主页控制器测试类 * 6.2 运行单元测试方法* 7. 启动应用查看结果* * 7.1 启动应用 * 7.2 访问项目首页* 8. 实战小结1. WebMvcTest概述-----------------* 在 Spring MVC 应用的测试领域WebMvcTest注解发挥着极为关键的作用。它为测试提供了专门定制的 Spring 环境支持使得开发者能够在无需完整启动应用服务器的情况下对 Spring MVC 的核心功能进行精准测试。 * 传统的测试方式可能需要启动整个服务器来验证功能这种做法在某些场景下显得笨重且效率低下。而WebMvcTest则不同它专注于 Spring MVC 相关的组件例如控制器Controller等。通过注入 MockMvc 实例测试类能够轻松地模拟 Spring MVC 的运行机制。 * MockMvc 为测试带来了极大的便利性。它允许开发者编写测试用例来模拟 HTTP 请求的发送与接收就如同在真实的浏览器与服务器交互环境中一样。例如可以轻松地模拟 GET、POST 等各种 HTTP 方法的请求并且对控制器返回的结果进行断言验证。这意味着能够快速地检查控制器中的业务逻辑是否正确比如验证数据是否被正确处理、视图是否正确返回等。 * 在实际应用场景中假设我们正在开发一个电商系统的商品控制器。使用WebMvcTest注解的测试类可以注入 MockMvc并针对商品的查询、添加、修改等操作编写详细的测试用例。如模拟一个查询商品列表的 GET 请求然后验证返回的商品数据是否符合预期包括商品的名称、价格、库存等信息是否准确无误。如果没有WebMvcTest提供的这种简洁高效的测试机制开发者可能需要花费大量精力启动整个电商应用服务器进行复杂的端到端测试这不仅耗时而且在开发初期可能由于其他模块尚未完善而难以开展。 * 综上所述WebMvcTest注解在 Spring MVC 应用测试中具有不可替代的地位。它通过巧妙地注入 MockMvc以轻量级的方式模拟 Spring MVC 运行机制极大地提高了测试效率让开发者能够更加专注于控制器层逻辑的正确性验证从而加速整个 Spring MVC 应用的开发与完善进程。 2. 创建Spring Boot项目-------------------* 设置项目基本信息* 选择Spring Boot版本添加项目依赖* 单击【Create】按钮生成项目基本骨架3. 创建主页控制器类------------* 在net.huawei.tacocloud包里创建controller子包* 在controller子包里创建HomeController类package net.huawei.tacocloud.controller; /** * 功能主页控制器 * 作者华卫 * 日期2024年12月02日/ import org.springframework.stereotype.Controller; import org.springframework.web.bind.annotation.GetMapping; Controller // 控制器注解 public class HomeController { GetMapping(“/”) // 处理对根路径“/ ”的请求 public String home() { return “home”; // 返回逻辑视图名 } } * 可以看到这个类带有Controller注解。就其本身而言Controller并没有做太多的事情。它的主要目的是让组件扫描将这个类识别为一个组件。因为HomeController带有Controller注解所以Spring的组件扫描功能会自动发现它并创建一个HomeController实例作为Spring应用上下文中的bean。实际上有一些其他的注解与Controller有着类似的目的包括Component、Service和Repository。你可以为HomeController添加上述的任意其他注解其作用是完全相同的。但是在这里选择使用Controller更能描述这个组件在应用中的角色。*home()是一个简单的控制器方法。它带有GetMapping注解表明如果针对“/”发送HTTP GET请求那么将会由这个方法来处理请求。该方法所做的只是返回String类型的home值。* 这个值将会解析为视图的逻辑名。视图如何实现取决于多个因素但是Thymeleaf位于类路径中使得我们可以使用Thymeleaf来定义模板。4. 准备图片素材----------* 在static里创建images目录* 将图片TacoCloud.png拷贝到images目录5. 创建主页模板视图------------* 在templates里创建home.html文件Taco Cloud HomeWelcome to Taco Cloud* 这个模板并没有太多需要讨论的。唯一需要注意的是用于展现Taco Cloud Logo的img标签。它使用了Thymeleaf的th:src属性和{...}表达式以便于引用相对于上下文路径的图片。除此之外这个主页就是一个扮演“Hello World”角色的页面。6. 主页控制器测试类------------### 6.1 创建主页控制器测试类* 在testjava的net.huawei.tacocloud包里创建HomeControllerTest类package net.huawei.tacocloud; import net.huawei.tacocloud.controller.HomeController; import org.junit.jupiter.api.Test; import org.springframework.beans.factory.annotation.Autowired; import org.springframework.boot.test.autoconfigure.web.servlet.WebMvcTest; import org.springframework.test.web.servlet.MockMvc; import static org.hamcrest.Matchers.containsString; import static org.springframework.test.web.servlet.request.MockMvcRequestBuilders.get; import static org.springframework.test.web.servlet.result.MockMvcResultMatchers.; /** * 功能主页控制器测试类 * 作者华卫 * 日期2024年12月02日/ WebMvcTest(HomeController.class) //针对HomeController的Web测试 public class HomeControllerTest { Autowired private MockMvc mockMvc; // 注入MockMvc Test public void testHomePage() throws Exception { mockMvc.perform(get(“/”)) // 发起对“/”的GET请求 .andExpect(status().isOk()) // 期望得到HTTP 200 .andExpect(view().name(“home”)) // 期望得到home视图 .andExpect(content().string(containsString(“Welcome to Taco Cloud”))); // 期望包含“Welcome to Taco Cloud” } } * 对于这个测试首先注意到的可能就是它使用了与TacoCloudApplicationTests类不同的注解。HomeControllerTest没有使用SpringBootTest标记而是添加了WebMvcTest注解。这是Spring Boot提供的一个特殊测试注解让这个测试在Spring MVC应用的上下文中执行。更具体来讲在本例中它会将HomeController注册到Spring MVC中这样一来我们就可以向它发送请求了。WebMvcTest同样会为测试Spring MVC应用提供了Spring环境的支持。尽管可以启动一个服务器来进行测试但是对于我们的场景来说仿造一下Spring MVC的运行机制就可以。测试类被注入了一个MockMvc能够让测试实现mockup。通过testHomePage()方法我们定义了针对主页想要执行的测试。它首先使用MockMvc对象对“/”根路径发起HTTP GET请求。对于这个请求我们设置了如下的预期 * 响应应该具备HTTP 200 (OK)状态 * 视图的逻辑名称应该是home* 渲染后的视图应该包含文本Welcome to Taco Cloud### 6.2 运行单元测试方法* 运行testHomePage()测试方法查看结果* 如果在MockMvc对象发送请求之后上述预期没有全部满足那么这个测试会失败。但是我们的控制器和视图模板在编写时都满足了这些预期所以测试应该能够通过并且带有成功的图标——至少能够看到一些绿色的背景表明测试通过了。* 解决Mockito警告Mockito is currently self-attaching to enable the inline-mock-maker. This will no longer work in future releases of the JDK. Please add Mockito as an agent to your build what is described in Mockito’s documentation: https://javadoc.io/doc/org.mockito/mockito-core/latest/org/mockito/Mockito.html#0.3* Mockito 目前使用 Java Agent 来启用其内联模拟制造器。在未来的 JDK 版本中这种动态附加可能不再工作。为了解决这个问题你需要按照 Mockito 的文档配置 Mockito 作为构建过程中的 Agent。根据 Mockito 的文档在Maven构建配置中添加插件。org.apache.maven.plugins maven-surefire-plugin 3.5.2 -javaagent:“${settings.localRepository}/org/mockito/mockito-core/5.14.2/mockito-core-5.14.2.jar” * 再次运行testHomePage()测试方法查看结果7. 启动应用查看结果-------------### 7.1 启动应用* 运行引导类TacoCloudApplication### 7.2 访问项目首页* 访问http://localhost:80808. 实战小结--------* 在本次实战中我们深入探讨了Spring Boot项目中WebMvcTest注解的应用它允许开发者在不启动整个服务器的情况下高效测试Spring MVC组件。通过逐步指导我们创建了Spring Boot项目编写了主页控制器和测试类并通过MockMvc进行了单元测试。此外解决了Mockito的Java Agent警告确保了测试的顺利进行。最终我们成功启动应用并验证了测试结果展示了WebMvcTest在提升测试效率和专注业务逻辑验证方面的重要性。
文章目录* 1. WebMvcTest概述* 2. 创建Spring Boot项目* 3. 创建主页控制器类* 4. 准备图片素材* 5. 创建主页模板视图* 6. 主页控制器测试类* * 6.1 创建主页控制器测试类 * 6.2 运行单元测试方法* 7. 启动应用查看结果* * 7.1 启动应用 * 7.2 访问项目首页* 8. 实战小结1. WebMvcTest概述-----------------* 在 Spring MVC 应用的测试领域WebMvcTest注解发挥着极为关键的作用。它为测试提供了专门定制的 Spring 环境支持使得开发者能够在无需完整启动应用服务器的情况下对 Spring MVC 的核心功能进行精准测试。 * 传统的测试方式可能需要启动整个服务器来验证功能这种做法在某些场景下显得笨重且效率低下。而WebMvcTest则不同它专注于 Spring MVC 相关的组件例如控制器Controller等。通过注入 MockMvc 实例测试类能够轻松地模拟 Spring MVC 的运行机制。 * MockMvc 为测试带来了极大的便利性。它允许开发者编写测试用例来模拟 HTTP 请求的发送与接收就如同在真实的浏览器与服务器交互环境中一样。例如可以轻松地模拟 GET、POST 等各种 HTTP 方法的请求并且对控制器返回的结果进行断言验证。这意味着能够快速地检查控制器中的业务逻辑是否正确比如验证数据是否被正确处理、视图是否正确返回等。 * 在实际应用场景中假设我们正在开发一个电商系统的商品控制器。使用WebMvcTest注解的测试类可以注入 MockMvc并针对商品的查询、添加、修改等操作编写详细的测试用例。如模拟一个查询商品列表的 GET 请求然后验证返回的商品数据是否符合预期包括商品的名称、价格、库存等信息是否准确无误。如果没有WebMvcTest提供的这种简洁高效的测试机制开发者可能需要花费大量精力启动整个电商应用服务器进行复杂的端到端测试这不仅耗时而且在开发初期可能由于其他模块尚未完善而难以开展。 * 综上所述WebMvcTest注解在 Spring MVC 应用测试中具有不可替代的地位。它通过巧妙地注入 MockMvc以轻量级的方式模拟 Spring MVC 运行机制极大地提高了测试效率让开发者能够更加专注于控制器层逻辑的正确性验证从而加速整个 Spring MVC 应用的开发与完善进程。 2. 创建Spring Boot项目-------------------* 设置项目基本信息* 选择Spring Boot版本添加项目依赖* 单击【Create】按钮生成项目基本骨架3. 创建主页控制器类------------* 在net.huawei.tacocloud包里创建controller子包* 在controller子包里创建HomeController类package net.huawei.tacocloud.controller; /** * 功能主页控制器 * 作者华卫 * 日期2024年12月02日/ import org.springframework.stereotype.Controller; import org.springframework.web.bind.annotation.GetMapping; Controller // 控制器注解 public class HomeController { GetMapping(“/”) // 处理对根路径“/ ”的请求 public String home() { return “home”; // 返回逻辑视图名 } } * 可以看到这个类带有Controller注解。就其本身而言Controller并没有做太多的事情。它的主要目的是让组件扫描将这个类识别为一个组件。因为HomeController带有Controller注解所以Spring的组件扫描功能会自动发现它并创建一个HomeController实例作为Spring应用上下文中的bean。实际上有一些其他的注解与Controller有着类似的目的包括Component、Service和Repository。你可以为HomeController添加上述的任意其他注解其作用是完全相同的。但是在这里选择使用Controller更能描述这个组件在应用中的角色。*home()是一个简单的控制器方法。它带有GetMapping注解表明如果针对“/”发送HTTP GET请求那么将会由这个方法来处理请求。该方法所做的只是返回String类型的home值。* 这个值将会解析为视图的逻辑名。视图如何实现取决于多个因素但是Thymeleaf位于类路径中使得我们可以使用Thymeleaf来定义模板。4. 准备图片素材----------* 在static里创建images目录* 将图片TacoCloud.png拷贝到images目录5. 创建主页模板视图------------* 在templates里创建home.html文件Taco Cloud HomeWelcome to Taco Cloud* 这个模板并没有太多需要讨论的。唯一需要注意的是用于展现Taco Cloud Logo的img标签。它使用了Thymeleaf的th:src属性和{...}表达式以便于引用相对于上下文路径的图片。除此之外这个主页就是一个扮演“Hello World”角色的页面。6. 主页控制器测试类------------### 6.1 创建主页控制器测试类* 在testjava的net.huawei.tacocloud包里创建HomeControllerTest类package net.huawei.tacocloud; import net.huawei.tacocloud.controller.HomeController; import org.junit.jupiter.api.Test; import org.springframework.beans.factory.annotation.Autowired; import org.springframework.boot.test.autoconfigure.web.servlet.WebMvcTest; import org.springframework.test.web.servlet.MockMvc; import static org.hamcrest.Matchers.containsString; import static org.springframework.test.web.servlet.request.MockMvcRequestBuilders.get; import static org.springframework.test.web.servlet.result.MockMvcResultMatchers.; /** * 功能主页控制器测试类 * 作者华卫 * 日期2024年12月02日/ WebMvcTest(HomeController.class) //针对HomeController的Web测试 public class HomeControllerTest { Autowired private MockMvc mockMvc; // 注入MockMvc Test public void testHomePage() throws Exception { mockMvc.perform(get(“/”)) // 发起对“/”的GET请求 .andExpect(status().isOk()) // 期望得到HTTP 200 .andExpect(view().name(“home”)) // 期望得到home视图 .andExpect(content().string(containsString(“Welcome to Taco Cloud”))); // 期望包含“Welcome to Taco Cloud” } } * 对于这个测试首先注意到的可能就是它使用了与TacoCloudApplicationTests类不同的注解。HomeControllerTest没有使用SpringBootTest标记而是添加了WebMvcTest注解。这是Spring Boot提供的一个特殊测试注解让这个测试在Spring MVC应用的上下文中执行。更具体来讲在本例中它会将HomeController注册到Spring MVC中这样一来我们就可以向它发送请求了。WebMvcTest同样会为测试Spring MVC应用提供了Spring环境的支持。尽管可以启动一个服务器来进行测试但是对于我们的场景来说仿造一下Spring MVC的运行机制就可以。测试类被注入了一个MockMvc能够让测试实现mockup。通过testHomePage()方法我们定义了针对主页想要执行的测试。它首先使用MockMvc对象对“/”根路径发起HTTP GET请求。对于这个请求我们设置了如下的预期 * 响应应该具备HTTP 200 (OK)状态 * 视图的逻辑名称应该是home* 渲染后的视图应该包含文本Welcome to Taco Cloud### 6.2 运行单元测试方法* 运行testHomePage()测试方法查看结果* 如果在MockMvc对象发送请求之后上述预期没有全部满足那么这个测试会失败。但是我们的控制器和视图模板在编写时都满足了这些预期所以测试应该能够通过并且带有成功的图标——至少能够看到一些绿色的背景表明测试通过了。* 解决Mockito警告Mockito is currently self-attaching to enable the inline-mock-maker. This will no longer work in future releases of the JDK. Please add Mockito as an agent to your build what is described in Mockito’s documentation: https://javadoc.io/doc/org.mockito/mockito-core/latest/org/mockito/Mockito.html#0.3* Mockito 目前使用 Java Agent 来启用其内联模拟制造器。在未来的 JDK 版本中这种动态附加可能不再工作。为了解决这个问题你需要按照 Mockito 的文档配置 Mockito 作为构建过程中的 Agent。根据 Mockito 的文档在Maven构建配置中添加插件。org.apache.maven.plugins maven-surefire-plugin 3.5.2 -javaagent:“${settings.localRepository}/org/mockito/mockito-core/5.14.2/mockito-core-5.14.2.jar” * 再次运行testHomePage()测试方法查看结果7. 启动应用查看结果-------------### 7.1 启动应用* 运行引导类TacoCloudApplication### 7.2 访问项目首页* 访问http://localhost:80808. 实战小结--------* 在本次实战中我们深入探讨了Spring Boot项目中WebMvcTest注解的应用它允许开发者在不启动整个服务器的情况下高效测试Spring MVC组件。通过逐步指导我们创建了Spring Boot项目编写了主页控制器和测试类并通过MockMvc进行了单元测试。此外解决了Mockito的Java Agent警告确保了测试的顺利进行。最终我们成功启动应用并验证了测试结果展示了WebMvcTest在提升测试效率和专注业务逻辑验证方面的重要性。
![[光学原理与应用-521]：对光的错误理解与纠偏](http://pic.xiahunao.cn/yaotu/[光学原理与应用-521]：对光的错误理解与纠偏)
