Code Guide

外观

SpringBoot数据访问

约 6461 字大约 22 分钟

2025-09-04

自动配置原理

主程序：

@MapperScan("com.atguigu.admin.mapper")
@ServletComponentScan(basePackages = "com.atguigu.admin")
@SpringBootApplication(exclude = RedisAutoConfiguration.class)
public class Boot05WebAdminApplication {

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

SpringBootApplication注解：

@Target(ElementType.TYPE)
@Retention(RetentionPolicy.RUNTIME)
@Documented
@Inherited
@SpringBootConfiguration
@EnableAutoConfiguration
@ComponentScan(excludeFilters = { @Filter(type = FilterType.CUSTOM, classes = TypeExcludeFilter.class),
		@Filter(type = FilterType.CUSTOM, classes = AutoConfigurationExcludeFilter.class) })
public @interface SpringBootApplication {}

重点理解*EnableAutoConfiguration*注解。

1、SQL

整合其他数据源开发的步骤：

  • 导入需要的某一个starter场景，场景会自动导入非常多的自动配置类
  • ***autoCon,自动配置类又会导入非常多的组件，比如操作数据库，会导入数据源，数据源的配置信息会和properties()里面的配置项进行绑定。配置项会和配置文件进行绑定读取配置。

1.1、数据源的自动配置-HikariDataSourcex

只要我们导入jdbc场景，springboot会给我们的容器中放一个HikariDataSourcex数据源，以后就可以从这个数据源中获取链接对数据库操作，目前是最好的数据源产品。

1.1.1、导入JDBC场景

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

1.1.2、分析自动配置

首先分析导入的jdbc导入了哪些内容,点进去spring-boot-starter-data-jdbc的相关依赖，可以看到导入的依赖：

在点进去spring-boot-starter-jdbc的依赖，可以发现导入一下内容：

依赖：

https://cdn.nlark.com/yuque/0/2020/png/1354552/1606366100317-5e0199fa-6709-4d32-bce3-bb262e2e5e6a.png?x-oss-process=image%2Fwatermark%2Ctype_d3F5LW1pY3JvaGVp%2Csize_20%2Ctext_YXRndWlndS5jb20g5bCa56GF6LC3%2Ccolor_FFFFFF%2Cshadow_50%2Ct_80%2Cg_se%2Cx_10%2Cy_10

数据库驱动？

为什么导入JDBC场景，官方不导入驱动？官方不知道我们接下要操作什么数据库。

数据库版本和驱动版本对应

1.2、分析自动配置

@Import注解提供了三种用法

1、@Import一个普通类 spring会将该类加载到spring容器中

2、@Import一个类，该类实现了ImportBeanDefinitionRegistrar接口，在重写的registerBeanDefinitions方法里面，能拿到BeanDefinitionRegistrybd的注册器，能手工往beanDefinitionMap中注册 beanDefinition

3、@Import一个类，该类实现了ImportSelector 重写selectImports方法该方法返回了String[]数组的对象，数组里面的类都会注入到spring容器当中

@EnableConfigurationProperties注解的作用是：使使用 @ConfigurationProperties 注解的类生效。

  • 如果一个配置类只配置@ConfigurationProperties注解，而没有使用@Component或者实现了@Component的其他注解，那么在IOC容器中是获取不到properties 配置文件转化的bean。说白了 @EnableConfigurationProperties 相当于把使用 @ConfigurationProperties 的类进行了一次注入。
  • 简单点说@EnableConfigurationProperties的功能类似于@Component。

@ConfigurationProperties作用：

在 SpringBoot 中，当想需要获取到配置文件数据时，除了可以用 Spring 自带的 @Value 注解外，SpringBoot 还提供了一种更加方便的方式：@ConfigurationProperties。只要在 Bean 上添加上了这个注解，指定好配置文件的前缀，那么对应的配置文件数据就会自动填充到 Bean 中。

1.2.1、自动配置的类

关于jdbc的自动配置：

Untitled

关于整个数据库的配置：

Untitled

  • DataSourceAutoConfiguration ： 数据源的自动配置，相当于帮助我们配置好底层使用好的数据库连接池。
    • 修改数据源相关的配置：通过在ymal文件中修改spring.datasource绑定的配置选项即可。
    • 数据库连接池的配置，是自己容器中没有DataSource才自动配置的
    • 底层配置好的连接池是：HikariDataSource
	@Configuration(proxyBeanMethods = false)
	@Conditional(PooledDataSourceCondition.class)
	@ConditionalOnMissingBean({ DataSource.class, XADataSource.class })
//下面表示导入的数据库连接池
	@Import({ DataSourceConfiguration..class, DataSourceConfiguration.Tomcat.class,
			DataSourceConfiguration.Dbcp2.class, DataSourceConfiguration.OracleUcp.class,
			DataSourceConfiguration.Generic.class, DataSourceJmxConfiguration.class })
	protected static class PooledDataSourceConfiguration
在DataSourceConfiguration类中配置了很多数据源，因为我们在导入启动器的时候，系统默认给我们导入了Hikar数据源，所以系统中默认是DataSourceConfiguration数据源
  • DataSourceTransactionManagerAutoConfiguration： 数据源事务管理器的自动配置
  • JdbcTemplateAutoConfiguration： JdbcTemplate的自动配置，可以来对数据库进行crud操作，轻量级的操作数据库工具。
    • 可以修改这个配置项@ConfigurationProperties(prefix = "spring.jdbc") 来修改JdbcTemplate
  • @Bean@Primary JdbcTemplate；容器中有这个组件
  • JndiDataSourceAutoConfiguration： jndi的自动配置
  • XADataSourceAutoConfiguration： 分布式事务相关的自动配置。

关于数据源自动配置源码分析：

1.2.2、修改配置项

#配置数据源
spring:
  datasource:
    url: jdbc:mysql://localhost:3306/gmall
    username: root
    password: root
    driver-class-name: com.mysql.jdbc.Driver # 数据库驱动

1.2.3、测试

1.3、使用Druid数据源

1.3.1、druid官方github地址

https://github.com/alibaba/druid

整合第三方技术的两种方式

  • 手动自定义
  • 找starter场景，starter通过自动配置类，将组件导入到容器中，而组件的核心配置项和配置文件绑定，很方便开发。

1.3.2、自定义方式

1、创建数据源

但是在springboot中，我们可以通过写一个配置类进行配置数据源。

自定义jdbcTemplate:

2、StatViewServlet

StatViewServlet的用途包括：

  • 提供监控信息展示的html页面
  • 提供监控信息的JSON API
	<servlet>
		<servlet-name>DruidStatView</servlet-name>
		<servlet-class>com.alibaba.druid.support.http.StatViewServlet</servlet-class>
	</servlet>
	<servlet-mapping>
		<servlet-name>DruidStatView</servlet-name>
		<url-pattern>/druid/*</url-pattern>
	</servlet-mapping>

3、StatFilter

用于统计监控信息；如SQL监控、URI监控

需要给数据源中配置如下属性；可以允许多个filter，多个用，分割；如：

<property name="filters" value="stat,slf4j" />

系统中所有filter：

别名Filter类名
defaultcom.alibaba.druid.filter.stat.StatFilter
statcom.alibaba.druid.filter.stat.StatFilter
mergeStatcom.alibaba.druid.filter.stat.MergeStatFilter
encodingcom.alibaba.druid.filter.encoding.EncodingConvertFilter
log4jcom.alibaba.druid.filter.logging.Log4jFilter
log4j2com.alibaba.druid.filter.logging.Log4j2Filter
slf4jcom.alibaba.druid.filter.logging.Slf4jLogFilter
commonloggingcom.alibaba.druid.filter.logging.CommonsLogFilter

慢SQL记录配置

<bean id="stat-filter" class="com.alibaba.druid.filter.stat.StatFilter">
    <property name="slowSqlMillis" value="10000" />
    <property name="logSlowSql" value="true" />
</bean>

使用 slowSqlMillis 定义慢SQL的时长

1.3.3、使用官方starter方式

1、引入druid-starter

官方的starter引入的依赖：

Untitled

2、分析自动配置

Untitled

数据源配置分析：

  • 扩展配置项 spring.datasource.druid,这个类里面扩展了配置
  • DruidSpringAopConfiguration.class, 监控SpringBean的；配置项：spring.datasource.druid.aop-patterns，只需要修改这些配置项，就可以对SpringBean进行配置。
  • DruidStatViewServletConfiguration.class, 监控页的配置：spring.datasource.druid.stat-view-servlet；默认开启
  • DruidWebStatFilterConfiguration.class, web监控配置；spring.datasource.druid.web-stat-filter；默认开启
  • DruidFilterConfiguration.class： 所有Druid自己filter的配置
这些filter默认都是配置好的
private static final String FILTER_STAT_PREFIX = "spring.datasource.druid.filter.stat";
    private static final String FILTER_CONFIG_PREFIX = "spring.datasource.druid.filter.config";
    private static final String FILTER_ENCODING_PREFIX = "spring.datasource.druid.filter.encoding";
    private static final String FILTER_SLF4J_PREFIX = "spring.datasource.druid.filter.slf4j";
    private static final String FILTER_LOG4J_PREFIX = "spring.datasource.druid.filter.log4j";
    private static final String FILTER_LOG4J2_PREFIX = "spring.datasource.druid.filter.log4j2";
    private static final String FILTER_COMMONS_LOG_PREFIX = "spring.datasource.druid.filter.commons-log";
    private static final String FILTER_WALL_PREFIX = "spring.datasource.druid.filter.wall";

3、配置示例

SpringBoot配置示例

https://github.com/alibaba/druid/tree/master/druid-spring-boot-starter

配置项列表https://github.com/alibaba/druid/wiki/DruidDataSource%E9%85%8D%E7%BD%AE%E5%B1%9E%E6%80%A7%E5%88%97%E8%A1%A8

1.4、整合MyBatis操作

https://github.com/mybatis

starter:

  • SpringBoot官方的Starter：spring-boot-starter-*
  • 第三方的： *-spring-boot-starter
<!--引入mybatis的starter-->
<dependency>
            <groupId>org.mybatis.spring.boot</groupId>
            <artifactId>mybatis-spring-boot-starter</artifactId>
            <version>2.1.4</version>
</dependency>

Untitled

导入starter:

Untitled

springboot启动之后，会找EnableAutoConfiguration，会自动导入spring.factories下面的内容，也就是加载jar包时候会自动导入以下两个组件：

org.mybatis.spring.boot.autoconfigure.MybatisLanguageDriverAutoConfiguration,\
org.mybatis.spring.boot.autoconfigure.MybatisAutoConfiguration

代码分析：

1.4.1、配置模式写sql查询

之前配置mybatis需要配置一下内容：

  • 全局配置文件
  • SqlSessionFactory: 在自动配置文件中已经帮我们配置好了
  • SqlSession：自动配置了 SqlSessionTemplate 组合了SqlSession
  • @Import(AutoConfiguredMapperScannerRegistrar.class）:配置自动扫描mapper接口文件的位置
    • Mapper： 只要我们写的操作MyBatis的接口标准了 @Mapper 就会被自动扫描进来
@EnableConfigurationProperties(MybatisProperties.class) ： MyBatis配置项绑定类。
@AutoConfigureAfter({ DataSourceAutoConfiguration.class, MybatisLanguageDriverAutoConfiguration.class })
public class MybatisAutoConfiguration{}

@ConfigurationProperties(prefix = "mybatis")
public class MybatisProperties

可以修改配置文件中 mybatis 开始的所有；

配置mybatis配置的两种方式：

  • 在mybatis-config.xml文件中配置
  • 在ymal配置文件中配置

配置 private Configuration configuration; mybatis.configuration下面的所有，就是相当于改mybatis全局配置文件中的值

springboot中集成mybatis的使用步骤：

  • 导入mybatis官方starter
  • 编写mapper接口。标注**@Mapper注解**
  • 编写sql映射文件并绑定mapper接口
  • 在application.yaml中指定Mapper配置文件的位置，以及指定全局配置文件的信息 （建议；配置在mybatis.configuration）

1.4.2、注解模式写sql查询

当查询的sql比较简单的时候，可以使用注解查询。

@Mapper
public interface CityMapper {
//    使用注解的方式查询
    @Select("select * from city where id=#{id}")
    public City getById(Long id);

    public void insert(City city);

}

1.4.3、混合模式

当查询的语句逻辑比较复杂，就可以使用混合模式，就是简单地sql使用注解方式查询，复杂的sql使用xml文件进行查询。注解和xml文件可以一起使用。

@Mapper
public interface CityMapper {

    @Select("select * from city where id=#{id}")
    public City getById(Long id);
//这个查询使用xml文件进行查询
    public void insert(City city);

}

最佳实战：

  1. 引入mybatis-starter
  2. 配置application.yaml中，指定mapper-location位置即可
  3. 编写Mapper接口并标注@Mapper注解
  4. 简单方法直接注解方式
  5. 复杂方法编写mapper.xml进行绑定映射
  6. @MapperScan("com.atguigu.admin.mapper") 简化，其他的接口就可以不用标注@Mapper注解，这个注解标注在主程序函数上，这样就可以自动扫描mapper接口。

1.5、整合 MyBatis-Plus 完成CRUD

1.5.1、什么是MyBatis-Plus

MyBatis-Plus（简称 MP）是一个 MyBatis 的增强工具，在 MyBatis 的基础上只做增强不做改变，为简化开发、提高效率而生。

mybatis plus 官网

建议安装 MybatisX 插件

1.5.2、整合MyBatis-Plus

 整合mybatis-plus场景
 <dependency>
            <groupId>com.baomidou</groupId>
            <artifactId>mybatis-plus-boot-starter</artifactId>
            <version>3.4.1</version>
</dependency>

Untitled

可以看到，mybatis-plus已经帮我们引入了spring-boot-starter-jdbc,所以我们在pom文件中可以不用在引入。

自动配置项：中自动配置了MybatisPlusAutoConfiguration，也就是项目一启动，就会自动加载这些配置。

Untitled

自动配置

  • MybatisPlusAutoConfiguration 配置类，MybatisPlusProperties 配置项绑定。mybatis-plus：xxx 就是对mybatis-plus的定制
  • SqlSessionFactory ，核心组件，自动配置好。底层是容器中默认的数据源
@Bean
@ConditionalOnMissingBean
public SqlSessionFactory sqlSessionFactory(DataSource dataSource) throws Exception {}
可以看到DataSource 数据源是从容器中获取，@Bean标注的方法，如果参数是一个对象，那么这个参数会自动的从容器中
获取组件，而容器中数据源是外部数据源，所以当前操作的也就是外部数据源，比如druid数据源。
  • mapperLocations 自动配置好的。有默认值。classpath:/mapper//*.xml；任意包的类路径下的所有mapper文件夹下任意路径下的所有xml都是sql映射文件。 建议以后sql映射文件，放在 mapper下*
  • 容器中也自动配置好了 SqlSessionTemplate
  • @Mapper 标注的接口也会被自动扫描；建议直@MapperScan("com.atguigu.admin.mapper") 批量扫描就行

原生mybatis写mapper接口，需要自己定义接口里面的方法，然后在xml文件或者使用注解的方式去查询数据库，在mybatis-plus汇总，有一个基类BaseMapper(*public interface* BaseMapper<T> *extends* Mapper<T>),有一个泛型T，想操作什么类型数据，指定类型即可。BaseMapper接口中已经定义了基础的crud功能，直接继承就不需要写crud方法。

Untitled

优点：

  • 只需要我们的Mapper继承 BaseMapper 就可以拥有crud能力
  • 要求，实体中的属性都要在数据库中存在。

*public class* ServiceImpl<M *extends* BaseMapper<T>, T> *implements* IService<T>{}

ServiceImpl接口中有两个泛型：

  • M *extends* BaseMapper<T>：指的是当前的service要操作那张表，就将那个表的mapper接口拿过来。
  • T：操作的表返回的类型。

Mapper是对一张表的crud操作。

1.5.3、CRUD功能

@Service
public class UserServiceImpl extends ServiceImpl<UserMapper,User> implements UserService {

}

public interface UserService extends IService<User> {

}

2、NoSQL

Redis 是一个开源（BSD许可）的，内存中的数据结构存储系统，它可以用作数据库、缓存和消息中间件。 它支持多种类型的数据结构，如 字符串（strings）， 散列（hashes）， 列表（lists）， 集合（sets）， 有序集合（sorted sets） 与范围查询， bitmaps， hyperloglogs 和 地理空间（geospatial） 索引半径查询。 Redis 内置了 复制（replication），LUA脚本（Lua scripting）， LRU驱动事件（LRU eviction），事务（transactions） 和不同级别的 磁盘持久化（persistence）， 并通过 Redis哨兵（Sentinel）和自动 分区（Cluster）提供高可用性（high availability）。

2.1、Redis自动配置

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

Untitled

官方整合的自动配置包都在autoConfigure目录下：

Untitled

自动配置：

  • RedisAutoConfiguration 自动配置类。RedisProperties 属性类 --> spring.redis.xxx是对redis的配置
  • 连接工厂是准备好的。LettuceConnectionConfiguration、JedisConnectionConfiguration
  • 自动注入了RedisTemplate<Object, Object> ：允许k-v都是object类型 xxxTemplate；和组件进行数据交互。
  • 自动注入了StringRedisTemplate；k：v都是String类型
  • key：value
  • 底层只要我们使用 StringRedisTemplate、RedisTemplate就可以操作redis

redis环境搭建

1、阿里云按量付费redis。经典网络

2、申请redis的公网连接地址

3、修改白名单 允许0.0.0.0/0 访问

2.2、RedisTemplate与Lettuce

    @Test
    void testRedis(){
        ValueOperations<String, String> operations = redisTemplate.opsForValue();

        operations.set("hello","world");

        String hello = operations.get("hello");
        System.out.println(hello);
    }

2.3、切换至jedis

贡献者

codingLab

版权归属：codingLab

许可证：bugcode

Code Guide © 2020-2025

项导文档说明

2025-08-17
- 已迁移至 docs.code-guide