做一个Spring Boot小例子-阿里云开发者社区

在我的《Spring Boot 框架介绍和使用》里介绍了Spring Boot，但是没有例子。所以这一篇的主要内容就是来做一个小例子。结合我上面那篇一起看效果更佳。

运行项目

创建项目和上篇文章一样，我用了2.0的快照版本的Spring Boot，因为现版本1.5的Thymeleaf还是2.1的版本，比较旧。在Idea中运行Spring Boot项目不如Spring Tool Suite简单，因为在STS中直接保存文件即可触发devtools的重启，而在IDEA中只能手动点击build project命令。

在这里还遇到一点小情况。我原来不明白IDEA中有一个delegate to gradle有什么作用，就胡乱选上了。现在才发现，原来选中这个选项之后，在点击构建项目的时候不会调用IDEA自己的构建工具，而是使用gradle的构建。所以速度会更慢。如果使用IDEA的构建命令，速度会更快一些。

当然这样感觉还是稍微比STS慢一点。所以我又找到了另外一种方法，就是利用gradle的持续构建选项。首先打开一个终端，输入gradle assemble --continuous，这样gradle就会一直编译项目。如果检测到文件发生更改，就会自动重复编译项目，直到我们手动关闭了终端。然后在用gradle bootRun命令正常调试运行项目，当文件发生更改的时候gradle会自动编译项目，从而触发devtools自动重启服务器。

Spring Boot项目在运行的时候支持LiveReload，我们只要在浏览器上安装相应的插件并启用，服务器自动重启之后便会自动刷新浏览器。我们不必每次更改之后手动刷新了。

MVC

多个视图解析器

在Spring Boot中，错误页面可以放在下面的文件夹下。在使用Thymeleaf的时候，情况就变的稍微有点复杂了。

src/
 +- main/
     +- java/
     |   + <source code>
     +- resources/
         +- templates/
             +- error/
             |   +- 404.html
             +- <other templates>

我们希望将重复的模板代码抽出来组合成单独的文件，让其他页面引用。这样以后修改的时候只需要修改一处就可以更改所有页面的效果。但是Thymeleaf默认的代码块导入只能支持同级页面，像下面这样错误页面在单独一个文件夹、公用页面也在单独一个文件夹下的情况，默认的配置不能满足我们的需要。这时候就需要覆盖Spring Boot的自动配置了。

多层试图文件夹

经过一番查阅，我找到了解决办法。这种情况下需要配置的多个视图解析器。在Spring Boot中很简单，我们只需要定义自己的视图解析器，Spring就会自动屏蔽默认配置的。

配置代码如下。我们为代码段单独配置一个视图解析器。然后将这些视图解析器都添加到视图引擎中。这些必须都配置为Spring Bean。如果直接在templateEngine()中new视图解析器并添加，就会抛出ApplicationContext为空的异常。

最后要注意setCheckExistence方法也必须设置。不然的话视图解析器就会认为视图总是存在，所以渲染页面的时候会出现找不到视图文件的情况。所以设置了这个选项，解析器就会先检查文件是否存在，不存在的话就直接返回。这样另一个视图解析器就会寻找视图，最后我们两个文件夹下的视图就可以都找到了。

@Configuration
public class TemplateConfig {
    private boolean cacheable = false;
    private String templatesPrefix = "classpath:templates/";
    private String fragmentsPrefix = "classpath:templates/fragments/";
    private String suffix = ".html";
    private TemplateMode templateMode = TemplateMode.HTML;
    private String encoding = "UTF-8";
    private boolean checkExistence = true;

    @Bean
    public SpringResourceTemplateResolver templateResolver() {
        SpringResourceTemplateResolver resolver = new SpringResourceTemplateResolver();
        resolver.setPrefix(templatesPrefix);
        resolver.setSuffix(suffix);
        resolver.setCharacterEncoding(encoding);
        resolver.setCacheable(cacheable);
        resolver.setCheckExistence(checkExistence);
        return resolver;
    }

    @Bean
    public SpringResourceTemplateResolver fragmentResolver() {
        SpringResourceTemplateResolver fragmentResolver = new SpringResourceTemplateResolver();
        fragmentResolver.setPrefix(fragmentsPrefix);
        fragmentResolver.setSuffix(suffix);
        fragmentResolver.setCacheable(cacheable);
        fragmentResolver.setTemplateMode(templateMode);
        fragmentResolver.setCharacterEncoding(encoding);
        fragmentResolver.setCheckExistence(checkExistence);
        return fragmentResolver;
    }

    @Bean
    public SpringTemplateEngine templateEngine() {
        SpringTemplateEngine templateEngine = new SpringTemplateEngine();
        templateEngine.addTemplateResolver(templateResolver());
        templateEngine.addTemplateResolver(fragmentResolver());
        templateEngine.setEnableSpringELCompiler(true);
        templateEngine.addDialect(new Java8TimeDialect());
        return templateEngine;
    }
}

MVC配置

spring自动配置的MVC基本够最基本的使用了，但是在做项目的话肯定要添加自己的配置。我们用Java配置的话也很简单。下面的例子很简单，添加了几个视图控制器，直接将请求和视图连在一起；还定义了两个格式化器。不知道为何Spring没有对这些新日期类的支持，所以我们只能自己写格式化器了。

如果我们只需要向下面添加几个自己的格式化器之类的，向下面这样继承WebMvcConfigurerAdapter即可。如果想完全控制Mvc的设置，可以添加@EnableMvc，这样Spring Boot的自动配置就会完全取消。

在此叨叨两句，如果是旧项目的话就算了。如果使用新项目的话我们在处理日期和时间的时候务必使用Java 8提供的新类，LocalDate、LocalDateTime这些，这些新类符合新标准，提供的新方法也更好用。

@Configuration
public class WebMvcConfig extends WebMvcConfigurerAdapter {
    @Override
    public void addViewControllers(ViewControllerRegistry registry) {
        registry.addViewController("/system-beans").setViewName("beans");
        registry.addViewController("/addUser").setViewName("addUser");
        registry.addViewController("/mvc").setViewName("mvc");
    }

    @Override
    public void addFormatters(FormatterRegistry registry) {
        registry.addFormatter(new LocalDateFormatter());
        registry.addFormatter(new LocalDateTimeFormatter());
    }
}

class LocalDateFormatter implements Formatter<LocalDate> {

    @Override
    public LocalDate parse(String text, Locale locale) throws ParseException {
        return LocalDate.parse(text);
    }

    @Override
    public String print(LocalDate object, Locale locale) {
        return object.toString();
    }
}

class LocalDateTimeFormatter implements Formatter<LocalDateTime> {

    @Override
    public LocalDateTime parse(String text, Locale locale) throws ParseException {
        return LocalDateTime.parse(text, DateTimeFormatter.ofPattern("yyyy-MM-dd HH:mm:ss"));
    }

    @Override
    public String print(LocalDateTime object, Locale locale) {
        DateTimeFormatter formatter = DateTimeFormatter.ofPattern("yyyy-MM-dd HH:mm:ss");
        return object.format(formatter);

    }
}

Spring Data

多数据源

在开发的时候我们一般有测试数据库和生产数据库，在测试的时候连接到测试数据库，部署的时候改为生产数据库。所以我们这里首先来配置一下多数据源。

在application-test.properties中。其实这里什么也不写也可以，Spring 检测到H2 、HSQLDB或Derby的话就会自动创建一个内存嵌入式数据源。

# 数据库设置
spring.datasource.driver-class-name=org.h2.Driver
spring.datasource.url=jdbc:h2:mem:test
spring.datasource.username=sa

在application-product.properties中，生产数据库为MySQL。

# 数据库设置
spring.datasource.username=root
spring.datasource.password=12345678
spring.datasource.url=jdbc:mysql://localhost:3306/test
spring.datasource.driver-class-name=com.mysql.jdbc.Driver

然后在application.properties中，激活配置即可。以后开发完成之后，改为product即可。

spring.profiles.active=test

使用Hikari连接池

Spring Boot会按照tomcat、HikariCP、DBCP2的顺序查找和使用连接池。不过我看了一下好像HikariCP的性能最好，所以这里我们直接使用HikariCP。

首先需要添加HikariCP的依赖。Spring Boot也包含了对HikariCP的版本号管理，不过它的版本比较低一点，所以我就干脆直接指定了最新的。

compile group: 'com.zaxxer', name: 'HikariCP', version: '2.6.1'

然后添加spring.datasource.type=com.zaxxer.hikari.HikariDataSource即可。

H2 web控制台

如果嵌入式数据库选择了H2，而且项目中添加了spring-boot-devtools。那么Spring还会启用H2的web控制台功能。

如果不需要这个功能可以直接关闭。

spring.h2.console.enabled=false

启用审计

最后我希望使用Spring Data的审计功能来帮我设置用户的注册时间。但是审计不是Spring Boot自动配置的内容。所以我们需要手动开启。

@Configuration
@EnableJpaAuditing
public class JpaConfig {
}

然后在实体类上添加EntityListeners注解。

@Entity
@EntityListeners(AuditingEntityListener.class)
public class User {
    @Id
    @GeneratedValue(strategy = GenerationType.IDENTITY)
    private int id;
    @Column(nullable = false, unique = true)
    private String username;
    @Column(nullable = false)
    private String password;
    @Column
    private String nickname;
    @Column
    private LocalDate birthday;
    @Column
    @CreatedDate
    private LocalDateTime registerTime;
}

这样，当我们处理数据的时候，注册时间就会由Spring自动填充了。

@Transactional
public interface UserRepository extends CrudRepository<User, Integer> {
    Optional<User> findByUsername(String username);
}

Actuator

在项目中添加Actuator的依赖项即可。这样Spring就会自动添加相关的路径映射。

compile("org.springframework.boot:spring-boot-starter-actuator")

为了保证安全，这些都需要验证才能访问。我们可以简单的关闭它，management.security.enabled=false。不过为了安全起见，实际开发中应该设置密码来保护这些敏感信息。

Beans可视化

本来我想将这些端点全做成可视化的，不过看了一些，大部分端点返回来的JSON都比较复杂，是个多层结构，所以最后只做了一个Beans的可视化。推荐一个Chrome插件，json-formatter。安装好之后，在查看这些端点的JSON，就不是糊成一团的了，而是格式化并且语法高亮的形式了。

Beans端点返回的JSON稍微有些奇怪，它是个类似下面这样的对象，也就是个数组，所以获取到数据之后必须使用data[0]这样的语法才能获取里层的对象。

[
  {
    context: "xxx",
    parent: "xxx",
    beans: [
        ...
...

然后页面就可以写成下面这样的。"[[@{/beans}]]"是Thymeleaf的语法，Thymeleaf引擎遇到它会转换为实际的URL。然后jquery获取到对象之后，使用了Knockout将数据绑定到页面上。详细使用方法请参考jQuery和Knockout的官方文档。

<!DOCTYPE html>
<html xmlns:th="http://www.thymeleaf.org">
<head th:replace="_header::header('系统监控')">
</head>
<body>
<nav th:replace="_navbar::navbar"></nav>
<div class="container">
    <div class="row">
        <div class="col-md-12">
            <h2>Beans</h2>
            <h4><a th:href="@{/beans}">点击查看原格式</a></h4>
            <p><strong>context:</strong><span data-bind="text: context"></span></p>
            <p><strong>parent:</strong><span data-bind="text: parent"></span></p>
            <p><strong>数量:</strong>共有<span data-bind="text: beans.length"></span>个Beans</p>
            <table class="table table-bordered table-hover table-responsive table-striped">
                <thead>
                <tr>
                    <th>Beans</th>
                    <th>resource</th>
                    <th>scope</th>
                    <th>type</th>
                </tr>
                </thead>
                <tbody data-bind="foreach: beans">
                <tr>
                    <td data-bind="text: bean"></td>
                    <td data-bind="text: resource"></td>
                    <td data-bind="text: scope"></td>
                    <td data-bind="text: type"></td>
                </tr>
                </tbody>
            </table>
        </div>

    </div>
</div>
<div th:replace="_footer::footer"></div>
<script>
    $(document).ready(function () {
        $.getJSON("[[@{/beans}]]", function (data) {
            ko.applyBindings(data[0])
        })
    })
</script>
</body>
</html>

Hypermedia方式查看数据

如果我们添加 Spring HATEOAS的依赖，也就是下面这个。

compile 'org.springframework.hateoas:spring-hateoas'

然后启用Hypermedia功能。

endpoints.hypermedia.enabled=true

Spring就会在默认/actuator路径下生成一个发现页面，返回所有可用的端点和相应的URL。这个发现页面的URL可以使用endpoints.actuator.path设置，这个发现功能可以使用endpoints.actuator.enabled打开或关闭。

如果还存在HAL Browser的jar包，也就是添加下面的依赖，那么Spring还会开启一个可视化页面覆盖/actuator的JSON形式。可视化页面其实也没啥功能，会把所有的端点和输出以格式化之后的JSON形式输出，如果没安装JSON美化浏览器插件的话这个功能还是挺有用的。

 compile group: 'org.springframework.data', name: 'spring-data-rest-hal-browser', version: '2.6.1.RELEASE'

主页

用Markdown格式化

想了想也没啥写的了。最后就来说说Markdown把。我用的是marked。然后在resouces/statis/md/下建了markdown格式文件。然后页面可以写成类似这样的。同样是通过jQuery获取数据，然后转换为HTML。

<div class="container" id="content">

</div>
<div th:replace="_footer::footer"></div>
<script>
    $(document).ready(function () {
        $.get("[[@{/md/index.md}]]", function (data) {
            $("#content").html(marked(data));
        })
    })
</script>

完整的Spring Boot小例子代码在CSDN代码库上了，有兴趣的同学可以看看。由于项目是Gradle项目，所以可能有些同学不好编译打包。这里我还上传了完整的二进制程序Spring Boot小例子程序，可以直接使用java -jar XXX.jar来运行。

做一个Spring Boot小例子