在当今的企业级Java应用开发中，数据持久化是不可或缺的一环。无论是电商系统的订单管理、金融平台的风控模块，还是图书馆的图书借阅系统，都需要高效、可靠地与数据库进行交互。MyBatis作为一款优秀的半自动ORM（对象关系映射）框架，凭借其灵活性和可控制性，成为众多开发者的首选。它不同于Hibernate等全自动ORM框架——后者试图完全屏蔽SQL，由框架自动生成；而MyBatis则将SQL的控制权交给开发者，允许你直接编写原生SQL语句，并通过简单的配置将结果集自动映射为Java对象。这种“半自动”的特性，使得MyBatis在处理复杂查询、多表关联、数据库特定功能（如批量插入、存储过程）时游刃有余，同时又能保持代码的简洁与可维护性。例如，在电商系统中，经常需要根据用户输入的关键词、价格区间、分类等多个条件动态组合查询商品，MyBatis的动态SQL可以轻松实现这种需求，避免拼接SQL的繁琐与安全风险；在金融系统中，对查询性能要求极高，手动优化的SQL往往比自动生成的SQL更高效。因此，MyBatis在实际开发中扮演着数据访问层的核心角色，帮助开发者构建健壮、高性能的应用。

MyBatis核心概念与基础配置

MyBatis的核心工作流程围绕SqlSessionFactory展开。通过配置文件（或Java配置）构建SqlSessionFactory，再由它打开SqlSession，SqlSession代表一次数据库会话，用于执行已映射的SQL语句。同时，MyBatis支持面向接口的编程，通过Mapper接口与XML映射文件（或注解）绑定，实现类型安全的数据库操作。

首先，引入MyBatis依赖（以Maven为例）：

xml

<dependency>
    <groupId>org.mybatis</groupId>
    <artifactId>mybatis</artifactId>
    <version>3.5.13</version>
</dependency>

接着，创建核心配置文件mybatis-config.xml，配置数据源和映射器：

xml

<?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>
    <environments default="development">
        <environment id="development">
            <transactionManager type="JDBC"/>
            <dataSource type="POOLED">
                <property name="driver" value="com.mysql.cj.jdbc.Driver"/>
                <property name="url" value="jdbc:mysql://localhost:3306/library?useSSL=false"/>
                <property name="username" value="root"/>
                <property name="password" value="123456"/>
            </dataSource>
        </environment>
    </environments>
    <mappers>
        <mapper resource="com/example/mapper/UserMapper.xml"/>
    </mappers>
</configuration>

定义实体类User：

java

public class User {
    private Integer id;
    private String name;
    private String email;
    // getters and setters...
}

创建Mapper接口UserMapper：

java

public interface UserMapper {
    User selectById(Integer id);
    List<User> selectAll();
    int insert(User user);
    int update(User user);
    int delete(Integer id);
}

对应的XML映射文件UserMapper.xml：

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.example.mapper.UserMapper">
    <resultMap id="userResultMap" type="User">
        <id property="id" column="id"/>
        <result property="name" column="name"/>
        <result property="email" column="email"/>
    </resultMap>

    <select id="selectById" resultMap="userResultMap">
        select * from user where id = #{id}
    </select>

    <select id="selectAll" resultMap="userResultMap">
        select * from user
    </select>

    <insert id="insert" useGeneratedKeys="true" keyProperty="id">
        insert into user(name, email) values(#{name}, #{email})
    </insert>

    <update id="update">
        update user set name = #{name}, email = #{email} where id = #{id}
    </update>

    <delete id="delete">
        delete from user where id = #{id}
    </delete>
</mapper>

使用MyBatis进行CRUD操作的示例代码：

java

String resource = "mybatis-config.xml";
InputStream inputStream = Resources.getResourceAsStream(resource);
SqlSessionFactory sqlSessionFactory = new SqlSessionFactoryBuilder().build(inputStream);

try (SqlSession session = sqlSessionFactory.openSession()) {
    UserMapper mapper = session.getMapper(UserMapper.class);
    
    // 插入
    User newUser = new User();
    newUser.setName("Alice");
    newUser.setEmail("alice@example.com");
    mapper.insert(newUser);
    session.commit();
    
    // 查询
    User user = mapper.selectById(newUser.getId());
    System.out.println(user.getName());
}

动态SQL与高级映射实战：图书馆查询系统

动态SQL是MyBatis最具特色的功能之一，它允许在XML中编写类似JSTL的条件判断、循环等逻辑，极大地简化了多条件组合查询的编写。考虑一个日常生活中常见的场景——图书馆管理系统，我们需要根据书名、作者、分类等条件动态查询图书，并展示借阅记录。以下是一个深度案例，展示动态SQL和关联映射。

表结构设计

  • book表：id, title, author, category, status

  • borrow_record表：id, book_id, borrower, borrow_date, return_date

实体类

java

public class Book {
    private Integer id;
    private String title;
    private String author;
    private String category;
    private String status; // 可借阅/已借出
    private List<BorrowRecord> borrowRecords; // 借阅历史
    // getters and setters
}

public class BorrowRecord {
    private Integer id;
    private Integer bookId;
    private String borrower;
    private Date borrowDate;
    private Date returnDate;
    // getters and setters
}
Mapper接口

java

public interface BookMapper {
    List<Book> searchBooks(@Param("title") String title, 
                           @Param("author") String author, 
                           @Param("category") String category);
    Book selectBookWithRecords(Integer id);
}
映射文件

xml

<mapper namespace="com.example.mapper.BookMapper">
    <resultMap id="bookResultMap" type="Book">
        <id property="id" column="id"/>
        <result property="title" column="title"/>
        <result property="author" column="author"/>
        <result property="category" column="category"/>
        <result property="status" column="status"/>
        <collection property="borrowRecords" ofType="BorrowRecord" 
                    select="selectBorrowRecordsByBookId" column="id"/>
    </resultMap>

    <resultMap id="borrowRecordResultMap" type="BorrowRecord">
        <id property="id" column="id"/>
        <result property="bookId" column="book_id"/>
        <result property="borrower" column="borrower"/>
        <result property="borrowDate" column="borrow_date"/>
        <result property="returnDate" column="return_date"/>
    </resultMap>

    <!-- 动态查询图书 -->
    <select id="searchBooks" resultMap="bookResultMap">
        select * from book
        <where>
            <if test="title != null and title != ''">
                and title like concat('%', #{title}, '%')
            </if>
            <if test="author != null and author != ''">
                and author like concat('%', #{author}, '%')
            </if>
            <if test="category != null and category != ''">
                and category = #{category}
            </if>
        </where>
    </select>

    <!-- 根据bookId查询借阅记录 -->
    <select id="selectBorrowRecordsByBookId" resultMap="borrowRecordResultMap">
        select * from borrow_record where book_id = #{id} order by borrow_date desc
    </select>

    <!-- 查询图书并加载借阅记录 -->
    <select id="selectBookWithRecords" resultMap="bookResultMap">
        select * from book where id = #{id}
    </select>
</mapper>

在这个案例中，searchBooks方法利用<where>和<if>动态拼接查询条件，当传入的参数为空时自动忽略该条件，避免了繁琐的字符串拼接。selectBookWithRecords方法通过嵌套查询（<collection>的select属性）加载该图书的所有借阅记录，实现了关联数据的懒加载或即时加载（取决于配置）。这种设计不仅使SQL清晰，还能灵活控制数据加载的粒度。

结语

MyBatis以其半自动的特性，在灵活性与开发效率之间取得了完美的平衡。它让开发者可以充分利用SQL的全部能力，同时避免了JDBC的样板代码和手动结果集映射。从简单的CRUD到复杂的动态查询，再到高级的关联映射和存储过程支持，MyBatis都能应对自如。无论是快速迭代的互联网项目，还是追求极致性能的金融系统，MyBatis都是一个值得信赖的持久层解决方案。

你在实际项目中使用MyBatis时，是否遇到过一些有趣的问题或巧妙的应用？比如如何利用MyBatis的插件机制实现分页，或者如何与Spring Boot无缝集成？欢迎在评论区分享你的经验和见解，如果你对MyBatis的底层原理或高级特性有更多好奇，也可以留言告诉我，我们可以一起探讨更深度的内容。

# mybatis # sql # oracle
Logo
https://edu.csdn.net/learn/39067/627173?utm_source=2019755004

汇聚全球AI编程工具，助力开发者即刻编程。

更多推荐

cover

一个 API 入口调用多个大模型：AiiOnly客户端 + CC Switch 打通 Codex AI编程流程

avatar AI编程社区
cover

VSCode Claude Code + MiMo 中转免登录完整配置教程（解决原生登录弹窗 + 模型报错）

avatar AI编程社区
cover

从零开始做一个属于自己的 Skill（保姆级教程）

avatar AI编程社区