本文将介绍 MybatisPlus 注解包相关类详解
@TableName("sys_user")
public class User {
private Long id;
private String name;
private Integer age;
private String email;
}
属性 | 类型 | 必须指定 | 默认值 | 描述 |
values |
String | 否 | "" | 表名 |
schema |
String | 否 | "" | schema |
keepGlobalPrefix |
boolean | 否 | false | 是否保持使用全局的 tablePrefix 的值(当全局 tablePrefix 生效时) |
resultMap |
String | 否 | "" | xml 中 resultMap 的 id(用于满足特定类型的实体类对象绑定) |
autoResultMap |
boolean | 否 | false | 是否自动构建 resultMap 并使用(如果设置 resultMap 则不会进行 resultMap 的自动构建与注入) |
excludeProperty |
String[] | 否 | {} | 需要排除的属性名 |
关于 autoResultMap
的说明:
MP 会自动构建一个 resultMap
并注入到 MyBatis 里(一般用不上),请注意以下内容:
因为 MP 底层是 MyBatis,所以 MP 只是帮您注入了常用 CRUD 到 MyBatis 里,注入之前是动态的(根据您的 Entity 字段以及注解变化而变化),但是注入之后是静态的(等于 XML 配置中的内容)。
而对于 typeHandler
属性,MyBatis 只支持写在 2 个地方:
resultMap
里,作用于查询结果的封装insert
和 update
语句的 #{property}
中的 property
后面(例:#{property,typehandler=xxx.xxx.xxx}
),并且只作用于当前 设置值除了以上两种直接指定 typeHandler
的形式,MyBatis 有一个全局扫描自定义 typeHandler
包的配置,原理是根据您的 property
类型去找其对应的 typeHandler
并使用。
@TableName("sys_user")
public class User {
@TableId
private Long id;
private String name;
private Integer age;
private String email;
}
属性 | 类型 | 必须指定 | 默认值 | 描述 |
value | String | 否 | "" | 主键字段名 |
type | Enum | 否 | IdType.NONE | 指定主键类型 |
值 | 描述 |
AUTO |
数据库 ID 自增 |
NONE |
无状态,该类型为未设置主键类型(注解里等于跟随全局,全局里约等于 INPUT) |
INPUT |
insert 前自行 set 主键值 |
ASSIGN_ID |
分配 ID(主键类型为 Number(Long 和 Integer)或 String)(since 3.3.0),使用接口IdentifierGenerator 的方法nextId (默认实现类为DefaultIdentifierGenerator 雪花算法) |
ASSIGN_UUID |
分配 UUID,主键类型为 String(since 3.3.0),使用接口IdentifierGenerator 的方法nextUUID (默认 default 方法) |
ID_WORKER |
分布式全局唯一 ID 长整型类型(please use ASSIGN_ID ) |
UUID |
32 位 UUID 字符串(please use ASSIGN_UUID ) |
ID_WORKER_STR |
分布式全局唯一 ID 字符串类型(please use ASSIGN_ID ) |
描述:字段注解(非主键)
@TableName("sys_user")
public class User {
@TableId
private Long id;
@TableField("nickname")
private String name;
private Integer age;
private String email;
}
属性 | 类型 | 必须指定 | 默认值 | 描述 |
value |
String | 否 | "" | 数据库字段名 |
exist |
boolean | 否 | true | 是否为数据库表字段 |
ondition |
String | 否 | "" | 字段where 实体查询比较条件,有值设置则按设置的值为准,没有则为默认全局的%s=#{%s} |
update |
String | 否 | "" | 字段 update set 部分注入,例如:当在version字段上注解update="%s+1" 表示更新时会 set version=version+1 (该属性优先级高于 el 属性) |
insertStrategy |
Enum | 否 | FieldStrategy.DEFAULT | 举例:NOT_NULL
insert into table_a(<if test="columnProperty != null">column</if>) values (<if test="columnProperty != null">#{columnProperty}</if>) |
updataStrategy |
Enum | 否 | FieldStrategy.DEFAULT | 举例:IGNORED
update table_a set column=#{columnProperty} |
whereStrategy |
Enum | 否 | FieldStrategy.DEFAULT | 举例:NOT_EMPTY
where <if test="columnProperty != null and columnProperty!=""">column=#{columnProperty}</if> |
fill |
Enum | 否 | FieldFill.DEFAULT | 字段自动填充策略 |
select |
boolean | 否 | true | 是否进行select查询 |
keepGlobalFormat |
boolean | 否 | false | 是否保持使用全局的format进行处理 |
jabcType |
jabcType | 否 | JdbcType.UNDEFINED | JDBC类型(该默认值不代表会按照该值生效) |
typeHandler |
Class<?extends TypeHandler> | 否 | UnknownTypeHandler.class | 类型处理器(该默认值不代表会按照该值生效) |
numericScale |
String | 否 | "" | 指定小数点后保留的位数 |
关于jdbcType
和typeHandler
以及numericScale
的说明:
numericScale
只生效于 update 的 sql. jdbcType
和typeHandler
如果不配合@TableName#autoResultMap = true
一起使用,也只生效于 update 的 sql. 对于typeHandler
如果你的字段类型和 set 进去的类型为equals
关系,则只需要让你的typeHandler
让
Mybatis 加载到即可,不需要使用注解
值 | 描述 |
IGNORED |
忽略判断 |
NOT_NULL |
非 NULL 判断
|
NOT_EMPTY |
非空判断(只对字符串类型字段,其他类型字段依然为非 NULL 判断)
|
DEFAULT
|
追随全局配置
|
值 | 描述 |
DEFAULT |
默认不处理 |
INSERT
|
插入时填充字段 |
UPDATE
|
更新时填充字段 |
INSERT_UPDATE
|
插入和更新时填充字段 |
@Verison
在字段上属性 | 类型 | 必须指定 | 默认值 | 描述 |
value |
String | 否 | "" | 逻辑未删除值 |
delval |
String | 否 | "" | 逻辑删除值 |
oracle
value
、resultMap
属性 | 类型 | 必须指定 | 默认值 | 描述 |
value |
String | 否 | "" | 序列名 |
clazz |
Class | 否 | Long.class | id 的类型, 可以指定 String.class,这样返回的 Sequence 值是字符串"1" |
属性 | 类型 | 必须指定 | 默认值 | 描述 |
isDesc | boolean | 否 | true | 是否倒序查询 |
sort | short | 否 | Short.MAX_VALUE | 数字越小越靠前 |
MyBatis-Plus 条件构造器-AbstractWrapperle(R column, Object val)le(boolean condition, R column, Object val)小于等于=例:...
MyBatis-Plus 条件构造器-AbstractWrapperorderBy(boolean condition, boolean isAsc, R... columns)排序:ORDERBY字段,...例:...
Spring教程 -Spring Bean属性我们可以通过几种方式将数据填充到Spring配置XML中定义的Java Bean中。以下部分显示将值注入定义的 ...
Spring教程 - 弹簧依赖检查Spring可以做依赖检查以确保已设置或注入所需的属性。Spring可以做依赖检查以确保已设置或注入所需的...
JSP教程 -JSP发送电子邮件要使用JSP发送电子邮件,请在CLASSPATH中安装JavaMail API和Java Activation Framework(JAF)。发送电子...
sql:setDataSource标签用来配置数据源或者将数据源信息存储在某作用域的变量中,用来作为其它JSTL数据库操作的数据源。语法格式s...