主键生成

H2 支持常见的 IDENTITY 自增列，也支持 sequence。dbVisitor 在 H2 下主要使用 JDBC generated keys 或插入前读取 sequence 两种方式处理主键。

说明

通用配置见主键生成与回填。

主键策略

策略	本数据源的用法
手工赋值	插入前由应用提供主键。
自增	由数据库生成数值主键。
UUID	字符主键使用 UUID32 或 UUID36。
序列	插入前取得序列值。
自定义	使用自定义生成器，在插入前或后处理主键。

使用 IDENTITY

CREATE TABLE user_info (
    id   BIGINT GENERATED BY DEFAULT AS IDENTITY PRIMARY KEY,
    name VARCHAR(64),
    age  INT
)

构造器 API

实体映射中使用 KeyType.Auto：

H2 IDENTITY 映射

@Table("user_info")
public class UserInfo {
    @Column(value = "id", primary = true, keyType = KeyType.Auto)
    private Long id;

    @Column("name")
    private String name;

    @Column("age")
    private Integer age;
}

新增后属性自动回填

UserInfo user = new UserInfo();
user.setName("mali");
user.setAge(18);

LambdaTemplate lambda = ...;
lambda.insert(UserInfo.class)
      .applyEntity(user)
      .executeSumResult();

Long id = user.getId();

方法注解

@Insert(
    value = "INSERT INTO user_info (name, age) VALUES (#{name}, #{age})",
    useGeneratedKeys = true,
    keyProperty = "id",
    keyColumn = "id"
)
int insertUser(UserInfo user);

Mapper 文件

H2 generated keys

<insert id="insertUser"
        useGeneratedKeys="true"
        keyProperty="id"
        keyColumn="id">
    INSERT INTO user_info (name, age)
    VALUES (#{name}, #{age})
</insert>

注意

需要回填主键时，多个实体逐条插入、分别回填。需要一起提交或回滚时，见多条写入一致性。

使用序列

下面使用普通主键列和序列，与上面的自增列示例独立：

CREATE TABLE user_info (
    id BIGINT PRIMARY KEY,
    name VARCHAR(64),
    age INTEGER
);
CREATE SEQUENCE user_info_seq START WITH 1 INCREMENT BY 1;

构造器 API

import net.hasor.dbvisitor.mapping.Column;
import net.hasor.dbvisitor.mapping.KeySeq;
import net.hasor.dbvisitor.mapping.KeyType;
import net.hasor.dbvisitor.mapping.Table;

@Table("user_info")
public class UserInfo {
    @Column(primary = true, keyType = KeyType.Sequence)
    @KeySeq("user_info_seq")
    private Long id;
    private String name;
    private Integer age;

    // 省略 getter 和 setter
}

UserInfo user = new UserInfo();
user.setName("mali");

lambda.insert(UserInfo.class)
        .applyEntity(user)
        .executeSumResult();

Long id = user.getId();

每次插入前自动获取序列值，赋给 id 后再写入记录。

方法注解

@SelectKeySql(
    value = "VALUES NEXT VALUE FOR user_info_seq",
    keyProperty = "id",
    keyColumn = "id",
    order = Order.Before
)
@Insert("INSERT INTO user_info (id, name, age) VALUES (#{id}, #{name}, #{age})")
int insertUser(UserInfo user);

Mapper 文件

<insert id="insertUser">
    <selectKey keyProperty="id" keyColumn="id" order="BEFORE">
        values next value for user_info_seq
    </selectKey>
    INSERT INTO user_info (id, name, age)
    VALUES (#{id}, #{name}, #{age})
</insert>