EclipseLink disallows @Version attribute of type java.time.LocalDateTime

[anija-anil]

Section 2.5 of the Jakarta Persistence 3.2 specification requires support for Version attributes that are of type

java.time.LocalDateTime,

The version must be of one of the following basic types:

int, Integer, short, Short, long, Long, or

java.time.LocalDateTime, java.time.Instant, or java.sql.Timestamp.

However, when I try to use an entity,

@Entity
public class County {
    @Version
    public LocalDateTime lastUpdated;

    @Id
    public String name;

    ...

it fails with,

jakarta.persistence.PersistenceException: Exception [EclipseLink-28018] (Eclipse Persistence Services - 5.0.0-B05.v202412161836-e4245e29fa3355029f10c42ea5546c73683dd504): org.eclipse.persistence.exceptions.EntityManagerSetupException
Exception Description: Predeployment of PersistenceUnit [persistence_service_pu-2] failed.
Internal Exception: Exception [EclipseLink-7168] (Eclipse Persistence Services - 5.0.0-B05.v202412161836-e4245e29fa3355029f10c42ea5546c73683dd504): org.eclipse.persistence.exceptions.ValidationException
Exception Description: The attribute [lastUpdated] of type [class java.time.LocalDateTime] on the entity class [class test.jakarta.data.jpa.web.County] is not valid for a version property. The following types are supported: int, Integer, short, Short, long, Long, Timestamp.
	at org.eclipse.persistence.internal.jpa.EntityManagerSetupImpl.createPredeployFailedPersistenceException(EntityManagerSetupImpl.java:2157)
	at org.eclipse.persistence.internal.jpa.EntityManagerSetupImpl.predeploy(EntityManagerSetupImpl.java:2133)
	at org.eclipse.persistence.jpa.PersistenceProvider.createContainerEntityManagerFactoryImpl(PersistenceProvider.java:424)
	at org.eclipse.persistence.jpa.PersistenceProvider.createContainerEntityManagerFactory(PersistenceProvider.java:388)
	at com.ibm.wsspi.persistence.internal.PersistenceServiceUnitImpl.<init>(PersistenceServiceUnitImpl.java:91)
	at com.ibm.wsspi.persistence.internal.PersistenceServiceImpl.createPersistenceServiceUnit(PersistenceServiceImpl.java:64)
	at com.ibm.wsspi.persistence.internal.DatabaseStoreImpl.createPersistenceServiceUnit(DatabaseStoreImpl.java:350)
	at ...
Caused by: Exception [EclipseLink-28018] (Eclipse Persistence Services - 5.0.0-B05.v202412161836-e4245e29fa3355029f10c42ea5546c73683dd504): org.eclipse.persistence.exceptions.EntityManagerSetupException
Exception Description: Predeployment of PersistenceUnit [persistence_service_pu-2] failed.
Internal Exception: Exception [EclipseLink-7168] (Eclipse Persistence Services - 5.0.0-B05.v202412161836-e4245e29fa3355029f10c42ea5546c73683dd504): org.eclipse.persistence.exceptions.ValidationException
Exception Description: The attribute [lastUpdated] of type [class java.time.LocalDateTime] on the entity class [class test.jakarta.data.jpa.web.County] is not valid for a version property. The following types are supported: int, Integer, short, Short, long, Long, Timestamp.
	at org.eclipse.persistence.exceptions.EntityManagerSetupException.predeployFailed(EntityManagerSetupException.java:233)
	... 14 more
Caused by: Exception [EclipseLink-7168] (Eclipse Persistence Services - 5.0.0-B05.v202412161836-e4245e29fa3355029f10c42ea5546c73683dd504): org.eclipse.persistence.exceptions.ValidationException
Exception Description: The attribute [lastUpdated] of type [class java.time.LocalDateTime] on the entity class [class test.jakarta.data.jpa.web.County] is not valid for a version property. The following types are supported: int, Integer, short, Short, long, Long, Timestamp.
	at org.eclipse.persistence.exceptions.ValidationException.invalidTypeForVersionAttribute(ValidationException.java:1175)
	at org.eclipse.persistence.internal.jpa.metadata.accessors.mappings.VersionAccessor.process(VersionAccessor.java:129)
	at org.eclipse.persistence.internal.jpa.metadata.MetadataDescriptor.processMappingAccessors(MetadataDescriptor.java:1542)
	at org.eclipse.persistence.internal.jpa.metadata.accessors.classes.ClassAccessor.processMappingAccessors(ClassAccessor.java:1658)
	at org.eclipse.persistence.internal.jpa.metadata.accessors.classes.EntityAccessor.processMappingAccessors(EntityAccessor.java:1240)
	at org.eclipse.persistence.internal.jpa.metadata.accessors.classes.EntityAccessor.process(EntityAccessor.java:699)
	at org.eclipse.persistence.internal.jpa.metadata.MetadataProject.processStage2(MetadataProject.java:1919)
	at org.eclipse.persistence.internal.jpa.metadata.MetadataProcessor.processORMMetadata(MetadataProcessor.java:599)
	at org.eclipse.persistence.internal.jpa.deployment.PersistenceUnitProcessor.processORMetadata(PersistenceUnitProcessor.java:640)
	at org.eclipse.persistence.internal.jpa.EntityManagerSetupImpl.predeploy(EntityManagerSetupImpl.java:2054)
	... 12 more

Also, I just tried @Version on a java.time.Instant attribute and it is also rejected, so that needs to be fixed as well.

Note that the error message doesn't indicate LocalDateTime or Instant as supported types, even though the Persistence 3.2 specification requires it.

[Tomas-Kraus]

Yes, this was missing in EclipseLink. Fixed main branch to satisfy JPA 3.2 requirements for versions.