在
Hibernate 中，`
generator` 是用于配置实体类主键生成策略的关键部分。
Hibernate 提供了多种主键生成方式，可以通过 XML 映射文件或注解方式进行配置。以下是对 `
generator` 的配置和使用指南：
### 主键生成策略
Hibernate 支持多种主键生成策略，常用的包括：
- **`increment`**：由
Hibernate 以递增方式生成主键值，适用于单实例环境。
- **`
identity`**：由数据库自动增长字段生成主键，如 MySQL 的 `AUTO_INCREMENT` 或 PostgreSQL 的 `SERIAL`。
- **`sequence`**：使用数据库序列生成主键，适用于支持序列的数据库，如 Oracle。
- **`hilo`**：通过一个高/低位算法生成主键，减少对数据库的访问频率。
- **`native`**：根据数据库方言自动选择合适的主键生成策略（如 MySQL 使用 `
identity`，Oracle 使用 `sequence`）。
- **`uu
id`**：生成 128 位的 UU
ID 作为主键，适用于分布式系统。
- **`assigned`**：由应用程序手动分配主键值。
### 注解方式配置 `
generator`
在使用注解进行实体类映射时，可以通过 `@GeneratedValue` 注解指定主键生成策略。以下是一个使用 `@GeneratedValue` 注解的示例：
```java
import javax.persistence.*;
@Entity
@Table(name = "users")
public class User {
@
Id
@GeneratedValue(strategy = GenerationType.
IDENTITY)
private Long
id;
@Column(name = "name")
private String name;
// 构造方法、getter 和 setter
}
```
在这个示例中，`@GeneratedValue(strategy = GenerationType.
IDENTITY)` 表示使用数据库自增策略生成主键 [^1]。
### XML 映射文件配置 `
generator`
如果使用 XML 文件进行映射，可以在 `<
id>` 标签中通过 `<
generator>` 子标签指定主键生成策略。例如：
```xml
<
hibernate-mapping>
<class name="com.example.model.User" table="users">
<
id name="
id" column="
id">
<
generator class="
identity"/>
</
id>
<property name="name" column="name"/>
</class>
</
hibernate-mapping>
```
### 自定义主键生成器
Hibernate 还支持自定义主键生成器，通过实现 `
Identifier
Generator` 接口并重写 `generate` 方法。以下是一个简单的自定义主键生成器示例：
```java
import org.
hibernate.
id.
Identifier
Generator;
import org.
hibernate.engine.spi.SharedSessionContractImplementor;
import java.io.Serializable;
import java.util.UU
ID;
public class Custom
IdGenerator implements
Identifier
Generator {
@Overr
ide
public Serializable generate(SharedSessionContractImplementor session, Object object) {
return UU
ID.randomUU
ID().toString().replace("-", "").substring(0, 20);
}
}
```
然后在实体类中通过 `name` 和 `
generator` 属性引用该自定义生成器：
```java
import javax.persistence.*;
import org.
hibernate.annotations.Generic
Generator;
@Entity
@Table(name = "custom_users")
@Generic
Generator(name = "custom-
id", strategy = "com.example.
id.Custom
IdGenerator")
public class CustomUser {
@
Id
@GeneratedValue(
generator = "custom-
id")
private String
id;
@Column(name = "name")
private String name;
// 构造方法、getter 和 setter
}
```
### 配置注意事项
- 确保数据库支持所选的主键生成策略，例如使用 `sequence` 时需要数据库支持序列。
- 在集群或分布式环境中，避免使用 `increment`，因为其无法保证主键的唯一性。
- 使用 `uu
id` 时，主键长度较长，可能影响索引性能。
- `native` 是一种推荐的通用策略，可以根据数据库自动选择合适的生成方式 [^1]。
### 常见问题
1. **为什么主键生成失败？**
- 可能是由于数据库不支持所选的生成策略，例如在不支持序列的数据库上使用 `sequence`。
- 数据库表的主键字段未正确设置为自增字段（如使用 `
identity` 时）。
2. **如何在不依赖数据库的情况下生成主键？**
- 可以使用 `uu
id` 或 `assigned` 策略，确保主键生成不依赖于数据库。
3. **如何查看
Hibernate 生成的 SQL 语句？**
- 在 `
hibernate.cfg.xml` 中配置 `
hibernate.show_sql` 和 `
hibernate.format_sql` 为 `true`，可以查看生成的 SQL 语句 [^2]。
---
本文介绍了Hibernate中用于生成唯一标识符的各种内置策略，包括increment、identity、sequence等，并详细解释了每种策略的工作原理及适用场景。
扫一扫
193
被折叠的 条评论
为什么被折叠?
到【灌水乐园】发言
