MyBatis：Java持久层框架的全面指南

牛哥说我不优雅2024-03-16 20:49

一、简介

MyBatis是一个基于Java的持久层框架，它提供了一种优雅地管理SQL查询、映射和数据库交互的方式。MyBatis的核心思想是将SQL语句与Java方法解耦，通过配置文件进行映射，从而实现数据库操作的简化和灵活性。

二、MyBatis的核心概念

MyBatis的核心概念包括配置文件、映射器接口和SQL映射文件。配置文件包含了连接数据库所需的信息，映射器接口定义了数据库操作的方法，而SQL映射文件则包含了SQL语句和与之对应的映射关系。

三、使用MyBatis进行数据库操作

1.配置文件

首先，需要在mybatis-config.xml中配置数据库连接信息：

xml 复制代码 
<!-- mybatis-config.xml -->
<configuration>
  <environments default="development">
    <environment id="development">
      <transactionManager type="JDBC"/>
      <dataSource type="POOLED">
        <property name="driver" value="com.mysql.jdbc.Driver"/>
        <property name="url" value="jdbc:mysql://localhost:3306/mybatis"/>
        <property name="username" value="username"/>
        <property name="password" value="password"/>
      </dataSource>
    </environment>
  </environments>
  <mappers>
    <mapper resource="com/example/mapper/ExampleMapper.xml"/>
  </mappers>
</configuration>

这段XML代码是MyBatis的配置文件，用于配置数据库连接信息和映射器(mappers)信息。

  • <environments>: 这个元素定义了MyBatis的运行环境，默认环境是"development"。在这里配置了一个名为"development"的环境。

  • <transactionManager>: 指定了事务管理器的类型，这里是"JDBC"，表示使用JDBC事务管理器。

  • <dataSource>: 指定了数据源的类型为"POOLED"，表示使用连接池来管理数据库连接。

  • <property>: 这些元素用于配置数据源的属性，包括数据库驱动、URL、用户名和密码等信息。

  • <mappers>: 这个元素用于指定映射器(mappers)的位置。在这里通过元素的resource属性指定了一个XML文件的路径，该文件包含了映射器的配置信息。

总的来说，这段配置文件指定了MyBatis的数据库连接信息和映射器的位置，确保MyBatis能够正确连接数据库并执行相应的SQL操作。

2.映射器接口

java 复制代码 
// ExampleMapper.java
package com.example.mapper;

import com.example.model.Example;

public interface ExampleMapper {
    Example selectExample(int id);
    void insertExample(Example example);
    void updateExample(Example example);
    void deleteExample(int id);
}

这段代码是一个Java接口ExampleMapper，用于定义对数据库表example进行查询、插入、更新和删除操作的方法。

ExampleMapper接口声明了以下方法：

  • selectExample(int id): 用于根据给定的id查询并返回一个Example对象。
  • insertExample(Example example): 用于向数据库中插入一个Example对象。
  • updateExample(Example example): 用于更新数据库中与给定Example对象相匹配的记录。
  • deleteExample(int id): 用于根据给定的id从数据库中删除相应的记录。

这些方法与前面提到的映射器文件中定义的SQL操作相对应，通过调用这些方法可以实现对数据库表example的CRUD操作。

该接口位于com.example.mapper包下，同时引入了com.example.model.Example类，用于作为方法的参数和返回类型。

3.SQL映射文件

xml 复制代码 
<!-- ExampleMapper.xml -->
<mapper namespace="com.example.mapper.ExampleMapper">
  <select id="selectExample" resultType="com.example.model.Example">
    SELECT * FROM example WHERE id = #{id}
  </select>
  <insert id="insertExample" parameterType="com.example.model.Example">
    INSERT INTO example (id, name) VALUES (#{id}, #{name})
  </insert>
  <update id="updateExample" parameterType="com.example.model.Example">
    UPDATE example SET name = #{name} WHERE id = #{id}
  </update>
  <delete id="deleteExample" parameterType="int">
    DELETE FROM example WHERE id = #{id}
  </delete>
</mapper>

这段XML代码是一个MyBatis映射器（mapper）文件的示例，用于定义对数据库表example进行查询、插入、更新和删除操作的SQL语句。

  • <mapper>: 这个元素定义了一个映射器，通过namespace属性指定了映射器的命名空间为com.example.mapper.ExampleMapper。

  • <select>: 这个元素定义了一个查询操作，通过id属性指定了操作的名称为selectExample，resultType属性指定了查询结果的类型为com.example.model.Example。SQL语句SELECT * FROM example WHERE id = #{id}会查询example表中符合条件的记录。

  • <insert>: 这个元素定义了一个插入操作，通过id属性指定了操作的名称为insertExample，parameterType属性指定了插入操作的参数类型为com.example.model.Example。SQL语句INSERT INTO example (id, name) VALUES (#{id}, #{name})会向example表中插入一条新记录。

  • <update>: 这个元素定义了一个更新操作，通过id属性指定了操作的名称为updateExample，parameterType属性指定了更新操作的参数类型为com.example.model.Example。SQL语句UPDATE example SET name = #{name} WHERE id = #{id}会更新example表中符合条件的记录。

  • <delete>: 这个元素定义了一个删除操作，通过id属性指定了操作的名称为deleteExample，parameterType属性指定了删除操作的参数类型为int。SQL语句DELETE FROM example WHERE id = #{id}会删除example表中符合条件的记录。

这段映射器文件定义了针对example表的常见CRUD操作，使得开发人员可以通过调用映射器中定义的方法来执行相应的数据库操作。

四、基本的CRUD操作示例

java 复制代码 
// 使用MyBatis进行基本的CRUD操作示例

// 创建SqlSessionFactory
SqlSessionFactory factory = new SqlSessionFactoryBuilder().build(Resources.getResourceAsStream("mybatis-config.xml"));

// 创建SqlSession
try (SqlSession session = factory.openSession()) {
    ExampleMapper mapper = session.getMapper(ExampleMapper.class);

    // 插入数据
    Example example = new Example(1, "Example 1");
    mapper.insertExample(example);

    // 查询数据
    Example result = mapper.selectExample(1);
    System.out.println("Selected Example: " + result);

    // 更新数据
    result.setName("Updated Example 1");
    mapper.updateExample(result);

    // 删除数据
    mapper.deleteExample(1);
}

使用SqlSessionFactory对象的openSession()方法创建一个SqlSession对象。SqlSession是与数据库交互的主要接口，用于执行SQL语句和管理事务。

通过SqlSession的getMapper()方法获取一个Mapper接口的实现类对象。在这里，我们获取了ExampleMapper接口的实现类对象mapper。 通过这个mapper对象，我们可以调用其中定义的方法来执行数据库操作，如查询、插入、更新等。

五、高级功能示例

1.参数传递

xml 复制代码 
<!-- ExampleMapper.xml -->
<select id="selectByExampleName" resultType="com.example.model.Example">
  SELECT * FROM example WHERE name = #{name}
</select>
java 复制代码 
// 参数传递示例
Example result = mapper.selectByExampleName("Example 1");

2.动态SQL

xml 复制代码 
<!-- ExampleMapper.xml -->
<select id="selectByExample" resultType="com.example.model.Example">
  SELECT * FROM example
  <where>
    <if test="name != null">
      AND name = #{name}
    </if>
    <if test="id != null">
      AND id = #{id}
    </if>
  </where>
</select>

这段XML代码是一个MyBatis的查询语句，用于根据条件从数据库表example中查询记录并返回com.example.model.Example对象的列表。

  • <select>: 这个元素定义了一个查询操作，通过id属性指定了操作的名称为selectByExample，resultType属性指定了查询结果的类型为com.example.model.Example。SQL语句SELECT * FROM example会查询example表中的所有记录。

  • <where>: 这个元素表示一个条件块，在查询时会根据条件动态拼接SQL语句。在这个例子中，会根据条件判断是否需要添加AND条件。

  • <if>: 这个元素用于条件判断，根据test属性的表达式结果来决定是否包含其中的SQL语句。如果条件成立，则会将包含的SQL语句添加到最终的查询语句中。

在这个查询语句中，根据传入的参数name和id的值进行条件判断：

如果name不为null，则会添加AND name = #{name}的条件到查询语句中。如果id不为null，则会添加AND id = #{id}的条件到查询语句中。通过这样的动态条件拼接，可以根据传入的参数灵活地构建查询条件，从而实现根据不同条件查询数据库表的功能。

3.参数映射

MyBatis支持多种参数映射方式，包括@Param注解、Map和@Param注解结合等。

java 复制代码 
public interface ExampleMapper {
    Example selectByIdAndName(@Param("id") int id, @Param("name") String name);
}
xml 复制代码 
<select id="selectByIdAndName" resultType="com.example.model.Example">
    SELECT * FROM example
    WHERE id = #{id} AND name = #{name}
</select>

在这个示例中，@Param注解用于给方法参数命名，这样在Mapper XML文件中可以通过指定的名称引用参数值。

六、最后的话

MyBatis的灵活性和易用性使其成为许多开发人员的首选持久层框架，可以帮助开发人员轻松地与数据库交互。通过本文的介绍，希望读者对MyBatis有了更深入的了解，并能够在实际项目中灵活运用。

能力一般，水平有限，本文可能存在纰漏或错误，如有问题欢迎大佬指正，感谢你阅读这篇文章，如果你觉得写得还行的话，不要忘记点赞、评论、收藏哦！祝生活愉快！

相关推荐
nvd111 分钟前
Java ETL - Apache Beam 简介
java·apache·etl
晴子呀18 分钟前
Spring底层原理大致脉络
java·后端·spring
只吹45°风24 分钟前
Java-ArrayList和LinkedList区别
java·arraylist·linkedlist·区别
阿华的代码王国32 分钟前
【JavaEE】多线程编程引入——认识Thread类
java·开发语言·数据结构·mysql·java-ee
黑蛋同志32 分钟前
array和linked list的区别
java
andrew_121938 分钟前
腾讯 IEG 游戏前沿技术 一面复盘
java·redis·sql·面试
andrew_121940 分钟前
腾讯 IEG 游戏前沿技术 二面复盘
后端·sql·面试
寻求出路的程序媛1 小时前
JVM —— 类加载器的分类，双亲委派机制
java·jvm·面试
这孩子叫逆1 小时前
35. MyBatis中的缓存失效机制是如何工作的？
java·spring·mybatis
骆晨学长1 小时前
基于SpringBoot的校园失物招领系统
java·spring boot
热门推荐
01RAG 实践- Ollama+RagFlow 部署本地知识库02组基轨迹建模 GBTM的介绍与实现（Stata 或 R）032024年高教社杯数学建模国赛C题超详细解题思路分析04苍穹外卖面试总结05Coze扣子平台完整体验和实践（附国内和国际版对比）06【2024数模国赛赛题思路公开】国赛B题思路丨附可运行代码丨无偿自提07CANoe Trace窗口过滤栏消失的几种解决方法（附上最终解决方案）08yolov8实战第五天——yolov8+ffmpg实时视频流检测并进行实时推流——（推流，保姆教学）09【2024高教社杯全国大学生数学建模竞赛】B题 生产过程中的决策问题——解题思路 代码 论文10【立创EDA-PCB设计基础】6.布线铺铜实战及细节详解