5,注解开发总结
前面我们已经完成了XML配置和注解的开发实现,至于两者之间的差异,咱们放在一块去对比回顾下:
🧠 理论理解
这部分总结了Spring两种主流开发模式:XML配置与注解开发。XML强调“集中管理、配置清晰”,适用于大型、复杂的项目结构;而注解强调“约定优于配置”,开发速度快、代码简洁,适合敏捷开发。
Spring的核心在于IoC(控制反转)与DI(依赖注入)。无论是XML还是注解,它们的本质目标是一样的——管理bean及其依赖关系,降低代码耦合度、提升扩展性。
企业实战理解
🏢 企业实战理解
-
阿里巴巴:复杂的电商系统早期以XML配置为主,便于全局管理,但在大促等高频迭代阶段切换到注解开发,实现敏捷上线。
-
字节跳动:大量微服务工程采用纯注解模式,结合Spring Boot实现快速开发交付,尤其在内部工具链中完全弃用XML。
-
Google:GCP(Google Cloud Platform)服务后台中,Spring生态采用注解为主、XML为辅的混合方案,实现灵活配置。
-
NVIDIA:在AI训练平台API接口中,以注解简化微服务bean管理,配合自动化CI/CD上线数百个微服务实例。
-
OpenAI:ChatGPT接口网关项目中,核心微服务全部基于注解开发,确保可扩展性和部署一致性。
题目 1:Spring 中注解开发和 XML 配置开发的核心区别?分别适用什么场景?(字节、腾讯)
✅ 答案:
-
核心区别:
-
XML 配置是“外部配置”思想,Bean 信息集中管理,解耦代码与配置;
-
注解开发是“内聚配置”思想,Bean 信息与代码绑定,开发速度快。
-
-
适用场景:
-
XML 适用于大型项目、团队协作、频繁更换配置;
-
注解适用于中小型、敏捷开发、Spring Boot 工程。
-
题目 2:@Component、@Repository、@Service、@Controller 有什么区别?(阿里巴巴)
✅ 答案:
-
本质上功能一样,都是把类交给 Spring 容器管理。
-
区别在于语义:
-
@Component
:泛指组件; -
@Repository
:持久层,便于 DAO 异常转换; -
@Service
:业务层; -
@Controller
:控制层(Spring MVC 入口)。
-
场景题 1(阿里 + 字节)
场景描述:
你在开发一个大型互联网电商系统时,初期使用了注解开发的方式,随着项目规模扩大,发现代码中大量充斥着 @Service
、@Repository
等注解,导致后续需要迁移 Bean 定义或修改配置特别费劲。领导要求你总结问题并提出解决方案。
✅ 答案:
问题总结:
注解开发在项目初期开发效率高,但随着项目复杂度上升,注解与代码强绑定,灵活性差,难以适配不同环境。大量硬编码注解让配置修改、迁移变得繁琐。
解决方案:
-
引入 分层式 XML 配置 管理核心 Bean,将灵活多变的部分从注解中抽离出来;
-
推荐采用 Spring Boot + @Conditional + YAML 实现环境感知的动态配置,减少注解硬编码;
-
大厂实战案例:
-
阿里云团队在飞天云操作系统中,将早期注解 Bean 改为分组 XML+注解混合开发模式,以实现可热更新配置。
-
字节跳动在抖音后台,借助 Spring Profile + 注解开发结合的方案,在测试、灰度、生产环境中灵活切换。
-
6,Spring整合
课程学习到这里,已经对Spring有一个简单的认识了,Spring有一个容器,叫做IoC容器,里面保存bean。在进行企业级开发的时候,其实除了将自己写的类让Spring管理之外,还有一部分重要的工作就是使用第三方的技术。前面已经讲了如何管理第三方bean了,下面结合IoC和DI,整合2个常用技术,进一步加深对Spring的使用理解。
6.1 Spring整合Mybatis思路分析
6.1.1 环境准备
在准备环境的过程中,我们也来回顾下Mybatis开发的相关内容:
步骤1:准备数据库表
Mybatis是来操作数据库表,所以先创建一个数据库及表
create database spring_db character set utf8;
use spring_db;
create table tbl_account(
id int primary key auto_increment,
name varchar(35),
money double
);
步骤2:创建项目导入jar包
项目的pom.xml添加相关依赖
<dependencies>
<dependency>
<groupId>org.springframework</groupId>
<artifactId>spring-context</artifactId>
<version>5.2.10.RELEASE</version>
</dependency>
<dependency>
<groupId>com.alibaba</groupId>
<artifactId>druid</artifactId>
<version>1.1.16</version>
</dependency>
<dependency>
<groupId>org.mybatis</groupId>
<artifactId>mybatis</artifactId>
<version>3.5.6</version>
</dependency>
<dependency>
<groupId>mysql</groupId>
<artifactId>mysql-connector-java</artifactId>
<version>5.1.47</version>
</dependency>
</dependencies>
步骤3:根据表创建模型类
public class Account implements Serializable {
private Integer id;
private String name;
private Double money;
//setter...getter...toString...方法略
}
步骤4:创建Dao接口
public interface AccountDao {
@Insert("insert into tbl_account(name,money)values(#{name},#{money})")
void save(Account account);
@Delete("delete from tbl_account where id = #{id} ")
void delete(Integer id);
@Update("update tbl_account set name = #{name} , money = #{money} where id = #{id} ")
void update(Account account);
@Select("select * from tbl_account")
List<Account> findAll();
@Select("select * from tbl_account where id = #{id} ")
Account findById(Integer id);
}
步骤5:创建Service接口和实现类
public interface AccountService {
void save(Account account);
void delete(Integer id);
void update(Account account);
List<Account> findAll();
Account findById(Integer id);
}
@Service
public class AccountServiceImpl implements AccountService {
@Autowired
private AccountDao accountDao;
public void save(Account account) {
accountDao.save(account);
}
public void update(Account account){
accountDao.update(account);
}
public void delete(Integer id) {
accountDao.delete(id);
}
public Account findById(Integer id) {
return accountDao.findById(id);
}
public List<Account> findAll() {
return accountDao.findAll();
}
}
步骤6:添加jdbc.properties文件
resources目录下添加,用于配置数据库连接四要素
jdbc.driver=com.mysql.jdbc.Driver
jdbc.url=jdbc:mysql://localhost:3306/spring_db?useSSL=false
jdbc.username=root
jdbc.password=root
useSSL:关闭MySQL的SSL连接
步骤7:添加Mybatis核心配置文件
<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE configuration
PUBLIC "-//mybatis.org//DTD Config 3.0//EN"
"http://mybatis.org/dtd/mybatis-3-config.dtd">
<configuration>
<!--读取外部properties配置文件-->
<properties resource="jdbc.properties"></properties>
<!--别名扫描的包路径-->
<typeAliases>
<package name="com.itheima.domain"/>
</typeAliases>
<!--数据源-->
<environments default="mysql">
<environment id="mysql">
<transactionManager type="JDBC"></transactionManager>
<dataSource type="POOLED">
<property name="driver" value="${jdbc.driver}"></property>
<property name="url" value="${jdbc.url}"></property>
<property name="username" value="${jdbc.username}"></property>
<property name="password" value="${jdbc.password}"></property>
</dataSource>
</environment>
</environments>
<!--映射文件扫描包路径-->
<mappers>
<package name="com.itheima.dao"></package>
</mappers>
</configuration>
步骤8:编写应用程序
public class App {
public static void main(String[] args) throws IOException {
// 1. 创建SqlSessionFactoryBuilder对象
SqlSessionFactoryBuilder sqlSessionFactoryBuilder = new SqlSessionFactoryBuilder();
// 2. 加载SqlMapConfig.xml配置文件
InputStream inputStream = Resources.getResourceAsStream("SqlMapConfig.xml.bak");
// 3. 创建SqlSessionFactory对象
SqlSessionFactory sqlSessionFactory = sqlSessionFactoryBuilder.build(inputStream);
// 4. 获取SqlSession
SqlSession sqlSession = sqlSessionFactory.openSession();
// 5. 执行SqlSession对象执行查询,获取结果User
AccountDao accountDao = sqlSession.getMapper(AccountDao.class);
Account ac = accountDao.findById(1);
System.out.println(ac);
// 6. 释放资源
sqlSession.close();
}
}
步骤9:运行程序
🧠 理论理解
环境准备阶段是企业应用搭建的基石,涉及数据表创建、Dao接口定义、Service实现,复现Mybatis操作数据库的流程,确保整个系统具备可落地执行的骨架。
🏢 企业实战理解
-
阿里云:每个产品线都有“快速交付模板”,包括数据库DDL、Dao模板、Service骨架,支持一键生成。
-
字节跳动:数据中台创建数据模型时,系统自动生成Dao和Service层,大幅减少手动编码。
-
Google:BigQuery + Spring生态,提供标准化的Schema + Dao封装模板,保证全局数据一致性。
题目 3:MyBatis 的 @Insert、@Select 注解实现了什么机制?有没有什么限制?(美团)
✅ 答案:
-
实现机制:通过 JDK 动态代理,将接口方法与 SQL 语句绑定,执行时生成 MappedStatement。
-
限制:不适合复杂 SQL(多表联查、动态 SQL),推荐 XML Mapper。
场景题 2(美团)
场景描述:
你正在 MyBatis 项目中开发一个资金管理模块,使用 @Insert
、@Select
注解完成 SQL 绑定,但上线后发现出现 SQL 超长、维护困难的问题。架构组要求你优化现有代码。
✅ 答案:
问题总结:
-
使用注解式 SQL 对简单表操作友好,但复杂 SQL(如动态拼接、子查询、分页)不易维护;
-
注解式 SQL 难以进行格式化和分块管理,代码杂乱。
优化方案:
-
将复杂 SQL 移到 XML Mapper 文件中,使用
<if>
、<choose>
等动态标签提升可读性; -
在 Service 层保留注解,但 SQL 绑定迁移至 XML,提升灵活性。
-
大厂实战:美团点评在支付模块中使用 XML 统一管理复杂 SQL,保证可扩展和审计友好性。
6.1.2 整合思路分析
Mybatis的基础环境我们已经准备好了,接下来就得分析下在上述的内容中,哪些对象可以交给Spring来管理?
-
Mybatis程序核心对象分析
从图中可以获取到,真正需要交给Spring管理的是==SqlSessionFactory==
-
整合Mybatis,就是将Mybatis用到的内容交给Spring管理,分析下配置文件
说明:
-
第一行读取外部properties配置文件,Spring有提供具体的解决方案
@PropertySource
,需要交给Spring -
第二行起别名包扫描,为SqlSessionFactory服务的,需要交给Spring
-
第三行主要用于做连接池,Spring之前我们已经整合了Druid连接池,这块也需要交给Spring
-
前面三行一起都是为了创建SqlSession对象用的,那么用Spring管理SqlSession对象吗?回忆下SqlSession是由SqlSessionFactory创建出来的,所以只需要将SqlSessionFactory交给Spring管理即可。
-
第四行是Mapper接口和映射文件[如果使用注解就没有该映射文件],这个是在获取到SqlSession以后执行具体操作的时候用,所以它和SqlSessionFactory创建的时机都不在同一个时间,可能需要单独管理。
-
🧠 理论理解
整合Spring与Mybatis的核心是解耦:让Spring管理SqlSessionFactory以及Mapper接口,避免手动构造连接,提升一致性与可维护性。整合后,Dao接口直接通过Spring注入。
🏢 企业实战理解
-
腾讯:支付系统采用Spring-Mybatis整合方案,每笔交易日志通过统一的Mapper接口标准持久化,稳定支撑亿级交易。
-
美团:外卖业务整合Mybatis,重度依赖Mapper动态代理,结合分库分表场景实现高效持久化。
-
OpenAI:在研发模型数据落地模块时,Spring-Mybatis整合简化了日志记录、模型元数据管理。
题目 4:Spring 管理 MyBatis 的 SqlSessionFactory 有哪些好处?(京东)
✅ 答案:
-
优点:
-
统一管理数据库连接池;
-
Dao 接口可直接注入,避免手动管理 SqlSession;
-
支持事务管理器集成。
-
场景题 3(京东)
场景描述:
你整合 Spring 与 MyBatis 时,项目中 Dao 层偶尔会报出 SqlSession is closed
错误,难以复现。请问你如何分析与定位这个问题?
✅ 答案:
分析过程:
-
该问题通常出现在 Dao 层未正确管理事务,导致
SqlSession
生命周期被提前关闭; -
检查是否使用了
@Transactional
标注 Service 层方法; -
检查
SqlSessionFactory
是否为单例,是否存在多实例管理异常。
解决方案:
-
确保 Service 层使用
@Transactional
注解,避免 Dao 层直接操作事务; -
检查 Spring 容器中 SqlSessionFactory 的定义,确保唯一性。
-
大厂实战:京东在订单系统中采用 Spring AOP + 统一事务策略,彻底解决多线程下 SqlSession 问题。
6.2 Spring整合Mybatis
前面我们已经分析了Spring与Mybatis的整合,大体需要做两件事,
第一件事是:Spring要管理MyBatis中的SqlSessionFactory
第二件事是:Spring要管理Mapper接口的扫描
具体该如何实现,具体的步骤为:
步骤1:项目中导入整合需要的jar包
<dependency>
<!--Spring操作数据库需要该jar包-->
<groupId>org.springframework</groupId>
<artifactId>spring-jdbc</artifactId>
<version>5.2.10.RELEASE</version>
</dependency>
<dependency>
<!--
Spring与Mybatis整合的jar包
这个jar包mybatis在前面,是Mybatis提供的
-->
<groupId>org.mybatis</groupId>
<artifactId>mybatis-spring</artifactId>
<version>1.3.0</version>
</dependency>
步骤2:创建Spring的主配置类
//配置类注解
@Configuration
//包扫描,主要扫描的是项目中的AccountServiceImpl类
@ComponentScan("com.itheima")
public class SpringConfig {
}
步骤3:创建数据源的配置类
在配置类中完成数据源的创建
public class JdbcConfig {
@Value("${jdbc.driver}")
private String driver;
@Value("${jdbc.url}")
private String url;
@Value("${jdbc.username}")
private String userName;
@Value("${jdbc.password}")
private String password;
@Bean
public DataSource dataSource(){
DruidDataSource ds = new DruidDataSource();
ds.setDriverClassName(driver);
ds.setUrl(url);
ds.setUsername(userName);
ds.setPassword(password);
return ds;
}
}
步骤4:主配置类中读properties并引入数据源配置类
@Configuration
@ComponentScan("com.itheima")
@PropertySource("classpath:jdbc.properties")
@Import(JdbcConfig.class)
public class SpringConfig {
}
步骤5:创建Mybatis配置类并配置SqlSessionFactory
public class MybatisConfig {
//定义bean,SqlSessionFactoryBean,用于产生SqlSessionFactory对象
@Bean
public SqlSessionFactoryBean sqlSessionFactory(DataSource dataSource){
SqlSessionFactoryBean ssfb = new SqlSessionFactoryBean();
//设置模型类的别名扫描
ssfb.setTypeAliasesPackage("com.itheima.domain");
//设置数据源
ssfb.setDataSource(dataSource);
return ssfb;
}
//定义bean,返回MapperScannerConfigurer对象
@Bean
public MapperScannerConfigurer mapperScannerConfigurer(){
MapperScannerConfigurer msc = new MapperScannerConfigurer();
msc.setBasePackage("com.itheima.dao");
return msc;
}
}
说明:
-
使用SqlSessionFactoryBean封装SqlSessionFactory需要的环境信息
-
SqlSessionFactoryBean是前面我们讲解FactoryBean的一个子类,在该类中将SqlSessionFactory的创建进行了封装,简化对象的创建,我们只需要将其需要的内容设置即可。
-
方法中有一个参数为dataSource,当前Spring容器中已经创建了Druid数据源,类型刚好是DataSource类型,此时在初始化SqlSessionFactoryBean这个对象的时候,发现需要使用DataSource对象,而容器中刚好有这么一个对象,就自动加载了DruidDataSource对象。
-
-
使用MapperScannerConfigurer加载Dao接口,创建代理对象保存到IOC容器中
-
这个MapperScannerConfigurer对象也是MyBatis提供的专用于整合的jar包中的类,用来处理原始配置文件中的mappers相关配置,加载数据层的Mapper接口类
-
MapperScannerConfigurer有一个核心属性basePackage,就是用来设置所扫描的包路径
-
步骤6:主配置类中引入Mybatis配置类
@Configuration
@ComponentScan("com.itheima")
@PropertySource("classpath:jdbc.properties")
@Import({JdbcConfig.class,MybatisConfig.class})
public class SpringConfig {
}
步骤7:编写运行类
在运行类中,从IOC容器中获取Service对象,调用方法获取结果
public class App2 {
public static void main(String[] args) {
ApplicationContext ctx = new AnnotationConfigApplicationContext(SpringConfig.class);
AccountService accountService = ctx.getBean(AccountService.class);
Account ac = accountService.findById(1);
System.out.println(ac);
}
}
步骤8:运行程序
支持Spring与Mybatis的整合就已经完成了,其中主要用到的两个类分别是:
-
==SqlSessionFactoryBean==
-
==MapperScannerConfigurer==
🧠 理论理解
核心步骤:
1️⃣ 配置SqlSessionFactory:通过SqlSessionFactoryBean
连接数据库、加载模型。
2️⃣ 开启Mapper扫描:MapperScannerConfigurer
自动扫描Dao接口,无需手动注册。
这种方式高度模块化,减少出错点,支持Spring全生命周期管理。
🏢 企业实战理解
-
阿里巴巴:结合
SqlSessionFactoryBean
和自研分布式事务管理,确保账务结算无误。 -
字节跳动:字节内部“通用数据层”模块化开发,完全基于Spring-Mybatis整合,10+个大型系统共用。
-
Google:数据仓库API接口层,用Spring-Mybatis封装外部查询服务,确保模型可热更新。
题目 5:Spring 如何实现 Mapper 接口的自动扫描和注入?底层做了什么?(字节跳动)
✅ 答案:
-
实现机制:
-
MapperScannerConfigurer
启动时扫描指定包; -
利用 BeanDefinitionRegistry 动态注册代理对象;
-
最终生成 Mapper 的代理类注入到容器中。
-
题目 6:如果 Mapper 接口找不到对应的 XML 映射文件会怎样?(阿里)
✅ 答案:
-
会抛出
BindingException
异常,提示找不到 SQL 映射; -
解决:检查
@MapperScan
路径、XML 文件位置、是否放在 resources 目录下。
场景题 4(阿里云)
场景描述:
在微服务架构中,你发现 MyBatis Mapper 接口过多,且多模块复用导致包扫描时 Bean 注入冲突。如何优化扫描策略?
✅ 答案:
问题总结:
-
多模块共享 Mapper,导致包路径交叉,Bean ID 冲突;
-
大量 Mapper 接口扫描导致启动耗时增加。
优化方案:
-
精确拆分
@MapperScan
的 basePackage,做到“一个服务只扫描自己的 Mapper”; -
引入
@MapperScan(nameGenerator=...)
自定义 Bean 命名策略,避免重名; -
大厂实战:阿里云的微服务网关模块中,为每个服务配置单独的 MapperScan,配合自定义 Bean 命名器隔离多租户。
6.3 Spring整合Junit
整合Junit与整合Druid和MyBatis差异比较大,为什么呢?Junit是一个搞单元测试用的工具,它不是我们程序的主体,也不会参加最终程序的运行,从作用上来说就和之前的东西不一样,它不是做功能的,看做是一个辅助工具就可以了。
题目 7:@RunWith 和 @ContextConfiguration 分别起什么作用?(腾讯云)
✅ 答案:
-
@RunWith
:指定 JUnit 使用的运行器,这里是SpringJUnit4ClassRunner
,集成 Spring 环境; -
@ContextConfiguration
:加载 Spring 的配置类或 XML 文件,初始化 IoC 容器。
6.3.1 环境准备
这块环境,大家可以直接使用Spring与Mybatis整合的环境即可。当然也可以重新创建一个,因为内容是一模一样,所以我们直接来看下项目结构即可:
6.3.2 整合Junit步骤
在上述环境的基础上,我们来对Junit进行整合。
步骤1:引入依赖
pom.xml
<dependency>
<groupId>junit</groupId>
<artifactId>junit</artifactId>
<version>4.12</version>
<scope>test</scope>
</dependency>
<dependency>
<groupId>org.springframework</groupId>
<artifactId>spring-test</artifactId>
<version>5.2.10.RELEASE</version>
</dependency>
步骤2:编写测试类
在test\java下创建一个AccountServiceTest,这个名字任意
//设置类运行器
@RunWith(SpringJUnit4ClassRunner.class)
//设置Spring环境对应的配置类
@ContextConfiguration(classes = {SpringConfiguration.class}) //加载配置类
//@ContextConfiguration(locations={"classpath:applicationContext.xml"})//加载配置文件
public class AccountServiceTest {
//支持自动装配注入bean
@Autowired
private AccountService accountService;
@Test
public void testFindById(){
System.out.println(accountService.findById(1));
}
@Test
public void testFindAll(){
System.out.println(accountService.findAll());
}
}
注意:
-
单元测试,如果测试的是注解配置类,则使用
@ContextConfiguration(classes = 配置类.class)
-
单元测试,如果测试的是配置文件,则使用
@ContextConfiguration(locations={配置文件名,...})
-
Junit运行后是基于Spring环境运行的,所以Spring提供了一个专用的类运行器,这个务必要设置,这个类运行器就在Spring的测试专用包中提供的,导入的坐标就是这个东西
SpringJUnit4ClassRunner
-
上面两个配置都是固定格式,当需要测试哪个bean时,使用自动装配加载对应的对象,下面的工作就和以前做Junit单元测试完全一样了
知识点1:@RunWith
名称 | @RunWith |
---|---|
类型 | 测试类注解 |
位置 | 测试类定义上方 |
作用 | 设置JUnit运行器 |
属性 | value(默认):运行所使用的运行期 |
知识点2:@ContextConfiguration
名称 | @ContextConfiguration |
---|---|
类型 | 测试类注解 |
位置 | 测试类定义上方 |
作用 | 设置JUnit加载的Spring核心配置 |
属性 | classes:核心配置类,可以使用数组的格式设定加载多个配置类 locations:配置文件,可以使用数组的格式设定加载多个配置文件名称 |
🧠 理论理解
整合Junit的意义在于让单元测试运行环境“模拟真实Spring环境”,通过@RunWith
、@ContextConfiguration
注解自动加载Spring配置,测试用例可以直接注入bean,覆盖业务流程。
🏢 企业实战理解
-
美团:用Spring + Junit 整合在CI流水线中跑全量测试,每天数千次回归,保证核心接口零回归。
-
字节跳动:抖音后台服务接入层用Spring整合Junit,实现API稳定性自动化回归,30分钟全量测试反馈。
-
NVIDIA:GPU云租赁管理系统,集成Junit测试覆盖率指标,自动生成每次上线的质量报告。
-
OpenAI:ChatGPT平台后端代码集成Junit回归测试,保持迭代高频次同时保证线上稳定。
题目 8:Spring Test 整合的常见坑有哪些?(字节 + OpenAI)
✅ 答案:
1️⃣ 容器未加载:
-
未标记
@RunWith(SpringJUnit4ClassRunner.class)
;
2️⃣ 配置找不到:
-
@ContextConfiguration
路径错误(classpath/前缀等);
3️⃣ 注入失败:
-
忘记
@Autowired
,或者自动注入未开启(缺少扫描配置)。
场景题 5(腾讯 + OpenAI)
场景描述:
你在单元测试时引入了 Spring 整合 JUnit,测试中发现 @Autowired
注入失败,报 NoSuchBeanDefinitionException
,但项目正常启动时没有问题。请问原因是什么,如何解决?
✅ 答案:
分析过程:
-
检查
@ContextConfiguration
是否正确指定配置类或 XML 文件; -
检查是否遗漏
@RunWith(SpringJUnit4ClassRunner.class)
注解; -
检查是否有依赖注入 Bean 定义在测试环境未加载的包下。
解决方案:
-
确保
@ContextConfiguration(classes = {SpringConfig.class})
加载主配置类; -
为 JUnit 环境单独指定测试 Profile,避免加载不全;
-
大厂实战:腾讯云在 Spring Cloud 单元测试中,封装了公共
@SpringBootTest
基类,自动加载依赖,防止漏配。