MyBatis 高效使用技巧

常见 MyBatis 使用技巧，这些技巧有助于简化数据库操作，提高开发效率，并增强系统的性能。

1. 动态 SQL

动态 SQL 让开发者能够依据参数灵活地构建 SQL 语句，避免了手动拼接字符串带来的复杂性和错误风险。

<select id="selectUsersByCondition" parameterType="map" resultType="User">SELECT * FROM users WHERE 1=1<if test="username != null">AND username = #{username}</if><if test="age != null">AND age = #{age}</if><if test="status != null">AND status = #{status}</if>
</select>

2. 批量操作

通过 <foreach> 标签可以轻松实现批量插入或更新，减少多次调用造成的性能损失。

<insert id="batchInsert" parameterType="list">INSERT INTO users (username, age)VALUES<foreach collection="list" item="user" separator=",">(#{user.username}, #{user.age})</foreach>
</insert>

3. 结果集映射 (resultMap)

当查询结果与实体类字段不匹配时，resultMap 可以帮助进行精确映射，适用于复杂的关联关系。

<resultMap id="userResultMap" type="User"><id property="id" column="user_id"/><result property="username" column="user_name"/><result property="age" column="user_age"/>
</resultMap>

4. 分页查询

利用分页插件（如 MyBatis-Plus 或 PageHelper）简化分页逻辑，无需手动处理 LIMIT 和 OFFSET。

Page<User> page = new Page<>(1, 10); // 第一页，每页10条记录
List<User> users = userMapper.selectPage(page, new QueryWrapper<>());

5. 一对多关系映射

collection 标签用于处理一对多的关系，自动将子表数据封装到父对象中。

<resultMap id="userWithOrders" type="User"><!-- 省略主表映射 --><collection property="orders" ofType="Order"><id property="id" column="order_id"/><result property="amount" column="order_amount"/></collection>
</resultMap>

6. 注解与 XML 配合使用

结合 @Mapper 注解和 XML 映射文件，既保持了接口配置的简洁性，又实现了 SQL 的外部化管理。

@Mapper
public interface UserMapper {List<User> selectUsersByCondition(Map<String, Object> params);
}

7. 批量更新

同样可以通过 <foreach> 实现批量更新，减少数据库交互次数。

<update id="batchUpdateUsers" parameterType="list"><foreach collection="list" item="user" separator=";">UPDATE users SET username = #{user.username}, age = #{user.age} WHERE id = #{user.id}</foreach>
</update>

8. 复杂表达式处理

bind 标签允许在 SQL 中直接处理复杂的表达式，使代码更整洁。

<bind name="pattern" value="'%' + keyword + '%'"/>
<select id="selectUsersByKeyword" resultType="User">SELECT * FROM users WHERE username LIKE #{pattern}
</select>

9. 自定义类型处理器

为了解决 Java 类型与数据库类型的不一致问题，可以创建自定义类型处理器。

@MappedJdbcTypes(JdbcType.VARCHAR)
@MappedTypes(CustomType.class)
public class CustomTypeHandler extends BaseTypeHandler<CustomType> { /* ... */ }

10. 逻辑删除

逻辑删除是一种保留历史数据的删除方式，它只是标记记录为已删除状态。

<update id="deleteUser" parameterType="int">UPDATE users SET deleted = 1 WHERE id = #{id}
</update>

11. 分表策略

对于海量数据场景，分表策略能显著提升查询性能。注意防范 SQL 注入风险。

<select id="selectFromTable" resultType="User">SELECT * FROM ${tableName} WHERE id = #{id}
</select>

12. SQL 片段复用

使用 <sql> 标签定义可复用的 SQL 片段，减少重复代码。

<sql id="baseUserColumns">id, username, age, email
</sql>

13. 枚举类型映射

枚举类型处理器简化了枚举值与数据库字段间的映射，增强了代码的可读性。

@EnumTypeHandler(EnumTypeHandler.class)
public enum UserStatus {ACTIVE, INACTIVE;
}

14. 多数据源配置

多数据源配置有助于分离不同类型的数据，满足微服务架构下的需求。

@Configuration
public class MyBatisConfig {@Beanpublic SqlSessionFactory sqlSessionFactory(DataSource dataSource) throws Exception {SqlSessionFactoryBean factoryBean = new SqlSessionFactoryBean();factoryBean.setDataSource(dataSource);return factoryBean.getObject();}
}

15. 延迟加载

延迟加载特性可以在需要时才加载关联数据，从而优化性能。

<settings><setting name="lazyLoadingEnabled" value="true"/>
</settings>

---