使用 Hibernate 和 MySQL 需要知道的五件事

https://www.thoughts-on-java.org/5-things-you-need-to-know-when-using-hibernate-with-mysql/

作者：Thorben Janssen

译者：oopsguy.com

使用 JPA 和 Hibernate 的其一好处是它提供了数据库特定方言和功能抽象。因此，理论上，你可以实现一个应用程序，将其连接到一个受支持的数据库，并且它可以在不用更改任何代码的情况下运行。

Hibernate 真的很好。但老实说，你有没有想过自己的应用程序真的能与每个支持的数据库完美运行吗？

Hibernate 帮你做了很多重要的事。但是，如果你希望应用程序能够稳定运行，你仍需要知道要使用哪种数据库，并相应地调整配置和代码。

在之前的一篇文章中，我讨论了“使用 Hibernate 和 PostgreSQL 数据库需要知道的 6 件事情”。今天我想仔细讨论 MySQL 数据库。

1、映射：主键

处理和创建主键是很基础的内容，但也是应用程序最重要的一部分。

JPA 规范的 @GeneratedValue 注解允许你定义用于创建唯一主键值的策略。你可以选择 SEQUENCE、IDENTITY、TABLE 和 AUTO。

一般来说，我建议使用 SEQUENCE 策略，因为它允许 Hibernate 使用 JDBC 批处理和其他需要延迟执行 SQL INSERT 语句的优化策略。

然而，你不能将此策略与 MySQL 数据库一起使用。因为它需要一个数据库序列，恰好 MySQL 不支持此功能。

因此，你需要在 IDENTITY 和 TABLE 之间进行选择。考虑到 TABLE 策略的性能和可扩展性问题，答案显而易见。

如果你正在使用 MySQL 数据库，则应始终使用 GenerationType.IDENTITY。它使用了有自增特性（autoincremented ）的数据库列，这是最有效的可用方法。你可以通过使用 @GeneratedValue(strategy = GenerationType.IDENTITY) 注解主键属性来执行此操作。

@Entity
public class Author {

    @Id
    @GeneratedValue(strategy = GenerationType.IDENTITY)
    @Column(name = "id", updatable = false, nullable = false)
    private Long id;

    ...
}

2、映射：Hibernate 5 中 GenerationType.AUTO 问题

当你使用 GenerationType.AUTO 时，Hibernate 会根据 Hibernate 方言生成策略。如果你需要支持多个数据库，以下一种常用的方法。

@Entity
public class Author {

    @Id
    @GeneratedValue(strategy = GenerationType.AUTO)
    @Column(name = "id", updatable = false, nullable = false)
    private Long id;

    ...
}

在旧版本中，Hibernate 为 MySQL 数据库选择 GenerationType.IDENTITY。这是一个不错的选择。如之前所述，这是最有效的方法。

不幸的是此行为在 Hibernate 5 中发生了改变，现在使用的是 GenerationType.TABLE，它使用数据库表来生成主键。这种方法需要大量数据库查询和悲观锁来生成唯一值。

14:35:50,959 DEBUG [org.hibernate.SQL] - select next_val as id_val from hibernate_sequence for update
14:35:50,976 DEBUG [org.hibernate.SQL] - update hibernate_sequence set next_val= ? where next_val=?
14:35:51,097 DEBUG [org.hibernate.SQL] - insert into Author (firstName, lastName, version, id) values (?, ?, ?, ?)

你可以通过定义一个 @GenericGenerator 来避免这一点，以下代码告诉 Hibernate 使用本地策略生成主键值。

@Entity
public class Author {

    @Id
    @GeneratedValue(strategy = GenerationType.AUTO, generator = "native")
    @GenericGenerator(name = "native", strategy = "native")
    @Column(name = "id", updatable = false, nullable = false)
    private Long id;

    ...
}

然后，Hibernate 将使用 MySQL 自增数据库列来生成主键值。

14:41:34,255 DEBUG [org.hibernate.SQL] - insert into Author (firstName, lastName, version) values (?, ?, ?)
14:41:34,298 DEBUG [org.hibernate.id.IdentifierGeneratorHelper] - Natively generated identity: 1

3、映射：只读视图

使用 JPA 与 Hibernate，你可以以任何数据库表相同的方式来映射视图，只要遵循 Hibernate 的命名约定即可。你只需要实现一个使用了 @Entity 注解的类，该类的属性为你想要映射的列。

如果视图只读，你应该使用 @Immutable 注解告诉 Hibernate，它将忽略对该实体的所有更改。

@Entity
@Immutable
public class BookView {

  @Id
  @Column(name = "id", updatable = false, nullable = false)
  private Long id;

  @Column(name = "version")
  private int version;

  @Column
  private String title;

  @Column
  @Temporal(TemporalType.DATE)
  private Date publishingDate;

  @Column
  private String authors;

  ...

}

4、查询：MySQL特有的函数与数据类型

作为一个数据库，MySQL 使用一组自定义函数和数据类型来扩展 SQL 标准。其中一例子是 JSON 数据类型和 sysdate 函数。

JPA 并不支持这些，但由于有 Hibernate 的 MySQL 方言的支持，因此你可以使用它们。

Query q = em.createQuery("SELECT a, sysdate() FROM Author a ");
List<Object[]> results = q.getResultList();

如果你发现有 Hibernate MySQL 方言不支持的函数或者数据类型，则可以使用一个 AttributeConverter 将数据类型转换为受支持的数据类型，或使用 JPQL 函数来调用一个 JPQL 查询中的任意函数。

但请记住，当使用数据库特有函数或数据类型，你可以将应用程序绑定到特定的数据库。但如果需要支持不同的数据库，你将需要更改应用程序的这部分代码。

5、查询：存储过程

许多数据库管理员喜欢在数据库中使用存储过程来执行繁重的数据操作。 大多数情况下，这种方法比在 Java 代码中执行相同的操作要快得多。

但是，大多数 Java 开发人员并不想使用存储过程。当然，有一个说法是业务逻辑分布在多个系统上，这使得它更加难以测试和理解。另一个原因是在 JPA 2.1 之前，该规范并没有直接支持存储过程调用。你必须使用原生查询，总之感觉很复杂。

知道 JPA 2.1 引入了 StoredProcedureQuery 和 @NamedStoredProcedureQuery 才有所改变。

@NamedStoredProcedureQuery

@NamedStoredProcedureQuery 注解允许你定义存储过程调用，且可通过其名称在业务代码中引用它。以下代码片段展示了一个简单示例，它定义了存储过程 calculate 的调用，附带了输入参数 x 和 y 以及输出参数 sum。

@NamedStoredProcedureQuery(
    name = "calculate",
    procedureName = "calculate",
    parameters = {  @StoredProcedureParameter(mode = ParameterMode.IN, type = Double.class, name = "x"),
            @StoredProcedureParameter(mode = ParameterMode.IN, type = Double.class, name = "y"),
            @StoredProcedureParameter(mode = ParameterMode.OUT, type = Double.class, name = "sum") })

之后，你可以将 @NamedStoredProcedureQuery 的名称提供给 EntityManager 的 createNamedStoredProcedureQuery，以实例化一个新的 StoredProcedureQuery。

StoredProcedureQuery query = em.createNamedStoredProcedureQuery("calculate");
query.setParameter("x", 1.23d);
query.setParameter("y", 4d);
query.execute();
Double sum = (Double) query.getOutputParameterValue("sum");

在代码段中可以看到，你可以设置输入参数的值，设置方式与设置 JPQL 查询的绑定参数值一样。你只需使用输入参数的名称和值来调用 StoredProcedureQuery 的 setParameter 方法即可。

StoredProcedureQuery

存储过程调用的编程定义非常类似于前面示例中给出的基于注解的方法。你只需将要执行的存储过程的名称配合 EntityManager 来调用 createStoredProcedureQuery 即可。还有一个 StoredProcedureQuery 接口，你可以使用它来注册存储过程的输入参数和输出参数。

StoredProcedureQuery query = em.createStoredProcedureQuery("calculate");
query.registerStoredProcedureParameter("x", Double.class, ParameterMode.IN);
query.registerStoredProcedureParameter("y", Double.class, ParameterMode.IN);
query.registerStoredProcedureParameter("sum", Double.class, ParameterMode.OUT);

这就是定义存储过程调用全部需要做的事。之后，你可以与 @NamedStoredProcedureQuery 一样使用它。在执行存储过程调用之前，需要设置输入参数值。

query.setParameter("x", 1.23d);
query.setParameter("y", 4d);
query.execute();

6、总结

Hibernate 已经支持大多数 MySQL 特有的特性。但是，如果要创建一个轻便且性能良好的应用程序，你还需要记住以上事项。

特别是 Hibernate 5 中生成唯一主键值和 GenerationType.AUTO 行为的改变，可能会在将应用程序部署到生产环境时产生意外的可扩展性问题。