相关信息

返回首页

Hibernate 6.5.0.CR1

发布者    |       Hibernate ORM 发布

6.5 版本带来了许多新特性，以及许多改进和修复。

Java 时间处理

Java 时间对象现在可以直接通过 JDBC 驱动程序进行封装，这符合 JDBC 4.2 的定义。在之前的版本中，Hibernate 会使用 java.sql.Date、java.sql.Time 或 java.sql.Timestamp 引用作为中间形式来处理 Java 时间对象。

与此相关的另一个行为变化是对时区的处理。 OffsetDateTime、OffsetTime 和 ZonedDateTime 都编码了显式时区信息。使用直接封装，Hibernate 简单地传递原始值。在传统行为中，由于 java.sql 变体不编码时区信息，Hibernate 通常需要在转换到这些中间形式时特别处理时区。

对于 6.5 版本，此行为默认禁用。要启用，

hibernate.type.prefer_java_type_jdbc_types=true

请参阅设置 Javadoc 以获取更多详细信息。

可配置的查询缓存布局

在 Hibernate ORM 6.0 中，查询缓存布局从实体和集合的“浅层”表示更改为“完整”表示。这样做是为了支持从查询缓存数据重新加载联接获取的数据，而不需要访问数据库。在查询缓存中存储完整数据会导致更高的内存消耗，这反过来可能会因为更高的垃圾收集活动而降低应用程序的性能。

6.5 添加了配置查询结果在查询缓存中存储格式的功能，可以是

  • 通过全局设置 hibernate.cache.query_cache_layout

  • 通过实体或集合的 @QueryCacheLayout 注解

全局 hibernate.cache.query_cache_layout 设置默认值为 AUTO，这将根据实体/集合是否可缓存自动选择 SHALLOW 或 FULL。

希望保留Hibernate ORM 6.0使用的FULL缓存布局的应用程序应配置全局属性hibernate.cache.query_cache_layout=FULL。希望使用Hibernate ORM 5及更低版本使用的缓存布局的应用程序应配置全局属性hibernate.cache.query_cache_layout=SHALLOW。

即使在SHALLOW缓存布局下，通过连接抓取暗示的关联急切性也将被尊重，并且关联将被急切初始化。因此，选择不同的缓存布局时，行为没有变化。

使用SHALLOW时，如果关联数据不存在于二级缓存中，Hibernate可能需要击中数据库来具体化关联数据。

允许Java记录作为@IdClass

现在可以将Java记录用作@IdClass

record PK(Integer key1, Integer key2) {}

@Entity
@IdClass(PK.class)
class AnEntity {
        @Id Integer key1;
        @Id Integer key2;
        ...
}

支持自动启用的过滤器

现在可以为每个Session和StatelessSession自动启用过滤器

@FilterDef(
    name="active-filter",
    condition="status = true",
    autoEnabled=true
)
@Filter(name="active-filter")
@Entity
class DeletableEntity {
    ...
}

可以与动态解决条件参数的能力结合使用，例如。

class TenantIdResolver implements Supplier<String> {
    @Override
    public String get() {
        return SomeContext.determineTenantId();
    }
}

@FilterDef(
    name="tenancy-filter",
    condition="tenant_id = :tenantId",
    autoEnabled=true,
    parameter = @ParamDef(
        name="tenantId",
        type=String.class,
        resolver=TenantIdResolver.class
    )
)
@Filter(name="tenancy-filter")
@Entity
class SensitiveData {
        ...
}

连接突变查询

现在可以使用连接来执行UPDATE和DELETE查询，例如。

delete from Person p where p.association.someAttr = 1

使用自定义Generator手动分配标识符

现在可以使用自定义的Generator使用手动分配的标识符值，这归功于新的allowAssignedIdentifiers()方法。

class MyIdGenerator implements Generator {
    ...
    @Override public boolean allowAssignedIdentifiers() {
        return true;
    }
}

@IdGeneratorType(MyIdGenerator.class)
@Target({METHOD, FIELD})
@Retention(RUNTIME)
@interface MyGeneratedId {
}

@Entity
class Book {
  @Id @MyGeneratedId
  Integer id;
  ...
}

Book book = new Book(1,...)
session.persist(book);

SelectionQuery.getResultCount()

选择查询现在具有报告最终结果中将有结果的数量的能力。

这触发了对数据库的查询。 
Query query = session.createQuery("from Person");
int results = query.getResultCount();

基于键的分页

作为孵化功能，6.5通过SelectionQuery和生成查询方法提供了对基于键的分页（有时称为“键集”分页）的支持。

请参阅KeyedPage和KeyedResultList的Javadoc以获取更多信息。

插入查询的ON CONFLICT子句

现在HQL和Criteria都支持可选的ON CONFLICT子句，以允许在发生约束违反时控制应发生什么，例如。

insert into Person (id, name)
values (1, 'John')
on conflict do nothing

有关详细信息，请参阅用户指南。

对StatelessSession的工作

StatelessSession现在支持过滤器和SQL日志记录

Jakarta Data

6.5还包括基于Hibernate注解处理器的Jakarta Data技术预览。

返回顶部