MyBatis-Plus 实体类注解的实现示例

更新时间：2024年09月25日 08:38:31 作者：Flying_Fish_Xuan

MyBatis-Plus作为MyBatis的增强版,提供了一系列实用的注解,如@TableName、@TableId、@TableField等,旨在简化数据库和Java实体类之间的映射及CRUD操作,通过这些注解,开发者可以轻松实现表映射、字段映射、逻辑删除、自动填充和乐观锁等功能

MyBatis-Plus 是 MyBatis 的增强版，旨在简化开发者的 CRUD 操作。它通过丰富的特性和注解，简化了数据库与 Java 实体类之间的映射。MyBatis-Plus 提供了一系列的实体类注解，帮助开发者更轻松地映射数据库表、字段，并处理常见的数据操作需求。

1. MyBatis-Plus 实体类注解概览

MyBatis-Plus 提供了一系列注解，用于简化实体类与数据库表之间的映射。常用注解包括：

@TableName：指定实体类对应的数据库表名。
@TableId：指定主键字段及其生成策略。
@TableField：指定非主键字段的映射信息。
@TableLogic：用于实现逻辑删除功能。
@TableField(fill = ...)：用于指定字段的自动填充策略。
@Version：用于实现乐观锁。

2. @TableName 注解

@TableName 用于指定实体类对应的数据库表名。如果实体类名与表名不一致，则需要使用该注解进行映射。

使用示例

import com.baomidou.mybatisplus.annotation.TableName;

@TableName("user")
public class User {
    private Integer id;
    private String username;
    private String email;
}

在上面的示例中，实体类 User 映射到数据库表 user。如果实体类名和数据库表名相同，则可以省略此注解。

常用属性

value：指定表名。
schema：指定数据库架构名称（可选）。
autoResultMap：是否启用自动结果映射，默认 false。

@TableName(value = "user", schema = "mydb", autoResultMap = true)

3. @TableId 注解

@TableId 用于指定表的主键列，并可以设置主键的生成策略。常见的生成策略有自动递增（AUTO）、手动分配（INPUT）等。

使用示例

import com.baomidou.mybatisplus.annotation.TableId;
import com.baomidou.mybatisplus.annotation.IdType;

public class User {
    @TableId(type = IdType.AUTO)
    private Integer id;
    private String username;
    private String email;
}

在上面的示例中，id 字段被标记为主键，并且使用了自动递增策略。

常用属性

value：指定主键字段名称。
type：指定主键生成策略，常见的生成策略有：
- IdType.AUTO：数据库自动生成（通常是自增主键）。
- IdType.INPUT：手动输入主键。
- IdType.ASSIGN_ID：MyBatis-Plus 自动生成 ID（分布式 ID 算法）。
- IdType.UUID：生成 UUID 作为主键。

@TableId(value = "user_id", type = IdType.ASSIGN_ID)

4. @TableField 注解

@TableField 用于标注非主键字段的映射。该注解可以配置数据库表中的列名、是否进行自动填充、是否是查询字段等。

使用示例

import com.baomidou.mybatisplus.annotation.TableField;

public class User {
    @TableId(type = IdType.AUTO)
    private Integer id;

    @TableField("user_name")
    private String username;

    @TableField(exist = false)
    private String tempField;  // 非数据库字段
}

在上面的示例中，username 字段对应数据库表中的 user_name 列，而 tempField 是一个实体类的临时字段，不会映射到数据库。

常用属性

value：指定数据库列名。
exist：是否是数据库表中的字段，默认 true。如果设置为 false，表示该字段不参与数据库映射。
fill：指定字段的自动填充策略，支持 INSERT、UPDATE、INSERT_UPDATE。

@TableField(value = "created_at", fill = FieldFill.INSERT)

5. @TableLogic 注解

@TableLogic 用于实现逻辑删除功能。逻辑删除是在数据表中不真正删除记录，而是通过标记某个字段（如 is_deleted）来表示数据是否被删除。

使用示例

import com.baomidou.mybatisplus.annotation.TableLogic;

public class User {
    @TableId(type = IdType.AUTO)
    private Integer id;

    private String username;

    @TableLogic
    private Integer isDeleted;
}

在上面的示例中，isDeleted 字段用于标记该记录是否被删除。当使用 MyBatis-Plus 提供的删除方法（如 deleteById）时，实际上会更新 isDeleted 字段的值，而不是物理删除该记录。

默认行为

未删除：isDeleted = 0（默认为 0）。
已删除：isDeleted = 1（默认为 1）。

自定义逻辑删除值

如果逻辑删除标记的值不为 0 和 1，可以通过全局配置进行自定义。

mybatis-plus:
  global-config:
    db-config:
      logic-not-delete-value: 0  # 未删除的值
      logic-delete-value: 2      # 已删除的值

6. 自动填充字段 @TableField(fill = ...)

自动填充是指在插入或更新数据时，MyBatis-Plus 自动为某些字段赋值。常见的场景包括：创建时间、更新时间、操作人等。

使用示例

import com.baomidou.mybatisplus.annotation.FieldFill;
import com.baomidou.mybatisplus.annotation.TableField;

import java.time.LocalDateTime;

public class User {
    @TableId(type = IdType.AUTO)
    private Integer id;

    @TableField(fill = FieldFill.INSERT)
    private LocalDateTime createdAt;

    @TableField(fill = FieldFill.INSERT_UPDATE)
    private LocalDateTime updatedAt;
}

在上面的示例中：

createdAt 字段会在插入时自动填充。
updatedAt 字段会在插入和更新时自动填充。

自动填充实现步骤

定义实体类字段并加上 @TableField(fill = ...) 注解。
创建自动填充处理器：实现 MetaObjectHandler 接口，重写 insertFill 和 updateFill 方法。

import com.baomidou.mybatisplus.core.handlers.MetaObjectHandler;
import org.apache.ibatis.reflection.MetaObject;
import org.springframework.stereotype.Component;

import java.time.LocalDateTime;

@Component
public class MyMetaObjectHandler implements MetaObjectHandler {

    @Override
    public void insertFill(MetaObject metaObject) {
        this.strictInsertFill(metaObject, "createdAt", LocalDateTime::now, LocalDateTime.class);
        this.strictInsertFill(metaObject, "updatedAt", LocalDateTime::now, LocalDateTime.class);
    }

    @Override
    public void updateFill(MetaObject metaObject) {
        this.strictUpdateFill(metaObject, "updatedAt", LocalDateTime::now, LocalDateTime.class);
    }
}

7. @Version 乐观锁注解

@Version 注解用于实现乐观锁。在并发环境下，乐观锁可以防止数据的“脏写”，通过版本号（version）字段来保证数据的一致性。

使用示例

import com.baomidou.mybatisplus.annotation.Version;

public class User {
    @TableId(type = IdType.AUTO)
    private Integer id;

    private String username;

    @Version
    private Integer version;  // 乐观锁版本号
}

当更新 User 表时，MyBatis-Plus 会检查 version 字段。如果版本号匹配，则进行更新，同时版本号自增；否则更新失败，防止数据冲突。

8. 综合示例

以下是一个使用了多种 MyBatis-Plus 注解的完整实体类示例：

import com.baomidou.mybatisplus.annotation.*;
import lombok.Data;
import java.time.LocalDateTime;

@Data
@TableName("user")
public class User {

    @TableId(type = IdType.AUTO)
    private Integer id;

    @TableField("user_name")
    private String username;

    private String email;

    @TableLogic
    private Integer isDeleted;

    @TableField(fill = FieldFill.INSERT)
    private LocalDateTime createdAt;

    @TableField(fill = FieldFill.INSERT_UPDATE)
    private LocalDateTime updatedAt;

   

 @Version
    private Integer version;
}

username 字段映射到数据库的 user_name 列。
isDeleted 实现逻辑删除。
createdAt 和 updatedAt 实现自动填充。
version 用于实现乐观锁。

9. 总结

MyBatis-Plus 提供的实体类注解极大简化了数据库字段与 Java 类之间的映射和管理，开发者可以通过简单的注解来完成复杂的数据库操作。

@TableName：用于映射实体类与数据库表。
@TableId 和 @TableField：用于映射主键和普通字段。
@TableLogic：实现逻辑删除。
@Version：用于乐观锁控制并发修改。
自动填充：通过 @TableField(fill = ...) 配合自定义 MetaObjectHandler 实现创建时间、更新时间等自动填充。

到此这篇关于MyBatis-Plus 实体类注解的实现示例的文章就介绍到这了,更多相关MyBatis-Plus 实体类注解内容请搜索脚本之家以前的文章或继续浏览下面的相关文章希望大家以后多多支持脚本之家！

您可能感兴趣的文章:

Java fastjson解析json字符串实现过程解析
这篇文章主要介绍了Java fastjson解析json字符串实现过程解析,文中通过示例代码介绍的非常详细，对大家的学习或者工作具有一定的参考学习价值,需要的朋友可以参考下
2020-10-10
Java实现前缀树详解
Java实现前缀树（Trie树）是一种树形数据结构，用于字符串的存储和查找，适用于大量字符串的快速匹配。通过将字符串拆分为字符序列，依次构建树形结构，将每个字符串的字符依次存储在树的节点上，实现高效的字符串匹配
2023-04-04
JAVA 并发容器的一些易出错点你知道吗
今天给大家带来的文章是Java并发编程的相关知识,文中对java同步容器与并发容器做了非常详细的介绍及代码示例,需要的朋友可以参考下
2021-09-09
SpringBoot集成WebSocket遇到的问题及解决
这篇文章主要介绍了SpringBoot集成WebSocket遇到的问题及解决方案，具有很好的参考价值，希望对大家有所帮助。
2023-07-07
Springboot源码 AbstractAdvisorAutoProxyCreator解析
这篇文章主要介绍了Springboot源码 AbstractAdvisorAutoProxyCreator解析,文中通过示例代码介绍的非常详细，对大家的学习或者工作具有一定的参考学习价值,需要的朋友可以参考下
2019-08-08
亲手教你SpringBoot中的多数据源集成问题
本文主要是介绍基于springboot的多数据源切换，轻量级的一种集成方案，对于小型的应用可以采用这种方案，我之前在项目中用到是因为简单，便于扩展以及优化，对SpringBoot多数据源集成问题感兴趣的朋友一起看看吧
2022-03-03
Spring Security配置保姆级教程
Spring Security是一个功能强大且可高度自定义的身份验证和访问控制框架。它是保护基于Spring的应用程序的事实上的标准。Spring Security是一个专注于为Java应用程序提供身份验证和授权的框架
2023-02-02
Java Swing JTextField文本框的代码示例
这篇文章主要介绍了Java Swing JTextField文本框的代码示例，文中通过示例代码介绍的非常详细，对大家的学习或者工作具有一定的参考学习价值，需要的朋友们下面随着小编来一起学习学习吧
2019-12-12
Java Optional介绍和用法示例解析
Java 的 Optional是 Java 8 引入的一个容器类,旨在更优雅地处理可能为 null的值,避免显式的 null检查和空指针异常（NullPointerException）,这篇文章给大家介绍Java Optional介绍和用法示例解析,感兴趣的朋友一起看看吧
2025-04-04
maven项目中<scope>provided</scope>的作用及说明
这篇文章主要介绍了maven项目中<scope>provided</scope>的作用及说明,具有很好的参考价值,希望对大家有所帮助,如有错误或未考虑完全的地方,望不吝赐教
2023-12-12