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有了更深入的了解，并能够在实际项目中灵活运用。

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

相关推荐
zquwei6 分钟前
SpringCloudGateway+Nacos注册与转发Netty+WebSocket
java·网络·分布式·后端·websocket·网络协议·spring
TT哇12 分钟前
*【每日一题 提高题】[蓝桥杯 2022 国 A] 选素数
java·算法·蓝桥杯
dessler27 分钟前
Docker-run命令详细讲解
linux·运维·后端·docker
火烧屁屁啦35 分钟前
【JavaEE进阶】初始Spring Web MVC
java·spring·java-ee
w_31234541 小时前
自定义一个maven骨架 | 最佳实践
java·maven·intellij-idea
岁岁岁平安1 小时前
spring学习(spring-DI(字符串或对象引用注入、集合注入)(XML配置))
java·学习·spring·依赖注入·集合注入·基本数据类型注入·引用数据类型注入
武昌库里写JAVA1 小时前
Java成长之路（一）--SpringBoot基础学习--SpringBoot代码测试
java·开发语言·spring boot·学习·课程设计
Q_19284999061 小时前
基于Spring Boot的九州美食城商户一体化系统
java·spring boot·后端
张国荣家的弟弟1 小时前
【Yonghong 企业日常问题 06】上传的文件不在白名单，修改allow.jar.digest属性添加允许上传的文件SH256值？
java·jar·bi
热门推荐
01构建高效的广告投放系统：应用架构的设计与实现02ARM学习（31）编译器对overlay方式的支持03玄机平台应急响应—webshell查杀04Cube-Studio：开源大模型全链路一站式中台05校验 GPT-4 真实性的三个经典问题：快速区分 GPT-3.5 与 GPT-4，并提供免费测试网站06Docker 夺命连环 15 问07〔AI 绘画〕Stable Diffusion 之 解决绘制多人或面部很小的人物时面部崩坏问题 篇08基于大语言模型（LLM）的合成数据生成、策展和评估的综述09(欧拉)openEuler系统添加网卡文件配置流程、(欧拉)openEuler系统手动配置ipv6地址流程、(欧拉)openEuler系统网络管理说明10Ubuntu 20.04使用Livox mid 360 测试 FAST_LIO