企业官网建设流程全解析

1. MyBatis-Plus Mapper 核心架构解析

MyBatis-Plus（以下简称MP）的Mapper层是整个框架中最核心的组件之一，它完美继承了MyBatis的灵活特性，同时通过BaseMapper接口提供了强大的自动化CRUD能力。在实际项目中，Mapper层承担着业务逻辑与数据库操作之间的桥梁作用，其设计质量直接影响着整个应用的开发效率和运行性能。

MP Mapper的核心设计理念是"约定优于配置"。通过BaseMapper 接口，开发者只需简单继承就能获得完整的单表操作能力，这背后是MP对MyBatis原生机制的深度封装。从实现原理来看，MP通过动态代理技术，在运行时自动生成Mapper接口的实现类。当调用BaseMapper的方法时，MP会根据实体类的元数据信息（如表名、字段映射等）动态构建对应的SQL语句。

这种设计带来了几个显著优势：

1. 开发效率提升：单表操作无需编写任何SQL，CRUD方法开箱即用
2. 代码规范性：统一的接口定义避免了不同开发者之间的风格差异
3. 维护成本低：字段变更只需调整实体类，无需修改大量SQL语句
4. 可扩展性：保留原生MyBatis的自定义SQL能力，应对复杂场景

2. BaseMapper 接口深度剖析

2.1 方法分类与使用场景

BaseMapper接口提供了超过30个常用方法，可以归纳为以下几大类：

数据插入相关

• int insert(T entity)：基础插入方法，返回影响行数
• int insertBatch(Collection<T> entityList)：批量插入（3.5.0+版本）
• 主键生成策略支持：
  • 数据库自增（AUTO）
  • 雪花算法（ASSIGN_ID）
  • UUID（ASSIGN_UUID）
  • 自定义生成器

数据删除相关

• int deleteById(Serializable id)：按主键删除
• int deleteByMap(Map<String, Object> columnMap)：按字段条件删除
• int deleteBatchIds(Collection<? extends Serializable> idList)：批量删除
• int delete(Wrapper<T> wrapper)：按条件构造器删除

数据更新相关

• int updateById(T entity)：按主键更新
• int update(T entity, Wrapper<T> wrapper)：按条件更新
• int updateBatchById(Collection<T> entityList)：批量更新（3.5.0+）

数据查询相关

• T selectById(Serializable id)：按主键查询
• List<T> selectBatchIds(Collection<? extends Serializable> idList)：批量查询
• List<T> selectByMap(Map<String, Object> columnMap)：按字段条件查询
• T selectOne(Wrapper<T> wrapper)：查询单条记录
• Long selectCount(Wrapper<T> wrapper)：查询记录数
• List<T> selectList(Wrapper<T> wrapper)：条件查询列表
• IPage<T> selectPage(IPage<T> page, Wrapper<T> wrapper)：分页查询

2.2 条件构造器详解

MP提供了两种主要的条件构造器：QueryWrapper和LambdaQueryWrapper。它们的核心区别在于字段引用的方式：

QueryWrapper示例

QueryWrapper<User> wrapper = new QueryWrapper<>(); wrapper.select("id", "name", "age") .eq("status", 1) .between("age", 20, 30) .like("name", "张") .orderByDesc("create_time");

LambdaQueryWrapper示例

LambdaQueryWrapper<User> lambdaWrapper = new LambdaQueryWrapper<>(); lambdaWrapper.select(User::getId, User::getName, User::getAge) .eq(User::getStatus, 1) .between(User::getAge, 20, 30) .like(User::getName, "张") .orderByDesc(User::getCreateTime);

Lambda方式的主要优势：

1. 类型安全：编译时检查字段名正确性
2. 代码可读性：IDE支持自动补全
3. 重构友好：字段改名时IDE会自动更新

2.3 主键策略配置

MP支持多种主键生成策略，可以通过全局配置或注解方式指定：

全局配置（application.yml）

mybatis-plus: global-config: db-config: id-type: assign_id # 雪花算法 # id-type: auto # 数据库自增 # id-type: none # 无主键 # id-type: input # 手动输入

注解配置（实体类）

@TableId(type = IdType.ASSIGN_ID) private Long id;

常用主键策略对比：

3. Mapper 自定义扩展实战

3.1 XML方式自定义SQL

XML方式适合复杂SQL场景，保持SQL与Java代码分离，便于维护。以下是完整实现步骤：

步骤1：配置XML文件路径

mybatis-plus: mapper-locations: classpath*:/mapper/**/*.xml type-aliases-package: com.example.entity

步骤2：定义Mapper接口方法

public interface UserMapper extends BaseMapper<User> { List<UserVO> selectUserWithRole(@Param("roleId") Long roleId); Page<UserVO> selectUserPage(Page<UserVO> page, @Param("query") UserQuery query); }

步骤3：编写XML映射文件

<!-- resources/mapper/UserMapper.xml --> <mapper namespace="com.example.mapper.UserMapper"> <resultMap id="userVOResultMap" type="com.example.vo.UserVO"> <id column="id" property="id"/> <result column="username" property="username"/> <collection property="roles" ofType="com.example.entity.Role"> <id column="role_id" property="id"/> <result column="role_name" property="name"/> </collection> </resultMap> <select id="selectUserWithRole" resultMap="userVOResultMap"> SELECT u.*, r.id AS role_id, r.name AS role_name FROM user u LEFT JOIN user_role ur ON u.id = ur.user_id LEFT JOIN role r ON ur.role_id = r.id <where> <if test="roleId != null"> AND r.id = #{roleId} </if> </where> </select> <select id="selectUserPage" resultMap="userVOResultMap"> SELECT u.*, r.id AS role_id, r.name AS role_name FROM user u LEFT JOIN user_role ur ON u.id = ur.user_id LEFT JOIN role r ON ur.role_id = r.id <where> <if test="query.keyword != null and query.keyword != ''"> AND (u.username LIKE CONCAT('%', #{query.keyword}, '%') OR u.nickname LIKE CONCAT('%', #{query.keyword}, '%')) </if> <if test="query.status != null"> AND u.status = #{query.status} </if> </where> </select> </mapper>

3.2 注解方式自定义SQL

对于简单的SQL语句，可以直接使用注解方式，避免XML文件的维护成本：

public interface OrderMapper extends BaseMapper<Order> { @Select("SELECT * FROM order WHERE user_id = #{userId} AND status = #{status}") List<Order> selectByUserAndStatus(@Param("userId") Long userId, @Param("status") Integer status); @Update("UPDATE order SET status = #{status} WHERE id = #{orderId}") int updateOrderStatus(@Param("orderId") Long orderId, @Param("status") Integer status); @SelectProvider(type = OrderSqlProvider.class, method = "selectByDynamicCondition") List<Order> selectByDynamicCondition(OrderQuery query); } public class OrderSqlProvider { public String selectByDynamicCondition(OrderQuery query) { return new SQL() {{ SELECT("*"); FROM("order"); if (query.getUserId() != null) { WHERE("user_id = #{userId}"); } if (query.getStartTime() != null) { WHERE("create_time >= #{startTime}"); } if (query.getEndTime() != null) { WHERE("create_time <= #{endTime}"); } ORDER_BY("create_time DESC"); }}.toString(); } }

3.3 动态SQL最佳实践

MP支持多种动态SQL构建方式，根据复杂度可以选择：

1. XML动态SQL：适合复杂条件组合

<select id="searchUsers" resultType="User"> SELECT * FROM user <where> <if test="name != null"> AND name LIKE CONCAT('%', #{name}, '%') </if> <if test="status != null"> AND status = #{status} </if> <choose> <when test="role == 'admin'"> AND is_admin = 1 </when> <when test="role == 'vip'"> AND is_vip = 1 </when> <otherwise> AND is_common = 1 </otherwise> </choose> </where> </select>

2. Java动态SQL：使用SQL构建器

public List<User> searchUsers(UserQuery query) { return new LambdaQueryChainWrapper<>(userMapper) .like(query.getName() != null, User::getName, query.getName()) .eq(query.getStatus() != null, User::getStatus, query.getStatus()) .list(); }

3. 注解动态SQL：使用@SelectProvider

@SelectProvider(type = UserSqlBuilder.class, method = "buildSearchSql") List<User> searchUsers(UserQuery query); public class UserSqlBuilder { public static String buildSearchSql(UserQuery query) { return new SQL() {{ SELECT("*"); FROM("user"); if (query.getName() != null) { WHERE("name LIKE CONCAT('%', #{name}, '%')"); } if (query.getStatus() != null) { WHERE("status = #{status}"); } }}.toString(); } }

4. Mapper 高级特性与优化

4.1 批量操作性能优化

MP提供了多种批量操作方式，性能对比：

最佳实践示例：

// 方式1：MP批量插入（自动分批） List<User> userList = ...; userMapper.insertBatchSomeColumn(userList); // 3.5.0+版本 // 方式2：原生MyBatis批量插入 @Insert("<script>" + "INSERT INTO user (name, age) VALUES " + "<foreach collection='list' item='item' separator=','>" + "(#{item.name}, #{item.age})" + "</foreach>" + "</script>") void batchInsert(@Param("list") List<User> userList); // 方式3：JDBC批量模式配置 spring: datasource: hikari: ><dependency> <groupId>com.baomidou</groupId> <artifactId>dynamic-datasource-spring-boot-starter</artifactId> <version>3.5.0</version> </dependency>

2. 配置数据源：

spring: datasource: dynamic: primary: master datasource: master: url: jdbc:mysql://localhost:3306/master username: root password: 123456 driver-class-name: com.mysql.cj.jdbc.Driver slave1: url: jdbc:mysql://localhost:3306/slave1 username: root password: 123456 driver-class-name: com.mysql.cj.jdbc.Driver

3. 使用注解切换数据源：

@Service @DS("master") // 类级别默认数据源 public class UserServiceImpl implements UserService { @Autowired private UserMapper userMapper; @Override @DS("slave1") // 方法级别覆盖 public User getById(Long id) { return userMapper.selectById(id); } @Override public void save(User user) { userMapper.insert(user); // 使用master数据源 } }

4.3 逻辑删除与自动填充

逻辑删除配置：

mybatis-plus: global-config: db-config: logic-delete-field: deleted # 逻辑删除字段名 logic-delete-value: 1 # 删除值 logic-not-delete-value: 0 # 未删除值

自动填充配置：

public class User { @TableField(fill = FieldFill.INSERT) private LocalDateTime createTime; @TableField(fill = FieldFill.INSERT_UPDATE) private LocalDateTime updateTime; } @Component public class MyMetaObjectHandler implements MetaObjectHandler { @Override public void insertFill(MetaObject metaObject) { this.strictInsertFill(metaObject, "createTime", LocalDateTime.class, LocalDateTime.now()); } @Override public void updateFill(MetaObject metaObject) { this.strictUpdateFill(metaObject, "updateTime", LocalDateTime.class, LocalDateTime.now()); } }

5. Mapper 性能调优与监控

5.1 SQL性能分析

启用MP的SQL分析插件，帮助发现慢查询：

@Bean public MybatisPlusInterceptor mybatisPlusInterceptor() { MybatisPlusInterceptor interceptor = new MybatisPlusInterceptor(); // SQL分析插件 interceptor.addInnerInterceptor(new PerformanceInnerInterceptor()); return interceptor; }

配置分析参数：

mybatis-plus: global-config: sql-parser-cache: true # 开启SQL解析缓存 configuration: log-impl: org.apache.ibatis.logging.stdout.StdOutImpl # 日志输出

5.2 二级缓存配置

MP支持MyBatis的二级缓存，提升查询性能：

1. 全局开启二级缓存：

mybatis-plus: configuration: cache-enabled: true

2. Mapper接口添加注解：

@CacheNamespace public interface UserMapper extends BaseMapper<User> { }

3. 实体类实现Serializable：

public class User implements Serializable { private static final long serialVersionUID = 1L; //... }

5.3 分页查询优化

MP分页插件配置与优化：

@Bean public MybatisPlusInterceptor mybatisPlusInterceptor() { MybatisPlusInterceptor interceptor = new MybatisPlusInterceptor(); // 分页插件 PaginationInnerInterceptor paginationInnerInterceptor = new PaginationInnerInterceptor(); paginationInnerInterceptor.setOptimizeJoin(true); // 优化JOIN分页 paginationInnerInterceptor.setMaxLimit(1000L); // 单页最大记录数 interceptor.addInnerInterceptor(paginationInnerInterceptor); return interceptor; }

分页查询示例：

public PageResult<User> queryUserPage(UserQuery query) { Page<User> page = new Page<>(query.getPageNum(), query.getPageSize()); LambdaQueryWrapper<User> wrapper = new LambdaQueryWrapper<>(); wrapper.eq(query.getStatus() != null, User::getStatus, query.getStatus()) .like(StringUtils.isNotBlank(query.getKeyword()), User::getName, query.getKeyword()); IPage<User> userPage = userMapper.selectPage(page, wrapper); return new PageResult<>( userPage.getRecords(), userPage.getTotal(), userPage.getCurrent(), userPage.getSize() ); }

6. 常见问题解决方案

6.1 字段映射问题

问题现象：数据库字段与实体类属性命名不一致导致查询结果映射失败。

解决方案：

1. 开启驼峰命名自动转换：

mybatis-plus: configuration: map-underscore-to-camel-case: true

2. 使用@TableField注解显式指定：

@TableField("user_name") private String name;

3. 全局配置表前缀：

mybatis-plus: global-config: db-config: table-prefix: t_

6.2 主键冲突问题

问题现象：批量插入时出现主键冲突。

解决方案：

1. 确保主键生成策略正确：

@TableId(type = IdType.ASSIGN_ID) private Long id;

2. 批量插入前检查主键是否已存在：

List<User> users = ...; List<Long> existIds = userMapper.selectList( new LambdaQueryWrapper<User>() .in(User::getId, users.stream().map(User::getId).collect(Collectors.toList())) ).stream().map(User::getId).collect(Collectors.toList()); List<User> newUsers = users.stream() .filter(u -> !existIds.contains(u.getId())) .collect(Collectors.toList()); if (!newUsers.isEmpty()) { userMapper.insertBatchSomeColumn(newUsers); }

6.3 乐观锁冲突问题

问题现象：并发更新时出现乐观锁版本冲突。

解决方案：

1. 实体类添加@Version注解：

@Version private Integer version;

2. 更新时自动带上版本条件：

User user = userMapper.selectById(id); user.setName("new name"); userMapper.updateById(user); // UPDATE user SET name=?, version=? WHERE id=? AND version=?

3. 重试机制处理冲突：

@Retryable(value = OptimisticLockingFailureException.class, maxAttempts = 3) public void updateWithRetry(User user) { userMapper.updateById(user); }

7. 最佳实践总结

经过多个项目的实践验证，以下是MP Mapper层的最佳实践建议：

1. 接口设计原则

• 保持Mapper接口的单一职责，每个Mapper只操作对应的实体表
• 复杂查询建议拆分为多个小方法，而不是一个庞大的万能查询
• 对于关联查询，优先考虑使用VO对象而非Map接收结果

2. 性能优化要点

• 批量操作务必使用批处理方式，避免循环单条操作
• 查询时只返回需要的字段，避免select *
• 高频查询考虑添加合适的数据库索引
• 大数据量分页使用优化后的分页方案

3. 事务管理建议

• 在Service层使用@Transactional管理事务
• 避免在循环中执行数据库操作，应在循环外批量处理
• 对于耗时较长的批处理，考虑分批次提交事务

4. 代码可维护性

• 保持SQL的可读性，复杂SQL添加必要注释
• 统一项目的查询风格（是使用Wrapper还是XML/注解）
• 对于通用查询条件，可以封装为公共方法或Wrapper

5. 安全注意事项

• 动态SQL务必使用参数化查询，防止SQL注入
• 用户输入的内容必须做适当的过滤和转义
• 敏感字段考虑在查询时排除或加密处理

在实际项目中，我们通常会结合团队规范制定更详细的Mapper层开发指南。例如：

• 规定所有条件查询必须使用LambdaQueryWrapper
• 规定超过3个表关联的查询必须使用XML方式实现
• 规定批量操作必须进行性能测试
• 规定所有数据库操作必须记录适当的日志

这些规范可以帮助团队保持代码风格一致，提高项目的可维护性。