MyBatis+MyBatis-Plus 全套 CRUD 数据库实战

MyBatisMyBatis-Plus 全套 CRUD 数据库实战写 SQL 写到怀疑人生MyBatis-Plus 了解一下——连 XML 都能省掉大半CRUD 写得像点菜一样简单。一、MyBatis vs MyBatis-Plus一对亲兄弟很多新手以为 MyBatis-Plus 是 MyBatis 的替代品其实它是增强工具包在 MyBatis 基础上做了大幅强化。两者的关系可以这么理解对比维度MyBatisMyBatis-PlusSQL 编写XML / 注解手写 SQL内置 CRUD零 SQL 完成基本操作分页手动写 LIMIT COUNT分页插件一行搞定条件查询手写 WHERE 拼接QueryWrapper 链式调用代码生成无AutoGenerator 一键生成主键策略手动处理TableId 注解雪花算法/自增按需选一句话总结MyBatis-Plus 只做增强不做改变引入它不会影响你原有的 MyBatis 代码丝滑升级。二、数据库准备先搞定 MySQL。假设你已有 MySQL 环境执行以下建库建表 SQLCREATEDATABASEIFNOTEXISTSdemo_dbDEFAULTCHARSETutf8mb4;USEdemo_db;CREATETABLEuser(idBIGINTNOTNULLAUTO_INCREMENTCOMMENT主键,usernameVARCHAR(50)NOTNULLCOMMENT用户名,ageINTDEFAULTNULLCOMMENT年龄,emailVARCHAR(100)DEFAULTNULLCOMMENT邮箱,create_timeDATETIMEDEFAULTCURRENT_TIMESTAMPCOMMENT创建时间,PRIMARYKEY(id))ENGINEInnoDBDEFAULTCHARSETutf8mb4COMMENT用户表;三、SpringBoot 整合 MyBatis-Plus3.1 pom.xml 依赖dependencygroupIdcom.baomidou/groupIdartifactIdmybatis-plus-boot-starter/artifactIdversion3.5.5/version/dependencydependencygroupIdcom.mysql/groupIdartifactIdmysql-connector-j/artifactIdscoperuntime/scope/dependency3.2 application.yml 配置spring:datasource:url:jdbc:mysql://localhost:3306/demo_db?useUnicodetruecharacterEncodingutf8mb4username:rootpassword:123456driver-class-name:com.mysql.cj.jdbc.Drivermybatis-plus:configuration:log-impl:org.apache.ibatis.logging.stdout.StdOutImpl# 控制台打印SQLmapper-locations:classpath:mapper/*.xml# XML映射文件路径(没用XML可省略)四、实体类注解字段映射三板斧DataTableName(user)// 映射表名类名和表名一致可省略publicclassUser{TableId(typeIdType.AUTO)// 主键策略AUTO数据库自增, ASSIGN_ID雪花算法privateLongid;TableField(username)// 字段名映射驼峰自动转下划线时可省略privateStringusername;privateIntegerage;privateStringemail;TableField(fillFieldFill.INSERT)privateLocalDateTimecreateTime;}三个核心注解TableName指定表名类名转下划线和表名一致时不用写TableId主键注解IdType.AUTO 是数据库自增ASSIGN_ID 是雪花算法分布式推荐TableField字段映射existfalse 排除非数据库字段五、BaseMapper 内置 CRUD——零 SQL 数据库操作只需定义一个 Mapper 接口继承BaseMapperT所有基础 CRUD 开箱即用MapperpublicinterfaceUserMapperextendsBaseMapperUser{// 继承BaseMapper后以下方法全部免费获得不需要写一行代码}内置方法速览// 插入userMapper.insert(user);// 根据ID删除userMapper.deleteById(1L);// 根据ID更新userMapper.updateById(user);// 根据ID查询UseruseruserMapper.selectById(1L);// 查询全部ListUserlistuserMapper.selectList(null);// 批量查询ListUserusersuserMapper.selectBatchIds(Arrays.asList(1L,2L,3L));拿deleteById举例MyBatis-Plus 自动生成DELETE FROM user WHERE id ?你一行 SQL 都不用写。六、条件构造器QueryWrapper 链式查询杀器当查询条件复杂起来光靠selectList(null)可不够这时条件构造器登场// QueryWrapper 写法直接写数据库字段名QueryWrapperUserquerynewQueryWrapper();query.eq(age,25)// age 25.like(email,qq.com)// email LIKE %qq.com%.ge(create_time,2024-01-01).orderByDesc(id);ListUserlistuserMapper.selectList(query);更推荐LambdaQueryWrapper用 lambda 表达式避免字段名字符串硬编码LambdaQueryWrapperUserlambdanewLambdaQueryWrapper();lambda.eq(User::getAge,25).like(User::getEmail,qq.com).in(User::getId,Arrays.asList(1L,2L,3L)).orderByDesc(User::getCreateTime);ListUserlistuserMapper.selectList(lambda);// 自动生成SQLSELECT * FROM user WHERE age ? AND email LIKE ? AND id IN (?,?,?) ORDER BY create_time DESC常用条件函数eq等于 /ne不等于gt大于 /ge大于等于 /lt小于 /le小于等于like模糊查询 /notLike不匹配in包含 /notIn不包含isNull为空 /isNotNull不为空orderByAsc升序 /orderByDesc降序between区间查询七、分页插件配置MyBatis-Plus 的分页功能需先注册插件ConfigurationpublicclassMybatisPlusConfig{BeanpublicMybatisPlusInterceptormybatisPlusInterceptor(){MybatisPlusInterceptorinterceptornewMybatisPlusInterceptor();interceptor.addInnerInterceptor(newPaginationInnerInterceptor(DbType.MYSQL));returninterceptor;}}使用分页只需两行PageUserpagenewPage(1,10);// 第1页每页10条PageUserresultuserMapper.selectPage(page,null);System.out.println(总记录数result.getTotal());System.out.println(总页数result.getPages());System.out.println(当前页数据result.getRecords());输出的 SQL 会自动拼接LIMIT 0,10和SELECT COUNT(*)免去手写分页的繁琐。八、完整 CRUD 实战Controller Service Mapper下面给出标准的 Controller-Service-Mapper 三层写法// Mapper 层MapperpublicinterfaceUserMapperextendsBaseMapperUser{}// Service 接口publicinterfaceUserServiceextendsIServiceUser{}// Service 实现ServicepublicclassUserServiceImplextendsServiceImplUserMapper,UserimplementsUserService{}// Controller 层RestControllerRequestMapping(/user)publicclassUserController{AutowiredprivateUserServiceuserService;PostMappingpublicResultadd(RequestBodyUseruser){userService.save(user);// IService 提供的 save 方法returnResult.ok();}DeleteMapping(/{id})publicResultdelete(PathVariableLongid){userService.removeById(id);returnResult.ok();}PutMappingpublicResultupdate(RequestBodyUseruser){userService.updateById(user);returnResult.ok();}GetMapping(/{id})publicResultgetById(PathVariableLongid){returnResult.ok(userService.getById(id));}GetMapping(/page)publicResultpage(RequestParamintcurrent,RequestParamintsize){PageUserpagenewPage(current,size);LambdaQueryWrapperUserwrappernewLambdaQueryWrapper();wrapper.orderByDesc(User::getCreateTime);returnResult.ok(userService.page(page,wrapper));}}是的Service 层也继承了IService和ServiceImpl同样获得一套现成的 CRUD连 Service 都不用写逻辑——典型的偷懒利器。九、常见问题排查问题一字段映射不生效检查mybatis-plus.configuration.map-underscore-to-camel-case是否设为 true默认就是 true确认实体字段和数据库字段的驼峰-下划线对应关系。问题二分页不生效最容易踩的坑——分页插件没注册。检查是否有Configuration类注入MybatisPlusInterceptor并添加PaginationInnerInterceptor。没有这个 BeanMyBatis-Plus 不做任何分页干预Page对象就是个摆设。问题三updateById 只更新了部分字段MyBatis-Plus 默认的更新策略是NOT_NULL即实体字段为 null 时不更新。如果想把某个字段更新为 null需要在字段上加TableField(updateStrategy FieldStrategy.IGNORED)。MyBatis-Plus 的价值在于把重复劳动自动化让你聚焦核心业务逻辑。从 BaseMapper 到 IService从条件构造器到分页插件每一步都在践行开发者体验优先。当然也别因为太方便就忘了学原生 SQL——调试时看不懂控制台打印的 SQL等于白搭。