1. Mybatis XML方式基础操作解析作为Java生态中最受欢迎的ORM框架之一Mybatis提供了两种主要的SQL映射方式注解和XML。在实际企业级开发中XML配置方式因其强大的表达能力、清晰的隔离性和灵活的动态SQL特性成为复杂业务场景下的首选方案。今天我们就来深入剖析Mybatis XML方式中最基础的CRUD操作——新增(insert)、删除(delete)和修改(update)这些看似简单的操作在实际开发中却藏着不少值得注意的技术细节。1.1 XML映射文件结构剖析一个标准的Mybatis映射文件通常以mapper作为根元素其namespace属性对应着Mapper接口的全限定名。以用户管理模块为例基础结构如下?xml version1.0 encodingUTF-8? !DOCTYPE mapper PUBLIC -//mybatis.org//DTD Mapper 3.0//EN http://mybatis.org/dtd/mybatis-3-mapper.dtd mapper namespacecom.example.mapper.UserMapper !-- 这里定义SQL语句 -- /mapper注意XML文件头部的DOCTYPE声明不可省略它定义了XML文档的验证规则。在实际项目中建议配置IDE的XML校验功能可以实时发现标签使用错误。1.2 三种基础操作语法对比先来看三种操作的标准语法模板!-- 新增 -- insert idinsertUser parameterTypeUser INSERT INTO user(name, age) VALUES(#{name}, #{age}) /insert !-- 修改 -- update idupdateUser parameterTypeUser UPDATE user SET name#{name}, age#{age} WHERE id#{id} /update !-- 删除 -- delete iddeleteUser parameterTypelong DELETE FROM user WHERE id#{id} /delete这三种操作虽然语法相似但在实际使用中却有以下关键差异点返回值处理insert/update返回受影响行数(int)delete同样返回int但要注意逻辑删除场景参数传递简单参数可直接使用#{param}复杂对象使用属性点号访问(如#{user.name})动态SQL支持三种操作都支持 , 等动态标签但批量操作时insert有 特殊优化2. 新增操作深度解析2.1 基础插入实现最基本的插入操作如前面示例所示但实际开发中我们更关注以下几个进阶特性insert idinsertUser parameterTypeUser useGeneratedKeystrue keyPropertyid INSERT INTO user(name, age, create_time) VALUES(#{name}, #{age}, NOW()) /insert关键参数说明useGeneratedKeys启用自增主键回填keyProperty指定回填到参数的哪个属性keyColumn可选明确指定数据库主键列名踩坑记录MySQL的批量插入时useGeneratedKeys可能无法正确返回所有ID这时需要改用selectKey方式。2.2 批量插入优化方案当需要插入大量数据时单条插入性能极差。Mybatis提供了两种批量插入方案方案一foreach动态拼接insert idbatchInsert parameterTypelist INSERT INTO user(name, age) VALUES foreach collectionlist itemuser separator, (#{user.name}, #{user.age}) /foreach /insert方案二ExecutorType.BATCH模式// 需要配合特殊session使用 try(SqlSession session sqlSessionFactory.openSession(ExecutorType.BATCH)){ UserMapper mapper session.getMapper(UserMapper.class); for(User user : userList){ mapper.insertUser(user); } session.commit(); }性能对比小批量数据(100条内)foreach略快大批量数据BATCH模式内存占用更低超大批量(万级)建议分批次并行处理3. 修改操作实战技巧3.1 动态更新实现实际业务中经常遇到只更新非空字段的需求这时就需要动态SQLupdate idupdateSelective parameterTypeUser UPDATE user set if testname ! nullname#{name},/if if testage ! nullage#{age},/if /set WHERE id#{id} /update注意点set标签会自动去除末尾多余的逗号判断条件建议使用! null而非! 对于String类型可组合判断Param注解的妙用3.2 乐观锁实现高并发下的数据安全更新方案update idupdateWithVersion UPDATE user SET name#{name}, versionversion1 WHERE id#{id} AND version#{version} /updateJava层校验int affected userMapper.updateWithVersion(user); if(affected 0){ throw new OptimisticLockException(数据已被修改); }4. 删除操作安全实践4.1 物理删除与逻辑删除物理删除标准写法delete iddeleteById DELETE FROM user WHERE id#{id} /delete逻辑删除推荐方案添加is_deleted字段配置全局逻辑删除规则改写删除操作为更新update idlogicDelete UPDATE user SET is_deleted1 WHERE id#{id} /update4.2 批量删除安全限制为防止误操作批量删除应增加限制条件delete idbatchDelete DELETE FROM user WHERE id IN foreach collectionids itemid open( separator, close) #{id} /foreach AND create_time DATE_SUB(NOW(), INTERVAL 30 DAY) /delete安全建议必须添加业务条件限制生产环境建议实现备份机制重大删除操作应增加审批流程5. 高级特性与性能优化5.1 参数传递的黄金法则基本类型直接使用#{param}POJO对象#{propertyName}Map类型#{key}集合/数组配合foreach使用特别提醒避免在XML中直接使用map.变量名形式推荐先用if判断if testtext 变量名 !-- 业务逻辑 -- /if5.2 动态SQL实战技巧多条件查询示例select idsearchUsers SELECT * FROM user where if testname ! null AND name LIKE CONCAT(%,#{name},%) /if choose when testminAge ! null AND age #{minAge} /when when testmaxAge ! null AND age #{maxAge} /when otherwise AND status 1 /otherwise /choose /where /select批量更新妙招update idbatchUpdate UPDATE user trim prefixSET suffixOverrides, trim prefixnameCASE suffixEND, foreach collectionlist itemuser WHEN id#{user.id} THEN #{user.name} /foreach /trim trim prefixageCASE suffixEND, foreach collectionlist itemuser WHEN id#{user.id} THEN #{user.age} /foreach /trim /trim WHERE id IN foreach collectionlist itemuser open( separator, close) #{user.id} /foreach /update6. 常见问题排查指南6.1 XML配置不生效排查步骤检查namespace是否与Mapper接口全名一致确认方法名与xml中的id匹配验证mybatis.mapper-locations配置正确查看日志是否加载了该XML文件6.2 参数绑定异常处理典型错误There is no getter for property name in class java.lang.String解决方案使用Param注解void update(Param(id) Long id, Param(name) String name);参数为Map时确保key存在基本类型建议使用包装类6.3 事务不生效场景检查方法是否为public确认没有被同类方法调用this.xxx()验证Transactional注解配置正确查看连接池autocommit设置7. 性能监控与优化建议7.1 SQL执行监控配置日志实现mybatis.configuration.log-implorg.apache.ibatis.logging.stdout.StdOutImpl或使用第三方组件Intercepts({ Signature(type Executor.class, methodupdate, args{MappedStatement.class,Object.class}) }) public class SqlStatsInterceptor implements Interceptor { // 实现监控逻辑 }7.2 高频优化点批量操作使用rewriteBatchedStatementstrue合理设置fetchSize获取大量数据复杂查询考虑使用二级缓存避免N1查询问题最后分享一个实用技巧在开发环境中可以配置Mybatis输出格式化后的SQL方便调试settings setting namelogImpl valueSTDOUT_LOGGING/ setting nameuseActualParamName valuefalse/ /settings