# 前言

Web 开发是我们平时开发中至关重要的,这里就来介绍一下 Spring Boot 对 Web 开发的支持。

# 正文

Spring Boot 提供了 spring-boot-starter-web 为 Web 开发予以支持,spring-boot-starter-web 为我们提供了嵌入的 Tomcat 以及 Spring MVC 的依赖。

# 项目结构推荐

一个好的项目结构会让你开发少一些问题,特别是 Spring Boot 中启动类要放在 root package 下面,我的 web 工程项目结构如下:

root package 结构: com.dudu
应用启动类 Application.java 置于 root package 下,这样使用 @ComponentScan 注解的时候默认就扫描当前所在类的 package
实体(Entity)置于 com.dudu.domain 包下
逻辑层(Service)置于 com.dudu.service 包下
controller 层(web)置于 com.dudu.controller 层包下
static 可以用来存放静态资源
templates 用来存放默认的模板配置路径

# Spring Web MVC 框架介绍

Spring Web MVC 框架(通常简称为”Spring MVC”)是一个富” 模型,视图,控制器” 的 web 框架。
Spring MVC 允许你创建特定的 @Controller @RestController beans 来处理传入的 HTTP 请求。
示例:

@RestController
@RequestMapping(value="/users")
public class MyRestController {
    @RequestMapping(value="/{user}", method=RequestMethod.GET)
    public User getUser(@PathVariable Long user) {
        // ...
    }
    @RequestMapping(value="/{user}/customers", method=RequestMethod.GET)
    List<Customer> getUserCustomers(@PathVariable Long user) {
        // ...
    }
    @RequestMapping(value="/{user}", method=RequestMethod.DELETE)
    public User deleteUser(@PathVariable Long user) {
        // ...
    }
}

# Spring MVC 自动配置

Spring Boot 为 Spring MVC 提供适用于多数应用的自动配置功能。在 Spring 默认基础上,自动配置添加了以下特性:

  1. 引入 ContentNegotiatingViewResolver 和 BeanNameViewResolver beans。
  2. 对静态资源的支持,包括对 WebJars 的支持。
  3. 自动注册 Converter,GenericConverter,Formatter beans。
  4. 对 HttpMessageConverters 的支持。
  5. 自动注册 MessageCodeResolver。
  6. 对静态 index.html 的支持。
  7. 对自定义 Favicon 的支持。

如果想全面控制 Spring MVC,你可以添加自己的 @Configuration,并使用 @EnableWebMvc 对其注解。如果想保留 Spring Boot MVC 的特性,并只是添加其他的 MVC 配置 (拦截器,formatters,视图控制器等),你可以添加自己的 WebMvcConfigurerAdapter 类型的 @Bean(不使用 @EnableWebMvc 注解), 具体拦截器等配置后续文章会解析。

# 静态文件

默认情况下,Spring Boot 从 classpath 下一个叫 /static(/public,/resources 或 / META-INF/resources)的文件夹或从 ServletContext 根目录提供静态内容。这使用了 Spring MVC 的 ResourceHttpRequestHandler,所以你可以通过添加自己的 WebMvcConfigurerAdapter 并覆写 addResourceHandlers 方法来改变这个行为(加载静态文件)。

在一个单独的 web 应用中,容器默认的 servlet 是开启的,如果 Spring 决定不处理某些请求,默认的 servlet 作为一个回退(降级)将从 ServletContext 根目录加载内容。大多数时候,这不会发生(除非你修改默认的 MVC 配置),因为 Spring 总能够通过 DispatcherServlet 处理请求。

此外,上述标准的静态资源位置有个例外情况是 Webjars 内容。任何在 /webjars/** 路径下的资源都将从 jar 文件中提供,只要它们以 Webjars 的格式打包。

:如果你的应用将被打包成 jar,那就不要使用 src/main/webapp 文件夹。尽管该文件夹是一个共同的标准,但它仅在打包成 war 的情况下起作用,并且如果产生一个 jar,多数构建工具都会静悄悄的忽略它

# 模板引擎

Spring Boot 支持多种模版引擎包括:

  • FreeMarker
  • Groovy
  • Thymeleaf (官方推荐)
  • Mustache

JSP 技术 Spring Boot 官方是不推荐的,原因有三:

  1. tomcat 只支持 war 的打包方式,不支持可执行的 jar。
  2. Jetty 嵌套的容器不支持 jsp
  3. Undertow
  4. 创建自定义 error.jsp 页面不会覆盖错误处理的默认视图,而应该使用自定义错误页面

当你使用上述模板引擎中的任何一个,它们默认的模板配置路径为: src/main/resources/templates 。当然也可以修改这个路径,具体如何修改,可在后续各模板引擎的配置属性中查询并修改。

# Thymeleaf 模板引擎

Thymeleaf 是一款用于渲染 XML/XHTML/HTML5 内容的模板引擎。类似 JSP,Velocity,FreeMaker 等,它也可以轻易的与 Spring MVC 等 Web 框架进行集成作为 Web 应用的模板引擎。与其它模板引擎相比,Thymeleaf 最大的特点是能够直接在浏览器中打开并正确显示模板页面,而不需要启动整个 Web 应用。它的功能特性如下:

  • Spring MVC 中 @Controller 中的方法可以直接返回模板名称,接下来 Thymeleaf 模板引擎会自动进行渲染
  • 模板中的表达式支持 Spring 表达式语言(Spring EL)
  • 表单支持,并兼容 Spring MVC 的数据绑定与验证机制
  • 国际化支持

Spring 官方也推荐使用 Thymeleaf, 所以本篇代码整合就使用 Thymeleaf 来整合。

# 引入依赖

<dependency>
    <groupId>org.springframework.boot</groupId>
    <artifactId>spring-boot-starter-thymeleaf</artifactId>
</dependency>


如图所示,spring-boot-starter-thymeleaf 会自动包含 spring-boot-starter-web,所以我们就不需要单独引入 web 依赖了。

# 编写 controller

@Controller
@RequestMapping("/learn")
public class LearnResourceController {
    @RequestMapping("/")
    public ModelAndView index(){
        List<LearnResouce> learnList =new ArrayList<LearnResouce>();
        LearnResouce bean =new LearnResouce("官方参考文档","Spring Boot Reference Guide","http://docs.spring.io/spring-boot/docs/1.5.1.RELEASE/reference/htmlsingle/#getting-started-first-application");
        learnList.add(bean);
        bean =new LearnResouce("官方SpriongBoot例子","官方SpriongBoot例子","https://github.com/spring-projects/spring-boot/tree/master/spring-boot-samples");
        learnList.add(bean);
        bean =new LearnResouce("龙国学院","Spring Boot 教程系列学习","http://www.roncoo.com/article/detail/125488");
        learnList.add(bean);
        bean =new LearnResouce("嘟嘟MD独立博客","Spring Boot干货系列 ","http://tengj.top/");
        learnList.add(bean);
        bean =new LearnResouce("后端编程嘟","Spring Boot教程和视频 ","http://www.toutiao.com/m1559096720023553/");
        learnList.add(bean);
        bean =new LearnResouce("程序猿DD","Spring Boot系列","http://www.roncoo.com/article/detail/125488");
        learnList.add(bean);
        bean =new LearnResouce("纯洁的微笑","Sping Boot系列文章","http://www.ityouknow.com/spring-boot");
        learnList.add(bean);
        bean =new LearnResouce("CSDN——小当博客专栏","Sping Boot学习","http://blog.csdn.net/column/details/spring-boot.html");
        learnList.add(bean);
        bean =new LearnResouce("梁桂钊的博客","Spring Boot 揭秘与实战","http://blog.csdn.net/column/details/spring-boot.html");
        learnList.add(bean);
        bean =new LearnResouce("林祥纤博客系列","从零开始学Spring Boot ","http://412887952-qq-com.iteye.com/category/356333");
        learnList.add(bean);
        ModelAndView modelAndView = new ModelAndView("/index");
        modelAndView.addObject("learnList", learnList);
        return modelAndView;
    }
}

# 编写 html

引入依赖后就在默认的模板路径 src/main/resources/templates 下编写模板文件即可完成。这里我们新建一个 index.html:

<!DOCTYPE html>
<html xmlns:th="http://www.thymeleaf.org">
<head>
    <title>learn Resources</title>
    <meta http-equiv="Content-Type" content="text/html; charset=UTF-8" />
</head>
<body>
<div style="text-align: center;margin:0 auto;width: 1000px; ">
<h1>学习资源大奉送,爱我就关注嘟嘟公众号:嘟爷java超神学堂(javaLearn)</h1>
<table width="100%" border="1" cellspacing="1" cellpadding="0">
    <tr>
        <td>作者</td>
        <td>教程名称</td>
        <td>地址</td>
    </tr>
    <!--/*@thymesVar id="learnList" type=""*/-->
    <tr th:each="learn : ${learnList}">
        <td th:text="${learn.author}">嘟嘟MD</td>
        <td th:text="${learn.title}">SPringBoot干货系列</td>
        <td><a th:href="${learn.url}" target="_blank">点我</a></td>
    </tr>
</table>
</div>
</body>
</html>

注:通过 xmlns:th=”http://www.thymeleaf.org“命令空间,将静态页面转换为动态的视图,需要进行动态处理的元素将使用 “th:” 前缀。
ok, 代码都写好了,让我们看对比下直接打开 index.html 和启动工程后访问 http://localhost:8080/learn 看到的效果,Thymeleaf 做到了不破坏 HTML 自身内容的数据逻辑分离。

# Thymeleaf 的默认参数配置

在 application.properties 中可以配置 thymeleaf 模板解析器属性

# THYMELEAF (ThymeleafAutoConfiguration)
#开启模板缓存(默认值:true
spring.thymeleaf.cache=true 
#Check that the template exists before rendering it.
spring.thymeleaf.check-template=true 
#检查模板位置是否正确(默认值:true
spring.thymeleaf.check-template-location=true
#Content-Type的值(默认值:text/html)
spring.thymeleaf.content-type=text/html
#开启MVC Thymeleaf视图解析(默认值:true
spring.thymeleaf.enabled=true
#模板编码
spring.thymeleaf.encoding=UTF-8
#要被排除在解析之外的视图名称列表,用逗号分隔
spring.thymeleaf.excluded-view-names=
#要运用于模板之上的模板模式。另见StandardTemplate-ModeHandlers(默认值:HTML5)
spring.thymeleaf.mode=HTML5
#在构建URL时添加到视图名称前的前缀(默认值:classpath:/templates/
spring.thymeleaf.prefix=classpath:/templates/
#在构建URL时添加到视图名称后的后缀(默认值:.html)
spring.thymeleaf.suffix=.html
#Thymeleaf模板解析器在解析器链中的顺序。默认情况下,它排第一位。顺序从1开始,只有在定义了额外的TemplateResolver Bean时才需要设置这个属性。
spring.thymeleaf.template-resolver-order=
#可解析的视图名称列表,用逗号分隔
spring.thymeleaf.view-names=

# 整合一个 bootstrap 框架给大家

大家可以直接打开 vanilla-cream-css 下面的 index.html 来查看静态效果,如下:

动态效果的话可以查看 template.html
这里把上面的资源例子重新用 bootstrap 写了下,效果不错哦,如下:

# 总结

本章到此就结束了,下一篇准备介绍下如何整合 jsp, 毕竟现在绝大多数的企业还是用 jsp 来作为模板引擎的。

想要查看更多 Spring Boot 干货教程,可前往:Post not found: Spring Boot干货系列总纲

# 源码下载

( ̄︶ ̄)↗[相关示例完整代码]