AI 助理
备案控制台
开发者社区 数据库 文章 正文

一起来学Mybatis Plus(二) & 内置注解

2023-12-28 86
版权
版权声明：
本文内容由阿里云实名注册用户自发贡献，版权归原作者所有，阿里云开发者社区不拥有其著作权，亦不承担相应法律责任。具体规则请查看《 阿里云开发者社区用户服务协议》和 《阿里云开发者社区知识产权保护指引》。如果您发现本社区中有涉嫌抄袭的内容，填写 侵权投诉表单进行举报，一经查实，本社区将立刻删除涉嫌侵权内容。
简介： 一起来学Mybatis Plus(二) & 内置注解

前言

目前正在出一个Mybatis Plus系列教程, 篇幅会较多, 喜欢的话，给个关注❤️ ~

之前给大家讲过Mybatis教程，而MyBatis-Plus 是一个 MyBatis 的增强工具，在MyBatis的基础上只做增强不做改变，为简化开发、提高效率而生。大家需要注意的是它只是一个工具，大家需要掌握和重点学习的依然是Mybatis，在熟练掌握基础的情况下使用MyBatis-Plus会达到事半功倍的效果。

好了, 废话不多说直接开整吧~

注解

今天给大家讲下mybatis-plus的内置注解

@TableName

表名注解，标识实体类对应的表，作用于实体类

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

该注解有以下几个属性:

  • value: 表名，非必填,string类型，默认""
  • schema: schema，非必填,string类型，默认""
  • keepGlobalPrefix: 是否保持使用全局的 tablePrefix 的值（当全局 tablePrefix 生效时）,非必填，boolean类型，默认false
  • resultMap: xml 中 resultMap 的 id（用于满足特定类型的实体类对象绑定）,非必填,string类型，默认""
  • autoResultMap: 是否自动构建 resultMap 并使用（如果设置 resultMap 则不会进行 resultMap 的自动构建与注入）,非必填，boolean类型，默认false
  • excludeProperty: 需要排除的属性名,非必填，string[]类型,默认{}

keepGlobalPrefix中关于全局表前缀配置:

mybatis-plus:
  global-config:
    db-config:
      table-prefix: sys_

关于autoResultMap,MyBatisPlus会自动构建一个 resultMap 并注入到MyBatis里（一般用不上）,因为 MyBatisPlus 底层是 MyBatis，所以  MyBatisPlus 只是注入了常用 CRUD 到 MyBatis 里，注入之前是动态的（根据实体类字段以及注解变化而变化），但是注入之后是静态的（等于 XML 配置中的内容）。

@TableId

主键注解,作用于实体类主键字段，有以下几个属性:

  • value: 主键字段名,非必填,string类型，默认""
  • type: 指定主键类型,非必填，Enum类型, 默认 IdType.NONE

例如，这里指定主键为id且类型自增，表依然使用上节内容的user表:

@TableName("`user`")
public class User {
    @TableId(value = "id", type = IdType.AUTO)
    private Long id;
    private String name;
    private Integer age;
}

插入一条记录：

 userMapper.insert(User.builder().name("xiaohong6").age(26).build());

运行之后发现报错了Field 'id' doesn't have a default value; nested exception is java.sql.SQLException: Field 'id' doesn't have a default value,然后我们看报错的语句:

SQL: INSERT INTO `user`  ( name, age )  VALUES (  ?, ?  )

很显然，这里我们指定了主键为id类型为自增，但是我们的表结构没有指定默认值，所以报错了，所以这里我们需要修改一下表结构，指定自增类型，然后再运行,发现结果正常了

1731552348470849539, 'xiaohong6', 26

在上节中，主键id我们并没有设置自增，mybatis默认帮我们生成了一个id

IdType

  • 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)

@TableField

字段注解（非主键）

  • value: 数据库字段名,非必填,string类型，默认""
  • exist:是否为数据库表字段,非必填,boolean类型, 默认true
  • condition:字段 where 实体查询比较条件，有值设置则按设置的值为准，没有则为默认全局的 %s=#{%s},非必填,string类型，默认""
  • update:字段 update set 部分注入，例如：当在version字段上注解update="%s+1" 表示更新时会 set version=version+1 （该属性优先级高于 el 属性）,非必填,string类型，默认""
  • select:是否进行 select 查询,非必填,boolean类型, 默认true
  • keepGlobalFormat是否保持使用全局的 format 进行处理,非必填,boolean类型,默认false
  • numericScale: 指定小数点后保留的位数,非必填,string类型，默认""

比如我们指定condition,该值有以下几种情况,可以到SqlCondition类中查看:

public class SqlCondition {
    public static final String EQUAL = "%s=#{%s}";
    public static final String NOT_EQUAL = "%s<>#{%s}";
    public static final String LIKE = "%s LIKE CONCAT('%%',#{%s},'%%')";
    public static final String ORACLE_LIKE = "%s LIKE CONCAT(CONCAT('%%',#{%s}),'%%')";
    public static final String LIKE_LEFT = "%s LIKE CONCAT('%%',#{%s})";
    public static final String LIKE_RIGHT = "%s LIKE CONCAT(#{%s},'%%')";
    public SqlCondition() {
    }
}

以上是常用的模糊匹配,大家也可以自行配置，下面我们一起看一下查询的例子:

@Builder
@Data
@TableName("`user`")
public class User {
    @TableId(value = "id", type = IdType.AUTO)
    private Long id;
    @TableField(value = "name", condition = SqlCondition.LIKE)
    private String name;
    private Integer age;
}

上述实体类中，指定了字段name的查询类型为模糊匹配,下面一起测试一下

@Test
    public void selectByConditionName() {
        // select all
        QueryWrapper<User> queryWrapper = new QueryWrapper<>(User.builder().name("x").build());
        List<User> userList = userMapper.selectList(queryWrapper);
        userList.forEach(System.out::println);
    }

结果:

User(id=1731552348403740673, name=xiaohong2, age=22)
User(id=1731552348403740674, name=xiaohong3, age=23)
User(id=1731552348470849537, name=xiaohong4, age=24)
User(id=1731552348470849538, name=xiaohong5, age=25)
User(id=1731552348470849539, name=xiaohong6, age=26)

可以看到name字段是进行了模糊匹配的，这种注解查询方式也等效于接口方式:

    @Test
    public void selectByName() {
        // select all
        QueryWrapper queryWrapper = new QueryWrapper();
        queryWrapper.like("name", "x%");
        List<User> userList = userMapper.selectList(queryWrapper);
        userList.forEach(System.out::println);
        //User(id=1731552348403740673, name=xiaohong2, age=22)
        //User(id=1731552348403740674, name=xiaohong3, age=23)
        //User(id=1731552348470849537, name=xiaohong4, age=24)
        //User(id=1731552348470849538, name=xiaohong5, age=25)
        //User(id=1731552348470849539, name=xiaohong6, age=26)
    }

大家可以根据情况使用，推荐大家使用接口的方式，不要在类字段上作用太多的注解，也方便维护

@Version

乐观锁注解, 作用于字段上，主要解决并发更新问题，为了方便看问题，我们可以配置sql日志信息:

mybatis-plus:
  configuration:
    log-impl: org.apache.ibatis.logging.stdout.StdOutImpl

这样在执行的时候，控制台就会输出相关的sql信息,接着需要修改一下表结构，添加字段version,接着我们在实体类中添加@Version注解:

@TableName("`user`")
public class User {
    @TableId(value = "id", type = IdType.AUTO)
    private Long id;
    @TableField(value = "name", condition = SqlCondition.LIKE)
    private String name;
    private Integer age;
    /**
     * 乐观锁
     */
    @Version
    private Integer version;
}

接着配置MybatisPlus的乐观锁插件,我们修改下配置类MyBatisPlusConfig:

@EnableTransactionManagement
@Configuration
@MapperScan("com.springboot.all.mybatisplus.mapper")
public class MyBatisPlusConfig {
    // 注册乐观锁插件
    @Bean
    public MybatisPlusInterceptor mybatisPlusInterceptor() {
        MybatisPlusInterceptor interceptor = new MybatisPlusInterceptor();
        interceptor.addInnerInterceptor(new OptimisticLockerInnerInterceptor());
        return interceptor;
    }
}

紧接着我们编写测试代码:

@Test
public void updateTest() {
    userMapper.updateById(User.builder().id(1731552348470849539L).name("hhhhh").version(1).build());
    userMapper.updateById(User.builder().id(1731552348470849539L).name("hhhhh").version(1).build());
}

上述代码更新了ID为1731552348470849539的name值，并指定了版本为1,这里的version一定要指定不能传空，否则会更新不成功，我们添加的version字段初始值设置为1代表第一个版本值，下面执行下

SqlSession [org.apache.ibatis.session.defaults.DefaultSqlSession@28f9fedd] was not registered for synchronization because synchronization is not active
JDBC Connection [com.alibaba.druid.proxy.jdbc.ConnectionProxyImpl@6fbc1bb] will not be managed by Spring
==>  Preparing: UPDATE `user` SET name=?, version=? WHERE id=? AND version=?
==> Parameters: hhhhh(String), 2(Integer), 1731552348470849539(Long), 1(Integer)
<==    Updates: 1
Closing non transactional SqlSession [org.apache.ibatis.session.defaults.DefaultSqlSession@28f9fedd]
Creating a new SqlSession
SqlSession [org.apache.ibatis.session.defaults.DefaultSqlSession@619f2afc] was not registered for synchronization because synchronization is not active
JDBC Connection [com.alibaba.druid.proxy.jdbc.ConnectionProxyImpl@6fbc1bb] will not be managed by Spring
==>  Preparing: UPDATE `user` SET name=?, version=? WHERE id=? AND version=?
==> Parameters: hhhhh(String), 2(Integer), 1731552348470849539(Long), 1(Integer)
<==    Updates: 0
Closing non transactional SqlSession [org.apache.ibatis.session.defaults.DefaultSqlSession@619f2afc]

从日志情况来看，只有第一条更新成功了，通过sql语句可以看到version也参与了查询条件，然后我们看下表中的记录更新情况

1731552348470849539 hhhhh 26  2

可以看到version值自动变为2了，所以第二条更新失败

@OrderBy

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

  • asc:是否倒序查询， 非必填,boolean类型, 默认true
  • sort:数字越小越靠前, 非必填short类型，默认值Short.MAX_VALUE

这个很简单，大家可以自己尝试一下

结束语

上述是常用的几个注解，下节给大家讲解代码生成器

本着把自己知道的都告诉大家，如果本文对有所帮助，点赞+关注鼓励一下呗~

文章标签：
Java
mybatis
数据库连接
SQL
数据库
关键词：
MyBatis注解
MyBatis plus
程序员皮卡秋(公众号程序员皮卡秋)
目录
相关文章
蓝染-惣右介
|
5天前
|
SQL Java 数据库连接
【MyBatisPlus·最新教程】包含多个改造案例，常用注解、条件构造器、代码生成、静态工具、类型处理器、分页插件、自动填充字段
MyBatis-Plus是一个MyBatis的增强工具，在 MyBatis 的基础上只做增强不做改变，为简化开发、提高效率而生。本文讲解了最新版MP的使用教程，包含多个改造案例，常用注解、条件构造器、代码生成、静态工具、类型处理器、分页插件、自动填充字段等核心功能。
蓝染-惣右介
67 1
【MyBatisPlus·最新教程】包含多个改造案例，常用注解、条件构造器、代码生成、静态工具、类型处理器、分页插件、自动填充字段
刘大猫.
|
15天前
|
SQL 缓存 Java
MyBatis如何关闭一级缓存(分注解和xml两种方式)
MyBatis如何关闭一级缓存(分注解和xml两种方式)
刘大猫.
43 5
刘大猫.
|
15天前
|
Java 数据库连接 mybatis
Mybatis使用注解方式实现批量更新、批量新增
Mybatis使用注解方式实现批量更新、批量新增
刘大猫.
36 3
蓝易云
|
22天前
|
SQL 存储 数据库
深入理解@TableField注解的使用-MybatisPlus教程
`@TableField`注解在MyBatis-Plus中是一个非常灵活和强大的工具，能够帮助开发者精细控制实体类与数据库表字段之间的映射关系。通过合理使用 `@TableField`注解，可以实现字段名称映射、自动填充、条件查询以及自定义类型处理等高级功能。这些功能在实际开发中，可以显著提高代码的可读性和维护性。如果需要进一步优化和管理你的MyBatis-Plus应用程
蓝易云
97 3
刘大猫.
|
20天前
|
Java 数据库连接 mybatis
Mybatis使用注解方式实现批量更新、批量新增
Mybatis使用注解方式实现批量更新、批量新增
刘大猫.
39 1
杀死一只知更鸟debug
|
2月前
|
SQL XML Java
mybatis复习02,简单的增删改查，@Param注解多个参数，resultType与resultMap的区别，#{}预编译参数
文章介绍了MyBatis的简单增删改查操作，包括创建数据表、实体类、配置文件、Mapper接口及其XML文件，并解释了`#{}`预编译参数和`@Param`注解的使用。同时，还涵盖了resultType与resultMap的区别，并提供了完整的代码实例和测试用例。
杀死一只知更鸟debug
53 1
mybatis复习02,简单的增删改查，@Param注解多个参数，resultType与resultMap的区别，#{}预编译参数
程序员小海绵
|
2月前
|
Java 数据库连接 数据格式
【Java笔记+踩坑】Spring基础2——IOC,DI注解开发、整合Mybatis,Junit
IOC/DI配置管理DruidDataSource和properties、核心容器的创建、获取bean的方式、spring注解开发、注解开发管理第三方bean、Spring整合Mybatis和Junit
程序员小海绵
49 0
【Java笔记+踩坑】Spring基础2——IOC,DI注解开发、整合Mybatis,Junit
热爱技术的小郑
|
3月前
|
SQL Java 数据库
5、Mybatis-Plus 常用注解
这篇文章详细介绍了Mybatis-Plus中常用的注解，包括解决实体类与数据库表名不一致、字段不匹配的问题，主键生成策略的配置，以及逻辑删除的实现方法。
热爱技术的小郑
34 0
5、Mybatis-Plus 常用注解
香吧香
|
4月前
|
Java 数据库连接 测试技术
mybatis plus 获取新增实体的主键
mybatis plus 获取新增实体的主键
香吧香
143 8
香吧香
|
4月前
|
Java 数据库连接 数据库
mybatis plus 更新值为null的字段
mybatis plus 更新值为null的字段
香吧香
57 7