mybatisplus默认xml文件路径

### MyBatis Plus 中配置 XML 映射文件包路径 在 MyBatis Plus 的应用环境中，为了使框架能正确识别并加载 XML 映射文件，需确保这些文件位于正确的目录下，并通过适当的方式告知 Spring Boot 或其他容器其具体位置。 通常情况下，在基于 Maven 构建的项目结构里，XML 映射文件应当放置于 `src/main/resources/mapper` 目录之下。对于 Gradle 项目，则可能是类似的资源路径。当遵循这种默认约定时，大多数场景下的自动扫描机制可以正常工作而不需要额外设置[^1]。 然而，如果希望自定义映射文件的位置或是处理更复杂的多模块工程，那么就需要显式指定 Mapper 接口对应的 XML 文件所在之处： #### 方法一：使用 @MapperScan 注解 可以在启动类上利用 `@MapperScan` 来指明接口所在的包名以及相应的 XML 文件路径。例如： ```java @SpringBootApplication @MapperScan(basePackages = "com.example.mapper", resourcesLocation = "classpath*:mapper/**/*.xml") // 自定义XML文件路径 public class Application { public static void main(String[] args) { SpringApplication.run(Application.class, args); } } ``` #### 方法二：Spring Boot 属性配置方式 另一种更为灵活的做法是在 application.properties 或者 yml 文件中添加属性来控制这一行为： ```properties mybatis-plus.mapper-locations=classpath*:mapper/**/*.xml ``` 上述配置意味着所有的 mapper XML 将会从项目的根 classpath 下名为 'mapper' 的子目录及其所有子目录中被检索出来[^4]。 以上两种方法都可以有效地帮助开发者管理不同业务逻辑层面上的数据访问组件之间的关系，同时也简化了开发过程中的资源配置问题。

<think>根据用户的问题，用户希望了解如何在MyBatis-Plus中通过XML配置文件实现分页查询功能。结合提供的引用内容，我们可以这样回答： 1. 首先，需要配置MyBatis-Plus的分页插件（如引用[2]所示），这是实现分页功能的前提。 2. 在Mapper接口中定义分页查询方法，该方法需要接受一个Page对象作为参数（用于分页信息）和查询条件（可选）。 3. 在XML映射文件中编写对应的SQL语句，注意不需要在SQL中写LIMIT，因为MyBatis-Plus的分页插件会自动处理。 具体步骤： ### 1. 配置分页插件 在配置类中注册分页拦截器（PaginationInnerInterceptor），如引用[2]所示： ```java @Configuration @MapperScan("com.example.demo.mapper") public class MybatisPlusConfig { @Bean public MybatisPlusInterceptor mybatisPlusInterceptor() { MybatisPlusInterceptor interceptor = new MybatisPlusInterceptor(); interceptor.addInnerInterceptor(new PaginationInnerInterceptor()); return interceptor; } } ``` ### 2. 创建Mapper接口 在Mapper接口中定义分页查询方法，例如： ```java public interface UserMapper extends BaseMapper<User> { IPage<User> selectPageByCondition(Page<User> page, @Param("condition") Map<String, Object> condition); } ``` 这里使用了`IPage`作为返回类型，`Page`对象作为参数传递分页信息（当前页、每页条数等），同时可以传递一个条件参数（如Map）用于查询条件。 ### 3. 编写XML映射文件 在对应的XML文件中编写SQL语句，注意使用`<script>`标签包裹动态SQL： ```xml <mapper namespace="com.example.demo.mapper.UserMapper"> <select id="selectPageByCondition" resultType="com.example.demo.entity.User"> SELECT * FROM users <where> <if test="condition.name != null and condition.name != ''"> name LIKE CONCAT('%', #{condition.name}, '%') </if> <if test="condition.age != null"> AND age = #{condition.age} </if> </where> </select> </mapper> ``` 这里不需要在SQL中写分页关键字（如LIMIT），因为分页插件会自动在原始SQL后添加分页语句。 ### 4. 调用分页查询 在Service或Controller中调用： ```java Page<User> page = new Page<>(1, 10); // 当前页为1，每页10条 Map<String, Object> condition = new HashMap<>(); condition.put("name", "John"); condition.put("age", 25); IPage<User> userPage = userMapper.selectPageByCondition(page, condition); List<User> userList = userPage.getRecords(); // 当前页数据 long total = userPage.getTotal(); // 总记录数 ``` ### 注意事项 - 如果使用MySQL数据库，分页插件会自动使用`LIMIT`语句；如果是Oracle，会使用ROWNUM。 - 分页查询的返回类型必须是`IPage<T>`，且参数中必须有`Page`对象（或其子类）。 - 如果不需要条件，可以只传递Page参数。 这样，我们就通过XML配置方式实现了MyBatis-Plus的分页查询功能。 §§相关问题§§ 1. MyBatis-Plus分页插件支持哪些数据库？ 2. 如何在MyBatis-Plus中实现自定义分页（如优化count查询）？ 3. MyBatis-Plus分页查询的性能如何优化？</think>### MyBatis-Plus XML配置实现分页查询 在MyBatis-Plus中通过XML配置实现分页查询需要以下步骤： #### 1. 配置分页插件（核心） 在Spring Boot配置类中注册分页拦截器（**必须步骤**）： ```java @Configuration @MapperScan("com.example.mapper") // 修改为实际Mapper包路径 public class MybatisPlusConfig { @Bean public MybatisPlusInterceptor mybatisPlusInterceptor() { MybatisPlusInterceptor interceptor = new MybatisPlusInterceptor(); // 添加分页拦截器 interceptor.addInnerInterceptor(new PaginationInnerInterceptor(DbType.MYSQL)); return interceptor; } } ``` > 引用[2]中展示了基础配置，这里添加了数据库类型参数[^2] #### 2. 创建Mapper接口 ```java public interface UserMapper extends BaseMapper<User> { // XML方式的分页查询方法 IPage<User> selectPageByCondition(Page<User> page, @Param("condition") Map<String, Object> condition); } ``` #### 3. 编写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"> <select id="selectPageByCondition" resultType="com.example.entity.User"> SELECT * FROM users <where> <!-- 动态SQL条件 --> <if test="condition.name != null and condition.name != ''"> AND name LIKE CONCAT('%', #{condition.name}, '%') </if> <if test="condition.age != null"> AND age = #{condition.age} </if> <if test="condition.status != null"> AND status = #{condition.status} </if> </where> ORDER BY create_time DESC </select> </mapper> ``` #### 4. 实体类配置 ```java @TableName("users") // 指定表名 public class User { @TableId(type = IdType.AUTO) // 主键策略 private Long id; private String name; private Integer age; private Integer status; // getter/setter省略 } ``` > 引用[3]展示了实体类基础配置[^3] #### 5. 服务层调用 ```java @Service public class UserServiceImpl implements UserService { @Autowired private UserMapper userMapper; public PageResult<User> queryByPage(int current, int size, Map<String, Object> params) { // 创建分页对象 Page<User> page = new Page<>(current, size); // 执行XML分页查询 IPage<User> result = userMapper.selectPageByCondition(page, params); return new PageResult<>( result.getRecords(), result.getTotal(), result.getSize(), result.getCurrent() ); } } ``` #### 关键说明： 1. **分页原理**：分页插件会自动在原始SQL后添加`LIMIT ?, ?`语句 2. **性能优化**：默认执行两次SQL（查询数据+COUNT查询），可通过`@InterceptorIgnore`注解优化 3. **XML要求**：XML中的SQL**不需要**手动写`LIMIT`，插件会自动处理 4. **返回值**：使用`IPage<T>`接口接收结果，包含分页元数据 #### 配置验证： 确保主配置类包含Mapper扫描： ```java @SpringBootApplication @MapperScan("com.example.mapper") // 与XML的namespace一致 public class Application { public static void main(String[] args) { SpringApplication.run(Application.class, args); } } ``` > 引用[4]展示了MapperScan配置[^4]