springboot-总结列表

一、Spring Boot 具有以下特点：

1. 独立运行的 Spring 项目

Spring Boot 可以以 jar 包的形式独立运行，Spring Boot 项目只需通过命令“ java–jar xx.jar” 即可运行。

2. 内嵌 Servlet 容器

Spring Boot 使用嵌入式的 Servlet 容器（例如 Tomcat、Jetty 或者 Undertow 等），应用无需打成 WAR 包 。

3. 提供 starter 简化 Maven 配置

Spring Boot 提供了一系列的“starter”项目对象模型（POMS）来简化 Maven 配置。

4. 提供了大量的自动配置

Spring Boot 提供了大量的默认自动配置，来简化项目的开发，开发人员也通过配置文件修改默认配置。

5. 自带应用监控

Spring Boot 可以对正在运行的项目提供监控。

6. 无代码生成和 xml 配置

Spring Boot 不需要任何 xml 配置即可实现 Spring 的所有配置。Spring Boot 提供了大量开箱即用（out-of-the-box）的依赖模块
 
 二、 Intellij IDEA 一般可以通过两种方式创建 Spring Boot 项目：
  • 使用 Maven 创建
  • 使用 Spring Initializr 创建

三、pom.xml 配置中其版本（version）

版本信息是由 spring-boot-starter-parent（版本仲裁中心） 统一控制的，查看 spring-boot-starter- parent 的底层代码，可以发现其有一个父级依赖 spring-boot-dependencies

Spring Boot 项目可以通过继承 spring-boot-starter-parent 来获得一些合理的默认配置，它主要提供了以下特性：

  • 默认 JDK 版本（Java 8）
  • 默认字符集（UTF-8）
  • 依赖管理功能
  • 资源过滤
  • 默认插件配置
  • 识别 application.properties 和 application.yml 类型的配置文件

mvn dependency:tree

四、YAML教程

SpringBoot 默认使用以下 2 种全局的配置文件，其文件名是固定的。

    • application.properties
    • application.yml

YAML 的语法如下：

  • 使用缩进表示层级关系。
  • 缩进时不允许使用 Tab 键，只允许使用空格。
  • 缩进的空格数不重要，但同级元素必须左侧对齐。
  • 大小写敏感。

YAML 支持以下三种数据结构：

  • 对象：键值对的集合
  • 数组：一组按次序排列的值
  • 字面量：单个的、不可拆分的值

五、配置绑定 

SpringBoot 提供了以下 2 种方式进行配置绑定：

  • 使用 @ConfigurationProperties 注解
  • 使用 @Value 注解

@PropertySource 

  1. @PropertySource(value = "classpath:person.properties")//指向对应的配置文件

@Value 与 @ConfigurationProperties 对比

@Value 和 @ConfigurationProperties 注解都能读取配置文件中的属性值并绑定到 JavaBean 中，但两者存在以下不同。

1. 使用位置不同

  • @ConfigurationProperties：标注在 JavaBean 的类名上；
  • @Value：标注在 JavaBean 的属性上。

2. 功能不同

  • @ConfigurationProperties：用于批量绑定配置文件中的配置；
  • @Value：只能一个一个的指定需要绑定的配置。

3. 松散绑定支持不同

@ConfigurationProperties：支持松散绑定（松散语法），例如实体类 Person 中有一个属性为 firstName，那么配置文件中的属性名支持以下写法：

  • person.firstName
  • person.first-name
  • person.first_name
  • PERSON_FIRST_NAME 

@Vaule：不支持松散绑定。

4. SpEL 支持不同

  • @ConfigurationProperties：不支持 SpEL 表达式;
  • @Value：支持 SpEL 表达式。

5. 复杂类型封装

  • @ConfigurationProperties：支持所有类型数据的封装，例如 Map、List、Set、以及对象等；
  • @Value：只支持基本数据类型的封装，例如字符串、布尔值、整数等类型。

6. 应用场景不同

@Value 和 @ConfigurationProperties 两个注解之间，并没有明显的优劣之分，它们只是适合的应用场景不同而已。

    • 若只是获取配置文件中的某项值，则推荐使用 @Value 注解；
    • 若专门编写了一个 JavaBean 来和配置文件进行映射，则建议使用 @ConfigurationProperties 注解。

六、导入Spring配置

Spring Boot 为了我们提供了以下 2 种方式来导入 Spring 配置：

  • 使用 @ImportResource 注解加载 Spring 配置文件
  • 使用全注解方式加载 Spring 配置

@ImportResource(locations = {"classpath:/beans.xml"})

Spring Boot 推荐我们使用全注解的方式加载 Spring 配置，其实现方式如下：

    1. 使用 @Configuration 注解定义配置类，替换 Spring 的配置文件；
    2. 配置类内部可以包含有一个或多个被 @Bean 注解的方法，这些方法会被 AnnotationConfigApplicationContext 或 AnnotationConfigWebApplicationContext 类扫描，构建 bean 定义（相当于 Spring 配置文件中的<bean></bean>标签），方法的返回值会以组件的形式添加到容器中，组件的 id 就是方法名。

@Configuration
public class MyAppConfig {
/**
* 与 <bean id="personService" class="PersonServiceImpl"></bean> 等价
* 该方法返回值以组件的形式添加到容器中
* 方法名是组件 id（相当于 <bean> 标签的属性 id)
*/
@Bean
public PersonService personService() {
System.out.println("在容器中添加了一个组件:peronService");
return new PersonServiceImpl();
}
}

七、Spring Boot Profile（多环境配置）

properties 配置

在 helloworld 的 src/main/resources 下添加 4 个配置文件：

  • application.properties：主配置文件
  • application-dev.properties：开发环境配置文件
  • application-test.properties：测试环境配置文件
  • application-prod.properties：生产环境配置文件

在 application.properties 文件中，指定默认服务器端口号为 8080，并通过以下配置激活生产环境（prod）的 profile。
#默认端口号
server.port=8080
#激活指定的profile
spring.profiles.active=prod

yml 配置
与 properties 文件类似，我们也可以添加 4 个配置文件：
application.yml：默认配置
application-dev.yml：开发环境配置
application-test.yml：测试环境配置
application-prod.yml：生产环境配置

在 applcation.yml 文件中指定默认服务端口号为 8080，并通过以下配置来激活开发环境的 profile。
纯文本复制
#默认配置
server:
port: 8080
#切换配置
spring:
profiles:
active: dev #激活开发环境配置

八、Spring Boot 配置加载顺序

所有位置的文件都会被加载，高优先级配置会覆盖低优先级配置，形成互补配置，即：

  • 存在相同的配置内容时，高优先级的内容会覆盖低优先级的内容；
  • 存在不同的配置内容时，高优先级和低优先级的配置内容取并集。

以下是常用的 Spring Boot 配置形式及其加载顺序（优先级由高到低）：
命令行参数
来自 java:comp/env 的 JNDI 属性
Java 系统属性（System.getProperties()）
操作系统环境变量
RandomValuePropertySource 配置的 random.* 属性值
配置文件（YAML 文件、Properties 文件）
@Configuration 注解类上的 @PropertySource 指定的配置文件
通过 SpringApplication.setDefaultProperties 指定的默认属性

九、Spring Boot自动配置原理

Spring Factories 机制
Spring Boot 的自动配置是基于 Spring Factories 机制实现的。
Spring Factories 机制是 Spring Boot 中的一种服务发现机制，这种扩展机制与 Java SPI 机制十分相似。Spring Boot 会自动扫描所有 Jar 包类路径下 META-INF/spring.factories 文件，并读取其中的内容，进行实例化，这种机制也是 Spring Boot Starter 的基础。

Spring Factories 实现原理

spring-core 包里定义了 SpringFactoriesLoader 类，这个类会扫描所有 Jar 包类路径下的 META-INF/spring.factories 文件，并获取指定接口的配置。在 SpringFactoriesLoader 类中定义了两个对外的方法，如下表。

返回值方法描述
<T> List<T>  loadFactories(Class<T> factoryType, @Nullable ClassLoader classLoader) 静态方法；
根据接口获取其实现类的实例；
该方法返回的是实现类对象列表。
List<String> loadFactoryNames(Class<?> factoryType, @Nullable ClassLoader classLoader)  公共静态方法；
根据接口l获取其实现类的名称；
该方法返回的是实现类的类名的列表


以上两个方法的关键都是从指定的 ClassLoader 中获取 spring.factories 文件，并解析得到类名列表，具体代码如下。

@SpringBootApplication 注解

所有 Spring Boot 项目的主启动程序类上都使用了一个 @SpringBootApplication 注解，该注解是 Spring Boot 中最重要的注解之一 ，也是 Spring Boot 实现自动化配置的关键。 

@SpringBootApplication 是一个组合元注解，其主要包含两个注解：@SpringBootConfiguration 和 @EnableAutoConfiguration，其中 @EnableAutoConfiguration 注解是 SpringBoot 自动化配置的核心所在。

AutoConfigurationImportSelector 类

AutoConfigurationImportSelector 类实现了 DeferredImportSelector 接口，AutoConfigurationImportSelector 中还包含一个静态内部类 AutoConfigurationGroup，它实现了 DeferredImportSelector 接口的内部接口 Group（Spring 5 新增）。

该类使用了以下注解：

  • @Configuration：用于定义一个配置类，可用于替换 Spring 中的 xml 配置文件；
  • @Bean：被 @Configuration 注解的类内部，可以包含有一个或多个被 @Bean 注解的方法，用于构建一个 Bean，并添加到 Spring 容器中；该注解与 spring 配置文件中 <bean> 等价，方法名与 <bean> 的 id 或 name 属性等价，方法返回值与 class 属性等价；

除了 @Configuration 和 @Bean 注解外，该类还使用 5 个 @Conditional 衍生注解：

    • @ConditionalOnClass({ServletRequest.class})：判断当前项目是否存在 ServletRequest 这个类，若存在，则该配置类生效。
    • @ConditionalOnWebApplication(type = Type.SERVLET)：判断当前应用是否是 Web 应用，如果是的话，当前配置类生效。
    • @ConditionalOnClass(name = {"org.apache.catalina.startup.Tomcat"})：判断是否存在 Tomcat 类，若存在则该方法生效。
    • @ConditionalOnMissingFilterBean({ForwardedHeaderFilter.class})：判断容器中是否有 ForwardedHeaderFilter 这个过滤器，若不存在则该方法生效。
    • @ConditionalOnProperty(value = {"server.forward-headers-strategy"},havingValue = "framework")：判断配置文件中是否存在 server.forward-headers-strategy = framework，若不存在则该方法生效。

 十、统一日志框架

日志框架的选择

市面上常见的日志框架有很多，它们可以被分为两类：日志门面（日志抽象层）和日志实现，如下表。
 

日志分类描述举例
日志门面（日志抽象层） 为 Java 日志访问提供一套标准和规范的 API 框架，其主要意义在于提供接口。 JCL（Jakarta Commons Logging）、SLF4j（Simple Logging Facade for Java）、jboss-logging
日志实现 日志门面的具体的实现 Log4j、JUL（java.util.logging）、Log4j2、Logback


通常情况下，日志由一个日志门面与一个日志实现组合搭建而成，Spring Boot 选用 SLF4J + Logback 的组合来搭建日志系统。

//日志级别 由低到高
logger.trace("trace 级别日志");
logger.debug("debug 级别日志");
logger.info("info 级别日志");
logger.warn("warn 级别日志");
logger.error("error 级别日志");

通过控制台输出结果可知，Spring Boot 日志默认级别为 info，日志输出内容默认包含以下元素：
  • 时间日期
  • 日志级别
  • 进程 ID
  • 分隔符：---
  • 线程名：方括号括起来（可能会截断控制台输出）
  • Logger 名称
  • 日志内容

十一、Web启动器

Spring Boot Web 快速开发

Spring Boot 为 Spring MVC 提供了自动配置，并在 Spring MVC 默认功能的基础上添加了以下特性：

  • 引入了 ContentNegotiatingViewResolver 和 BeanNameViewResolver（视图解析器）
  • 对包括 WebJars 在内的静态资源的支持
  • 自动注册 Converter、GenericConverter 和 Formatter （转换器和格式化器）
  • 对 HttpMessageConverters 的支持（Spring MVC 中用于转换 HTTP 请求和响应的消息转换器）
  • 自动注册 MessageCodesResolver（用于定义错误代码生成规则）
  • 支持对静态首页（index.html）的访问
  • 自动使用 ConfigurableWebBindingInitializer

十二、静态资源映射

Spring Boot 默认为我们提供了 3 种静态资源映射规则：

  • WebJars 映射
  • 默认资源映射
  • 静态首页（欢迎页）映射

示例 1
1. 在 Spring Boot 项目 spring-boot-springmvc-demo1 的 pom.xml 中添加以下依赖，将 jquery 引入到该项目中。
<dependency>
<groupId>org.webjars</groupId>
<artifactId>jquery</artifactId>
<version>3.6.0</version>
</dependency>

默认静态资源映射

当访问项目中的任意资源（即“/**”）时，Spring Boot 会默认从以下路径中查找资源文件（优先级依次降低）：

  1. classpath:/META-INF/resources/
  2. classpath:/resources/
  3. classpath:/static/
  4. classpath:/public/

十三、Thymeleaf教程

Thymeleaf 是一款用于渲染 XML/XHTML/HTML5 内容的模板引擎。它与 JSP，Velocity，FreeMaker 等模板引擎类似

Thymeleaf 是新一代 Java 模板引擎，与 Velocity、FreeMarker 等传统 Java 模板引擎不同，Thymeleaf 支持 HTML 原型，其文件后缀为“.html”，因此它可以直接被浏览器打开，此时浏览器会忽略未定义的 Thymeleaf 标签属性，展示 thymeleaf 模板的静态页面效果；

Thymeleaf 的特点

Thymeleaf 模板引擎具有以下特点：

  • 动静结合：Thymeleaf 既可以直接使用浏览器打开，查看页面的静态效果，也可以通过 Web 应用程序进行访问，查看动态页面效果。
  • 开箱即用：Thymeleaf 提供了 Spring 标准方言以及一个与 SpringMVC 完美集成的可选模块，可以快速的实现表单绑定、属性编辑器、国际化等功能。
  • 多方言支持：它提供了 Thymeleaf 标准和 Spring 标准两种方言，可以直接套用模板实现 JSTL、 OGNL 表达式；必要时，开发人员也可以扩展和创建自定义的方言。
  • 与 SpringBoot 完美整合：SpringBoot 为 Thymeleaf 提供了的默认配置，并且还为 Thymeleaf 设置了视图解析器，因此 Thymeleaf 可以与 Spring Boot 完美整合。

在使用 Thymeleaf 之前，首先要在页面的 html 标签中声明名称空间，示例代码如下。

  1. xmlns:th="http://www.thymeleaf.org"

2.1 标准表达式语法

Thymeleaf 模板引擎支持多种表达式：

  • 变量表达式：${...}
  • 选择变量表达式：*{...}
  • 链接表达式：@{...}
  • 国际化表达式：#{...}
  • 片段引用表达式：~{...}

2.1.1 变量表达式

使用 ${} 包裹的表达式被称为变量表达式，该表达式具有以下功能：

  • 获取对象的属性和方法
  • 使用内置的基本对象
  • 使用内置的工具对象

① 获取对象的属性和方法

使用变量表达式可以获取对象的属性和方法，例如，获取 person 对象的 lastName 属性，表达式形式如下：

  1. ${person.lastName}

② 使用内置的基本对象

使用变量表达式还可以使用内置基本对象，获取内置对象的属性，调用内置对象的方法。 Thymeleaf 中常用的内置基本对象如下：

  • #ctx ：上下文对象；
  • #vars ：上下文变量；
  • #locale：上下文的语言环境；
  • #request：HttpServletRequest 对象（仅在 Web 应用中可用）；
  • #response：HttpServletResponse 对象（仅在 Web 应用中可用）；
  • #session：HttpSession 对象（仅在 Web 应用中可用）；
  • #servletContext：ServletContext 对象（仅在 Web 应用中可用）。

例如，我们通过以下 2 种形式，都可以获取到 session 对象中的 map 属性：

  1. ${#session.getAttribute('map')}
  2. ${session.map}

③ 使用内置的工具对象

除了能使用内置的基本对象外，变量表达式还可以使用一些内置的工具对象。

  • strings：字符串工具对象，常用方法有：equals、equalsIgnoreCase、length、trim、toUpperCase、toLowerCase、indexOf、substring、replace、startsWith、endsWith，contains 和 containsIgnoreCase 等；
  • numbers：数字工具对象，常用的方法有：formatDecimal 等；
  • bools：布尔工具对象，常用的方法有：isTrue 和 isFalse 等；
  • arrays：数组工具对象，常用的方法有：toArray、length、isEmpty、contains 和 containsAll 等；
  • lists/sets：List/Set 集合工具对象，常用的方法有：toList、size、isEmpty、contains、containsAll 和 sort 等；
  • maps：Map 集合工具对象，常用的方法有：size、isEmpty、containsKey 和 containsValue 等；
  • dates：日期工具对象，常用的方法有：format、year、month、hour 和 createNow 等。

例如，我们可以使用内置工具对象 strings 的 equals 方法，来判断字符串与对象的某个属性是否相等，代码如下。

  1. ${#strings.equals('编程帮',name)}

十三、定制Spring MVC

在 Spring Boot 项目中，我们可以通过以下 2 中形式定制 Spring MVC:

  • 扩展 Spring MVC
  • 全面接管 Spring MVC

//实现 WebMvcConfigurer 接口可以来扩展 SpringMVC 的功能
//@EnableWebMvc 不要接管SpringMVC
@Configuration
public class MyMvcConfig implements WebMvcConfigurer {
@Override
public void addViewControllers(ViewControllerRegistry registry) {
//当访问 “/” 或 “/index.html” 时，都直接跳转到登陆页面
registry.addViewController("/").setViewName("login");
registry.addViewController("/index.html").setViewName("login");
}
}

全面接管 Spring MVC
//实现 WebMvcConfigurer 接口可以来扩展 SpringMVC 的功能
@EnableWebMvc // 完全接管SpringMVC
@Configuration
public class MyMvcConfig implements WebMvcConfigurer {
@Override
public void addViewControllers(ViewControllerRegistry registry) {
//当访问 “/” 或 “/index.html” 时，都直接跳转到登陆页面
registry.addViewController("/").setViewName("login");
registry.addViewController("/index.html").setViewName("login");
}
}

十四、Spring Boot国际化

 

在 Spring 项目中实现国际化，通常需要以下 3 步：

  1. 编写国际化资源（配置）文件；
  2. 使用 ResourceBundleMessageSource 管理国际化资源文件；
  3. 在页面获取国际化内容。

十五、Spring Boot拦截器精讲

定义拦截器

在 Spring Boot 中定义拦截器十分的简单，只需要创建一个拦截器类，并实现 HandlerInterceptor 接口即可。
HandlerInterceptor  接口中定义以下 3 个方法，如下表。

返回值类型方法声明描述
boolean preHandle(HttpServletRequest request, HttpServletResponse response, Object handler)  该方法在控制器处理请求方法前执行，其返回值表示是否中断后续操作，返回 true 表示继续向下执行，返回 false 表示中断后续操作。
void postHandle(HttpServletRequest request, HttpServletResponse response, Object handler, ModelAndView modelAndView) 该方法在控制器处理请求方法调用之后、解析视图之前执行，可以通过此方法对请求域中的模型和视图做进一步修改。
void afterCompletion(HttpServletRequest request, HttpServletResponse response, Object handler, Exception ex) 该方法在视图渲染结束后执行，可以通过此方法实现资源清理、记录日志信息等工作。

 十五、Spring Boot异常处理

Spring Boot 异常处理自动配置原理

Spring Boot 通过配置类 ErrorMvcAutoConfiguration 对异常处理提供了自动配置，该配置类向容器中注入了以下 4 个组件。

  • ErrorPageCustomizer：该组件会在在系统发生异常后，默认将请求转发到“/error”上。
  • BasicErrorController：处理默认的“/error”请求。
  • DefaultErrorViewResolver：默认的错误视图解析器，将异常信息解析到相应的错误视图上。
  • DefaultErrorAttributes：用于页面上共享异常信息。

全局异常--定制错误页面

我们可以通过以下 3 种方式定制 Spring Boot 错误页面：

  • 自定义 error.html
  • 自定义动态错误页面
  • 自定义静态错误页面

十六、注册Web原生组件（Servlet、Filter、Listener） 

由于 Spring Boot 默认以 Jar 包方式部署的，默认没有 web.xml，因此无法再像以前一样通过 web.xml 配置来使用 Servlet 、Filter、Listener，但 Spring Boot 提供了 2 种方式来注册这些 Web 原生组件。

  • 通过组件扫描注册
  • 使用 RegistrationBean 注册

通过组件扫描注册

Servlet 3.0 提供了以下 3 个注解：

    • @WebServlet：用于声明一个 Servlet；
    • @WebFilter：用于声明一个 Filter；
    • @WebListener：用于声明一个 Listener。

使用 RegistrationBean 注册

我们还可以在配置类中使用 RegistrationBean 来注册原生 Web 组件，不过这种方式相较于注解方式要繁琐一些。使用这种方式注册的原生 Web 组件，不再需要使用 @WebServlet 、@WebListener 和 @WebListener 等注解。

RegistrationBean 是个抽象类，负责将组件注册到 Servlet 容器中，Spring 提供了三个它的实现类，分别用来注册 Servlet、Filter 和 Listener。

    • ServletRegistrationBean：Servlet 的注册类
    • FilterRegistrationBean：Filter 的注册类
    • ServletListenerRegistrationBean：Listener 的注册类

十七、JDBC访问数据库

<!--导入JDBC的场景启动器-->
<dependency>
<groupId>org.springframework.boot</groupId>
<artifactId>spring-boot-starter-data-jdbc</artifactId>
</dependency>
<!--导入数据库驱动-->
<dependency>
<groupId>mysql</groupId>
<artifactId>mysql-connector-java</artifactId>
<scope>runtime</scope>
</dependency>
配置数据源
在导入了 JDBC 场景启动器和数据库驱动后，接下来我们就可以在配置文件（application.properties/yml）中配置数据源了，示例代码（application.yml）如下。
纯文本复制
#数据源连接信息
spring:
datasource:
username: root
password: root
url: jdbc:mysql://127.0.0.1:3306/bianchengbang_jdbc
driver-class-name: com.mysql.cj.jdbc.Driver

//数据源组件
@Autowired
DataSource dataSource;
//用于访问数据库的组件
@Autowired
JdbcTemplate jdbcTemplate;

十八、数据源配置原理

在市面上有很多优秀的开源数据源，例如 DBCP、C3P0、Druid、HikariCP 等等。在 Spring Boot 2.x 中，则采用目前性能最佳的 HikariCP 作为其默认数据源。接下来，我们就来具体介绍下 Spring Boot 的默认数据源配置及其原理。

DataSourceAutoConfiguration

我们知道，Spring Boot 中几乎所有的默认配置都是通过配置类 XxxAutoConfiguration 进行配置的，Spring Boot 数据源也不例外，它的自动配置类是：DataSourceAutoConfiguration。

DataSourceAutoConfiguration 中共包括以下 5 个内部静态类：

    • EmbeddedDatabaseCondition
    • PooledDataSourceAvailableCondition
    • PooledDataSourceCondition
    • PooledDataSourceConfiguration（池化数据源自动配置类）
    • EmbeddedDatabaseConfiguration（内嵌数据源自动配置类）

通过对 Spring Boot 数据源自动配置原理的分析可知：

  • 在用户没有配置数据源的情况，若容器中存在 HikariDataSource 类，则 Spring Boot 就会自动实例化 Hikari，并将其作为其数据源。
  • Spring Boot 的 JDBC 场景启动器（spring-boot-starter-data-jdbc）通过 spring- boot-starter-jdbc 默认引入了 HikariCP 数据源（包含 HikariDataSource 类），因此 Spring Boot 默认使用 HikariCP 作为其数据源。

十九、整合Druid数据源

Druid 不是 Spring Boot 内部提供的技术，它属于第三方技术，我们可以通过以下两种方式进行整合：

  • 自定义整合 Druid 
  • 通过 starter 整合 Druid 

<!--自定义整合需要编写一个与之相关的配置类-->
<dependency>
<groupId>com.alibaba</groupId>
<artifactId>druid</artifactId>
<version>1.2.6</version>
</dependency>

Druid 内置 Filter 配置

Druid Spring Boot Starter 对以下 Druid 内置 Filter，都提供了默认配置：

  • StatFilter
  • WallFilter
  • ConfigFilter
  • EncodingConvertFilter
  • Slf4jLogFilter
  • Log4jFilter
  • Log4j2Filter
  • CommonsLogFilter

二十、整合MyBatis

引入依赖

Spring Boot 整合 MyBatis 的第一步，就是在项目的 pom.xml 中引入 mybatis-spring-boot-starter 的依赖，示例代码如下。

  1. <!--引入 mybatis-spring-boot-starter 的依赖-->
  2. <dependency>
  3. <groupId>org.mybatis.spring.boot</groupId>
  4. <artifactId>mybatis-spring-boot-starter</artifactId>
  5. <version>2.2.0</version>
  6. </dependency>

配置 MyBatis

在 Spring Boot 的配置文件（application.properties/yml）中对 MyBatis 进行配置，例如指定 mapper.xml 的位置、实体类的位置、是否开启驼峰命名法等等，示例代码如下。

###################################### MyBatis 配置######################################
mybatis:
# 指定 mapper.xml 的位置
mapper-locations: classpath:mybatis/mapper/*.xml
#扫描实体类的位置,在此处指明扫描实体类的包，在 mapper.xml 中就可以不写实体类的全路径名
type-aliases-package: net.biancheng.www.bean
configuration:
#默认开启驼峰命名法，可以不用设置该属性
map-underscore-to-camel-case: true

注解方式

通过上面的学习，我们知道 mapper 映射文件其实就是一个 XML 配置文件，它存在 XML 配置文件的通病，即编写繁琐，容易出错。即使是一个十分简单项目，涉及的 SQL 语句也都十分简单，我们仍然需要花费一定的时间在mapper 映射文件的配置上。

为了解决这个问题，MyBatis 针对实际实际业务中使用最多的“增伤改查”操作，分别提供了以下注解来替换 mapper 映射文件，简化配置：

    • @Select
    • @Insert
    • @Update
    • @Delete

二十一、自定义starter

可以分为以下 7 步：

  1. 创建工程
  2. 添加 POM 依赖
  3. 定义 propertie 类
  4. 定义 Service 类
  5. 定义配置类
  6. 创建 spring.factories文件
  7. 构建 starter

HelloAutoConfiguration 使用了以下 4 个注解：

  • @Configuration：表示该类是一个配置类；
  • @EnableConfigurationProperties(HelloProperties.class)：该注解的作用是为 HelloProperties 开启属性配置功能，并将这个类以组件的形式注入到容器中；
  • @ConditionalOnMissingBean(HelloService.class)：该注解表示当容器中没有 HelloService 类时，该方法才生效；
  • @Bean：该注解用于将方法的返回值以 Bean 对象的形式添加到容器中。

二十二、入口类和@SpringBootApplication 

@SpringBootApplication注解主要(我这里说了主要喔)组合了 @Configuration,@EnableAutoConfiguration,@ComponentScan

言外之意就是可以将这三个注解直接替换@SpringBootApplication

1.@EnableAutoCOnfiguration让Spring Boot根据类路径中的jar包依赖为当前项目进行自动配置。例如添加了spring-boot-starter-web依赖，会自动添加Tomcat和Spring MVC的依赖，Spring Boot就会对Tomcat和Spring MVC进行自动配置。
2.@ComponentScan 让Spring Boot去扫描与入口类同级以及以下包的Bean(使用注解配置的)，把他们添加到Spring容器，若为JPA项目还可以扫描标注@Entity的实体类。
3.@Configuration 表示当前是一个配置类，也会被Spring进行加载

@SpringBootApplication(exclude = {DataSourceAutoConfiguration.class})  关闭特定的自动配置

二十三、整合mybatis-generator-maven-plugin

包含几块内容：

（a）classPathEntry 标签定义的是mysql-connector的jar包地址

（b）jdbcConnection 数据库连接信息

（c）javaModelGenerator、sqlMapGenerator、javaClientGenerator定义的是生成文件存放的地址；

（d）table具体执行生成代码的tabel，增加几个标签，不生成example方法。

二十四、springboot-权限控制shiro

2.1.2 整体说明

shiro的demo项目主要包含三块内容：

（1）1是pom文件，获取相关jar包；

（2）2是资源（resources），一个配置文件以及6个演示页面；

（3）3是主类，包含启动类、控制类、shiro配置类。

2.1.3 shiro 过滤器说明

（1）认证过滤器
anon：用户不需要认证也可以访问
authc: 用户必须认证才可以访问
user：用户只要rememberMe，就可以访问
（2）授权过滤器
perms: 基于资源的授权过滤器
roles : 基于角色的授权过滤器

使用了anon、authc认证过滤与perms资源授权过滤器，简单说shiro就是通过这些过滤器实现的权限控制。

二十五、springboot-多模块相关

（a）springboot不同环境打包-profiles

（b）springboot+druid连接池及监控配置

（c）前后端分离之Swagger2

（d）springboot与logback配置

（a）RestTemplate替换HttpClient

（b）springboot+redis实现session共享

（c）springboot定时任务配置

（d）springboot+mybatis分页插件PageHelper

（a）springboot打war包

（b）springboot不加载mapper文件问题解析

（c）SpringBoot中快速操作Mongodb

二十六、SpringBoot应用跨域访问解决方案

包含几块内容：

（a）第一类方案：前端解决方案

（b）第二类方案：使用代理 　　

（c）第三类方案：CORS

（d）SpringBoot下实现CORS的四种方式

3.1.使用CorsFilter进行全局跨域配置

3.2. 重写WebMvcConfigurer的addCorsMappings方法（全局跨域配置）

3.3.使用CrossOrigin注解（局部跨域配置）

3.4 使用HttpServletResponse设置响应头(局部跨域配置)

二十七、SpringBoot多数据源：动态数据源

主要有以下几个包：

├─annotation ---- // 自定义注解
├─aop ----------- // 切面
├─config -------- // 数据源配置
├─constants ----- // 常用注解
├─context ------- // 自定义上下文
├─controller ---- // 访问接口
├─entity -------- // 实体
├─mapper -------- // 数据库dao操作
├─service ------- // 服务类
└─vo ------------ // 视图返回数据

实现方式：

数据库连接信息配置master-slave
数据源配置DynamicDataSourceConfig
添加动态数据源类 AbstractRoutingDataSource
数据源 key 的上下文--ThreadLocal
设置动态数据 DynamicDataSource 路由策略使用

AOP 选择数据源，切面实现细节

二十八、SpringBootApplication背后的秘密

@Target(ElementType.TYPE)            // 注解的适用范围，其中TYPE用于描述类、接口（包括包注解类型）或enum声明
@Retention(RetentionPolicy.RUNTIME)  // 注解的生命周期，保留到class文件中（三个生命周期）
@Documented                          // 表明这个注解应该被javadoc记录
@Inherited                           // 子类可以继承该注解
@SpringBootConfiguration             // 继承了Configuration，表示当前是注解类
@EnableAutoConfiguration             // 开启springboot的注解功能，springboot的四大神器之一，其借助@import的帮助
@ComponentScan(excludeFilters = {    // 扫描路径设置（具体使用待确认）
        @Filter(type = FilterType.CUSTOM, classes = TypeExcludeFilter.class),
        @Filter(type = FilterType.CUSTOM, classes = AutoConfigurationExcludeFilter.class) })
public @interface SpringBootApplication {
...
}

虽然定义使用了多个Annotation进行了原信息标注，但实际上重要的只有三个Annotation：

  • @Configuration（@SpringBootConfiguration点开查看发现里面还是应用了@Configuration）
  • @EnableAutoConfiguration
  • @ComponentScan

JavaConfig形式的Spring Ioc容器的配置类使用的那个@Configuration，SpringBoot社区推荐使用基于JavaConfig的配置形式，所以，这里的启动类标注了@Configuration之后，本身其实也是一个IoC容器的配置类。

@ComponentScan这个注解在Spring中很重要，它对应XML配置中的元素，@ComponentScan的功能其实就是自动扫描并加载符合条件的组件（比如@Component和@Repository等）或者bean定义，最终将这些bean定义加载到IoC容器中。

@EnableAutoConfiguration这个Annotation最为重要，所以放在最后来解读，大家是否还记得Spring框架提供的各种名字为@Enable开头的Annotation定义？比如@EnableScheduling、@EnableCaching、@EnableMBeanExport等，@EnableAutoConfiguration的理念和做事方式其实一脉相承，简单概括一下就是，借助@Import的支持，收集和注册特定场景相关的bean定义。

  • @EnableScheduling是通过@Import将Spring调度框架相关的bean定义都加载到IoC容器。
  • @EnableMBeanExport是通过@Import将JMX相关的bean定义加载到IoC容器。

两个比较重要的注解：

  • @AutoConfigurationPackage：自动配置包

  • @Import: 导入自动配置的组件

 

posted @ 2022-05-07 07:34  hanease  阅读(85)  评论(0)  编辑  收藏  举报