跳到主要内容
版本:6.1.1

自动生成键

Doubao 中英对照 Auto generating keys

本章介绍如何使用内置机制自动生成 couchbase 文档键。支持两种自动生成策略。

备注

couchbase 支持的最大键长度为 250 字节。

配置​

要自动生成的键应使用 @GeneratedValue 注解。默认策略为 USE_ATTRIBUTES。键的前缀和后缀可以作为实体本身的一部分提供;这些值不会被持久化,仅用于键生成。前缀和后缀使用 order 值排序。默认顺序为 0,多个未指定顺序的前缀会覆盖前一个。如果 id 的值已经存在,则跳过自动生成。拼接所用的分隔符可以通过 delimiter 提供,默认分隔符为 .。

示例 1. GeneratedValue 注解

@Document
public class User {
@Id @GeneratedValue(strategy = USE_ATTRIBUTES, delimiter = ".")
private String id;
@IdPrefix(order=0)
private String userPrefix;
@IdSuffix(order=0)
private String userSuffix;
...
}

使用属性生成键​

使用文档属性的组合来生成键是一种常见做法。使用属性生成键会将所有标注了 IdAttribute 的属性值按与前缀和后缀类似的顺序拼接起来。

示例 2. IdAttribute 注解

@Document
public class User {
@Id @GeneratedValue(strategy = USE_ATTRIBUTES)
private String id;
@IdAttribute
private String userid;
...
}

使用 uuid 生成键​

这种自动生成方式使用 UUID 随机生成器来生成文档键,占用 16 字节的键空间。该机制仅推荐用于测试脚手架。

示例 3. 唯一键生成注解

@Document
public class User {
@Id @GeneratedValue(strategy = UNIQUE)
private String id;
...
}