{"content":{"title":"MyBatis-Plus 效能提升秘籍：掌握这些注解，事半功倍！","body":"MyBatis-Plus是一个功能强大的MyBatis扩展插件，它提供了许多便捷的注解，让我们在开发过程中能够更加高效地完成数据库操作，本文将带你一一了解这些注解，并通过实例来展示它们的魅力。\r\n\r\n## 一、@Tablename注解\r\n\r\n这个注解用于指定实体类对应的数据库表名。如果你的表名和实体类名不一致，就需要用到它：\r\n\r\n```\r\n@TableName(\"user_info\")\r\npublic class UserInfo {\r\n    // 类的属性和方法\r\n}\r\n```\r\n\r\n\r\n\r\n在上述代码中，即使实体类名为UserInfo，但通过@TableName注解，我们知道它对应数据库中的\"user_info\"表。\r\n\r\n## 二、@Tableld注解\r\n\r\n每个数据库表都有主键，@TableId注解用于标识实体类中的主键属性。通常与@TableName配合使用，确保主键映射正确。\r\n\r\n```\r\nAUTO(0),\r\nNONE(1),\r\nINPUT(2),\r\nASSIGN_ID(3),\r\nASSIGN_UUID(4),\r\n/** @deprecated */\r\n@Deprecated\r\nID_WORKER(3),\r\n/** @deprecated */\r\n@Deprecated\r\nID_WORKER_STR(3),\r\n/** @deprecated */\r\n@Deprecated\r\nUUID(4);\r\n```\r\n\r\n\r\n\r\n![Description](https://ydcqoss.ydcode.cn/ydyx/bbs/1709105285-Og2k44.png)\r\n\r\n* INPUT 如果开发者没有手动赋值，则数据库通过自增的方式给主键赋值，如果开发者手动赋值，则存入该值。\r\n* AUTO 默认就是数据库自增，开发者无需赋值。\r\n* ASSIGN_ID MP 自动赋值，雪花算法。\r\n* ASSIGN_UUID 主键的数据类型必须是 String，自动生成 UUID 进行赋值。\r\n\r\n```\r\n// 自己赋值\r\n    //@TableId(type = IdType.INPUT)\r\n    // 默认使用的雪花算法，长度比较长，所以使用Long类型，不用自己赋值\r\n    @TableId\r\n    private Long id;\r\n```\r\n\r\n\r\n\r\n**测试**\r\n\r\n```\r\n@Test\r\n    void save(){\r\n        // 由于id加的有注解，这里就不用赋值了\r\n        Student student = new Student();\r\n        student.setName(\"天明\");\r\n        student.setAge(18);\r\n        mapper.insert(student);\r\n}\r\n```\r\n\r\n\r\n\r\n![Description](https://ydcqoss.ydcode.cn/ydyx/bbs/1709105364-4733V2.png)\r\n\r\n### 雪花算法\r\n\r\n雪花算法是由Twitter公布的分布式主键生成算法，它能够保证不同表的主键的不重复性，以及相同表的主键的有序性。\r\n\r\n**核心思想：**\r\n\r\n* 长度共64bit（一个long型）。\r\n* 首先是一个符号位，1bit标识，由于long基本类型在Java中是带符号的，最高位是符号位，正数是0，负数是1，所以id一般是正数，最高位是0。\r\n* 41bit时间截(毫秒级)，存储的是时间截的差值（当前时间截 - 开始时间截)，结果约等于69.73年。\r\n* 10bit作为机器的ID（5个bit是数据中心，5个bit的机器ID，可以部署在1024个节点）。\r\n* 12bit作为毫秒内的流水号（意味着每个节点在每毫秒可以产生 4096 个 ID）。\r\n\r\n![Description](https://ydcqoss.ydcode.cn/ydyx/bbs/1709105413-9Tc48J.png)\r\n\r\n**优点：** 整体上按照时间自增排序，并且整个分布式系统内不会产生ID碰撞，并且效率较高。\r\n\r\n## 三、@TableField注解\r\n\r\n当你的实体类属性名与数据库字段名不一致时，@TableField注解可以帮助你建立二者之间的映射关系。\r\n\r\n* 映射非主键字段，value 映射字段名；\r\n* exist 表示是否为数据库字段 false，如果实体类中的成员变量在数据库中没有对应的字段，则可以使用 exist，VO、DTO；\r\n* select 表示是否查询该字段；\r\n* fill 表示是否自动填充，将对象存入数据库的时候，由 MyBatis Plus 自动给某些字段赋值，create_time、update_time。\r\n\r\n![Description](https://ydcqoss.ydcode.cn/ydyx/bbs/1709105492-v1c857.png)\r\n\r\n### 自动填充\r\n\r\n1）给表添加 create_time、update_time 字段。\r\n\r\n![Description](https://ydcqoss.ydcode.cn/ydyx/bbs/1709105517-5WkT9C.png)\r\n\r\n2）实体类中添加成员变量。\r\n\r\n```\r\npackage com.md.entity;\r\n\r\nimport com.baomidou.mybatisplus.annotation.*;\r\nimport com.md.enums.StatusEnum;\r\nimport lombok.Data;\r\nimport java.util.Date;\r\n\r\n@Data\r\n@TableName(value = \"student\")\r\npublic class Student {\r\n    @TableId\r\n    private Long id;\r\n\r\n    // 当该字段名称与数据库名字不一致\r\n    @TableField(value = \"name\")\r\n    private String name;\r\n\r\n    // 不查询该字段\r\n    @TableField(select = false)\r\n    private Integer age;\r\n\r\n    // 当数据库中没有该字段，就忽略\r\n    @TableField(exist = false)\r\n    private String gender;\r\n\r\n    // 第一次添加填充\r\n    @TableField(fill = FieldFill.INSERT)\r\n    private Date createTime;\r\n\r\n    // 第一次添加的时候填充，但之后每次更新也会进行填充\r\n    @TableField(fill = FieldFill.INSERT_UPDATE)\r\n    private Date updateTime;\r\n\r\n}\r\n```\r\n\r\n\r\n\r\n3）创建自动填充处理器。\r\n\r\n注意：不要忘记添加 @Component 注解。\r\n\r\n```\r\npackage com.md.handler;\r\n\r\nimport com.baomidou.mybatisplus.core.handlers.MetaObjectHandler;\r\nimport org.apache.ibatis.reflection.MetaObject;\r\nimport org.springframework.stereotype.Component;\r\n\r\nimport java.util.Date;\r\n\r\n/**\r\n * @author md\r\n * @Desc 对实体类中使用的自动填充注解进行编写\r\n * @date 2020/10/26 17:29\r\n */\r\n// 加入注解才能生效\r\n@Component\r\npublic class MyMetaObjectHandler implements MetaObjectHandler {\r\n\r\n    @Override\r\n    public void insertFill(MetaObject metaObject) {\r\n        this.setFieldValByName(\"createTime\", new Date(), metaObject);\r\n        this.setFieldValByName(\"updateTime\", new Date(), metaObject);\r\n    }\r\n\r\n    @Override\r\n    public void updateFill(MetaObject metaObject) {\r\n        this.setFieldValByName(\"updateTime\", new Date(), metaObject);\r\n    }\r\n}\r\n```\r\n\r\n\r\n\r\n4）测试\r\n\r\n```\r\n@Test\r\n    void save(){\r\n        // 由于id加的有注解，这里就不用赋值了\r\n        Student student = new Student();\r\n        student.setName(\"韩立\");\r\n        student.setAge(11);\r\n        // 时间自动填充\r\n        mapper.insert(student);\r\n}\r\n```\r\n\r\n\r\n\r\n![Description](https://ydcqoss.ydcode.cn/ydyx/bbs/1709105597-Uy3g4d.png)\r\n\r\n5）更新\r\n\r\n当该字段发生变化的时候时间会自动更新。\r\n\r\n```\r\n@Test\r\n    void update(){\r\n        Student student = mapper.selectById(1001);\r\n        student.setName(\"韩信\");\r\n        mapper.updateById(student);\r\n}\r\n```\r\n\r\n\r\n\r\n![Description](https://ydcqoss.ydcode.cn/ydyx/bbs/1709105626-Hjd66C.png)\r\n\r\n## 四、@TableLogic注解\r\n\r\n在很多应用中，数据并不是真的被删除，而是标记为已删除状态。@TableLogic注解用于标识逻辑删除字段，通常配合逻辑删除功能使用。\r\n\r\n### 1、逻辑删除\r\n\r\n**物理删除：** 真实删除，将对应数据从数据库中删除，之后查询不到此条被删除的数据。\r\n\r\n**逻辑删除：** 假删除，将对应数据中代表是否被删除字段的状态修改为“被删除状态”，之后在数据库中仍旧能看到此条数据记录。\r\n\r\n**使用场景：** 可以进行数据恢复。\r\n\r\n### 2、实现逻辑删除\r\n\r\n**step1：** 数据库中创建逻辑删除状态列。\\\r\n![Description](https://ydcqoss.ydcode.cn/ydyx/bbs/1709105789-lze79J.png)\r\n\r\n**step2：** 实体类中添加逻辑删除属性。\r\n\r\n```\r\n@TableLogic\r\n@TableField(value = \"is_deleted\")\r\nprivate Integer deleted;\r\n```\r\n\r\n\r\n\r\n### 3、测试\r\n\r\n**测试删除：** 删除功能被转变为更新功能。\r\n\r\n```\r\n-- 实际执行的SQL\r\nupdate user set is_deleted=1 where id = 1 and is_deleted=0\r\n```\r\n\r\n\r\n\r\n**测试查询：** 被逻辑删除的数据默认不会被查询。\r\n\r\n```\r\n-- 实际执行的SQL\r\nselect id,name,is_deleted from user where is_deleted=0\r\n```\r\n\r\n> 在这里给大家分享一下【云端源想】学习平台，无论你是初学者还是有经验的开发者，这里都有你需要的一切。包含课程视频、知识库、微实战、云实验室、一对一咨询等等，现在功能全部是免费的，[点击这里，立即开始你的学习之旅！](https://www.ydcode.cn/?sourceId=761)\r\n\r\n## 五、@Version注解\r\n\r\n乐观锁是一种并发控制策略，@Version注解用于标识版本号字段，确保数据的一致性。\r\n\r\n### 乐观锁\r\n\r\n![Description](https://ydcqoss.ydcode.cn/ydyx/bbs/1709105924-XtIg8L.png)\\\r\n标记乐观锁，通过 version 字段来保证数据的安全性，当修改数据的时候，会以 version 作为条件，当条件成立的时候才会修改成功。\r\n\r\nversion = 2\r\n\r\n* 线程1：update … set version = 2 where version = 1\r\n* 线程2：update … set version = 2 where version = 1\r\n\r\n1.数据库表添加 version 字段，默认值为 1。\r\n\r\n2.实体类添加 version 成员变量，并且添加 @Version。\r\n\r\n```\r\npackage com.md.entity;\r\n\r\nimport com.baomidou.mybatisplus.annotation.*;\r\nimport com.md.enums.StatusEnum;\r\nimport lombok.Data;\r\nimport java.util.Date;\r\n\r\n@Data\r\n@TableName(value = \"student\")\r\npublic class Student {\r\n    @TableId\r\n    private Long id;\r\n    @TableField(value = \"name\")\r\n    private String name;\r\n    @TableField(select = false)\r\n    private Integer age;\r\n    @TableField(exist = false)\r\n    private String gender;\r\n    @TableField(fill = FieldFill.INSERT)\r\n    private Date createTime;\r\n    @TableField(fill = FieldFill.INSERT_UPDATE)\r\n    private Date updateTime;\r\n    \r\n    @Version\r\n    private Integer version; //版本号\r\n  \r\n}\r\n```\r\n\r\n\r\n\r\n3.注册配置类\r\n\r\n在 MybatisPlusConfig 中注册 Bean。\r\n\r\n```\r\npackage com.md.config;\r\n\r\nimport com.baomidou.mybatisplus.extension.plugins.OptimisticLockerInterceptor;\r\nimport com.baomidou.mybatisplus.extension.plugins.PaginationInterceptor;\r\nimport org.springframework.context.annotation.Bean;\r\nimport org.springframework.context.annotation.Configuration;\r\n\r\n/**\r\n * @author md\r\n * @Desc\r\n * @date 2020/10/26 20:42\r\n */\r\n@Configuration\r\npublic class MyBatisPlusConfig {\r\n    /**\r\n    * 乐观锁\r\n    */\r\n    @Bean\r\n    public OptimisticLockerInterceptor optimisticLockerInterceptor(){\r\n        return new OptimisticLockerInterceptor();\r\n    }\r\n}\r\n```\r\n\r\n\r\n## 六、@EnumValue注解\r\n\r\nmp框架对枚举进行处理的一个注解。\r\n\r\n**使用场景：** 创建枚举类，在需要存储数据库的属性上添加@EnumValue注解。\r\n\r\n```\r\npublic enum SexEnum {\r\n\r\n MAN(1, \"男\"),\r\n WOMAN(2, \"女\");\r\n\r\n @EnumValue\r\n private Integer key;\r\n}\r\n```\r\n\r\n\r\n\r\nMyBatis-Plus的注解是开发者的好帮手，它们简化了映射配置，提高了开发效率。希望以上的介绍能帮助新手朋友们快速理解和运用这些常用注解，让你们在MyBatis-Plus的世界里游刃有余！记得实践是最好的学习方式，快去动手试试吧！"},"author":{"user":"https://learnblockchain.cn/people/17279","address":null},"history":null,"timestamp":1709193280,"version":1}