Package org.hibernate.cfg

Interface JpaComplianceSettings

All Known Subinterfaces:

AvailableSettings

All Known Implementing Classes:

Environment

public interface JpaComplianceSettings

Author:

Steve Ebersole

Field Summary

Fields

Modifier and Type	Field	Description
static final String	JPA_CACHING_COMPLIANCE	By default, Hibernate uses second-level cache invalidation for entities with secondary tables in order to avoid the possibility of inconsistent cached data in the case where different transactions simultaneously update different table rows corresponding to the same entity instance.
static final String	JPA_CASCADE_COMPLIANCE	Controls whether Hibernate applies cascade CascadeType.PERSIST or CascadeType.SAVE_UPDATE at flush time.
static final String	JPA_CLOSED_COMPLIANCE	JPA specifies that an IllegalStateException must be thrown by EntityManager.close() and EntityManagerFactory.close() if the object has already been closed.
static final String	JPA_COMPLIANCE	Specifies a default value for all JpaCompliance flags.
static final String	JPA_ID_GENERATOR_GLOBAL_SCOPE_COMPLIANCE	Determines whether the scope of any identifier generator name specified via TableGenerator.name() or SequenceGenerator.name() is considered global to the persistence unit, or local to the entity in which identifier generator is defined.
static final String	JPA_LIST_COMPLIANCE	Deprecated. Use MappingSettings.DEFAULT_LIST_SEMANTICS instead.
static final String	JPA_LOAD_BY_ID_COMPLIANCE	Determines if an identifier value passed to EntityManager.find(java.lang.Class<T>, java.lang.Object) or EntityManager.getReference(java.lang.Class<T>, java.lang.Object) may be coerced to the identifier type declared by the entity.
static final String	JPA_ORDER_BY_MAPPING_COMPLIANCE	JPA specifies that items occurring in OrderBy lists must be references to entity attributes, whereas Hibernate, by default, allows more complex expressions.
static final String	JPA_PROXY_COMPLIANCE	The JPA specification insists that an EntityNotFoundException must be thrown whenever an uninitialized entity proxy with no corresponding row in the database is accessed.
static final String	JPA_QUERY_COMPLIANCE	Controls whether Hibernate’s handling of Query (JPQL, Criteria and native) should strictly follow the requirements defined in the Jakarta Persistence specification, both in terms of JPQL validation and behavior of Query method implementations.
static final String	JPA_TRANSACTION_COMPLIANCE	When enabled, specifies that the Hibernate Transaction should behave according to the semantics defined by the JPA specification for an EntityTransaction.
static final String	JPAQL_STRICT_COMPLIANCE	Deprecated. Prefer JPA_QUERY_COMPLIANCE

Field Details

JPA_COMPLIANCE

static final String JPA_COMPLIANCE

Specifies a default value for all JpaCompliance flags. Each individual flag may still be overridden by explicitly specifying its specific configuration property.

Since:

6.0

See Also:

• JPA_TRANSACTION_COMPLIANCE
• JPA_QUERY_COMPLIANCE
• JPA_LIST_COMPLIANCE
• JPA_ORDER_BY_MAPPING_COMPLIANCE
• JPA_CLOSED_COMPLIANCE
• JPA_PROXY_COMPLIANCE
• JPA_CACHING_COMPLIANCE
• JPA_ID_GENERATOR_GLOBAL_SCOPE_COMPLIANCE
• JPA_LOAD_BY_ID_COMPLIANCE
• Constant Field Values

JPA_TRANSACTION_COMPLIANCE

static final String JPA_TRANSACTION_COMPLIANCE

When enabled, specifies that the Hibernate Transaction should behave according to the semantics defined by the JPA specification for an EntityTransaction.

Since:

5.3

See Also:

• JpaCompliance.isJpaTransactionComplianceEnabled()
• SessionFactoryBuilder.enableJpaTransactionCompliance(boolean)
• Constant Field Values

JPA_QUERY_COMPLIANCE

static final String JPA_QUERY_COMPLIANCE

Controls whether Hibernate’s handling of Query (JPQL, Criteria and native) should strictly follow the requirements defined in the Jakarta Persistence specification, both in terms of JPQL validation and behavior of Query method implementations.

Since:

5.3

See Also:

• JpaCompliance.isJpaQueryComplianceEnabled()
• SessionFactoryBuilder.enableJpaQueryCompliance(boolean)
• Constant Field Values

JPA_CASCADE_COMPLIANCE

static final String JPA_CASCADE_COMPLIANCE

Controls whether Hibernate applies cascade CascadeType.PERSIST or CascadeType.SAVE_UPDATE at flush time. If enabled, Hibernate will cascade the standard JPA PERSIST operation. Otherwise, Hibernate will cascade the legacy SAVE_UPDATE operation.

Since:

6.6

See Also:

• Constant Field Values

JPA_LIST_COMPLIANCE

@Deprecated(since="6.0")
static final String JPA_LIST_COMPLIANCE

Deprecated.

Use MappingSettings.DEFAULT_LIST_SEMANTICS instead. The specification actually leaves this behavior undefined, saying that portable applications should not rely on any specific behavior for a List with no @OrderColumn.

Controls whether Hibernate should treat what it would usually consider a "bag", that is, a list with no index column, whose element order is not persistent, as a true list with an index column and a persistent element order.

Since:

5.3

See Also:

• JpaCompliance.isJpaListComplianceEnabled()
• SessionFactoryBuilder.enableJpaListCompliance(boolean)
• Constant Field Values

JPA_ORDER_BY_MAPPING_COMPLIANCE

static final String JPA_ORDER_BY_MAPPING_COMPLIANCE

JPA specifies that items occurring in OrderBy lists must be references to entity attributes, whereas Hibernate, by default, allows more complex expressions.

Since:

6.0

See Also:

• JpaCompliance.isJpaOrderByMappingComplianceEnabled()
• SessionFactoryBuilder.enableJpaOrderByMappingCompliance(boolean)
• Constant Field Values

JPA_CLOSED_COMPLIANCE

static final String JPA_CLOSED_COMPLIANCE

JPA specifies that an IllegalStateException must be thrown by EntityManager.close() and EntityManagerFactory.close() if the object has already been closed. By default, Hibernate treats any additional call to close() as a noop.

Since:

5.3

See Also:

• JpaCompliance.isJpaClosedComplianceEnabled()
• SessionFactoryBuilder.enableJpaClosedCompliance(boolean)
• Constant Field Values

JPA_PROXY_COMPLIANCE

static final String JPA_PROXY_COMPLIANCE

The JPA specification insists that an EntityNotFoundException must be thrown whenever an uninitialized entity proxy with no corresponding row in the database is accessed. For most programs, this results in many completely unnecessary round trips to the database.

Traditionally, Hibernate does not initialize an entity proxy when its identifier attribute is accessed, since the identifier value is already known and held in the proxy instance. This behavior saves the round trip to the database.

Since:

5.2.13

See Also:

• JpaCompliance.isJpaProxyComplianceEnabled()
• Constant Field Values

JPA_CACHING_COMPLIANCE

static final String JPA_CACHING_COMPLIANCE

By default, Hibernate uses second-level cache invalidation for entities with secondary tables in order to avoid the possibility of inconsistent cached data in the case where different transactions simultaneously update different table rows corresponding to the same entity instance.

The Jakarta Persistence TCK, requires that entities with secondary tables be immediately cached in the second-level cache rather than invalidated and re-cached on a subsequent read.

Since:

5.3

See Also:

• JpaCompliance.isJpaCacheComplianceEnabled()
• AbstractEntityPersister.isCacheInvalidationRequired()
• Constant Field Values

JPA_ID_GENERATOR_GLOBAL_SCOPE_COMPLIANCE

static final String JPA_ID_GENERATOR_GLOBAL_SCOPE_COMPLIANCE

Determines whether the scope of any identifier generator name specified via TableGenerator.name() or SequenceGenerator.name() is considered global to the persistence unit, or local to the entity in which identifier generator is defined.

Since:

5.2.17

See Also:

• JpaCompliance.isGlobalGeneratorScopeEnabled()
• Constant Field Values

JPA_LOAD_BY_ID_COMPLIANCE

static final String JPA_LOAD_BY_ID_COMPLIANCE

Determines if an identifier value passed to EntityManager.find(java.lang.Class<T>, java.lang.Object) or EntityManager.getReference(java.lang.Class<T>, java.lang.Object) may be coerced to the identifier type declared by the entity. For example, an Integer argument might be widened to Long.

Since:

6.0

See Also:

• JpaCompliance.isLoadByIdComplianceEnabled()
• Constant Field Values

JPAQL_STRICT_COMPLIANCE

@Deprecated
static final String JPAQL_STRICT_COMPLIANCE

Deprecated.

Prefer JPA_QUERY_COMPLIANCE

See Also:

• Constant Field Values