1051 字

5 分钟

Mybatis基础

2026-05-19

编程学习

Java

Mybatis

SpringBoot

数据库

ORM

浏览量加载中...

AI 摘要

Mybatis基础#

定义#

MyBatis 是一款优秀的持久层框架，用于简化JDBC的开发。原本是Apache的开源项目iBatis，2010年迁移至Google Code并改名为MyBatis，2013年11月迁移到Github。

官网：https://mybatis.org/mybatis-3/zh/index.html

持久层：即数据访问层（DAO），负责与数据库交互。

框架：一套可重用、通用、半成品的软件基础代码模型，在框架基础上开发更高效、规范。

快速入门#

1. 创建SpringBoot工程，导入依赖#

1
<dependency>
2
    <groupId>org.mybatis.spring.boot</groupId>
3
    <artifactId>mybatis-spring-boot-starter</artifactId>
4
</dependency>
5
<dependency>
6
    <groupId>mysql</groupId>
7
    <artifactId>mysql-connector-java</artifactId>
8
</dependency>
9
<dependency>
10
    <groupId>org.projectlombok</groupId>
11
    <artifactId>lombok</artifactId>
12
</dependency>

2. 数据准备#

实体类 User（位于 com.itheima.pojo 包）：

1
@Data
2
@NoArgsConstructor
3
@AllArgsConstructor
4
public class User {
5
    private Integer id;
6
    private String username;
7
    private String password;
8
    private String name;
9
    private Integer age;
10
}

3. 配置Mybatis#

application.properties：

1
spring.datasource.url=jdbc:mysql://localhost:3306/web
2
spring.datasource.driver-class-name=com.mysql.cj.jdbc.Driver
3
spring.datasource.username=root
4
spring.datasource.password=root@1234

4. 编写Mapper接口#

1
@Mapper
2
public interface UserMapper {
3
    @Select("select * from user")
4
    public List<User> findAll();
5
}

@Mapper：表示Mybatis中的Mapper接口，运行时框架自动生成代理对象并交由Spring IOC容器管理。
@Select：编写select查询语句。

5. 单元测试#

1
@SpringBootTest
2
class ApplicationTests {
3
    @Autowired
4
    private UserMapper userMapper;
5

6
    @Test
7
    public void testFindAll() {
8
        List<User> userList = userMapper.findAll();
9
        userList.forEach(System.out::println);
10
    }
11
}

JDBC vs Mybatis#

JDBC缺点	Mybatis解决方案
url/username/password硬编码在代码中	配置在 `application.properties` 中
查询结果解析封装繁琐	自动完成映射封装
频繁获取/释放连接造成资源浪费	内置数据库连接池技术

数据库连接池#

数据库连接池是一个容器，负责分配、管理数据库连接。

工作原理：

程序启动时，在连接池中创建一定数量的Connection对象。
客户端执行SQL时从连接池获取Connection，执行完毕后归还（复用）。
空闲时间超过最大空闲时间的连接会被自动释放。

好处：资源重用、提升响应速度、避免连接遗漏。

常见连接池产品#

连接池	说明
Hikari	SpringBoot默认，性能优越
Druid	阿里巴巴开源，功能强大
C3P0 / DBCP	老牌连接池，较少使用

切换为Druid#

1
<dependency>
2
    <groupId>com.alibaba</groupId>
3
    <artifactId>druid-spring-boot-starter</artifactId>
4
    <version>1.2.19</version>
5
</dependency>

1
spring.datasource.type=com.alibaba.druid.pool.DruidDataSource
2
spring.datasource.druid.driver-class-name=com.mysql.cj.jdbc.Driver
3
spring.datasource.druid.url=jdbc:mysql://localhost:3306/web
4
spring.datasource.druid.username=root
5
spring.datasource.druid.password=1234

增删改查操作#

注解速查#

操作	注解	示例
查询	`@Select`	`@Select("select * from user where id = #{id}")`
新增	`@Insert`	`@Insert("insert into user(...) values(#{...})")`
修改	`@Update`	`@Update("update user set ... where id = #{id}")`
删除	`@Delete`	`@Delete("delete from user where id = #{id}")`

参数占位符#

Mybatis提供两种占位符：

占位符	特点	推荐
`#{...}`	预编译SQL（生成 `?`），防SQL注入	强烈推荐
`${...}`	直接字符串拼接，存在SQL注入风险	不推荐

删除示例#

1
@Delete("delete from user where id = #{id}")
2
public Integer deleteById(Integer id);

Integer 返回值表示DML语句影响的记录数。

新增示例#

1
@Insert("insert into user(username,password,name,age) values(#{username},#{password},#{name},#{age})")
2
public void insert(User user);

多个参数封装到对象中，通过 #{对象属性名} 引用。

修改示例#

1
@Update("update user set username=#{username},password=#{password},name=#{name},age=#{age} where id=#{id}")
2
public void update(User user);

查询示例（多参数）#

1
@Select("select * from user where username = #{username} and password = #{password}")
2
public User findByUsernameAndPassword(@Param("username") String username, @Param("password") String password);

@Param 注解为方法形参起名；基于官方骨架创建的SpringBoot项目中接口编译时会保留方法形参名，@Param 可省略（直接 #{形参名}）。

XML映射配置#

使用场景#

注解：简单的增删改查功能。
XML：复杂的SQL功能。

注意：一个接口方法对应的SQL语句，要么使用注解，要么使用XML，不可同时配置。

XML配置规范#

XML映射文件名称与Mapper接口名称一致，放在相同包下（同包同名）。
XML映射文件的 namespace 为Mapper接口全限定名。
SQL语句的 id 与Mapper接口方法名一致，返回类型一致。

XML示例#

1
<?xml version="1.0" encoding="UTF-8" ?>
2
<!DOCTYPE mapper
3
  PUBLIC "-//mybatis.org//DTD Mapper 3.0//EN"
4
  "https://mybatis.org/dtd/mybatis-3-mapper.dtd">
5
<mapper namespace="com.itheima.mapper.UserMapper">
6

7
    <select id="findAll" resultType="com.itheima.pojo.User">
8
        select * from user
9
    </select>
10

11
</mapper>

辅助配置#

SQL提示#

在IDEA中配置与MySQL数据库的连接，可在 @Select 注解中获得SQL语法提示和表名/列名校验。

Mybatis日志输出#

1
mybatis.configuration.log-impl=org.apache.ibatis.logging.stdout.StdOutImpl

开启后可在控制台查看执行的SQL语句及参数。

注意事项#

测试类所在包需要与引导类所在包相同。
强烈建议使用 #{} 占位符，防止SQL注入。
DML操作建议定义 Integer 返回值接收影响行数。
MybatisX是IDEA中快速开发Mybatis的插件，可快速定位Mapper与XML的映射关系。

相关链接#

支持与分享

如果这篇文章对你有帮助，欢迎分享给更多人或赞助支持！

赞助

Mybatis基础

https://blog.tsh520.cn/posts/javawebai/后端基础/mybatis基础/

作者

团子和蛋糕

发布于

2026-05-19

许可协议

CC BY-NC-SA 4.0

最后更新于 2026-05-19，距今已过 32 天

部分内容可能已过时

JDBC查询操作

SpringBoot配置文件

评论区

[ 标签 ]

# AI 1 # Ajax 2 # Apifox 1 # Astro 2 # claudecode 1 # CloudFlare 1 # CSS 6 # DELETE 1 # Gist 1 # GitHub 1 # HTML 6 # HTTP 2 # Java 23 # java 13 # JavaScript 5 # JDBC 3 # JSON 1 # JUnit 1 # Logback 1 # Maven 6 # Mybatis 1 # MyBatis 4 # MySQL 6 # MySql 1 # Obsidian 1 # ORM 1 # PathVariable 1 # PicGo 1 # RequestBody 1 # RequestMapping 1 # RESTful风格 1 # Slf4j 1 # SpringBoot 11 # SQL 2 # Svelte 1 # TailwindCSS 1 # Telegram 1 # Tlias 2 # Vue 7 # Web基础 6 # YAML 1 # 三层架构 1 # 使用文档 7 # 刷步数 1 # 前端 32 # 单词 1 # 博客 2 # 博客开发 1 # 参数接收 1 # 后端 1 # 图床 1 # 存储 1 # 学习方法 1 # 导航栏 1 # 工具 1 # 开发 1 # 开发规范 1 # 开心 1 # 影视 1 # 想法 3 # 感悟 4 # 数据库 10 # 日常 13 # 日志框架 1 # 生活迁移 1 # 电影 1 # 碎碎念 1 # 网络教室 1 # 蓝奏云 1 # 记录 1 # 词根 1 # 词缀 1 # 路径参数 1 # 运动 1 # 配置 1 # 音乐 1 # 音标 1 # 驼峰命名 1

[ 分类 ]

# 编程学习 63 # 博客指南 8 # 技术分享 6 # 英语笔记本 5 # AI使用 1 # 资源整理 1

[ 公告 ]

如果你喜欢，那么欢迎来到我的世界！

了解更多

[ 音乐 ]

找不到相关结果。

[ contents ]

[ 全部文章 ]

Mybatis基础

Mybatis基础#

定义#

快速入门#

1. 创建SpringBoot工程，导入依赖#

2. 数据准备#

3. 配置Mybatis#

4. 编写Mapper接口#

5. 单元测试#

JDBC vs Mybatis#

数据库连接池#

常见连接池产品#

切换为Druid#

增删改查操作#

注解速查#

参数占位符#

删除示例#

新增示例#

修改示例#

查询示例（多参数）#

XML映射配置#

使用场景#

XML配置规范#

XML示例#

辅助配置#

SQL提示#

Mybatis日志输出#

注意事项#

相关链接#

支持与分享

相关阅读

评论区

音乐