Spring Boot入门使用教程

Spring Boot入门使用教程

Spring Boot 并不是一个全新的框架，而是将已有的 Spring 组件整合起来。特点是去掉了繁琐的 XML 配置，改使用约定或注解。所以熟悉了 Spring Boot 之后，开发效率将会提升一个档次。

约定优于配置的这种做法在如今越来越流行了，它的特点是简单、快速、便捷。但是这是建立在程序员熟悉这些约定的前提上。而 Spring 拥有一个庞大的生态体系，刚开始转到 Spring Boot 完全舍弃 XML 时肯定是不习惯的，所以也会造成一些困扰。这里介绍一下一些常用的心得。

运行方式

spring-boot-starter-web包含了 Spring MVC 的相关依赖（包括 Json 支持的 Jackson 和数据校验的 Hibernate Validator）和一个内置的 Tomcat 容器，这使得在开发阶段可以直接通过main方法或是 JAR 包独立运行一个 WEB 项目。而在部署阶段也可以打成 WAR 包放到生产环境运行。

在拥有@SpringBootApplication注解的类中，使用SpringApplication的run方法可以通过JAR启动项目。

继承SpringBootServletInitializer类并实现configure方法，使用application的sources方法可以通过WAR启动项目。

配置文件

Spring boot 的默认配置文件是resources下的application.properties和application.yml。

我曾在项目中遇到过application.properties出现中文乱码问题，当时尝试了很多办法都没有解决。Spring Boot 总是会以iso-8859的编码方式读取该文件，后来改用 YAML 了就再也没有出现过乱码了。并且它也拥有更简洁的语法，所以在此也更推荐使用application.yml作为默认的配置文件。

配置文件中可以定义一个叫做spring.profiles.active的属性，该属性可以根据运行环境自动读取不同的配置文件。例如将该属性定义为dev的话，Spring Boot 会额外从application-dev.yml文件中读取该环境的配置。

Spring Boot 注入配置文件属性的方法有两种，一种是通过@Value注解接受配置文件中的属性，另外一种是通过@ConfigurationProperties注解通过set方法自动为Bean注入对应的属性。

通过@Value注入属性，接收者既可以是方法参数，也可以是成员变量。

通过@Value接受方法参数初始化Bean：

通过@ConfigurationProperties读取配置初始化Bean，会直接调用对应的set方法注入：

Spring Boot 目前还无法直接注入的静态变量。我目前使用的方法是专门建立一个读取配置文件的Bean，然后使用@PostConstruct注解修饰的方法对这些静态属性进行初始化，例如：

Servlet

Servlet 中最重要的配置文件就是web.xml，它的主要用途是配置Servlet映射和过滤器。而在 Spring Boot 中这将简单很多，只需要将对应的Servlet和Filter定义为 Bean 即可。

声明一个映射根路径的 Servlet ，例如 Spring MVC 的DispatcherServlet：

需要注意的是，Spring Boot 默认会自动创建DispatcherServlet的映射。但这是在项目中没有手动声明其他 Servlet Bean 的情况下，否则就需要也将这个 Bean 一起声明。

声明一个映射特定路径的 Servlet ，或是需要配置初始化参数的话，则需要使用ServletRegistrationBean。例如 Druid 的StatViewServlet：

声明过滤器也是如此，例如 Spring MVC 的CharacterEncodingFilter：

复杂一点的同样是通过类似的FilterRegistrationBean，例如：

Spring MVC

Spring MVC 主要的配置都可以通过继承WebMvcConfigurerAdapter（或者WebMvcConfigurationSupport）类进行修改，这两个类的主要方法有：

addFormatters：增加格式化工具（用于接收参数）

configureMessageConverters：配置消息转换器（用于@RequestBody和@ResponseBody）

configurePathMatch：配置路径映射

addArgumentResolvers：配置参数解析器（用于接收参数）

addInterceptors：添加拦截器

总之几乎所有关于 Spring MVC 都可以在这个类中配置。之后只需要将其设为@Configuration，Spring Boot 就会在运行时加载这些配置。

还有一些常用的 Bean 默认会自动创建，但是可以通过自定义进行覆盖，例如负责@RequestBody和@RequestBody进行转换的MappingJackson2HttpMessageConverter和ObjectMapper，可以直接这样覆盖掉：

DataSource

如果使用了spring-boot-starter-data-jpa，Spring Boot将会自动创建一个 DataSource Bean。可以直接在配置文件中定义它的属性，前缀是spring.datasource。并且无需指定数据库的方言，这个 Bean 会自动根据项目中依赖的数据库驱动判断使用的哪种数据库。

同样的，如果使用了spring-boot-starter-data-redis，也会自动创建RedisTemplate、ConnectionFactory等 Bean。也同样可以在配置文件中定义属性，前缀是spring.redis。