一步步学习 《Spring 实战 第5版》--（5）创建一个初步的Web程序

前面我们的对Spring的基本概念有了了解，也建立了一个基本的Spring boot应用程序。但这个程序还没有实现网页功能，这章将添加一个主页。

添加一个主页需要网页和控制器。主页用于显示，一般采用视图模板来定义。控制器用于将用户的请求定位到相应的视图，或者做其他的事情。

同时，我们还将完成一个简单的测试类，来测试控制器能否正常工作。

一、处理Web请求

控制功能是通过Spring提供的强大的Web框架实现的，这个框架就是Spring MVC。Spring MVC提供的控制器的功能，能够对用户请求做出恰当的响应，比如调用登录功能、展现新的页面等等，并将请求传递给一个视图，生成一个HTML页面，返回给浏览器。

现在我们编写一个最简单的控制器，处理跟路径的请求（“/”），并根据这个请求，返回Home页面。程序如下：

创建controller.png

类上的@Controller注解表面这个类是个控制组件，这样Spring 组件扫描时就能扫描到它。其他的注解，例如@Component、@Service、@Repository等，都能实现这个功能，这里使用@Controller注解，主要原因是更容易让人理解这个类的功能。

方法上的@GetMapping注解，表明如果有了一个针对“/”的HTTP GET请求，那么就由home()这个方法来处理。此时home()方法会返回一个“home”字符串。

这个“home”会被Spring MVC框架解析为视图的逻辑名，然后将对应的视图返回给浏览器。

二、定义视图

为了简单起见，这里采用了Thymeleaf模板引擎。在resources/templates/ 下增加home.html文件。我们已经在pom.xml文件中添加了Thymeleaf依赖。home代码如下：

home网页代码.png

这里的内使用了Thymeleaf标签。使用了th:src属性和@{...}表达式，用于引用路径中的图片。

Spring的静态资源默认是放在"/src/main/resources/static/"下的，因此这个图片也是放在"/src/main/resources/static/images/TacoCloud.png"下。

至此，基于Spring MVC的控制器和 视图都已编写完成。接下来还有一个重要的工作，编写测试。

三、编写测试控制器

Spring boot对Web测试提供了强大的支持，能够模拟浏览器对控制器发起请求，这使得测试Web页面变得十分简单。

我们此时需要测试的是，模拟浏览器向控制器发送一个“/”请求，确认返回的视图名称是home，并且返回内容包含 “Welcome to...”。

在test目录下创建一个HomeControllerTest类。代码如下。

創建測試.png

@RunWith注解是一个JUnit注解，它会提供一个测试运行器来使得JUnit运行测试。这个测试运行器有Spring提供，后面的SpringRunner指明了这一点。

@WebMvcTest注解会让应用在SpringMVC提供的上下文中执行，将HomeController注册到SpringMVC中。

运行这个测试程序不用启动服务器来进行测试，@WebMvcTest会提供一个模拟的环境来执行测试。MockMvc就是这个模拟器。通过模拟，可以使测试脱离具体的服务器，使测试执行起来更快，可靠性更高。

具体的测试内容从代码中显而易见。我们通过模拟器执行了一个根目录下的请求。那么要测试服务器对这个请求响应应该返回OK状态，视图的逻辑名称应该是home，视图应该包括文本“Welcom”等等。

如果其中有一个条件不符，那么测试就会失败。我们现在看看测试通过时的状态。

测试结论.png

四、结论

本章我们为自动生成的SpringBoot框架下程序增加了控制器、视图和测试代码，测试代码运行正确。下一章我们将具体运行这个应用，并感受一下Spring Boot DevTools开发工具的实际功能。