0

0

MyBatis 的Mapper接口是如何工作的?为什么没有实现类?

紅蓮之龍

紅蓮之龍

发布时间:2025-09-03 22:05:01

|

522人浏览过

|

来源于php中文网

原创

MyBatis通过动态代理自动生成Mapper接口实现类,运行时将接口方法绑定到SQL语句,结合XML映射文件中的SQL与参数配置,由SqlSession执行并返回结果,避免了手动编写实现类的繁琐过程。

mybatis 的mapper接口是如何工作的?为什么没有实现类?

MyBatis 的 Mapper 接口实际上并不需要我们手动去写实现类,它的工作方式有点像“魔法”,但背后是扎实的框架机制在支撑。简单来说,MyBatis 通过动态代理,在运行时生成接口的实现类,并将 SQL 语句绑定到这些实现类的方法上。

解决方案:

MyBatis 的 Mapper 接口工作流程主要依赖于以下几个核心机制:

  1. 接口定义: 首先,你需要定义一个 Mapper 接口,这个接口中的方法对应着你想要执行的 SQL 操作。接口方法可以接受参数,也可以返回结果。

    public interface UserMapper {
        User getUserById(int id);
        List getAllUsers();
        void insertUser(User user);
        void updateUser(User user);
        void deleteUser(int id);
    }
  2. SQL 映射文件: 然后,你需要创建一个 XML 映射文件,这个文件与 Mapper 接口对应,并且包含了 SQL 语句和接口方法之间的映射关系。

    
        
    
        
    
        
            INSERT INTO users (name, email) VALUES (#{name}, #{email})
        
    
        
            UPDATE users SET name = #{name}, email = #{email} WHERE id = #{id}
        
    
        
            DELETE FROM users WHERE id = #{id}
        
    
  3. 动态代理: 当你通过

    SqlSession
    获取 Mapper 接口的实例时,MyBatis 会使用 JDK 动态代理(或者 CGLIB,如果接口没有实现)创建一个代理对象。这个代理对象会拦截所有对接口方法的调用。

  4. 方法拦截和 SQL 执行: 当代理对象拦截到方法调用时,它会根据方法名和参数,在 XML 映射文件中查找对应的 SQL 语句。然后,它会使用

    SqlSession
    执行 SQL 语句,并将结果映射到相应的 Java 对象。

  5. 结果返回: 最后,代理对象会将执行结果返回给调用者。

为什么没有实现类?因为 MyBatis 在运行时动态生成了实现类。 这避免了大量重复的样板代码,也使得代码更加简洁和易于维护。想象一下,如果每个 Mapper 接口都要手动写一个实现类,那将会是一场噩梦。

MyBatis 如何加载和解析 Mapper 映射文件?

MyBatis 通过

SqlSessionFactoryBuilder
构建
SqlSessionFactory
,在构建过程中,会解析 MyBatis 的配置文件 (mybatis-config.xml),其中会包含 Mapper 映射文件的位置。

具体来说,MyBatis 会使用

XMLConfigBuilder
解析配置文件,并使用
XMLMapperBuilder
解析 Mapper 映射文件。
XMLMapperBuilder
会读取 XML 文件,并将其中的 SQL 语句、参数映射、结果映射等信息解析成 MyBatis 内部的数据结构,例如
MappedStatement
。这些
MappedStatement
对象会被存储在
Configuration
对象中,供后续的 SQL 执行使用。

如果你的Mapper文件没有正确加载,可能会遇到

org.apache.ibatis.binding.BindingException: Invalid bound statement (not found)
错误。 检查你的 mybatis-config.xml 文件,确保Mapper文件路径正确,并且文件存在。 另外,检查Mapper接口的namespace是否和Mapper文件的namespace一致。

如何在 Spring Boot 中集成 MyBatis 并使用 Mapper 接口?

Spring Boot 提供了

mybatis-spring-boot-starter
依赖,可以方便地集成 MyBatis。

Designify
Designify

拖入图片便可自动去除背景✨

下载
  1. 添加依赖: 首先,需要在

    pom.xml
    文件中添加
    mybatis-spring-boot-starter
    依赖。

    
        org.mybatis.spring.boot
        mybatis-spring-boot-starter
        2.2.0 
    
  2. 配置数据源: 然后,需要在

    application.properties
    application.yml
    文件中配置数据源信息,例如数据库连接 URL、用户名、密码等。

    spring.datasource.url=jdbc:mysql://localhost:3306/mydatabase
    spring.datasource.username=root
    spring.datasource.password=password
    spring.datasource.driver-class-name=com.mysql.cj.jdbc.Driver
  3. 配置 MyBatis: 接下来,可以在

    application.properties
    application.yml
    文件中配置 MyBatis 的相关属性,例如 Mapper 接口的扫描路径、配置文件的位置等。

    mybatis.mapper-locations=classpath:mapper/*.xml
    mybatis.configuration.map-underscore-to-camel-case=true
  4. 使用 Mapper 接口: 最后,可以使用

    @Autowired
    注解将 Mapper 接口注入到你的 Service 或 Controller 中,并直接调用接口方法执行 SQL 操作。

    @Service
    public class UserService {
        @Autowired
        private UserMapper userMapper;
    
        public User getUserById(int id) {
            return userMapper.getUserById(id);
        }
    }

注意, Spring Boot 会自动扫描 Mapper 接口,并将其注册为 Spring Bean。 如果你没有看到你的Mapper Bean被注入,检查你的启动类是否添加了

@MapperScan
注解,并指定正确的 Mapper 接口扫描路径。 例如:
@MapperScan("com.example.mapper")

MyBatis 的动态 SQL 是如何实现的?它有哪些常用的标签?

MyBatis 的动态 SQL 功能允许你根据不同的条件动态生成 SQL 语句,这在处理复杂的查询场景时非常有用。 动态 SQL 的实现依赖于 MyBatis 提供的各种标签,例如

,
,
,
,
,
,
等。

  • 用于根据条件判断是否包含某段 SQL 片段。

  • ,
    ,
    类似于 Java 中的
    switch
    语句,用于根据不同的条件选择不同的 SQL 片段。

  • 用于自动添加
    WHERE
    关键字,并且可以智能地处理
    AND
    OR
    关键字的开头问题。

  • 用于在
    UPDATE
    语句中动态设置字段,并且可以智能地处理逗号的问题。

    
      update Author
        
          username=#{username},
          password=#{password},
          email=#{email},
          bio=#{bio}
        
      where id=#{id}
    
  • 用于遍历集合,可以生成
    IN
    语句或者批量插入语句。

在使用动态 SQL 时,需要注意 SQL 注入的风险。 尽量使用

#
占位符,而不是
${}
字符串替换。
#
占位符可以防止 SQL 注入,因为它会将参数值作为预编译语句的参数传递给数据库,而不是直接拼接到 SQL 语句中。

相关专题

更多
java
java

Java是一个通用术语,用于表示Java软件及其组件,包括“Java运行时环境 (JRE)”、“Java虚拟机 (JVM)”以及“插件”。php中文网还为大家带了Java相关下载资源、相关课程以及相关文章等内容,供大家免费下载使用。

825

2023.06.15

java正则表达式语法
java正则表达式语法

java正则表达式语法是一种模式匹配工具,它非常有用,可以在处理文本和字符串时快速地查找、替换、验证和提取特定的模式和数据。本专题提供java正则表达式语法的相关文章、下载和专题,供大家免费下载体验。

724

2023.07.05

java自学难吗
java自学难吗

Java自学并不难。Java语言相对于其他一些编程语言而言,有着较为简洁和易读的语法,本专题为大家提供java自学难吗相关的文章,大家可以免费体验。

731

2023.07.31

java配置jdk环境变量
java配置jdk环境变量

Java是一种广泛使用的高级编程语言,用于开发各种类型的应用程序。为了能够在计算机上正确运行和编译Java代码,需要正确配置Java Development Kit(JDK)环境变量。php中文网给大家带来了相关的教程以及文章,欢迎大家前来阅读学习。

396

2023.08.01

java保留两位小数
java保留两位小数

Java是一种广泛应用于编程领域的高级编程语言。在Java中,保留两位小数是指在进行数值计算或输出时,限制小数部分只有两位有效数字,并将多余的位数进行四舍五入或截取。php中文网给大家带来了相关的教程以及文章,欢迎大家前来阅读学习。

398

2023.08.02

java基本数据类型
java基本数据类型

java基本数据类型有:1、byte;2、short;3、int;4、long;5、float;6、double;7、char;8、boolean。本专题为大家提供java基本数据类型的相关的文章、下载、课程内容,供大家免费下载体验。

445

2023.08.02

java有什么用
java有什么用

java可以开发应用程序、移动应用、Web应用、企业级应用、嵌入式系统等方面。本专题为大家提供java有什么用的相关的文章、下载、课程内容,供大家免费下载体验。

429

2023.08.02

java在线网站
java在线网站

Java在线网站是指提供Java编程学习、实践和交流平台的网络服务。近年来,随着Java语言在软件开发领域的广泛应用,越来越多的人对Java编程感兴趣,并希望能够通过在线网站来学习和提高自己的Java编程技能。php中文网给大家带来了相关的视频、教程以及文章,欢迎大家前来学习阅读和下载。

16881

2023.08.03

php源码安装教程大全
php源码安装教程大全

本专题整合了php源码安装教程,阅读专题下面的文章了解更多详细内容。

74

2025.12.31

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
微信小程序开发之API篇
微信小程序开发之API篇

共15课时 | 1.2万人学习

Laravel---API接口
Laravel---API接口

共7课时 | 0.6万人学习

进程与SOCKET
进程与SOCKET

共6课时 | 0.3万人学习

关于我们 免责申明 举报中心 意见反馈 讲师合作 广告合作 最新更新
php中文网:公益在线php培训,帮助PHP学习者快速成长!
关注服务号 技术交流群
PHP中文网订阅号
每天精选资源文章推送

Copyright 2014-2026 https://www.php.cn/ All Rights Reserved | php.cn | 湘ICP备2023035733号