自动生成键
本章介绍如何使用内置机制自动生成 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;
...
}