学习笔记(SpringBoot)

Spring Boot

SpringBoot介绍

SpringBoot不是一个框架,只是一个Spring+SpringMvc的脚手架

什么是SpringBoot

SpringBoot是Spring项目中的一个子工程，与Spring-framework 同属于spring的产品:

https://spring.io/projects

介绍：

Takes an opinionated view of building production-ready Spring applications. Spring Boot favors convention over configuration and is designed to get you up and running as quickly as possible.

翻译：

用一些固定的方式来构建生产级别的spring应用。Spring Boot 推崇约定大于配置的方式以便于你能够尽可能快速的启动并运行程序。

其实把Spring Boot 称为搭建程序的脚手架。其最主要作用就是快速的构建庞大的spring项目，并且尽可能的减少一切xml配置，做到开箱即用，迅速上手，关注与业务而非配置。

为什么要学习SpringBoot

java一直被人诟病的一点就是臃肿、麻烦。当我们还在辛苦的搭建项目时，可能Python程序员已经把功能写好了，究其原因注意是两点：

• 复杂的配置，

  项目各种配置其实是开发时的损耗， 因为在思考 Spring 特性配置和解决业务问题之间需要进行思维切换，所以写配置挤占了写应用程序逻辑的时间。

• 一个是混乱的依赖管理。

  项目的依赖管理也是件吃力不讨好的事情。决定项目里要用哪些库就已经够让人头痛的了，你还要知道这些库的哪个版本和其他库不会有冲突，这难题实在太棘手。并且，依赖管理也是一种损耗，添加依赖不是写应用程序代码。一旦选错了依赖的版本，随之而来的不兼容问题毫无疑问会是生产力杀手。

而SpringBoot让这一切成为过去！

Spring Boot 简化了基于Spring的应用开发，只需要“run”就能创建一个独立的、生产级别的Spring应用。Spring Boot为Spring平台及第三方库提供开箱即用的设置（提供默认设置，存放默认配置的包就是启动器），这样我们就可以简单的开始。多数Spring Boot应用只需要很少的Spring配置。

可以使用SpringBoot创建java应用，并使用java –jar 启动它，就能得到一个生产级别的web工程。

SpringBoot的特点

Spring Boot 主要目标是：

• 为所有 Spring 的开发者提供一个非常快速的、广泛接受的入门体验
• 开箱即用（启动器starter-其实就是SpringBoot提供的一个jar包），但通过自己设置参数（.properties），即可快速摆脱这种方式。
• 提供了一些大型项目中常见的非功能性特性，如内嵌服务器、安全、指标，健康检测、外部化配置等
• 绝对没有代码生成，也无需 XML 配置。

更多细节，可以到官网查看。

快速入门

接下来，就利用SpringBoot搭建一个web工程，体会一下SpringBoot的魅力所在！

创建maven项目

创建普通的maven项目即可

添加依赖

前面说传统开发的问题之一就是依赖管理混乱，怎么这里还需要管理依赖呢？难道SpringBoot不帮管理吗？
别着急，现在项目与SpringBoot还没有什么关联。SpringBoot提供了一个名为spring-boot-starter-parent的工程，里面已经对各种常用依赖（并非全部）的版本进行了管理，项目需要以这个项目为父工程，这样就不用操心依赖的版本问题了，需要什么依赖，直接引入坐标即可！

添加父工程坐标

<parent>
    <groupId>org.springframework.boot</groupId>
    <artifactId>spring-boot-starter-parent</artifactId>
    <version>2.0.0.RELEASE</version>
</parent>

添加web启动器

为了让SpringBoot完成各种自动配置，必须引入SpringBoot提供的自动配置依赖，我们称为启动器。因为我们是web项目，这里引入web启动器：

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

需要注意的是，并没有在这里指定版本信息。因为SpringBoot的父工程已经对版本进行了管理了。

这个时候，我们会发现项目中多出了大量的依赖：

这些都是SpringBoot根据spring-boot-starter-web这个依赖自动引入的，而且所有的版本都已经管理好，不会出现冲突。

管理jdk版本

默认情况下，maven工程的jdk版本是1.5，而开发使用的是1.8，因此这里需要修改jdk版本，只需要简单的添加以下属性即可：

<properties>
    <java.version>1.8</java.version>
</properties>

完整pom

<?xml version="1.0" encoding="UTF-8"?>
<project xmlns="http://maven.apache.org/POM/4.0.0"
         xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
         xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd">
    <modelVersion>4.0.0</modelVersion>

    <groupId>com.lyx</groupId>
    <artifactId>springboot02</artifactId>
    <version>1.0-SNAPSHOT</version>

    <properties>
        <maven.compiler.source>8</maven.compiler.source>
        <maven.compiler.target>8</maven.compiler.target>
    </properties>

    <parent>
        <groupId>org.springframework.boot</groupId>
        <artifactId>spring-boot-starter-parent</artifactId>
        <version>2.2.1.RELEASE</version>
    </parent>

    <dependencies>
        <dependency>
            <groupId>org.springframework.boot</groupId>
            <artifactId>spring-boot-starter-web</artifactId>
        </dependency>
    </dependencies>
</project>

启动类

@SpringBootApplication
public class Application {
    public static void main(String[] args) {
        SpringApplication.run(Application.class,args);
    }
}

编写controller

@RestController
@RequestMapping("/user")
public class UserController {

    @Autowired
    UserService userService;

    @GetMapping("/findById")
    public User findById(@RequestParam("id") String id){
        System.out.println(id);
        return userService.findById(id);
    }
}

编写Service

@Service
public class UserService {
    public User findById(String id){
        User user = new User();
        user.setId(id);
        user.setNickname("admin");
        user.setPassword("admin123");
        return user;
    }

启动测试

接下来，运行main函数，查看控制台,可以看到以下信息：

• 1）监听的端口是8080
• 2）SpringMVC的映射路径是：/
• 3）/findById路径已经映射到了UserController中的findById()方法

打开页面访问：http://localhost:8080/user.findById
测试成功

Java配置(了解)

在入门案例中，没有任何的配置，就可以实现一个SpringMVC的项目了，快速、高效！
如果没有任何的xml，那么如果要配置一个Bean要配置一个数据库连接池，以前会这么玩：

<context:property-placeholder location="classpath:jdbc.properties"/><!-- 加载配置文件 -->  
<!-- 配置连接池 -->
<bean id="dataSource" class="com.alibaba.druid.pool.DruidDataSource"
      init-method="init" destroy-method="close">
    <property name="url" value="${jdbc.url}" />
    <property name="username" value="${jdbc.username}" />
    <property name="password" value="${jdbc.password}" />
</bean>

回顾历史

事实上，在Spring3.0开始，Spring官方就已经开始推荐使用java配置来代替传统的xml配置了，我们不妨来回顾一下Spring的历史：

• Spring1.0时代

  在此时因为jdk1.5刚刚出来，注解开发并未盛行，因此一切Spring配置都是xml格式，想象一下所有的bean都用xml配置。

• Spring2.0时代

  Spring引入了注解开发，但是因为并不完善，因此并未完全替代xml，此时的程序员往往是把xml与注解进行结合，貌似之前都是这种方式。

• Spring3.0及以后

  3.0以后Spring的注解已经非常完善了，因此Spring推荐使用完全的java配置来代替以前的xml，不过似乎在国内并未推广盛行。然后当SpringBoot来临，人们才慢慢认识到java配置的优雅。

尝试java配置

java配置主要靠java类和一些注解，比较常用的注解有：

• @Configuration：声明一个类作为配置类，代替xml文件
• @Bean：声明在方法上，将方法的返回值加入Bean容器，代替<bean>标签
• @value：属性注入
• @PropertySource：指定外部属性文件，

接下来用java配置来尝试实现连接池配置：

首先引入Druid连接池依赖(不要使用starter的方式引入,如果使用starter方式引入就自动配置了)：

<dependency>
    <groupId>com.alibaba</groupId>
    <artifactId>druid</artifactId>
    <version>1.1.6</version>
</dependency>

创建一个jdbc.properties文件，编写jdbc属性：

jdbc.driverClassName=com.mysql.jdbc.Driver
jdbc.url=jdbc:mysql://127.0.0.1:3306/db1
jdbc.username=root
jdbc.password=123

代码：

@Configuration
@PropertySource("classpath:jdbc.properties")
public class JdbcConfig {

    @Value("${jdbc.url}")
    String url;
    @Value("${jdbc.driverClassName}")
    String driverClassName;
    @Value("${jdbc.username}")
    String username;
    @Value("${jdbc.password}")
    String password;

    @Bean
    public DataSource dataSource() {
        DruidDataSource dataSource = new DruidDataSource();
        dataSource.setUrl(url);
        dataSource.setDriverClassName(driverClassName);
        dataSource.setUsername(username);
        dataSource.setPassword(password);
        return dataSource;
    }
}

解读：

• @Configuration：声明JdbcConfig是一个配置类
• @PropertySource：指定属性文件的路径是:classpath:jdbc.properties
• 通过@Value为属性注入值
• 通过@Bean将dataSource()方法声明为一个注册Bean的方法，Spring会自动调用该方法，将方法的返回值加入Spring容器中。
  然后就可以在任意位置通过@Autowired注入DataSource了！
  测试：

@RestController
public class HelloController {

    @Autowired
    private DataSource dataSource;

    @GetMapping("hello")
    public String hello() {
        return "hello, spring boot!" + dataSource;
    }
}

以下两种注入都在application.properties中写属性

SpringBoot的属性注入

在上面的案例中，实验了java配置方式。不过属性注入使用的是@Value注解。这种方式虽然可行，但是不够强大，因为它只能注入基本类型值。

在SpringBoot中，提供了一种新的属性注入方式，支持各种java基本数据类型及复杂类型的注入。

1）我们新建一个类，用来进行属性注入：

@ConfigurationProperties(prefix = "jdbc")
public class JdbcProperties {
    private String url;
    private String driverClassName;
    private String username;
    private String password;
}

• 在类上通过@ConfigurationProperties注解声明当前类为属性读取类

• prefix="jdbc"读取属性文件中，前缀为jdbc的值。

• 在类上定义各个属性，名称必须与属性文件中jdbc.后面部分一致

• 需要注意的是，这里并没有指定属性文件的地址，所以需要把jdbc.properties名称改为application.properties，这是SpringBoot默认读取的属性文件名：
  2） 在JdbcConfig中使用这个属性：

@Configuration
@EnableConfigurationProperties(JdbcProperties.class)
public class JdbcConfig {

    @Bean
    public DataSource dataSource(JdbcProperties jdbc) {
        DruidDataSource dataSource = new DruidDataSource();
        dataSource.setUrl(jdbc.getUrl());
        dataSource.setDriverClassName(jdbc.getDriverClassName());
        dataSource.setUsername(jdbc.getUsername());
        dataSource.setPassword(jdbc.getPassword());
        return dataSource;
    }

• 通过@EnableConfigurationProperties(JdbcProperties.class)来声明要使用JdbcProperties这个类的对象

• 然后你可以通过以下方式注入JdbcProperties：

  • @Autowired注入

    @Autowired
    private JdbcProperties prop;
    

  • 构造函数注入

    private JdbcProperties prop;
    public JdbcConfig(Jdbcproperties prop){
        this.prop = prop;
    }
    

  • 声明有@Bean的方法参数注入

    @Bean
    public Datasource dataSource(JdbcProperties prop){
        // ...
    }
    

本例中，采用第三种方式。

3）debug测试

更优雅的注入

事实上，如果一段属性只有一个Bean需要使用，我们无需将其注入到一个类（JdbcProperties）中。而是直接在需要的地方声明即可：

@Configuration
public class JdbcConfig {
    @Bean
    // 声明要注入的属性前缀，SpringBoot会自动把相关属性通过set方法注入到DataSource中
    @ConfigurationProperties(prefix = "jdbc")
    public DataSource dataSource() {
        DruidDataSource dataSource = new DruidDataSource();
        return dataSource;
    }
}

直接把@ConfigurationProperties(prefix = "jdbc")声明在需要使用的@Bean的方法上，然后SpringBoot就会自动调用这个Bean（此处是DataSource）的set方法，然后完成注入。使用的前提是：该类必须有对应属性的set方法！

自动配置原理

使用SpringBoot之后，一个整合了SpringMVC的WEB工程开发，变的无比简单，那些繁杂的配置都消失不见了，这是如何做到的？
一切魔力的开始，都是从main函数来的，所以再次来看下启动类：
发现特别的地方有两个：

• 注解：@SpringBootApplication
• run方法：SpringApplication.run()
  分别来研究这两个部分。
  这里重点的注解有3个：

@SpringBootApplication

• @SpringBootConfiguration
• @EnableAutoConfiguration
• @ComponentScan

@SpringBootConfiguration

关于这个注解，官网上有一段说明：
通过源码我们可以看出，在这个注解上面，又有一个@Configuration注解。通过上面的注释阅读我们知道：这个注解的作用就是声明当前类是一个配置类，然后Spring会自动扫描到添加了@Configuration的类，并且读取其中的配置信息。而@SpringBootConfiguration是来声明当前类是SpringBoot应用的配置类，项目中只能有一个。所以一般我们无需自己添加。

@EnableAutoConfiguration

关于这个注解，官网上有一段说明：

The second class-level annotation is @EnableAutoConfiguration. This annotation
tells Spring Boot to “guess” how you want to configure Spring, based on the jar
dependencies that you have added. Since spring-boot-starter-web added Tomcat
and Spring MVC, the auto-configuration assumes that you are developing a web
application and sets up Spring accordingly.

简单翻译以下：

第二级的注解@EnableAutoConfiguration，告诉SpringBoot基于你所添加的依赖，去“猜测”你想要如何配置Spring。比如我们引入了spring-boot-starter-web，而这个启动器中帮我们添加了tomcat、SpringMVC的依赖。此时自动配置就知道你是要开发一个web应用，所以就帮你完成了web及SpringMVC的默认配置了！

总结，SpringBoot内部对大量的第三方库或Spring内部库进行了默认配置，这些配置是否生效，取决于我们是否引入了对应库所需的依赖，如果有默认配置就会生效。
所以，我们使用SpringBoot构建一个项目，只需要引入所需框架的依赖，配置就可以交给SpringBoot处理了。除非你不希望使用SpringBoot的默认配置，它也提供了自定义配置的入口。

@ComponentScan

查看注释,大概的意思：

配置组件扫描的指令。提供了类似与<context:component-scan>标签的作用

通过basePackageClasses或者basePackages属性来指定要扫描的包。如果没有指定这些属性，那么将从声明这个注解的类所在的包开始，扫描包及子包

而我们的@SpringBootApplication注解声明的类就是main函数所在的启动类，因此扫描的包是该类所在包及其子包。因此，一般启动类会放在一个比较前的包目录中。

默认配置原理

默认配置类

通过刚才的学习，我们知道@EnableAutoConfiguration会开启SpringBoot的自动配置，并且根据你引入的依赖来生效对应的默认配置。那么问题来了：

• 这些默认配置是在哪里定义的呢？
• 为何依赖引入就会触发配置呢？

其实在我们的项目中，已经引入了一个依赖：spring-boot-autoconfigure，其中定义了大量自动配置类,几乎涵盖了现在主流的开源框架，例如：

• redis
• jms
• amqp
• jdbc
• jackson
• mongodb
• jpa
• solr
• elasticsearch

… 等等

我们来看一个我们熟悉的，例如SpringMVC，查看mvc 的自动配置类：

WebMvcProperties

打开：WebMvcAutoConfiguration

我们看到这个类上的4个注解：

• @Configuration：声明这个类是一个配置类

• @ConditionalOnWebApplication(type = Type.SERVLET)

  ConditionalOn，翻译就是在某个条件下，此处就是满足项目的类是是Type.SERVLET类型，也就是一个普通web工程，显然我们就是

• @ConditionalOnClass({ Servlet.class, DispatcherServlet.class, WebMvcConfigurer.class })

  这里的条件是OnClass，也就是满足以下类存在：Servlet、DispatcherServlet、WebMvcConfigurer，其中Servlet只要引入了tomcat依赖自然会有，后两个需要引入SpringMVC才会有。这里就是判断你是否引入了相关依赖，引入依赖后该条件成立，当前类的配置才会生效！

• @ConditionalOnMissingBean(WebMvcConfigurationSupport.class)

  这个条件与上面不同，OnMissingBean，是说环境中没有指定的Bean这个才生效。其实这就是自定义配置的入口，也就是说，如果我们自己配置了一个WebMVCConfigurationSupport的类，那么这个默认配置就会失效！

接着，我们查看该类中定义了什么：

视图解析器：

@Bean
@ConditionalOnMissingBean
public InternalResourceViewResolver defaultViewResolver() {
    InternalResourceViewResolver resolver = new InternalResourceViewResolver();
    resolver.setPrefix(this.mvcProperties.getView().getPrefix());
    resolver.setSuffix(this.mvcProperties.getView().getSuffix());
    return resolver;
}

处理器适配器（HandlerAdapter）：

@Override
protected RequestMappingHandlerAdapter createRequestMappingHandlerAdapter() {
   if (this.mvcRegistrations != null
       && this.mvcRegistrations.getRequestMappingHandlerAdapter() != null) {
       return this.mvcRegistrations.getRequestMappingHandlerAdapter();
   }
   return super.createRequestMappingHandlerAdapter();
}

还有很多…

默认配置属性

另外，这些默认配置的属性来自哪里呢？

@EnableConfigurationProperties({ WebMvcProperties.class, ResourceProperties.class })

我们看到，这里通过@EnableAutoConfiguration注解引入了两个属性：WebMvcProperties和ResourceProperties。这不正是SpringBoot的属性注入嘛。

我们查看这两个属性类：

@ConfigurationProperties(prefix = "spring.mvc")
public class WebMvcProperties {

    /**
	 * Formatting strategy for message codes (PREFIX_ERROR_CODE, POSTFIX_ERROR_CODE).
	 */
    private DefaultMessageCodesResolver.Format messageCodesResolverFormat;

    /**
	 * Locale to use. By default, this locale is overridden by the "Accept-Language"
	 * header.
	 */
    private Locale locale;

    /**
	 * Define how the locale should be resolved.
	 */
    private LocaleResolver localeResolver = LocaleResolver.ACCEPT_HEADER;

    /**
	 * Date format to use (e.g. dd/MM/yyyy).
	 */
    private String dateFormat;

    /**
	 * Dispatch TRACE requests to the FrameworkServlet doService method.
	 */
    private boolean dispatchTraceRequest = false;
    .....
}

找到了内部资源视图解析器的prefix和suffix属性。

如果我们要覆盖这些默认属性，只需要在application.properties中定义与其前缀prefix和字段名一致的属性即可。

总结

SpringBoot为我们提供了默认配置，而默认配置生效的条件一般有两个：

• 你引入了相关依赖
• 你自己没有配置

1）启动器

所以，我们如果不想配置，只需要引入依赖即可，而依赖版本我们也不用操心，因为只要引入了SpringBoot提供的stater（启动器），就会自动管理依赖及版本了。

因此，玩SpringBoot的第一件事情，就是找启动器，SpringBoot提供了大量的默认启动器(常用依赖)

2）全局配置

另外，SpringBoot的默认配置，都会读取默认属性，而这些属性可以通过自定义application.properties文件来进行覆盖。这样虽然使用的还是默认配置，但是配置中的值改成了我们自定义的。

因此，玩SpringBoot的第二件事情，就是通过application.properties来覆盖默认属性值，形成自定义配置。我们需要知道SpringBoot的默认属性key，非常多.

SpringBoot实践

整合SpringMVC

虽然默认配置已经可以使用SpringMVC了，不过有时候需要进行自定义配置。

修改端口

查看SpringBoot的全局属性可知，端口通过以下方式配置：

server.port=80

访问静态资源

现在，项目是一个jar工程，那么就没有webapp，静态资源该放哪里呢？

回顾上面看的源码，有一个叫做ResourceProperties的类，里面就定义了静态资源的默认查找路径：

@ConfigurationProperties(prefix = "spring.resources", ignoreUnknownFields = false)
public class ResourceProperties {

    private static final String[] CLASSPATH_RESOURCE_LOCATIONS = { "classpath:/META-INF/resources/",
                                                                  "classpath:/resources/", "classpath:/static/", "classpath:/public/" };
    .....
}

默认的静态资源路径为：

• classpath:/META-INF/resources/
• classpath:/resources/
• classpath:/static/
• classpath:/public
  只要静态资源放在这些目录中任何一个，SpringMVC都会处理。

习惯会把静态资源放在classpath:/static/目录下。创建目录，并且添加一些静态资源：

重启项目后测试：

添加拦截器

拦截器也是经常需要使用的，在SpringBoot中该如何配置呢？
拦截器不是一个普通属性，而是一个类，所以就要用到java配置方式了。在SpringBoot官方文档中有这么一段说明：

If you want to keep Spring Boot MVC features and you want to add additional MVC configuration (interceptors, formatters, view controllers, and other features), you can add your own @Configuration class of type WebMvcConfigurer but without @EnableWebMvc. If you wish to provide custom instances of RequestMappingHandlerMapping, RequestMappingHandlerAdapter, or ExceptionHandlerExceptionResolver, you can declare a WebMvcRegistrationsAdapter instance to provide such components.

If you want to take complete control of Spring MVC, you can add your own @Configuration annotated with @EnableWebMvc.

翻译：

如果你想要保持Spring Boot 的一些默认MVC特征，同时又想自定义一些MVC配置（包括：拦截器，格式化器, 视图控制器、消息转换器 等等），你应该让一个类实现WebMvcConfigurer，并且添加@Configuration注解，但是千万不要加@EnableWebMvc注解。如果你想要自定义HandlerMapping、HandlerAdapter、ExceptionResolver等组件，你可以创建一个WebMvcRegistrationsAdapter实例 来提供以上组件。

如果你想要完全自定义SpringMVC，不保留SpringBoot提供的一切特征，你可以自己定义类并且添加@Configuration注解和@EnableWebMvc注解
总结：通过实现WebMvcConfigurer并添加@Configuration注解来实现自定义部分SpringMvc配置。

首先我们定义一个拦截器：

import lombok.extern.slf4j.Slf4j;
import org.springframework.stereotype.Component;
import org.springframework.web.servlet.HandlerInterceptor;
import org.springframework.web.servlet.ModelAndView;
import javax.servlet.http.HttpServletRequest;
import javax.servlet.http.HttpServletResponse;

@Slf4j
@Component
public class LoginIntercepter implements HandlerInterceptor {
    /**
     * controller执行之前拦截,返回true进入下一个拦截器,如果没有下一个拦截器,则执行controller
     * @param request
     * @param response
     * @param handler
     * @return
     */
    @Override
    public boolean preHandle(HttpServletRequest request, HttpServletResponse response, Object handler) {

        log.error("preHandle method is now running!");
        return true;
    }

    //在返回ModelAndView之前执行
    @Override
    public void postHandle(HttpServletRequest request, HttpServletResponse response, Object handler, ModelAndView modelAndView) {
        log.error("postHandle method is now running!");
    }

    //数据返回后执行
    @Override
    public void afterCompletion(HttpServletRequest request, HttpServletResponse response, Object handler, Exception ex) {
        log.error("afterCompletion method is now running!");
    }
}

然后，我们配置类，注册拦截器：

import com.uplooking.springbootstudy.intercepter.LoginIntercepter;
import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.context.annotation.Bean;
import org.springframework.context.annotation.Configuration;
import org.springframework.web.servlet.config.annotation.InterceptorRegistry;
import org.springframework.web.servlet.config.annotation.WebMvcConfigurer;

@Configuration
public class MvcConfig implements WebMvcConfigurer {
    @Autowired
    private LoginIntercepter loginIntercepter;
    @Override
    public void addInterceptors(InterceptorRegistry registry) {
        registry.addInterceptor(loginIntercepter).addPathPatterns("/**");
    }
}

接下来运行并查看日志：

会发现日志中什么都没有，因为记录的log级别是debug，默认是显示info以上，需要进行配置。

SpringBoot通过logging.level.*=debug来配置日志级别，*填写包名

# 设置com.up包的日志级别为debug
logging.level.com.lyx=debug

再次运行查看：

2018-05-05 17:50:01.811 DEBUG 4548 --- [p-nio-80-exec-1] com.up.interceptor.LoginInterceptor   : preHandle method is now running!
2018-05-05 17:50:01.854 DEBUG 4548 --- [p-nio-80-exec-1] com.up.interceptor.LoginInterceptor   : postHandle method is now running!
2018-05-05 17:50:01.854 DEBUG 4548 --- [p-nio-80-exec-1] com.up.interceptor.LoginInterceptor   : afterCompletion method is now running!

整合jdbc和事务

spring中的jdbc连接和事务是配置中的重要一环，在SpringBoot中该如何处理呢？

答案是不需要处理，只要找到SpringBoot提供的启动器即可：

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

当然，不要忘了数据库驱动，SpringBoot并不知道用的什么数据库，这里选择MySQL：

<dependency>
    <groupId>mysql</groupId>
    <artifactId>mysql-connector-java</artifactId>
</dependency>

至于事务，SpringBoot中通过注解来控制。就是@Transactional

@Service
public class UserService {

    @Autowired
    private UserMapper userMapper;

    public User queryById(Long id){
        return this.userMapper.selectByPrimaryKey(id);
    }

    @Transactional
    public void deleteById(Long id){
        this.userMapper.deleteByPrimaryKey(id);
    }
}

整合连接池

其实，在刚才引入jdbc启动器的时候，SpringBoot已经自动引入了一个连接池HikariCP

应该是目前速度最快的连接池了，看看它与c3p0的对比：

c3p0: 234
hikari:50273

因此，只需要指定连接池参数即可：

# 连接四大参数
spring.datasource.url=jdbc:mysql://localhost:3306/up
spring.datasource.username=root
spring.datasource.password=123
# 可省略，SpringBoot自动推断
spring.datasource.driverClassName=com.mysql.jdbc.Driver

spring.datasource.hikari.idle-timeout=60000
spring.datasource.hikari.maximum-pool-size=30
spring.datasource.hikari.minimum-idle=10

当然，如果使用Druid连接池，也可以使用Druid官方提供的启动器：

<!-- Druid连接池 -->
<dependency>
    <groupId>com.alibaba</groupId>
    <artifactId>druid-spring-boot-starter</artifactId>
    <version>1.1.10</version>
</dependency>

注意Druid与SpringBoot有版本兼容问题,在SpringBoot2.x之后就要使用Druid的1.1.10的版本

---

整合mybatis

#控制台打印mybatis生成的sql
mybatis.configuration.log-impl=org.apache.ibatis.logging.stdout.StdOutImpl

mybatis依赖

SpringBoot官方并没有提供Mybatis的启动器，不过Mybatis官网自己实现了：

<!--mybatis -->
<dependency>
    <groupId>org.mybatis.spring.boot</groupId>
    <artifactId>mybatis-spring-boot-starter</artifactId>
    <version>1.3.2</version>
</dependency>

配置，基本没有需要配置的：

# mybatis 别名扫描
mybatis.type-aliases-package=com.up.pojo
# mapper.xml文件位置,如果没有映射文件，请注释掉
mybatis.mapper-locations=classpath:mappers/*.xml

需要注意，这里没有配置mapper接口扫描包，因此我们需要给每一个Mapper接口添加@Mapper注解，才能被识别。

@Mapper
public interface UserMapper {
}

/src/main/resources/mapper/UserMapper.xml

<?xml version="1.0" encoding="UTF-8" ?>
<!DOCTYPE mapper
        PUBLIC "-//mybatis.org//DTD Mapper 3.0//EN"
        "http://mybatis.org/dtd/mybatis-3-mapper.dtd">
<mapper namespace="com.uplooking.springboot.mapper.UserMapper">
    <select id="findUser" resultType="user" parameterType="int">
        select * from user where id=#{value}
    </select>
</mapper>

解决mapper.xml的文件位置问题

默认idea只认识resources目录下面的.xml文件,但是有很多程序员是习惯把mapper.xml放在和Mapper.java在同一个目录,所以我们要给maven配置构建的目录;

<build>
    <resources>
        <!-- mapper.xml文件在java目录下
                    idea默认只能识别resources目录下面的xml文件,不能识别我们自己包中的xml文件,所以我们需要自己构建时指定
                -->
        <resource>
            <directory>src/main/java</directory>
            <includes>
                <include>**/*.xml</include>
            </includes>
        </resource>
    </resources>
</build>

通用mapper

@Mapper
public interface UserMapper extends tk.mybatis.mapper.common.Mapper<User>{
    User findById(@Param("id") Integer id);
    Integer updateById(@Param("id") Integer id,@Param("nickname") String nickname);
}

通用Mapper的作者也为自己的插件编写了启动器，我们直接引入即可：

<!-- 通用mapper -->
<dependency>
    <groupId>tk.mybatis</groupId>
    <artifactId>mapper-spring-boot-starter</artifactId>
    <version>2.0.2</version>
</dependency>

不需要做任何配置就可以使用了。

@Mapper
public interface UserMapper extends tk.mybatis.mapper.common.Mapper<User>{
}

测试tkMapper

@RestController
@RequestMapping("user")
public class UserController {
    @Autowired
    private UserMapper userMapper;
    @RequestMapping("userinfo/{id}")
    private List<User> userInfo(@PathVariable("id") Integer id) {
        User user = new User(1, "tom", 20, new Date());
        List<User> users = userMapper.selectAll();
        System.out.println(111);
        return users;
    }

SpringBoot热部署

注意:热部署要慎重使用要不然电脑会很卡

添加pom依赖

<!--SpringBoot热部署的插件-->
<dependency>
    <groupId>org.springframework.boot</groupId>
    <artifactId>spring-boot-devtools</artifactId>
    <optional>true</optional>
</dependency>

修改配置文件application.properties

spring.thymeleaf.cache=false

修改idea自动编译java

file--->other settings--->default settings---->Build--->compiler--->build project autoxxxx(勾选)

ps:这个自动编译的设置只是针对在没有运行程序的情况下自动编译

修改idea运行中的自动编译

help--->find action--->Registry--->compiler.automake.allow.when.app.running(勾选)

SpringBoot全局异常处理

• 创建异常处理器(声明为控制器通知)

  //异常处理器类要声明为控制器通知类
  @ControllerAdvice
  public class MyExceptionHandler {
      @ResponseBody
      @ExceptionHandler(Exception.class)
      public Map<String, Object> handlerException(Exception e) {
          Map<String, Object> map = new HashMap<>();
          map.put("errorCode", 1);
          map.put("errorMsg", "exception....."+e);
          return map;
      }
  }
  
  

  在代码中制造异常就可以由异常处理器统一处理

Thymeleaf快速入门

SpringBoot并不推荐使用jsp，但是支持一些模板引擎技术：

以前大家用的比较多的是Freemarker，但是我们今天的主角是Thymeleaf！

为什么是Thymeleaf？

简单说， Thymeleaf 是一个跟 Velocity、FreeMarker 类似的模板引擎，它可以完全替代 JSP 。相较与其他的模板引擎，它有如下三个极吸引人的特点：

• 动静结合：Thymeleaf 在有网络和无网络的环境下皆可运行，即它可以让美工在浏览器查看页面的静态效果，也可以让程序员在服务器查看带数据的动态页面效果。这是由于它支持 html 原型，然后在 html 标签里增加额外的属性来达到模板+数据的展示方式。浏览器解释 html 时会忽略未定义的标签属性，所以 thymeleaf 的模板可以静态地运行；当有数据返回到页面时，Thymeleaf 标签会动态地替换掉静态内容，使页面动态显示。
• 开箱即用：它提供标准和spring标准两种方言，可以直接套用模板实现JSTL、 OGNL表达式效果，避免每天套模板、该jstl、改标签的困扰。同时开发人员也可以扩展和创建自定义的方言。
• 多方言支持：Thymeleaf 提供spring标准方言和一个与 SpringMVC 完美集成的可选模块，可以快速的实现表单绑定、属性编辑器、国际化等功能。
• 与SpringBoot完美整合，SpringBoot提供了Thymeleaf的默认配置，并且为Thymeleaf设置了视图解析器，我们可以像以前操作jsp一样来操作Thymeleaf。代码几乎没有任何区别，就是在模板语法上有区别。

接下来，就通过入门案例来体会Thymeleaf的魅力：

编写接口

编写一个controller，返回一些用户数据，放入模型中，等会在页面渲染

@GetMapping("/all")
public String all(ModelMap model) {
    // 查询用户
    List<User> users = this.userService.queryAll();
    // 放入模型
    model.addAttribute("users", users);
    // 返回模板名称（就是classpath:/templates/目录下的html文件名）
    return "users";
}

引入启动器

直接引入启动器：

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

SpringBoot会自动为Thymeleaf注册一个视图解析器

• 默认前缀：classpath:/templates/
• 默认后缀：.html

所以如果返回视图：users，会指向到 classpath:/templates/users.html

一般无需进行修改，默认即可。

th:text

<h1 th:text="${name}">h1h1h1h1h1</h1>
${名称}就可以获取model中的数据,原来的数据"h1h1h1h1h1"不需要删除,当${名称}获取到model中的值时,就会自动替换数据,这样方便做到 前后端互相分离

引入url

<a th:href="${murl}" href="http://www.baidu.com">this is me </a>
<img th:src="${msrc}"  src="/1.png" />

字符串的拼接

<h2 th:text="ff+${msrc}+${mname}">h2h2h2h2</h2>

运算符

在表达式中可以使用各类算术运算符，例如+, -, *, /, %

<p th:text="${age}+12">this is p</p>

逻辑运算符>, <, <=,>=，==,!=都可以使用，唯一需要注意的是使用<,>时需要用它的HTML转义符： > <

条件表达式if/unless

Thymeleaf中使用th:if和th:unless属性进行条件判断，下面的例子中，标签只有在th:if中条件成立时才显示：

<h3 th:text="${mage}" th:if="${mage} > 120">myh3h3h3</h3>

th:unless于th:if恰好相反，只有表达式中的条件不成立，才会显示其内容

<h3 th:text="${mage}" th:unless="${mage} > 120">myh3h3h3</h3>

switch分支

<div th:switch="${age}">
        <p th:case="12" th:text="${age}"></p>
        <p th:case="13" th:text="${age}"></p>
   </div>

each 循环

渲染列表数据是一种非常常见的场景，例如现在有n条记录需要渲染成一个表格

<ul th:each="name:${names}">
        <li th:text="${name}"></li>
</ul>

模板缓存

Thymeleaf会在第一次对模板解析之后进行缓存，极大的提高了并发处理能力。但是这给开发带来了不便，修改页面后并不会立刻看到效果，开发阶段可以关掉缓存使用：

# 开发阶段关闭thymeleaf的模板缓存
spring.thymeleaf.cache=false

注意：

在Idea中，需要在修改页面后按快捷键：`Ctrl + Shift + F9` 对项目进行rebuild才可以。(搭配spring.thymeleaf.cache=false进行使用)

thymeleaf老版本标签闭合问题

在Thymeleaf 2.x版本中，要求HTML中元素标签必须要闭合，但是在3.x版本中已经不存在该问题了，但是在Springboot 1.5.9版本中，使用的Thymeleaf版本依然是2.x版本，因此要么在构建脚本中覆盖Springboot默认的Thymeleaf版本，或者使用更高版本的Springboot。

经测试，使用2.0.0 M7版本Springboot，默认使用了3.x版本的Thymeleaf，可以解决HTML元素标签不闭合的问题。

在thymeleaf2.x中的解决方案:

<!--SpringBoot的ThyMeLeaf关闭严格检查模式-->
<dependency>
    <groupId>net.sourceforge.nekohtml</groupId>
    <artifactId>nekohtml</artifactId>
    <version>1.9.22</version>
</dependency>

application.yaml
#禁用thymeleaf的严格检查模式
spring:
  thymeleaf:
    cache: false
    mode: LEGACYHTML5

SpringBoot打包

在build目录下

<plugins>
    <plugin>
        <groupId>org.springframework.boot</groupId>
        <artifactId>spring-boot-maven-plugin</artifactId>
    </plugin>
</plugins>