脚本之家 服务器常用软件
快捷导航
您的位置：首页 → 软件编程 → java → MyBatis-Plus使用XML和注解

MyBatis-Plus混合使用XML和注解过程

 更新时间：2025年12月24日 09:42:57   作者：wh_xia_jun  
文章介绍了MyBatis-Plus混合使用XML和注解配置的方法和最佳实践,包括配置原则、具体配置方法、注意事项、动态SQL示例、常见问题及解决方案,同时,还详细说明了@MapperScan与mapper-locations的区别和使用场景

mybatisplus代码生成器

版本匹配是个比较麻烦的问题，这是我的配置：

       <dependency>
            <groupId>com.baomidou</groupId>
            <artifactId>mybatis-plus-boot-starter</artifactId>
            <version>3.5.2</version>
        </dependency>

        <dependency>
            <groupId>com.baomidou</groupId>
            <artifactId>mybatis-plus-generator</artifactId>
            <version>3.5.2</version>
        </dependency>
        <dependency>
            <groupId>org.freemarker</groupId>
            <artifactId>freemarker</artifactId>
            <version>2.3.31</version> <!-- 推荐版本 -->
        </dependency>

CodeGenerator：

package com.neuedu.hisweb.utils;

import com.baomidou.mybatisplus.core.exceptions.MybatisPlusException;
import com.baomidou.mybatisplus.generator.FastAutoGenerator;
import com.baomidou.mybatisplus.generator.config.OutputFile;
import com.baomidou.mybatisplus.generator.config.rules.DateType;
import com.baomidou.mybatisplus.generator.config.rules.NamingStrategy;
import com.baomidou.mybatisplus.generator.engine.FreemarkerTemplateEngine;
import com.baomidou.mybatisplus.generator.fill.Column;
import com.baomidou.mybatisplus.annotation.FieldFill; // 引入正确的枚举类
import org.apache.commons.lang3.StringUtils;

import java.util.Collections;
import java.util.Scanner;

public class CodeGenerator {

    private static final String URL = "jdbc:mysql://localhost:3306/his02?useUnicode=true&characterEncoding=utf-8&useSSL=false&allowMultiQueries=true";
    private static final String USERNAME = "root";
    private static final String PASSWORD = "1";
    private static final String AUTHOR = "xj";
    private static final String PARENT_PACKAGE = "com.neuedu.hisweb";
    private static final String OUTPUT_DIR = System.getProperty("user.dir") + "/src/main/java";

    public static String scanner(String tip) {
        Scanner scanner = new Scanner(System.in);
        System.out.println("请输入" + tip + "：");
        if (scanner.hasNext()) {
            String ipt = scanner.next();
            if (StringUtils.isNotBlank(ipt)) {
                return ipt;
            }
        }
        throw new MybatisPlusException("请输入正确的" + tip + "！");
    }

    public static void main(String[] args) {
        // 获取需要生成的表名
        String tables = scanner("表名，多个英文逗号分割");

        FastAutoGenerator.create(URL, USERNAME, PASSWORD)
                .globalConfig(builder -> {
                    builder.author(AUTHOR)
                            .outputDir(OUTPUT_DIR)
                            .fileOverride()
                            .disableOpenDir()
                            .dateType(DateType.ONLY_DATE)
                            .commentDate("yyyy-MM-dd");
                })
                .packageConfig(builder -> {
                    builder.parent(PARENT_PACKAGE)
                            .entity("entity")
                            .service("service")
                            .serviceImpl("service.impl")
                            .mapper("mapper")
                            .controller("controller")
                            .pathInfo(Collections.singletonMap(
                                    OutputFile.xml,
                                    System.getProperty("user.dir") + "/src/main/resources/mapper"
                            ));
                })
                .strategyConfig(builder -> {
                    builder.addInclude(tables.split(","))
                            .entityBuilder()
                            .enableLombok()
                            .naming(NamingStrategy.underline_to_camel)
                            .columnNaming(NamingStrategy.underline_to_camel)
                            .logicDeleteColumnName("deleted")
                            .versionColumnName("version")
                            .addTableFills(
                                    new Column("create_time", FieldFill.INSERT),  // 修改为正确的枚举值
                                    new Column("update_time", FieldFill.INSERT_UPDATE)  // 修改为正确的枚举值
                            )
                            .controllerBuilder()
                            .enableRestStyle()
                            .formatFileName("%sController")
                            .serviceBuilder()
                            .formatServiceFileName("%sService")
                            .formatServiceImplFileName("%sServiceImpl")
                            .mapperBuilder()
                            .formatMapperFileName("%sMapper")
                            .formatXmlFileName("%sMapper");
                })
                .templateEngine(new FreemarkerTemplateEngine())
                .execute();
    }
}

MyBatis-Plus混合使用XML和注解配置

配置原则

1.优先级：

  • XML 配置会覆盖注解配置。

2.最佳实践：

  • 简单的 CRUD 操作可以使用注解（如 @Select、@Insert 等）。
  • 复杂的 SQL 查询（如多表关联、动态 SQL）建议使用 XML 配置。

3.XML 文件位置：

  • 默认放在 resources/mapper 目录下，文件名与 Mapper 接口名对应。

具体配置方法

1.基础配置

确保 application.yml 或 application.properties 中正确配置 MyBatis-Plus：

# application.yml
mybatis-plus:
  # Mapper XML 文件路径
  mapper-locations: classpath:mapper/*.xml
  # 实体扫描，多个package用逗号或者分号分隔
  type-aliases-package: com.neuedu.hisweb.entity
  configuration:
    # 开启驼峰命名
    map-underscore-to-camel-case: true

2.混合使用示例

Mapper 接口：

package com.neuedu.hisweb.mapper;

import com.baomidou.mybatisplus.core.mapper.BaseMapper;
import com.neuedu.hisweb.entity.User;
import org.apache.ibatis.annotations.*;

import java.util.List;

public interface UserMapper extends BaseMapper<User> {

    // 1. 使用注解实现简单查询
    @Select("SELECT * FROM user WHERE age > #{age}")
    List<User> selectByAge(int age);

    // 2. 使用注解实现带参数的插入
    @Insert("INSERT INTO user(name, age) VALUES(#{name}, #{age})")
    @Options(useGeneratedKeys = true, keyProperty = "id")
    int insertUser(User user);

    // 3. 使用 XML 实现复杂查询（XML 文件中定义该方法）
    List<User> selectUserWithDepartment();
}

对应的 XML 文件（resources/mapper/UserMapper.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.neuedu.hisweb.mapper.UserMapper">
    
    <!-- 实现 UserMapper 接口中定义的 selectUserWithDepartment 方法 -->
    <select id="selectUserWithDepartment" resultType="com.neuedu.hisweb.entity.User">
        SELECT u.*, d.name as dept_name 
        FROM user u
        LEFT JOIN department d ON u.dept_id = d.id
        WHERE u.deleted = 0
    </select>
    
    <!-- 可以添加更多复杂 SQL -->
</mapper>

注意事项

1.方法名匹配：XML 文件中的 id 必须与 Mapper 接口中的方法名一致。

2.参数处理：

  • 注解方式：使用 @Param 注解为参数命名。
  • XML 方式：可以直接使用参数名或索引。

3.冲突处理：

  • 如果同一方法在 XML 和注解中都有定义，XML 配置会覆盖注解配置。

4.XML 文件路径：

  • 确保 mapper-locations 配置正确指向 XML 文件。
  • 推荐使用 classpath:mapper/*.xml 或 classpath*:mapper/**/*.xml。

动态 SQL 示例

对于复杂的动态 SQL，XML 方式更加灵活：

<select id="selectUserByCondition" resultType="com.neuedu.hisweb.entity.User">
    SELECT * FROM user
    <where>
        <if test="name != null and name != ''">
            AND name LIKE CONCAT('%', #{name}, '%')
        </if>
        <if test="age != null">
            AND age &gt;= #{age}
        </if>
        <if test="deptId != null">
            AND dept_id = #{deptId}
        </if>
    </where>
    ORDER BY create_time DESC
</select>

常见问题

XML 文件未被加载：

  • 检查 mapper-locations 配置是否正确。
  • 确保 XML 文件在 resources 目录下的正确位置。

方法找不到：

  • 检查 XML 中的 namespace 是否与 Mapper 接口的全限定名一致。
  • 检查方法名（id）是否匹配。

依赖问题：

  • 确保项目中包含 MyBatis-Plus 和 MyBatis 的依赖：
<dependency>
    <groupId>com.baomidou</groupId>
    <artifactId>mybatis-plus-boot-starter</artifactId>
    <version>3.5.2</version>
</dependency>

@MapperScan与mapper-locations的功能的兼容性

  • @MapperScan 负责让 Spring 容器识别 Mapper 接口。
  • mapper-locations 负责让 MyBatis-Plus 加载 XML 中的 SQL 定义。只要两者的路径配置与实际文件位置一致，即可同时使用，不会产生冲突。

两者的核心功能区别

@MapperScan("com.neuedu.hisweb.mapper") 的作用

  • 扫描 Mapper 接口：告诉 Spring 容器去哪里查找 MyBatis-Plus 的 Mapper 接口（如 PatientcostsMapper），并将这些接口注册为 Spring Bean。
  • 必须配置：如果没有该注解或未通过其他方式扫描 Mapper 接口，Spring 将无法识别这些接口，导致依赖注入失败（如 @Autowired UserMapper 会报错）。

mapper-locations: classpath:mapper/*.xml 的作用

  • 指定 XML 映射文件路径：告诉 MyBatis-Plus 去哪里查找 XML 格式的 SQL 映射文件（如 PatientcostsMapper.xml）。
  • 可选配置：如果 Mapper 接口中所有方法都使用注解（如 @Select）定义 SQL，则无需配置；若存在 XML 定义的 SQL，则必须配置正确路径。

为什么需要同时使用？

场景示例：

  • Mapper 接口 PatientcostsMapper 继承自 BaseMapper<Patientcosts>，自动获得 CRUD 方法（无需 XML）。
  • 若该接口中定义了自定义方法（如 selectByCondition），且该方法的 SQL 在 PatientcostsMapper.xml 中实现，则必须通过 mapper-locations 配置 XML 路径，否则 MyBatis-Plus 无法找到对应的 SQL 语句。

@MapperScan 解决的是 Mapper 接口的注册问题，mapper-locations 解决的是 XML 映射文件的加载问题，两者功能独立，可同时使用。

目录结构建议

为避免混淆，建议按以下规范组织文件：

Mapper 接口位置： 

src/main/java/com/neuedu/hisweb/mapper/PatientcostsMapper.java

（与 @MapperScan("com.neuedu.hisweb.mapper") 扫描路径一致）

XML 映射文件位置： 

src/main/resources/mapper/PatientcostsMapper.xml

（与 mapper-locations: classpath:mapper/*.xml 配置路径一致）

可能的冲突场景与解决方案

1.XML 与注解的 SQL 定义冲突

  • 问题：若 Mapper 接口的某个方法同时通过注解（如 @Select）和 XML 定义 SQL，则 XML 配置优先级更高，会覆盖注解中的 SQL。
  • 解决方案：同一方法的 SQL 定义只能选择一种方式（注解或 XML），避免重复定义。

2.Mapper 接口未被扫描

  • 问题：若 @MapperScan 扫描路径错误（如写成 @MapperScan("com.neuedu.hisweb.dao")），则 Spring 无法找到 PatientcostsMapper，导致启动时报错。
  • 解决方案：确保 @MapperScan 的包路径与 Mapper 接口实际路径一致。

验证配置是否生效

启动应用：

  • 若控制台无 NoSuchBeanDefinitionException 或 Invalid bound statement 错误，说明配置正确。

查看日志：

  • 若配置了 mybatis-plus.configuration.log-impl=org.apache.ibatis.logging.stdout.StdOutImpl，执行 SQL 时会打印 XML 或注解中的 SQL 语句，可验证是否正确加载。

总结

以上为个人经验，希望能给大家一个参考，也希望大家多多支持脚本之家。

您可能感兴趣的文章:

相关文章

  • mybatis if传入字符串数字踩坑记录及解决

    mybatis if传入字符串数字踩坑记录及解决

    这篇文章主要介绍了mybatis if传入字符串数字踩坑记录及解决方案，具有很好的参考价值，希望对大家有所帮助。如有错误或未考虑完全的地方，望不吝赐教
    2023-02-02
  • JAVA 对象创建与对象克隆

    JAVA 对象创建与对象克隆

    这篇文章主要介绍了JAVA 对象创建与对象克隆，new 创建、反射、克隆、反序列化，克隆它分为深拷贝和浅拷贝，通过调用对象的 clone方法，进行对象的克隆，下面来看看文章的详细内容吧
    2022-02-02
  • arthas jprofiler做复杂链路的调用分析

    arthas jprofiler做复杂链路的调用分析

    这篇文章主要为大家介绍了arthas jprofiler做复杂链路的调用分析，有需要的朋友可以借鉴参考下，希望能够有所帮助，祝大家多多进步，早日升职加薪
    2022-06-06
  • 关于Spring @Transactional事务传播机制详解

    关于Spring @Transactional事务传播机制详解

    我们日常工作中极少使用事务传播级别,单纯只是使用事务和rollbackfor抛出异常来解决事务问题,但其实我们很多时候使用的是不正确的,或者说会造成事务粒度过大,本文详解一下事务传播级别,也让自己更好地处理事务问题,需要的朋友可以参考下
    2023-08-08
  • 使用mybatis-plus中Page进行分页不生效解决过程

    使用mybatis-plus中Page进行分页不生效解决过程

    在使用MyBatis-Plus的Page进行分页时,如果发现分页不生效,可能是由于未正确配置分页插件,确保在配置类中正确引入了分页插件,并且数据库类型设置正确,同时,检查MybatisPlusConfig类是否被正确注入
    2025-12-12
  • SpringBoot如何优雅的实现重试功能

    SpringBoot如何优雅的实现重试功能

    这篇文章主要详细介绍了SpringBoot如何优雅的实现重试功能的步骤详解，文中有详细的代码示例，具有一定的参考价值，感兴趣的同学可以借鉴阅读
    2023-06-06
  • Spring中的@ExceptionHandler注解统一异常处理详解

    Spring中的@ExceptionHandler注解统一异常处理详解

    这篇文章主要介绍了Spring中的@ExceptionHandler注解统一异常处理详解,当我们使用这个@ExceptionHandler注解时,定义一个异常的处理方法,加上@ExceptionHandler注解,这个方法就会处理类中其他方法抛出的异常,需要的朋友可以参考下
    2024-01-01
  • Java在算法题中的输入问题实例详解

    Java在算法题中的输入问题实例详解

    在校招笔试中,有的时候我们要自己设计输入输出,所以下面这篇文章主要给大家介绍了关于Java在算法题中的输入问题,文中通过示例代码介绍的非常详细,需要的朋友可以参考下
    2022-02-02
  • Springboot3.4.x中的@Bean使用案例

    Springboot3.4.x中的@Bean使用案例

    Spring Boot 3.4.x中@Bean新增defaultCandidate=false属性,用于在存在相同类型Bean时忽略非默认候选者,确保仅实例化一个Bean,下面就来介绍一下如何使用
    2025-08-08
  • Java8 Optional优雅空值判断的示例代码

    Java8 Optional优雅空值判断的示例代码

    这篇文章主要介绍了Java8 Optional优雅空值判断的相关知识，本文通过实例代码给大家介绍的非常详细，对大家的学习或工作具有一定的参考借鉴价值，需要的朋友可以参考下
    2021-05-05

最新评论