MyBatis-Plus 快速入门-注解

本文将介绍 MybatisPlus 注解包相关类详解

@TableName

• 描述：表名注解，标识实体类对应的表
• 使用位置：实体类

@TableName("sys_user")
public class User {
    private Long id;
    private String name;
    private Integer age;
    private String email;
}

关于 ​autoResultMap​ 的说明：

MP 会自动构建一个 ​​resultMap​并注入到 ​MyBatis ​里（一般用不上），请注意以下内容：

因为 MP 底层是 MyBatis，所以 MP 只是帮您注入了常用 CRUD 到 MyBatis 里，注入之前是动态的（根据您的 Entity 字段以及注解变化而变化），但是注入之后是静态的（等于 XML 配置中的内容）。

而对于 ​typeHandler属性，MyBatis 只支持写在 2 个地方:

1. 定义在 ​resultMap ​里，作用于查询结果的封装
2. 定义在 ​insert ​和 ​update ​语句的 ​#{property}​ 中的 ​property ​后面（例：​#{property,typehandler=xxx.xxx.xxx}​），并且只作用于当前 设置值

除了以上两种直接指定 ​typeHandler ​的形式，MyBatis 有一个全局扫描自定义 ​typeHandler ​包的配置，原理是根据您的 ​property ​类型去找其对应的 ​typeHandler ​并使用。

@TableId

• 描述：主键注解
• 使用位置：实体类主键字段

@TableName("sys_user")
public class User {
    @TableId
    private Long id;
    private String name;
    private Integer age;
    private String email;
}

IdType

@TableField

描述：字段注解（非主键）

@TableName("sys_user")
public class User {
    @TableId
    private Long id;
    @TableField("nickname")
    private String name;
    private Integer age;
    private String email;
}

关于​jdbcType​和​typeHandler​以及​numericScale​的说明:

​numericScale​只生效于 update 的 sql. ​jdbcType​和​typeHandler​如果不配合​@TableName#autoResultMap = true​一起使用,也只生效于 update 的 sql. 对于​typeHandler​如果你的字段类型和 set 进去的类型为​equals​关系,则只需要让你的​typeHandler​让
Mybatis 加载到即可,不需要使用注解

FieldStrategy

FieldFill

@Version

• 描述：乐观锁注解、标记 ​@Verison​ 在字段上

@EnumValue

• 描述：普通枚举类注解(注解在枚举字段上)

@TableLogic

• 描述：表字段逻辑处理注解（逻辑删除）

@KeySequence

• 描述：序列主键策略 ​oracle
​
• 属性：​value​、​resultMap​

@OrderBy

• 描述：内置 SQL 默认指定排序，优先级低于 wrapper 条件查询