Hibernate 6替代AbstractEntityPersister获取元数据方法咨询

统一元数据入口获取 #

在Hibernate 6中，无需再通过unwrap(Session.class)获取旧版SessionFactory来获取ClassMetadata，直接通过以下方式获取核心元数据对象MappingMetamodel：

MappingMetamodel mappingMetamodel = entityManager.getEntityManagerFactory()
    .unwrap(SessionFactory.class)
    .getMappingMetamodel();
// 获取对应实体的描述器（替代原AbstractEntityPersister）
EntityDescriptor<T> entityDescriptor = mappingMetamodel.getEntityDescriptor(clazz);

原方法的替代实现 #

针对你用到的每个方法，对应替代方式如下：

1. toColumns() / getPropertyColumnNames(String propertyName) #

获取属性对应的数据库列名：

// 获取属性描述器
AttributeDescriptor attributeDescriptor = entityDescriptor.getAttribute(propertyName);
// 获取列名数组
String[] columnNames = attributeDescriptor.getJdbcValueDescriptor().getColumnNames();

2. getPropertyNames() #

获取实体所有属性名：

// 返回不可修改的属性名集合，可转为数组
Set<String> propertyNames = entityDescriptor.getAttributeNames();
String[] propertyNameArray = propertyNames.toArray(new String[0]);

3. getPropertyNullability() #

获取每个属性的 nullable 状态数组：

Boolean[] nullability = entityDescriptor.getAttributeDescriptors().stream()
    .map(AttributeDescriptor::isNullable)
    .toArray(Boolean[]::new);

4. getIdentifier(Object entity) #

获取实体主键值，直接用JPA标准API即可，也可使用Hibernate原生API：

// JPA标准方式（推荐）
Object id = entityManager.getIdentifier(entity);

// Hibernate原生方式
IdentifierDescriptor identifierDescriptor = entityDescriptor.getIdentifierDescriptor();
Object id = identifierDescriptor.getIdentifier(entity);

5. getPropertyValue(Object entity, String propertyName) #

获取实体指定属性的值，JPA标准API或Hibernate原生API均可：

// JPA标准方式
ManagedType<T> managedType = entityManager.getMetamodel().managedType(clazz);
Object value = managedType.getSingularAttribute(propertyName).get(entity);

// Hibernate原生方式
Object value = entityDescriptor.getPropertyValue(entity, propertyName);

推荐的统一替代API #

优先使用Hibernate提供的MappingMetamodel + EntityDescriptor组合：

• 这是Hibernate 6专为元数据访问设计的新API，完全替代旧版ClassMetadata/AbstractEntityPersister
• 提供更全面的映射细节（包括JDBC类型、列约束、关联关系等）
• 比JPA标准的ManagedType更贴近底层数据库映射需求，若需操作数据库相关元数据，优先选用这套API

内容的提问来源于stack exchange，提问作者Derek Vinyard