SpringBoot3学习总结

一.SpringBoot3介绍

(一)主要目标

SpringBoot的主要目标是：

为所有 Spring 开发提供更快速、可广泛访问的入门体验。

开箱即用，设置合理的默认值，但是也可以根据需求进行适当的调整

提供一系列大型项目通用的非功能性程序（如嵌入式服务器、安全性、指标、运行检查等）。

约定大于配置，基本不需要主动编写配置类、也不需要 XML 配置文件

(二)系统要求


技术&工具	版本（or later）
maven	3.6.3 or later 3.6.3 或更高版本
Tomcat	10.0+
Servlet	9.0+
JDK	17+

(三)快速入门

1.创建空项目

2.创建maven模块

3添加依赖(springboot父工程依赖 , web启动器依赖)

pom.xml文件

<?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>
    <parent>
        <!--  springboot父工程依赖  -->
        <groupId>org.springframework.boot</groupId>
        <artifactId>spring-boot-starter-parent</artifactId>
        <version>3.0.5</version>
    </parent>
    <groupId>com.yan</groupId>
    <artifactId>springboot-base-quick-01</artifactId>
    <version>1.0-SNAPSHOT</version>
    <!--导入对应的启动器-->
    <dependencies>
        <dependency>
            <groupId>org.springframework.boot</groupId>
            <artifactId>spring-boot-startelr-web</artifactId>
        </dependency>
    </dependencies>

</project>

为什么依赖不需要写版本？

每个boot项目都有一个父项目spring-boot-starter-parent

parent的父项目是spring-boot-dependencies

父项目版本仲裁中心，把所有常见的jar的依赖版本都声明好了

什么是启动器?

Spring Boot提供了一种叫做Starter的概念，它是一组预定义的依赖项集合，旨在简化Spring应用程序的配置和构建过程。Starter包含了一组相关的依赖项，以便在启动应用程序时自动引入所需的库、配置和功能。

Spring Boot提供了许多预定义的Starter，例如spring-boot-starter-web用于构建Web应用程序，spring-boot-starter-data-jpa用于使用JPA进行数据库访问，spring-boot-starter-security用于安全认证和授权等等。

4.创建启动类

@SpringBootApplication是一个特殊的注解，用于标识一个Spring Boot应用程序的入口类。它的主要作用是将三个常用注解组合在一起，简化了配置的过程。

@SpringBootApplication注解包含以下三个注解的功能：

@Configuration：将该类标识为应用程序的配置类。它允许使用Java代码定义和配置Bean。

@EnableAutoConfiguration：启用Spring Boot的自动配置机制。它根据项目的依赖项自动配置Spring应用程序的行为。自动配置根据类路径、注解和配置属性等条件来决定要使用的功能和配置。

@ComponentScan：自动扫描并加载应用程序中的组件，如控制器、服务、存储库等。它默认扫描@SpringBootApplication注解所在类的包及其子包中的组件。

//启动类
@SpringBootApplication
public class Main {
    public static void main(String[] args) {
        //自动创建ioc容器,启动tomcat服务器软件
        SpringApplication.run(Main.class,args);

    }
}

5.编写处理器controller

IoC和DI注解需要在启动类的同包或者子包下方可生效！无需指定，约束俗称。

6.启动测试

由日志可知路径是localhost:8080

二.SpringBoot3配置文件

(一)统一配置管理

SpringBoot工程下，进行统一的配置管理，你想设置的任何参数（端口号、项目根路径、数据库连接信息等等)都集中到一个固定位置和命名的配置文件（application.properties或application.yml）中！

配置文件应该放置在Spring Boot工程的src/main/resources目录下。这是因为src/main/resources目录是Spring Boot默认的类路径（classpath），配置文件会被自动加载并可供应用程序访问。

如果同时存在application.properties | application.yml(.yaml) , properties的优先级更高。

(二) 属性配置文件使用

1.application.properties 配置文件

在 resource 文件夹下面新建 application.properties 配置文件

# application.properties 为统一配置文件
# 内部包含: 固定功能的key,自定义的key
# 此处的配置信息,我们都可以在程序中@Value等注解读取

# 固定的key
# 启动端口号
server.port=80 

# 自定义
spring.jdbc.datasource.driverClassName=com.mysql.cj.jdbc.driver
spring.jdbc.datasource.url=jdbc:mysql:///springboot_01
spring.jdbc.datasource.username=root
spring.jdbc.datasource.password=root

2.yml配置文件

数据结构用树形结构呈现，通过缩进来表示层级，
连续的项目（集合）通过减号 ” - ” 来表示
键值结构里面的key/value对用冒号 ” : ”+空格来分隔。
YAML配置文件的扩展名是yaml 或 yml

# YAML配置文件示例
app_name: 我的应用程序
version: 1.0.0
author: 张三

database:
  host: localhost
  port: 5432
  username: admin
  password: password123

features:
  - 登录
  - 注册
  - 仪表盘

settings:
  analytics: true
  theme: dark

(三)批量配置文件注入

@Value(key必须写全)

@Value只能读单个值

@ConfigurationProperties是SpringBoot提供的重要注解, 他可以将一些配置属性批量注入到bean对象。

1.编写yml文件

spring:
  jdbc:
    datasource:
      driverClassName: com.mysql.jdbc.Driver
      url: jdbc:mysql://127.0.0.1:3307/mybatis-example?serverTimezone=UTC
      username: root
      password: 1234567

server:
  port: 8080

2.创建类,添加属性和注解

在类上通过@ConfigurationProperties注解声明该类要读取属性配置

prefix="spring.jdbc.datasource" 读取属性文件中前缀为spring.jdbc.datasource的值。前缀和属性名称和配置文件中的key必须要保持一致才可以注入成功

@Data
@Component
@ConfigurationProperties(prefix = "spring.jdbc.datasource")
public class DataSourceProperties {
    private String driverClassName;
    private String url;
    private String username;
    private String password;

    @Override
    public String toString() {
        return "DataSourceProperties{" +
                "driverClassName='" + driverClassName + '\'' +
                ", url='" + url + '\'' +
                ", username='" + username + '\'' +
                ", password='" + password + '\'' +
                '}';
    }
}

3.测试

@RestController
@RequestMapping("hello")
public class HelloController {
    @Autowired
    private DataSourceProperties dataSourceProperties;

    @GetMapping("properties")
    public void printProperties() {
        System.out.println(dataSourceProperties);
    }


}

(四) 多环境配置和使用

创建开发、测试、生产三个环境的配置文件

开发

spring:
  jdbc:
    datasource:
      driverClassName: com.mysql.cj.jdbc.Driver
      url: jdbc:mysql:///dev
      username: root
      password: root

测试

spring:
  jdbc:
    datasource:
      driverClassName: com.mysql.cj.jdbc.Driver
      url: jdbc:mysql:///test
      username: root
      password: root

生产

spring:
  jdbc:
    datasource:
      driverClassName: com.mysql.cj.jdbc.Driver
      url: jdbc:mysql:///prod
      username: root
      password: root

环境激活

spring:
  profiles:
    active: dev

如果设置了spring.profiles.active，并且和application有重叠属性，以active设置优先。

如果设置了spring.profiles.active，和application无重叠属性，application设置依然生效！

三.SpringBoot3整合SpringMVC

(一)Web相关配置

application.yml

# web相关的配置
# https://docs.spring.io/spring-boot/docs/current/reference/html/application-properties.html#appendix.application-properties.server
server:
  # 端口号设置
  port: 80
  # 项目根路径
  servlet:
    context-path: /boot

1.server.port:指定应用程序的HTTP服务器端口号。默认情况下，Spring Boot使用8080作为默认端口。

2.server.servlet.context-path:设置应用程序的上下文路径。这是应用程序在URL中的基本路径。默认情况下，上下文路径为空。

3.spring.mvc.view.prefix和spring.mvc.view.suffix:这两个属性用于配置视图解析器的前缀和后缀。

4.spring.resources.static-locations:配置静态资源的位置。静态资源可以是CSS、JavaScript、图像等。默认情况下，Spring Boot会将静态资源放在classpath:/static目录下。

5.spring.http.encoding.charset和spring.http.encoding.enabled:这两个属性用于配置HTTP请求和响应的字符编码

spring.http.encoding.charset定义字符编码的名称（例如UTF-8），spring.http.encoding.enabled用于启用或禁用字符编码的自动配置。

(二)静态资源的处理

1.默认路径

默认的静态资源路径为：

· classpath:/META-INF/resources/

· classpath:/resources/

· classpath:/static/

· classpath:/public/

我们只要静态资源放在这些目录中任何一个，SpringMVC都会帮我们处理

我们习惯会把静态资源放在classpath:/static/ 目录下。在resources目录下创建index.html文件

打开浏览器输入 : http://localhost:8080/index.html

2.覆盖路径

# web相关的配置
# https://docs.spring.io/spring-boot/docs/current/reference/html/application-properties.html#appendix.application-properties.server
server:
  # 端口号设置
  port: 80
  # 项目根路径
  servlet:
    context-path: /boot
spring:
  web:
    resources:
      # 配置静态资源地址,如果设置,会覆盖默认值
      static-locations: classpath:/webapp

访问地址：http://localhost/boot/login.html

(三)自定义拦截器

1.拦截器声明

@Component
public class MyInterceptor implements HandlerInterceptor {
    @Override
    public boolean preHandle(HttpServletRequest request, HttpServletResponse response, Object handler) throws Exception {
        System.out.println("拦截器.......");
        return  true;
    }
}

2.拦截器配置

配置类要在启动类的同包或者子包方可生效！

@Configuration
public class WebMvcConfig implements WebMvcConfigurer {
    //配置拦截器
    @Autowired
    private MyInterceptor myInterceptor ;
    @Override
    public void addInterceptors(InterceptorRegistry myInterceptor) {
        myInterceptor.addInterceptor(new MyInterceptor()).addPathPatterns("/**");;
    }
}

3.测试

@RestController
@RequestMapping("spring-boot")
public class Controller {
    @GetMapping("test")
    public String getString() {
        return "测试";
    }
}

四.SpringBoot3整合Druid数据源

1.创建程序

2.导入依赖

<?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>

    <parent>
        <groupId>org.springframework.boot</groupId>
        <artifactId>spring-boot-starter-parent</artifactId>
        <version>3.0.5</version>
    </parent>
    <groupId>com.atguigu</groupId>
    <artifactId>springboot-starter-druid-04</artifactId>
    <version>1.0-SNAPSHOT</version>

    <properties>
        <maven.compiler.source>17</maven.compiler.source>
        <maven.compiler.target>17</maven.compiler.target>
        <project.build.sourceEncoding>UTF-8</project.build.sourceEncoding>
    </properties>


    <dependencies>
        <!--  web开发的场景启动器 -->
        <dependency>
            <groupId>org.springframework.boot</groupId>
            <artifactId>spring-boot-starter-web</artifactId>
        </dependency>

        <!-- 数据库相关配置启动器 jdbctemplate 事务相关-->
        <dependency>
            <groupId>org.springframework.boot</groupId>
            <artifactId>spring-boot-starter-jdbc</artifactId>
        </dependency>

        <!-- druid启动器的依赖  -->
        <dependency>
            <groupId>com.alibaba</groupId>
            <artifactId>druid-spring-boot-3-starter</artifactId>
            <version>1.2.18</version>
        </dependency>

        <!-- 驱动类-->
        <dependency>
            <groupId>mysql</groupId>
            <artifactId>mysql-connector-java</artifactId>
            <version>8.0.28</version>
        </dependency>

        <dependency>
            <groupId>org.projectlombok</groupId>
            <artifactId>lombok</artifactId>
            <version>1.18.28</version>
        </dependency>

    </dependencies>

    <!--    SpringBoot应用打包插件-->
    <build>
        <plugins>
            <plugin>
                <groupId>org.springframework.boot</groupId>
                <artifactId>spring-boot-maven-plugin</artifactId>
            </plugin>
        </plugins>
    </build>

</project>

3.启动类

@SpringBootApplication
public class MainApplication {

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

4.配置文件编写

spring:
  datasource:
    type:
      com.alibaba.druid.pool.DruidDataSource #使用druid连接池

    druid:
      url: jd
      username: dfs
      password: 1234567
      driver-class-name: jdbc:mysql://127.0.0.1:3307/mybatis-example?serverTimezone=UTC
      # 初始化时建立物理连接的个数
      initial-size: 5
      # 连接池的最小空闲数量
      min-idle: 5
        # 连接池最大连接数量
      max-active: 20
        # 获取连接时最大等待时间，单位毫秒
      max-wait: 60000
        # 申请连接的时候检测，如果空闲时间大于timeBetweenEvictionRunsMillis，执行validationQuery检测连接是否有效。
      test-while-idle: true
        # 既作为检测的间隔时间又作为testWhileIdel执行的依据
      time-between-eviction-runs-millis: 60000
        # 销毁线程时检测当前连接的最后活动时间和当前时间差大于该值时，关闭当前连接(配置连接在池中的最小生存时间)
      min-evictable-idle-time-millis: 30000
        # 用来检测数据库连接是否有效的sql 必须是一个查询语句(oracle中为 select 1 from dual)
      validation-query: select 1
        # 申请连接时会执行validationQuery检测连接是否有效,开启会降低性能,默认为true
      test-on-borrow: false
        # 归还连接时会执行validationQuery检测连接是否有效,开启会降低性能,默认为true
      test-on-return: false
        # 是否缓存preparedStatement, 也就是PSCache,PSCache对支持游标的数据库性能提升巨大，比如说oracle,在mysql下建议关闭。
      pool-prepared-statements: false
        # 要启用PSCache，必须配置大于0，当大于0时，poolPreparedStatements自动触发修改为true。在Druid中，不会存在Oracle下PSCache占用内存过多的问题，可以把这个数值配置大一些，比如说100
      max-pool-prepared-statement-per-connection-size: -1
        # 合并多个DruidDataSource的监控数据
      use-global-data-source-stat: true

5.编写Controller

实体类

@Data
public class User {

    private int id;
    private String username;
    private String password;
}

controller

@Slf4j
@Controller
@RequestMapping("/user")
public class UserController {
    //只要导入了jdbc启动器,jdbcTemplate被放入ioc容器
    @Autowired
    private JdbcTemplate jdbcTemplate;

    @GetMapping("/getUser")
    @ResponseBody
    public List<User> getUser() {
        String sql = "select * from user ; ";
        List<User> user = jdbcTemplate.query(sql, new BeanPropertyRowMapper<>(User.class));
        log.info("查询的user数据为:{}", user.toString());
        return user;
    }

}

6.解决问题

通过源码分析，druid-spring-boot-3-starter目前最新版本是1.2.18，虽然适配了SpringBoot3，但缺少自动装配的配置文件，需要手动在resources目录下创建META-INF/spring/org.springframework.boot.autoconfigure.AutoConfiguration.imports，文件内容如下!

com.alibaba.druid.spring.boot3.autoconfigure.DruidDataSourceAutoConfigure

7.测试

五.SpringBoot3整合Mybatis

(一)Mybatis整合

1.创建maven项目

2.导入依赖

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

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

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

    <!-- 数据库相关配置启动器 -->
    <dependency>
        <groupId>org.springframework.boot</groupId>
        <artifactId>spring-boot-starter-jdbc</artifactId>
    </dependency>

    <!-- druid启动器的依赖  -->
    <dependency>
        <groupId>com.alibaba</groupId>
        <artifactId>druid-spring-boot-3-starter</artifactId>
        <version>1.2.18</version>
    </dependency>

    <!-- 驱动类-->
    <dependency>
        <groupId>mysql</groupId>
        <artifactId>mysql-connector-java</artifactId>
        <version>8.0.28</version>
    </dependency>

    <dependency>
        <groupId>org.projectlombok</groupId>
        <artifactId>lombok</artifactId>
        <version>1.18.28</version>
    </dependency>

</dependencies>

3.配置文件

server:
  port: 80
  servlet:
    context-path: /
spring:
  datasource:
    type: com.alibaba.druid.pool.DruidDataSource
    druid:
      url: jdbc:mysql:///day01
      username: root
      password: root
      driver-class-name: com.mysql.cj.jdbc.Driver
      
mybatis:
  configuration:  # setting配置
    auto-mapping-behavior: full
    map-underscore-to-camel-case: true
    log-impl: org.apache.ibatis.logging.slf4j.Slf4jImpl
  type-aliases-package: com.xx.pojo # 配置别名
  mapper-locations: classpath:/mapper/*.xml # resources下mapperxml位置

4.解决druid的问题

com.alibaba.druid.spring.boot3.autoconfigure.DruidDataSourceAutoConfigure

5.创建实体类

package com.yan.pojo;

import lombok.Data;

@Data
public class User {
    private int id;
    private String username;
    private String password;
}

6.mapper接口创建

public interface UserMapper {

    List<User> queryAll();
}

7.Mapper接口实现（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.yan.mapper.UserMapper">

<select id="queryAll" resultType="user">
    select * from user;
</select>

</mapper>

8.启动类和接口扫描

@SpringBootApplication
@MapperScan("com.yan.mapper")//指定mapper接口的位置
public class Main {
    public static void main(String[] args) {
        SpringApplication.run(Main.class, args);
    }
}

9.创建Controller进行测试


@RestController
@RequestMapping("user")
public class UserController {
    @Autowired
    private UserMapper userMapper;
    @GetMapping
    @ResponseBody
    public List<User> query(){
        return userMapper.queryAll();
    }
}

10.测试结果

(二) 声明式事务整合

1.导入依赖

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

2.@Transactional注解

注：SpringBoot项目会自动配置一个 DataSourceTransactionManager，所以我们只需在方法（或者类）加上 @Transactional 注解，就自动纳入 Spring 的事务管理了

@Transactional
public void update(){
    User user = new User();
    user.setId(1);
    user.setPassword("test2");
    user.setAccount("test2");
    userMapper.update(user);
}

(三)AOP整合

1.导入依赖

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

2.使用aop注解

@Component
@Aspect
public class LogAdvice {

    @Before("execution(* com..service.*.*(..))")
    public void before(JoinPoint joinPoint){
        System.out.println("LogAdvice.before");
        System.out.println("joinPoint = " + joinPoint);
    }

}

六.SpringBoot3项目打包和运行

springboot内置服务器软件

命令执行 java -jar xx

(一)安装插件

在Spring Boot项目中添加spring-boot-maven-plugin插件是为了支持将项目打包成可执行的可运行jar包。如果不添加spring-boot-maven-plugin插件配置，使用常规的java -jar命令来运行打包后的Spring Boot项目是无法找到应用程序的入口点，因此导致无法运行。

<!--    SpringBoot应用打包插件-->
<build>
    <plugins>
        <plugin>
            <groupId>org.springframework.boot</groupId>
            <artifactId>spring-boot-maven-plugin</artifactId>
        </plugin>
    </plugins>
</build>

(二)执行打包

在idea点击package进行打包

可以在编译的target文件中查看jar包

(三)命令启动和参数说明

命令格式：java -jar [选项] [参数]

-D=：设置系统属性，可以通过System.getProperty()方法在应用程序中获取该属性值。例如：java -jar -Dserver.port=8080 myapp.jar

-X：设置JVM参数，例如内存大小、垃圾回收策略等。常用的选项包括：

-Xmx：设置JVM的最大堆内存大小，例如 -Xmx512m 表示设置最大堆内存为512MB

-Xms：设置JVM的初始堆内存大小，例如 -Xms256m 表示设置初始堆内存为256MB。

-Dspring.profiles.active=：指定Spring Boot的激活配置文件，可以通过application-.properties或application-.yml文件来加载相应的配置。例如：java -jar -Dspring.profiles.active=dev myapp.jar。 -D 参数必须要在jar之前！否者不生效！