自学内容网 自学内容网
自学内容网 > 正文

深入理解 `@TableId(type = IdType.AUTO)`：使用方法及其与其他主键生成策略的区别

🕗 发布于 2024-11-17 23:00 java  spring boot  

在MyBatis-Plus（简称MP）中，@TableId 注解是用来标注实体类中主键的字段的，而 type = IdType.AUTO 是一个常见的配置选项，它指定了主键的生成策略。在实际开发中，如何配置主键生成策略对数据库的性能和稳定性有着重要影响。本文将深入探讨 @TableId(type = IdType.AUTO) 的使用方法，以及它与其他主键生成策略（如 IdType.INPUT、IdType.UUID 等）的区别和适用场景。

一、什么是 @TableId 注解？

在 MyBatis-Plus 中，@TableId 注解用于指定实体类中的主键字段。通常情况下，主键字段需要具有唯一性，而且数据库会根据该字段的值来区分每一条记录。

@TableId(value = "id", type = IdType.AUTO)
private Long id;

在上面的代码中，@TableId 被用来标注 id 字段是表的主键。value 属性指定了数据库表中的字段名，而 type 属性指定了主键的生成策略。

二、@TableId(type = IdType.AUTO) 的使用方法

IdType.AUTO 表示主键由数据库自动生成，通常与自增长字段一起使用。这意味着，主键的值在插入时由数据库自增，而不是由程序代码显式指定。

常见的数据库支持：
  • MySQL：AUTO_INCREMENT
  • PostgreSQL：SERIAL
  • Oracle：SEQUENCE

代码示例

假设我们有一个实体类 User，我们希望在插入数据时由数据库自动生成主键：

@Data
@TableName("user")
public class User {
    @TableId(type = IdType.AUTO) // 自动生成主键
    private Long id;

    private String name;
    private Integer age;
}

对于上述实体类，当我们执行 userMapper.insert(user) 时，id 字段会被数据库自动填充（通常是自增长）。

三、与其他主键生成策略的区别

MyBatis-Plus 提供了多种主键生成策略，具体配置如下：

1. IdType.AUTO（数据库自增）

@TableId(type = IdType.AUTO) 配置表示主键由数据库自动生成。适用于支持自动增量字段的数据库，如 MySQL 的 AUTO_INCREMENT、PostgreSQL 的 SERIAL 等。

优点：

  • 简单易用，数据库自动处理主键。
  • 避免了手动生成主键的麻烦。

缺点：

  • 主键生成依赖数据库，某些数据库可能存在性能瓶颈（如高并发时自增主键可能引发争用问题）。
  • 对于分布式系统来说，可能需要额外的处理（如数据库分库分表时，可能会导致主键冲突或性能问题）。
2. IdType.INPUT（手动输入）

@TableId(type = IdType.INPUT) 配置表示主键由开发者手动输入，程序员需要在插入数据时显式指定主键值。

@TableId(type = IdType.INPUT)
private Long id;

优点：

  • 适合主键需要特定值的情况（如UUID或业务逻辑生成的主键）。
  • 适用于需要从外部系统传入主键的场景。

缺点：

  • 需要手动生成主键，增加了开发的复杂性和错误的风险。
  • 可能需要额外的处理来确保主键的唯一性，尤其是在分布式系统中。
3. IdType.UUID（UUID）

@TableId(type = IdType.UUID) 配置表示主键由 UUID（通用唯一识别码）生成。这是一个跨平台、全局唯一的标识符。

@TableId(type = IdType.UUID)
private String id;

优点：

  • 主键具有全局唯一性，适合分布式系统。
  • 不依赖数据库的自增长特性，避免了数据库主键生成的限制。

缺点：

  • UUID 是一串字符串，长度较长，可能导致数据库存储的空间浪费。
  • 在性能上可能不如自增主键，尤其是在大量数据插入时，UUID 生成和查询速度相对较慢。
4. IdType.ID_WORKER（雪花算法）

@TableId(type = IdType.ID_WORKER) 配置表示主键使用雪花算法生成。雪花算法是一种分布式ID生成算法，确保在分布式环境下每个服务生成的主键唯一且递增。

@TableId(type = IdType.ID_WORKER)
private Long id;

优点：

  • 生成的ID具有唯一性和有序性，适合分布式环境。
  • 雪花算法生成的ID为数字类型，性能较好。

缺点：

  • 雪花算法需要额外的配置和分布式协调。
  • 如果服务之间的时钟不一致，可能会产生主键重复的问题。
5. IdType.ASSIGN_UUID（分布式 UUID）

@TableId(type = IdType.ASSIGN_UUID) 配置表示主键为分布式的 UUID，通常与分布式系统搭配使用，确保不同节点生成的主键不会冲突。

@TableId(type = IdType.ASSIGN_UUID)
private String id;

优点：

  • 保证跨系统、跨机器的唯一性。
  • 在分布式系统中尤其有用。

缺点：

  • UUID 长度较长，可能会影响查询性能。
  • 不适合大量数据插入时的高效生成主键。

四、如何选择合适的主键生成策略？

选择合适的主键生成策略，通常取决于以下几个因素：

  • 单体应用或分布式系统：

    • 如果是单体应用，IdType.AUTO（数据库自增）通常是最简单、最有效的选择。
    • 如果是分布式系统，IdType.UUID 或 IdType.ID_WORKER 更适合，因为它们能确保不同节点生成的主键唯一。

  • 性能需求：

    • IdType.AUTO 在性能上可能会受到数据库锁机制的影响，在高并发场景下可能不如雪花算法（IdType.ID_WORKER）或 UUID（IdType.UUID）性能好。

  • 主键的唯一性：

    • 如果需要确保全局唯一，尤其是在分布式系统中，UUID 和雪花算法是更好的选择。

  • 业务需求：

    • 如果主键需要根据业务规则自定义，使用 IdType.INPUT 是最合适的。

五、总结

  • @TableId(type = IdType.AUTO) 适用于需要数据库自增的场景，简化了开发，但在分布式系统中可能带来一些挑战。
  • MyBatis-Plus 提供了多种主键生成策略（如 UUID、ID_WORKER、INPUT），开发者可以根据具体的应用场景来选择合适的策略。
  • 在选择主键生成策略时，需考虑系统的分布式架构、性能需求以及主键唯一性等多方面因素。

原文地址：https://blog.csdn.net/weixin_39973810/article/details/143793135

免责声明：本站文章内容转载自网络资源，如本站内容侵犯了原著者的合法权益，可联系本站删除。更多内容请关注自学内容网（zxcms.com）！

相关文章

自学内容网
Copyright © 2015-2024