深入理解 MyBatis 框架的核心对象：SqlSession

F20226974862025-02-14 8:17

Mybatis框架中的SqlSession对象详解

引言

MyBatis 是一个优秀的持久层框架，它支持定制化 SQL、存储过程以及高级映射。MyBatis 避免了几乎所有的 JDBC 代码和手动设置参数以及获取结果集的工作。MyBatis 可以使用简单的 XML 或注解来配置和映射原生信息，将接口和 Java 的 POJOs（Plain Old Java Objects，普通的 Java 对象）映射成数据库中的记录。

在学习 MyBatis 框架时，SqlSession是一个无法绕开的核心概念。它是 MyBatis 提供的一个面向用户的接口，封装了底层的数据库操作细节，使得开发者可以通过简单的接口调用完成复杂的数据库交互。本文将详细介绍 SqlSession 的功能、创建方式、生命周期以及与其他相关对象的关系，帮助大家更好地理解和使用 MyBatis。

1. SqlSession 概述

SqlSession 是 MyBatis 中用于执行 SQL 语句、获取映射器（Mapper）和管理事务的接口。它是 MyBatis 框架与数据库交互的核心对象。每个线程都应该有它自己的 SqlSession 实例，SqlSession 的实例不是线程安全的，因此不能被共享。

1.1 SqlSession 的主要功能

  • 执行 SQL 语句 ：SqlSession 提供了多种方法来执行 SQL 语句，包括 selectOne、selectList、insert、update、delete 等。
  • 获取映射器 ：通过 SqlSession 可以获取到 Mapper 接口的实例，从而调用 Mapper 中定义的 SQL 方法。
  • 管理事务 ：SqlSession 提供了事务管理的方法，如 commit、rollback 等。

2. SqlSession 的创建与关闭

2.1 创建 SqlSession

SqlSession 是通过 SqlSessionFactory 创建的。SqlSessionFactory 是一个线程安全的对象，它可以通过 SqlSessionFactoryBuilder 来构建。

java 复制代码 
// 指定 MyBatis 配置文件的路径
// 配置文件通常命名为 "mybatis-config.xml"，位于项目的资源目录中
String resource = "mybatis-config.xml";

// 使用 MyBatis 的 Resources 工具类加载配置文件
// Resources 是 MyBatis 提供的一个工具类，用于加载资源文件
// getResourceAsStream 方法会从类路径中加载指定的资源文件，并返回一个 InputStream 对象
InputStream inputStream = Resources.getResourceAsStream(resource);

// 使用 SqlSessionFactoryBuilder 构建 SqlSessionFactory
// SqlSessionFactoryBuilder 是 MyBatis 提供的一个构建器类，用于创建 SqlSessionFactory
// build 方法接受一个 InputStream 对象，解析 MyBatis 的配置文件，并初始化 MyBatis 的运行环境
// 最终返回一个 SqlSessionFactory 对象
SqlSessionFactory sqlSessionFactory = new SqlSessionFactoryBuilder().build(inputStream);

// 使用 SqlSessionFactory 创建 SqlSession
// SqlSession 是 MyBatis 的核心接口，用于执行 SQL 语句、获取 Mapper 接口的代理对象和管理事务
// openSession 方法默认创建一个自动提交（AUTO）的 SqlSession
// 如果需要手动提交事务，可以调用 openSession(false)
SqlSession sqlSession = sqlSessionFactory.openSession();

2.2 关闭 SqlSession

SqlSession 使用完毕后，应该及时关闭以释放数据库连接资源。

java 复制代码 
sqlSession.close();

3. SqlSession 的常用方法

3.1 执行 SQL 语句

SqlSession 提供了多种方法来执行 SQL 语句，常用的方法包括：

  • selectOne(String statement, Object parameter)：执行查询并返回一个对象。
  • selectList(String statement, Object parameter)：执行查询并返回一个对象列表。
  • insert(String statement, Object parameter)：执行插入操作。
  • update(String statement, Object parameter)：执行更新操作。
  • delete(String statement, Object parameter)：执行删除操作。
java 复制代码 
// 查询单个用户
// selectOne 方法用于执行查询操作，返回单个结果
// 参数1：映射文件中定义的 SQL 语句的 ID，格式为 "namespace.SQL语句ID"
// 参数2：传递给 SQL 语句的参数，这里是用户ID
// 返回值：查询结果，类型为 User 对象
User user = sqlSession.selectOne("org.mybatis.example.UserMapper.selectUser", 1);

// 查询所有用户
// selectList 方法用于执行查询操作，返回多个结果
// 参数1：映射文件中定义的 SQL 语句的 ID
// 返回值：查询结果，类型为 User 对象的列表
List<User> users = sqlSession.selectList("org.mybatis.example.UserMapper.selectAllUsers");

// 插入新用户
// insert 方法用于执行插入操作
// 参数1：映射文件中定义的 SQL 语句的 ID
// 参数2：传递给 SQL 语句的参数，这里是 User 对象
// 返回值：插入操作影响的行数
sqlSession.insert("org.mybatis.example.UserMapper.insertUser", newUser);

// 更新用户信息
// update 方法用于执行更新操作
// 参数1：映射文件中定义的 SQL 语句的 ID
// 参数2：传递给 SQL 语句的参数，这里是 User 对象
// 返回值：更新操作影响的行数
sqlSession.update("org.mybatis.example.UserMapper.updateUser", user);

// 删除用户
// delete 方法用于执行删除操作
// 参数1：映射文件中定义的 SQL 语句的 ID
// 参数2：传递给 SQL 语句的参数，这里是用户ID
// 返回值：删除操作影响的行数
sqlSession.delete("org.mybatis.example.UserMapper.deleteUser", 1);

3.2 获取映射器

通过 SqlSession 可以获取到 Mapper 接口的实例，从而调用 Mapper 中定义的 SQL 方法。

java 复制代码 
// 通过 SqlSession 获取 UserMapper 接口的代理对象
// getMapper 方法会根据传入的 Mapper 接口类型，返回一个代理对象
// 这个代理对象内部封装了 SQL 语句的执行逻辑，通过调用代理对象的方法，
// 可以执行 Mapper 接口中定义的数据库操作
UserMapper userMapper = sqlSession.getMapper(UserMapper.class);

// 调用 UserMapper 接口的 selectUser 方法查询用户
User user = userMapper.selectUser(1);

3.3 事务管理

SqlSession 提供了事务管理的方法，如 commit、rollback 等。

java 复制代码 
try {
    sqlSession.insert("org.mybatis.example.UserMapper.insertUser", newUser);
    sqlSession.commit();
} catch (Exception e) {
    sqlSession.rollback();
} finally {
    sqlSession.close();
}

4. SqlSession 的最佳实践

4.1 使用 try-with-resources 语句

为了确保 SqlSession 能够正确关闭，可以使用 Java 7 引入的 try-with-resources 语句。

java 复制代码 
try (SqlSession sqlSession = sqlSessionFactory.openSession()) {
    UserMapper userMapper = sqlSession.getMapper(UserMapper.class);
    User user = userMapper.selectUser(1);
    // 其他操作
}

4.2 使用自动提交模式

在某些情况下，可以将 SqlSession 设置为自动提交模式，这样每次执行 SQL 语句后都会自动提交事务。

java 复制代码 
SqlSession sqlSession = sqlSessionFactory.openSession(true);

4.3 使用局部变量

SqlSession 的实例不是线程安全的，因此应该将其作为局部变量使用，避免在多线程环境中共享。

java 复制代码 
public void doSomething() {
    try (SqlSession sqlSession = sqlSessionFactory.openSession()) {
        UserMapper userMapper = sqlSession.getMapper(UserMapper.class);
        User user = userMapper.selectUser(1);
        // 其他操作
    }
}

5. 总结

SqlSession 是 MyBatis 框架中非常重要的对象，它负责执行 SQL 语句、获取映射器和管理事务。在使用 SqlSession 时，应该注意其线程安全性，并确保在使用完毕后及时关闭。通过合理使用 SqlSession，可以有效地提高 MyBatis 应用的性能和稳定性。

相关推荐
cat三三10 小时前
java之异常
java·开发语言
浙江第二深情10 小时前
前端性能优化终极指南
java·maven
养乐多072211 小时前
【Java】IO流
java
俊男无期11 小时前
超效率工作法
java·前端·数据库
中国胖子风清扬11 小时前
SpringAI和 Langchain4j等 AI 框架之间的差异和开发经验
java·数据库·人工智能·spring boot·spring cloud·ai·langchain
月明长歌11 小时前
【码道初阶】牛客TSINGK110：二叉树遍历（较难）如何根据“扩展先序遍历”构建二叉树？
java·数据结构·算法
用户21903265273511 小时前
Spring Boot + Redis 注解极简教程：5分钟搞定CRUD操作
java·后端
Alice11 小时前
linux scripts
java·linux·服务器
Filotimo_11 小时前
Spring Data JPA 方法名查询特性的使用
java·开发语言·windows
代码栈上的思考11 小时前
MyBatis：注解方式实现数据库 CRUD 全操作
java·开发语言·mybatis
热门推荐
01GitHub 镜像站点02UV安装并设置国内源03Linux下V2Ray安装配置指南04安娜的档案(Anna’s Archive) 镜像网站/国内最新可访问入口（持续更新）05在VSCode配置Java开发环境的保姆级教程（适配各类AI编程IDE）06RedissonClient的配置解析07BongoCat - 跨平台键盘猫动画工具08Open-AutoGLM Windows 安装部署教程09jdk21下载、安装（Windows、Linux、macOS）10【AutoGLM部署】本地私有化部署AI手机Agent