This table lists the properties of the Options page of the persistence.xml Editor.


This page is not available for projects using the Generic platform.

Property Description Default

Session Options

Session Name

Specify the name by which the EclipseLink session is stored in the static session manager. Use this option if you need to access the EclipseLink shared session outside of the context of the JPA or to use a pre-existing EclipseLink session configured through a EclipseLink sessions.xml file

Valid values: a valid EclipseLink session name that is unique in a server deployment.

Example: persistence.xml file

<property name="eclipselink.session-name" value="MySession"/>

Sessions XML

Specify persistence information loaded from the EclipseLink session configuration file (sessions.xml).

You can use this option as an alternative to annotations and deployment XML. If you specify this property, EclipseLink will override all class annotation and the object relational mapping from the persistence.xml, as well as ORM.xml and other mapping files, if present.

Indicate the session by setting the eclipselink.session-name property.

Note: If you do not specify the value for this property, sessions.xml file will not be used.

Valid values: the resource name of the sessions XML file.

Example: persistence.xml file

<property name="toplink.session-xml" value="mysession.xml"/>

Target Database

Select the target database. You can also set the value to the fully qualified class name of a subclass of the org.eclipse.persistence.platform.DatabasePlatform class.

Example: persistence.xml file

<property name="eclipselink.target-database" value="Oracle"/>


Target Server

Select the target server for your JPA application.

Example: persistence.xml file

<property name="eclipselink.target-server" value="OC4J_10_1_3"/>


Event Listener

Specify a descriptor event listener to be added during bootstrapping.

Valid values: qualified class name for a class that implements the eclipselink.sessions.SessionEventListener interface.

Example: persistence.xml file

<property name="eclipselink.session-event-listener" value="mypackage.MyClass.class"/>

Include Descriptor Queries

Enable or disable the default copying of all named queries from the descriptors to the session. These queries include the ones defined using EclipseLink API, descriptor amendment methods, and so on.


Miscellaneous Options

Temporal mutable

Specify if all Date and Calendar persistent fields should be handled as mutable objects.

Example: persistence.xml file

<property name="eclipselink.temporal.mutable" value="true"/>


Lock timeout


Query timeout


Validation mode


Validate pre-persist group

Validate pre-update group

Validate pre-remove group

Related references