org.eclipse.persistence.config

Class PersistenceUnitProperties

java.lang.Object

org.eclipse.persistence.config.PersistenceUnitProperties

public class PersistenceUnitProperties
extends java.lang.Object

The class defines EclipseLink persistence unit property names. These values are used to assist in the configuration of properties passed to Persistence.createEntityManagerFactory(String, Map) which override the values specified in the persistence.xml file.

Usage Example: Map props = new HashMap();

props.put(PersistenceUnitProperties.JDBC_USER, "user-name");
props.put(PersistenceUnitProperties.JDBC_PASSWORD, "password");

EntityManagerFactory emf = Persistence.createEntityManagerFactory("pu-name", props);

Property values are usually case-insensitive with some common sense exceptions, for instance class names.

See Also:

Persistence.createEntityManagerFactory(String, Map)

Field Summary

Fields

Modifier and Type	Field and Description
static java.lang.String	ALLOW_NATIVE_SQL_QUERIES The "eclipselink.jdbc.allow-native-sql-queries" property specifies whether any user defined SQL is allowed within a persistence unit.
static java.lang.String	ALLOW_ZERO_ID Deprecated. replaced by ID_VALIDATION property with value "NULL".
static java.lang.String	APP_LOCATION The property "eclipselink.application-location" Specifies the file system directory location where DDL files are written (output) to.
static java.lang.String	BATCH_WRITING The "eclipselink.jdbc.batch-writing" property configures the use of batch writing to optimize transactions with multiple writes.
static java.lang.String	BATCH_WRITING_SIZE The "eclipselink.jdbc.batch-writing.size" property configures the batch size used for batch writing.
static java.lang.String	CACHE_SHARED_ Indicates whether entity's cache should be shared (non-isolated).
static java.lang.String	CACHE_SHARED_DEFAULT Default caching properties - apply to all entities.
static java.lang.String	CACHE_SIZE_ Property prefix "eclipselink.cache.size.
static java.lang.String	CACHE_SIZE_DEFAULT Default caching properties - apply to all entities.
static java.lang.String	CACHE_STATEMENTS The "eclipselink.jdbc.cache-statements" property specifies whether JDBC statements should be cached.
static java.lang.String	CACHE_STATEMENTS_SIZE The "eclipselink.jdbc.cache-statements.size" property specifies the number of statements held when using internal statement caching.
static java.lang.String	CACHE_TYPE_ All valid values for CACHE_TYPE_ properties are declared in CacheType class.
static java.lang.String	CACHE_TYPE_DEFAULT Default caching properties - apply to all entities.
static java.lang.String	CANONICAL_MODEL_LOAD_XML This optional property can be used a performance enhancement between compile rounds.
static java.lang.String	CANONICAL_MODEL_LOAD_XML_DEFAULT
static java.lang.String	CANONICAL_MODEL_PREFIX This optional property specifies the prefix that will be added to the start of the class name of any canonical model class generated.
static java.lang.String	CANONICAL_MODEL_PREFIX_DEFAULT
static java.lang.String	CANONICAL_MODEL_SUB_PACKAGE This optional property specifies a sub-package name that can be used to have the canonical model generator generate its classes in a sub-package of the package where the corresponding entity class is located.
static java.lang.String	CANONICAL_MODEL_SUB_PACKAGE_DEFAULT
static java.lang.String	CANONICAL_MODEL_SUFFIX This optional property specifies the suffix that will be added to the end of the class name of any canonical model class generated.
static java.lang.String	CANONICAL_MODEL_SUFFIX_DEFAULT
static java.lang.String	CANONICAL_MODEL_USE_STATIC_FACTORY This optional property can be used a performance enhancement between compile rounds within an IDE.
static java.lang.String	CANONICAL_MODEL_USE_STATIC_FACTORY_DEFAULT
static java.lang.String	CATEGORY_LOGGING_LEVEL_ Property prefix "eclipselink.logging.level.
static java.lang.String	CLASSLOADER Specify the classloader to use to create an EntityManagerFactory in the property map passed to Persistence.createEntityManagerFactory.
static java.lang.String	COMPOSITE_UNIT Indicates if it's a composite persistence unit ("true").
static java.lang.String	COMPOSITE_UNIT_MEMBER Indicates if the persistence unit must be a member of a composite persistence unit ("true"), can't be used as an independent persistence unit.
static java.lang.String	COMPOSITE_UNIT_PROPERTIES The property may be passed to createEntityManagerFactory method of a composite persistence unit to pass properties to member persistence units.
static java.lang.String	CONNECTION_POOL Allow configuring a "eclipselink.connection-pool."
static java.lang.String	CONNECTION_POOL_FAILOVER The "failover" property.
static java.lang.String	CONNECTION_POOL_INITIAL The "initial" property.
static java.lang.String	CONNECTION_POOL_INTERNALLY_POOL_DATASOURCE Tell EclipseLink to use it's internal connection pool to pool connections from a datasource.
static java.lang.String	CONNECTION_POOL_JTA_DATA_SOURCE The "jtaDataSource" property.
static java.lang.String	CONNECTION_POOL_MAX The "max" property.
static java.lang.String	CONNECTION_POOL_MIN The "min" property.
static java.lang.String	CONNECTION_POOL_NON_JTA_DATA_SOURCE The "nonJtaDataSource" property.
static java.lang.String	CONNECTION_POOL_PASSWORD The "password" property.
static java.lang.String	CONNECTION_POOL_READ Allow configuring the "eclipselink.connection-pool.read."
static java.lang.String	CONNECTION_POOL_SEQUENCE Allow configuring the "eclipselink.connection-pool.sequence."
static java.lang.String	CONNECTION_POOL_SHARED The "shared" property.
static java.lang.String	CONNECTION_POOL_URL The "url" property.
static java.lang.String	CONNECTION_POOL_USER The "user" property.
static java.lang.String	CONNECTION_POOL_WAIT The "wait" property.
static java.lang.String	COORDINATION_ASYNCH the "eclipselink.cache.coordination.propagate-asynchronously" property configures cache coordination for a clustered environment.
static java.lang.String	COORDINATION_CHANNEL the "eclipselink.cache.coordination.channel" property configures cache coordination for a clustered environment.
static java.lang.String	COORDINATION_JMS_FACTORY The "eclipselink.cache.coordination.jms.factory" property configures cache coordination for a clustered environment.
static java.lang.String	COORDINATION_JMS_HOST The "eclipselink.cache.coordination.jms.host" property configures cache coordination for a clustered environment.
static java.lang.String	COORDINATION_JMS_REUSE_PUBLISHER The "eclipselink.cache.coordination.jms.reuse-topic-publisher" property configures cache coordination for a clustered environment.
static java.lang.String	COORDINATION_JMS_TOPIC The "eclipselink.cache.coordination.jms.topic" property configures cache coordination for a clustered environment.
static java.lang.String	COORDINATION_JNDI_CONTEXT The "eclipselink.cache.coordination.jndi.initial-context-factory" property configures cache coordination for a clustered environment.
static java.lang.String	COORDINATION_JNDI_PASSWORD The "eclipselink.cache.coordination.jndi.password" property configures cache coordination for a clustered environment.
static java.lang.String	COORDINATION_JNDI_USER the "eclipselink.cache.coordination.jndi.user" property configures cache coordination for a clustered environment.
static java.lang.String	COORDINATION_NAMING_SERVICE The "eclipselink.cache.coordination.naming-service" property configures cache coordination for a clustered environment.
static java.lang.String	COORDINATION_PROTOCOL The "eclipselink.cache.coordination.protocol" property configures cache coordination for a clustered environment.
static java.lang.String	COORDINATION_REMOVE_CONNECTION The "eclipselink.cache.coordination.remove-connection-on-error" property configures cache coordination for a clustered environment.
static java.lang.String	COORDINATION_RMI_ANNOUNCEMENT_DELAY The "eclipselink.cache.coordination.rmi.announcement-delay" property configures cache coordination for a clustered environment.
static java.lang.String	COORDINATION_RMI_MULTICAST_GROUP The "eclipselink.cache.coordination.rmi.multicast-group" property configures cache coordination for a clustered environment.
static java.lang.String	COORDINATION_RMI_MULTICAST_GROUP_PORT The "eclipselink.cache.coordination.rmi.multicast-group.port" property configures cache coordination for a clustered environment.
static java.lang.String	COORDINATION_RMI_PACKET_TIME_TO_LIVE The "eclipselink.cache.coordination.rmi.packet-time-to-live" property configures cache coordination for a clustered environment.
static java.lang.String	COORDINATION_RMI_URL The "eclipselink.cache.coordination.rmi.url" property configures cache coordination for a clustered environment.
static java.lang.String	COORDINATION_SERIALIZER the "eclipselink.cache.coordination.serializer" property configures how cache coordination serializes message sent between nodes.
static java.lang.String	COORDINATION_THREAD_POOL_SIZE the "eclipselink.cache.coordination.thread.pool.size" property configures thread pool size for cache coordination threads.
static java.lang.String	CREATE_JDBC_DDL_FILE The property "eclipselink.create-ddl-jdbc-file-name" Specifies the name of the DDL file which is used to create database tables.
static java.lang.String	CREATE_ONLY The parameter value "create-tables" For use with the "eclipselink.ddl-generation" property.
static java.lang.String	CREATE_OR_EXTEND The parameter value "create-or-extend-tables" For use with the "eclipselink.ddl-generation" property.
static java.lang.String	DATABASE_EVENT_LISTENER Allows integration with a database event notification service.
static java.lang.String	DDL_BOTH_GENERATION The parameter value "both" For use with the "eclipselink.ddl-generation.output-mode" property.
static java.lang.String	DDL_DATABASE_GENERATION The parameter value "database" For use with the "eclipselink.ddl-generation.output-mode" property, and is the default parameter value Specifies that DDL will be written to the database.
static java.lang.String	DDL_GENERATION Allows the database schema to be generated on deployment.
static java.lang.String	DDL_GENERATION_INDEX_FOREIGN_KEYS The "eclipselink.ddl-generation.index-foreign-keys" property.
static java.lang.String	DDL_GENERATION_MODE Configures if database schema should be generated on the database, to a file, or both.
static java.lang.String	DDL_SQL_SCRIPT_GENERATION The parameter value "sql-script" For use with the "eclipselink.ddl-generation.output-mode" property.
static java.lang.String	DEFAULT Default Suffix could be appended to some prefixes to form a property name setting the default for the persistence unit.
static java.lang.String	DEFAULT_APP_LOCATION The default location in the file system to output DDL files.
static java.lang.String	DEFAULT_CREATE_JDBC_FILE_NAME The default name of the DDL file which is used to create database tables.
static java.lang.String	DEFAULT_DDL_GENERATION_MODE The eclipselink.ddl-generation.output-mode parameter is configured to the default value of database.
static java.lang.String	DEFAULT_DROP_JDBC_FILE_NAME The default name of the DDL file which is used to drop database tables.
static java.lang.String	DEPLOY_ON_STARTUP The "eclipselink.deploy-on-startup" property controls whether EclipseLink creates the persistence unit when the application starts up, or when the persistence unit is first actually accessed by the application.
static java.lang.String	DESCRIPTOR_CUSTOMIZER_ The "eclipselink.descriptor.customizer."
static java.lang.String	DROP_AND_CREATE The parameter value "drop-and-create-tables" For use with the "eclipselink.ddl-generation" property.
static java.lang.String	DROP_JDBC_DDL_FILE The property "eclipselink.drop-ddl-jdbc-file-name" Specifies the name of the DDL file which is used to drop database tables.
static java.lang.String	DROP_ONLY The parameter value "drop-tables" For use with the "eclipselink.ddl-generation" property.
static java.lang.String	ECLIPSELINK_PERSISTENCE_UNITS This "eclipselink.persistenceunits" property specifies the set of persistence unit names that will be processed when generating the canonical model.
static java.lang.String	ECLIPSELINK_PERSISTENCE_XML The "eclipselink.persistencexml" property specifies the full resource name to look for the persistence XML files in.
static java.lang.String	ECLIPSELINK_PERSISTENCE_XML_DEFAULT The default resource location used to locate the persistence.xml configuration files.
static java.lang.String	EXCEPTION_HANDLER_CLASS The "eclipselink.exception-handler" property allows an ExceptionHandler to be specified.
static java.lang.String	EXCLUDE_ECLIPSELINK_ORM_FILE The "eclipselink.exclude-eclipselink-orm" property configures the exclusion of an EclipseLink ORM mapping file for a specific persistence unit.
static java.lang.String	EXCLUSIVE_CONNECTION_IS_LAZY The "eclipselink.jdbc.exclusive-connection.is-lazy" property specifies when write connection is acquired lazily.
static java.lang.String	EXCLUSIVE_CONNECTION_MODE The "eclipselink.jdbc.exclusive-connection.mode" property specifies when reads are performed through the write connection.
static java.lang.String	FLUSH_CLEAR_CACHE Defines EntityManager cache behavior after a call to flush method followed by a call to clear method.
static java.lang.String	FREE_METADATA The "eclipselink.memory.free-metadata"property configures the JPA internal deployment metadata to be released after deployment.
static java.lang.String	ID_VALIDATION The "eclipselink.id-validation" property defines which primary key components values are considered invalid.
static java.lang.String	INCLUDE_DESCRIPTOR_QUERIES The "eclipselink.session.include.descriptor.queries" property configures whether to enable the copying of all descriptor named queries to the session to be usable from the entity manager.
static java.lang.String	JAVASE_DB_INTERACTION The system property INTERACT_WITH_DB Specified to enable or disable the execution of DDL (configured with the eclipselink.ddl-generation property) against a database.
static java.lang.String	JDBC_BIND_PARAMETERS Property "eclipselink.jdbc.bind-parameters configures whether parameter binding will be used in the creation of JDBC prepared statements.
static java.lang.String	JDBC_CONNECTIONS_INITIAL Deprecated. as of EclipseLink 2.2 replaced by CONNECTION_POOL_INITIAL
static java.lang.String	JDBC_CONNECTIONS_MAX Deprecated. as of EclipseLink 2.2 replaced by CONNECTION_POOL_MAX
static java.lang.String	JDBC_CONNECTIONS_MIN Deprecated. as of EclipseLink 2.2 replaced by CONNECTION_POOL_MIN
static java.lang.String	JDBC_CONNECTIONS_WAIT Deprecated. as of EclipseLink 2.2 replaced by CONNECTION_POOL_WAIT
static java.lang.String	JDBC_CONNECTOR The "eclipselink.jdbc.connector" property.
static java.lang.String	JDBC_DRIVER The javax.persistence.jdbc.driver" property specifies the JDBC DriverManager class name used for internal connection pooling when a data source is not being used.
static java.lang.String	JDBC_PASSWORD The javax.persistence.jdbc.password" property specifies the data source or JDBC password.
static java.lang.String	JDBC_PROPERTY Allows passing of JDBC driver specific connection properties.
static java.lang.String	JDBC_READ_CONNECTIONS_INITIAL Deprecated. as of EclipseLink 2.2 replaced by CONNECTION_POOL_INITIAL
static java.lang.String	JDBC_READ_CONNECTIONS_MAX Deprecated. as of EclipseLink 2.2 replaced by CONNECTION_POOL_MAX
static java.lang.String	JDBC_READ_CONNECTIONS_MIN Deprecated. as of EclipseLink 2.2 replaced by CONNECTION_POOL_MIN
static java.lang.String	JDBC_READ_CONNECTIONS_SHARED Deprecated. as of EclipseLink 2.2 replaced by CONNECTION_POOL_SHARED
static java.lang.String	JDBC_RESULT_SET_ACCESS_OPTIMIZATION Allows to set whether a query should by default use ResultSet Access optimization.
static java.lang.String	JDBC_SEQUENCE_CONNECTION_POOL Deprecated. as of EclipseLink 2.2 replaced by CONNECTION_POOL_SEQUENCE
static java.lang.String	JDBC_SEQUENCE_CONNECTION_POOL_DATASOURCE Deprecated. as of EclipseLink 2.2 replaced by CONNECTION_POOL_NON_JTA_DATA_SOURCE
static java.lang.String	JDBC_SEQUENCE_CONNECTION_POOL_INITIAL Deprecated. as of EclipseLink 2.2 replaced by CONNECTION_POOL_INITIAL
static java.lang.String	JDBC_SEQUENCE_CONNECTION_POOL_MAX Deprecated. as of EclipseLink 2.2 replaced by CONNECTION_POOL_MAX
static java.lang.String	JDBC_SEQUENCE_CONNECTION_POOL_MIN Deprecated. as of EclipseLink 2.2 replaced by CONNECTION_POOL_MIN
static java.lang.String	JDBC_URL The javax.persistence.jdbc.url" property specifies the JDBC URL used for internal connection pooling when a data source is not being used.
static java.lang.String	JDBC_USER The javax.persistence.jdbc.user" property specifies the data source or JDBC user name.
static java.lang.String	JDBC_WRITE_CONNECTIONS_INITIAL Deprecated. as of EclipseLink 2.2 replaced by CONNECTION_POOL_INITIAL
static java.lang.String	JDBC_WRITE_CONNECTIONS_MAX Deprecated. as of EclipseLink 2.2 replaced by CONNECTION_POOL_MAX
static java.lang.String	JDBC_WRITE_CONNECTIONS_MIN Deprecated. as of EclipseLink 2.2 replaced by CONNECTION_POOL_MIN
static java.lang.String	JOIN_EXISTING_TRANSACTION The "eclipselink.transaction.join-existing" property Set to "true" this property forces persistence context to read through JTA-managed ("write") connection in case there is an active transaction.The property set in persistence.xml or passed to createEntityManagerFactory affects all EntityManagers created by the factory.
static java.lang.String	JPQL_PARSER The "eclipselink.jpql.parser" property allows the JPQL parser to be configured.
static java.lang.String	JPQL_VALIDATION The "eclipselink.jpql.validation" property allows the JPQL parser validation level to be configured.
static java.lang.String	JTA_DATASOURCE The javax.persistence.jtaDataSource" property specifies the JTA data source name that will look up a valid DataSource.
static java.lang.String	LOGGING_CONNECTION Property: "eclipselink.logging.connection" Values: "true" (Default) "false"
static java.lang.String	LOGGING_EXCEPTIONS Values: "true" (Default) "false"
static java.lang.String	LOGGING_FILE The "eclipselink.logging.file" property configures a file location where the log will be output to instead of standard out.
static java.lang.String	LOGGING_LEVEL Property "eclipselink.logging.level allows the default logging levels to be specified.
static java.lang.String	LOGGING_LOGGER The type of logger.
static java.lang.String	LOGGING_PARAMETERS By default sql bind paramters are displayed in exceptions and logs when the log level is FINE or greater.
static java.lang.String	LOGGING_SESSION Property "eclipselink.logging.session" indicating if the session in use should have its identity included in each log message.
static java.lang.String	LOGGING_THREAD Property "eclipselink.logging.thread" indicating if current thread should have its identity included in each log message.
static java.lang.String	LOGGING_TIMESTAMP The "eclipselink.logging.timestamp" property configures if the current timestamp should be included in each log message.
static java.lang.String	METADATA_SOURCE The "eclipselink.metadata-source"property configures the type of MetadataSource implementation to use to read Metadata Values (case insensitive): "XML": Use XMLMetadataSource Custom MetadataSource - Specify a custom class name which implements MetadataSource
static java.lang.String	METADATA_SOURCE_PROPERTIES_FILE The property "eclipselink.metadata-source.properties.file" Specifies the name of the metadata repository properties file to read from using classloader to find the resource
static java.lang.String	METADATA_SOURCE_RCM_COMMAND the "eclipselink.metadata-source.send-refresh-command" property works with cache coordination for a clustered environment to.
static java.lang.String	METADATA_SOURCE_XML_FILE The property "eclipselink.metadata-source.xml.file" Specifies the name of the metadata repository xml file to read from using classloader to find the resource This property should be used in conjunction with the "eclipselink.metadata-repository" when an XML repository is being used.
static java.lang.String	METADATA_SOURCE_XML_URL The property "eclipselink.metadata-source.xml.URL" Specifies the name of the metadata repository xml URL to read from.
static java.lang.String	MULTITENANT_PROPERTY_DEFAULT The "eclipselink.tenant-id" property specifies the default context property used to populate multitenant entities.
static java.lang.String	MULTITENANT_SHARED_CACHE Property "eclipselink.multitenant.tenants-share-cache specifies that multitenant entities will share the L2 cache.
static java.lang.String	MULTITENANT_SHARED_EMF Property "eclipselink.multitenant.shared-emf is used to indicate that multitenant entities will be used within a shared entity manager factory.
static java.lang.String	NATIVE_QUERY_UPPERCASE_COLUMNS The "eclipselink.jdbc.uppercase-columns" property configures native SQL queries are used, the JDBC meta-data may return column names in lower case on some platforms.
static java.lang.String	NATIVE_SQL The "eclipselink.jdbc.native-sql" property specifies whether generic SQL should be used or platform specific 'native' SQL.
static java.lang.String	NON_JTA_DATASOURCE The javax.persistence.nonJtaDataSource" property specifies the non-JTA data source name that will look up a valid DataSource.
static java.lang.String	NONE The parameter value "none" For use with the "eclipselink.ddl-generation" property, and is the default parameter value.
static java.lang.String	NOSQL_CONNECTION_FACTORY The "eclipselink.nosql.connection-factory" property.
static java.lang.String	NOSQL_CONNECTION_SPEC The "eclipselink.nosql.connection-spec" property.
static java.lang.String	NOSQL_PASSWORD Allows setting of NoSQL password property.
static java.lang.String	NOSQL_PROPERTY Allows setting of NoSQL connection properties.
static java.lang.String	NOSQL_USER Allows setting of NoSQL user property.
static java.lang.String	ORACLE_PROXY_TYPE The "eclipselink.oracle.proxy-type" property is used to specify proxy type that should be passed to OracleConnection.openProxySession method.
static java.lang.String	ORDER_UPDATES Configures if updates should be ordered by primary key.
static java.lang.String	ORM_SCHEMA_VALIDATION This property set on the session is used to override orm.xml schema validation from its default of false.
static java.lang.String	PARTITIONING "eclipselink.partitioning" Used to set the default PartitioningPolicy for a persistence unit.
static java.lang.String	PARTITIONING_CALLBACK "eclipselink.partitioning.callback" Used to integrate with an external DataSource's data affinity support, such as UCP.
static java.lang.String	PERSISTENCE_CONTEXT_CLOSE_ON_COMMIT The "eclipselink.persistence-context.close-on-commit" property specifies that the EntityManager will be closed or not used after commit (not extended).
static java.lang.String	PERSISTENCE_CONTEXT_COMMIT_WITHOUT_PERSIST_RULES The "eclipselink.persistence-context.commit-without-persist-rules" property specifies that the EntityManager will search all managed objects and persist any related non-managed new objects that are found ignoring any absence of CascadeType.PERSIST settings.
static java.lang.String	PERSISTENCE_CONTEXT_FLUSH_MODE The "eclipselink.persistence-context.flush-mode property configures the EntityManager FlushMode to be set as a persistence property.
static java.lang.String	PERSISTENCE_CONTEXT_PERSIST_ON_COMMIT The "eclipselink.persistence-context.persist-on-commit" property specifies that the EntityManager will search all managed objects and persist any related non-managed new objects that are cascade persist.
static java.lang.String	PERSISTENCE_CONTEXT_REFERENCE_MODE The "eclipselink.persistence-context.reference-mode" property configures whether there should be hard or soft references used within the Persistence Context.
static java.lang.String	PESSIMISTIC_LOCK_TIMEOUT The "javax.persistence.lock.timeout" property configures the WAIT timeout used in pessimistic locking, if the database query exceeds the timeout the database will terminate the query and return an exception.
static java.lang.String	PROFILER The "eclipselink.profiler"property configures the type of profiler used to capture runtime statistics.
static java.lang.String	PROJECT_CACHE The "eclipselink.project-cache"property configures the type of ProjectCacheAccessor implementation to use to retrieve and store projects representing the metadata for the project Values (case insensitive): "java-serialization": Use FileBasedProjectCache Custom ProjectCacheAccessor - Specify a custom class name which implements ProjectCacheAccessor
static java.lang.String	PROJECT_CACHE_FILE The property "eclipselink.project-cache.java-serialization.file" Specifies the name of the file to read/write a serialized project representing the application's metadata* Specifies the name of the metadata repository xml file to read from using classloader to find the resource This property should be used in conjunction with "eclipselink.project-cache" when a project is serialized to a file for caching.
static java.util.Map<java.lang.String,java.lang.String>	PROPERTY_LOG_OVERRIDES INTERNAL: The following properties will not be displayed through logging but instead have an alternate value shown in the log.
static java.lang.String	QUERY_CACHE Property prefix "eclipselink.cache.query-results used to configure the default option for query results caching.
static java.lang.String	QUERY_TIMEOUT The "javax.persistence.query.timeout" property configures the default query timeout value.
static java.lang.String	REMOTE_PROTOCOL The "eclipselink.remote.protocol" property configures remote JPA for a client or server.
static java.lang.String	REMOTE_SERVER_NAME The "eclipselink.remote.server.name" property configures remote JPA for a server.
static java.lang.String	REMOTE_URL The "eclipselink.remote.client.url" property configures remote JPA for a client.
static java.lang.String	SCHEMA_DATABASE_MAJOR_VERSION If sufficient database version information is not included from the JDBC DatabaseMetaData method getDatabaseProductName, the "javax.persistence.database-major-version" property should be specified as needed.
static java.lang.String	SCHEMA_DATABASE_MINOR_VERSION If sufficient database version information is not included from the JDBC DatabaseMetaData method getDatabaseProductName, the "javax.persistence.database-minor-version" property should be specified as needed.
static java.lang.String	SCHEMA_DATABASE_PRODUCT_NAME If scripts are to be generated by the persistence provider and a connection to the target database is not supplied, the "javax.persistence.database-product-name" property must be specified.
static java.lang.String	SCHEMA_GENERATION_CONNECTION The "javax.persistence.schema-generation.connection" property specifies the JDBC connection to be used for schema generation.
static java.lang.String	SCHEMA_GENERATION_CREATE_ACTION The parameter value "create" For use with the "javax.persistence.schema-generation.database.action" and "javax.persistence.schema-generation.scripts.action" properties.
static java.lang.String	SCHEMA_GENERATION_CREATE_DATABASE_SCHEMAS In Java EE environments, it is anticipated that the Java EE platform provider may wish to control the creation of database schemas rather than delegate this task to the persistence provider.
static java.lang.String	SCHEMA_GENERATION_CREATE_SCRIPT_SOURCE The "javax.persistence.schema-generation.create-script-source" is used for script execution.
static java.lang.String	SCHEMA_GENERATION_CREATE_SOURCE The "javax.persistence.schema-generation.create-source" property specifies whether the creation of database artifacts is to occur on the basis of the object/relational mapping metadata, DDL script, or a combination of the two.
static java.lang.String	SCHEMA_GENERATION_DATABASE_ACTION The "javax.persistence.schema-generation.database.action" property specifies the action to be taken by the persistence provider with regard to the database artifacts.
static java.lang.String	SCHEMA_GENERATION_DROP_ACTION The parameter value "drop" For use with the "javax.persistence.schema-generation.database.action" and "javax.persistence.schema-generation.scripts.action" properties.
static java.lang.String	SCHEMA_GENERATION_DROP_AND_CREATE_ACTION The parameter value "drop-and-create" For use with the "javax.persistence.schema-generation.database.action" and "javax.persistence.schema-generation.scripts.action" properties.
static java.lang.String	SCHEMA_GENERATION_DROP_SCRIPT_SOURCE The "javax.persistence.schema-generation.drop-script-source" is used for script execution.
static java.lang.String	SCHEMA_GENERATION_DROP_SOURCE The "javax.persistence.schema-generation.drop-source" property specifies whether the dropping of database artifacts is to occur on the basis of the object/relational mapping metadata, DDL script, or a combination of the two.
static java.lang.String	SCHEMA_GENERATION_METADATA_SOURCE The parameter value "metadata" For use with the "javax.persistence.schema-generation.create-source" and "javax.persistence.schema-generation.drop-source" properties.
static java.lang.String	SCHEMA_GENERATION_METADATA_THEN_SCRIPT_SOURCE The parameter value "metadata-then-script" For use with the "javax.persistence.schema-generation.create-source" and "javax.persistence.schema-generation.drop-source" properties.
static java.lang.String	SCHEMA_GENERATION_NONE_ACTION The parameter value "none" For use with the "javax.persistence.schema-generation.database.action" and "javax.persistence.schema-generation.scripts.action" properties.
static java.lang.String	SCHEMA_GENERATION_SCRIPT_SOURCE The parameter value "script" For use with the "javax.persistence.schema-generation.create-source" and "javax.persistence.schema-generation.drop-source" properties.
static java.lang.String	SCHEMA_GENERATION_SCRIPT_THEN_METADATA_SOURCE The parameter value "script-then-metadata" For use with the "javax.persistence.schema-generation.create-source" and "javax.persistence.schema-generation.drop-source" properties.
static java.lang.String	SCHEMA_GENERATION_SCRIPTS_ACTION The "javax.persistence.schema-generation.scripts.action" property specifies which scripts are to be generated by the persistence provider.
static java.lang.String	SCHEMA_GENERATION_SCRIPTS_CREATE_TARGET If scripts are to be generated, the target locations for the writing of these scripts must be specified.
static java.lang.String	SCHEMA_GENERATION_SCRIPTS_DROP_TARGET If scripts are to be generated, the target locations for the writing of these scripts must be specified.
static java.lang.String	SCHEMA_GENERATION_SQL_LOAD_SCRIPT_SOURCE In Java EE container environments, it is generally expected that the container will be responsible for executing data load scripts, although the container is permitted to delegate this task to the persistence provider.
static java.lang.String	SEQUENCING_SEQUENCE_DEFAULT The "eclipselink.sequencing.default-sequence-to-table" property determines the default behavior when a GeneratedValue of type SEQUENCE is used on a database platform that does not support SEQUENCE generation.
static java.lang.String	SERIALIZER Specifies class name for session serializer (must implement org.eclipse.persistence.sessions.serializers.Serializer) Default value is "org.eclipse.persistence.sessions.serializers.JavaSerializer"
static java.lang.String	SESSION_CUSTOMIZER The "eclipselink.session.customizer" property configures a SessionCustomizer used to alter the runtime configuration through API.
static java.lang.String	SESSION_EVENT_LISTENER_CLASS The "eclipselink.session-event-listener" property configures a session event listener class.
static java.lang.String	SESSION_NAME The "eclipselink.session-name" property configures a specific name to use when storing the singleton server session within the SessionManager.
static java.lang.String	SESSIONS_XML The "eclipselink.sessions-xml" property configures the use of the specified native sessions.xml configuration file.
static java.lang.String	SQL_CAST The "eclipselink.jdbc.sql-cast" property specifies if platform specific CAST SQL operations should be used.
static java.lang.String	TABLE_CREATION_SUFFIX The "eclipselink.ddl.table-creation-suffix" property is used in conjunction with DDL generation options to append a string to the end of generated CREATE Table statements This value is applied to all Table creation statements through the DDL generation feature ie
static java.lang.String	TARGET_DATABASE The "eclipselink.target-database" property configures the database that will be used controlling custom operations and SQL generation for the specified database.
static java.lang.String	TARGET_SERVER The "eclipselink.target-server" property configures the ServerPlatform that will be used to enable integration with a host container.
static java.lang.String	TEMPORAL_MUTABLE The "eclipselink.temporal.mutable" property configures the default for detecting changes to temporal field (Date, Calendar).
static java.lang.String	THROW_EXCEPTIONS Configures if the first exception that occurs during deployment should be thrown, or if all exceptions should be caught and summary thrown at end of deployment attempt.
static java.lang.String	TRANSACTION_TYPE The javax.persistence.transactionType" property specifies the transaction type for the persistence unit.
static java.lang.String	TUNING The "eclipselink.tuning"property configures the type of tuner to use to configure the persistence unit.
static java.lang.String	UPPERCASE_COLUMN_NAMES The "eclipselink.jpa.uppercase-column-names" property configures JPA processing to uppercase all column name definitions.
static java.lang.String	VALIDATE_EXISTENCE The "eclipselink.validate-existence" property configures if the existence of an object should be verified on persist(), otherwise it will assume to be new if not in the persistence context.
static java.lang.String	VALIDATION_GROUP_PRE_PERSIST The "javax.persistence.validation.group.pre-persist" property specifies the name of the validator groups to execute for preUpdate event.
static java.lang.String	VALIDATION_GROUP_PRE_REMOVE The "javax.persistence.validation.group.pre-remove" property specifies the name of the validator groups to execute for preRemove event.
static java.lang.String	VALIDATION_GROUP_PRE_UPDATE The "javax.persistence.validation.group.pre-update" property specifies the name of the validator groups to execute for preUpdate event.
static java.lang.String	VALIDATION_MODE The "javax.persistence.validation.mode" property specifies whether the automatic lifecycle event validation is in effect.
static java.lang.String	VALIDATION_ONLY_PROPERTY The "eclipselink.validation-only" property validates deployment which includes initializing descriptors but does not connect (no login to the database).
static java.lang.String	VALIDATOR_FACTORY The "javax.persistence.validation.factory" property specifies an instance of javax.validation.ValidatorFactory used by EclipseLink to perform Automatic Validation upon Lifecycle Events.
static java.lang.String	WEAVING The "eclipselink.weaving" property configures whether weaving should be performed.
static java.lang.String	WEAVING_CHANGE_TRACKING The "eclipselink.weaving.changetracking" property configures whether AttributeLevelChangeTracking should be enabled through weaving.
static java.lang.String	WEAVING_EAGER The "eclipselink.weaving.eager" property configures whether EAGER mapping's attributes should be woven to use indirection.
static java.lang.String	WEAVING_FETCHGROUPS The "eclipselink.weaving.fetchgroups" property configures whether FetchGroup support should be enabled through weaving.
static java.lang.String	WEAVING_INTERNAL The "eclipselink.weaving.internal" property indicates whether internal optimizations should be enabled through weaving.
static java.lang.String	WEAVING_LAZY The "eclipselink.weaving.lazy" property configures whether LAZY OneToOne and ManyToOne mappings should be enabled through weaving.
static java.lang.String	WEAVING_REST The "eclipselink.weaving.rest" property configures whether classes will be weaved to support our JPA_RS functionality This property will only be considered if weaving is enabled.

Constructor Summary

Constructors

Constructor and Description
PersistenceUnitProperties()

Method Summary

Methods

Modifier and Type	Method and Description
static java.lang.String	getOverriddenLogStringForProperty(java.lang.String propertyName) INTERNAL: Return the overridden log string.
static java.util.Set<java.lang.String>	getSupportedNonServerSessionProperties()

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Field Detail

TRANSACTION_TYPE

public static final java.lang.String TRANSACTION_TYPE

The javax.persistence.transactionType" property specifies the transaction type for the persistence unit. This property overrides the value specified in the persistence.xml.

Values: A string value of "JTA" or "RESOURCE_LOCAL"

See Also:

Constant Field Values

JTA_DATASOURCE

public static final java.lang.String JTA_DATASOURCE

The javax.persistence.jtaDataSource" property specifies the JTA data source name that will look up a valid DataSource. This property is used to override the value specified in the persistence.xml.

Values: A well formed JNDI resource name that can locate the data source in the target container or an instance of DataSource

See Also:

Constant Field Values

NON_JTA_DATASOURCE

public static final java.lang.String NON_JTA_DATASOURCE

The javax.persistence.nonJtaDataSource" property specifies the non-JTA data source name that will look up a valid DataSource. This can be used to override the value specified in the persistence.xml.

Values: A well formed JNDI resource name that can locate the data source in the target container or an instance of DataSource

See Also:

Constant Field Values

JDBC_DRIVER

public static final java.lang.String JDBC_DRIVER

The javax.persistence.jdbc.driver" property specifies the JDBC DriverManager class name used for internal connection pooling when a data source is not being used. The value must be a string which is the qualified class name for a valid class that implements java.sql.Driver.

Persistence XML example:

The previous value for this property "eclipselink.jdbc.driver is now deprecated and should be replaced with this new name.

See Also:

Constant Field Values

JDBC_URL

public static final java.lang.String JDBC_URL

The javax.persistence.jdbc.url" property specifies the JDBC URL used for internal connection pooling when a data source is not being used. The value must be a string which represents a valid URL for the specified JDBC driver.

Persistence XML example:

The previous value for this property "eclipselink.jdbc.url is now deprecated and should be replaced with this new name.

See Also:

Constant Field Values

JDBC_USER

public static final java.lang.String JDBC_USER

The javax.persistence.jdbc.user" property specifies the data source or JDBC user name.

Persistence XML example:

The previous value for this property "eclipselink.jdbc.user is now deprecated and should be replaced with this new name.

See Also:

Constant Field Values

JDBC_PASSWORD

public static final java.lang.String JDBC_PASSWORD

The javax.persistence.jdbc.password" property specifies the data source or JDBC password.

Persistence XML example: The previous value for this property "eclipselink.jdbc.password is now deprecated and should be replaced with this new name.

See Also:

Constant Field Values

NATIVE_SQL

public static final java.lang.String NATIVE_SQL

The "eclipselink.jdbc.native-sql" property specifies whether generic SQL should be used or platform specific 'native' SQL. The platform specific SQL customizes join syntax, date operators, sequencing, ...

Allowed Values (String):

• "true" - use database specific SQL
• "false" (DEFAULT) - use generic SQL

See Also:

DatabaseLogin.setUsesNativeSQL(boolean), Constant Field Values

SQL_CAST

public static final java.lang.String SQL_CAST

The "eclipselink.jdbc.sql-cast" property specifies if platform specific CAST SQL operations should be used. Casting is normally not required, and can cause issues when used. Allowed Values (String):

• "true" - enable platform specific cast
• "false" (DEFAULT) - disable platform specific cast

See Also:

DatabasePlatform.setIsCastRequired(boolean), Constant Field Values

JPQL_PARSER

public static final java.lang.String JPQL_PARSER

The "eclipselink.jpql.parser" property allows the JPQL parser to be configured. Two JPQL parsers are provided:

• "org.eclipse.persistence.internal.jpa.jpql.HermesParser" (DEFAULT) - new parser as of EclipseLink 2.4, provides extended JPQL support.
• "org.eclipse.persistence.queries.ANTLRQueryBuilder" - old parser used previous to EclipseLink 2.4, can be used for backward compatibility.

See Also:

ParserType, JPAQueryBuilder, Constant Field Values

JPQL_VALIDATION

public static final java.lang.String JPQL_VALIDATION

The "eclipselink.jpql.validation" property allows the JPQL parser validation level to be configured. This setting is only supported in the Hermes parser. Valid values are:

• "EclipseLink" (DEFAULT) - allows EclipseLink JPQL extensions.
• "JPA 1.0" - only allows valid JPA 1.0 JPQL.
• "JPA 2.0" - only allows valid JPA 2.0 JPQL.
• "JPA 2.1" - only allows valid JPA 2.1 JPQL.
• "None" - no JPQL validation is done.

See Also:

ParserValidationType, Constant Field Values

CONNECTION_POOL_WAIT

public static final java.lang.String CONNECTION_POOL_WAIT

The "wait" property. This can be append to any connection pool property, i.e. "eclipselink.jdbc.connection_pool.default.wait" which specifies the timeout time in milliseconds (ms) that will be waited for an available connection before an exception is thrown. Ignored in case external connection pools are used.

Default: 180000 ms (3 minutes).

The value specified should be a string containing a positive integer value. A value of 0 means wait forever.

See Also:

CONNECTION_POOL, Constant Field Values

CONNECTION_POOL_MAX

public static final java.lang.String CONNECTION_POOL_MAX

The "max" property. This can be append to any connection pool property, i.e. "eclipselink.jdbc.connection_pool.default.max" Specifies the maximum number of read connection in the internal connection pool. If the maximum size is reached, threads requiring a connection will wait until one is released back to the pool. By default a single shared (exclusive) read/write pool is used with min/max 32 connections and 1 initial. Ignored in case external connection pools are used.

The value specified should be a string containing a positive integer value.

See Also:

CONNECTION_POOL, Constant Field Values

CONNECTION_POOL_MIN

public static final java.lang.String CONNECTION_POOL_MIN

The "min" property. This can be append to any connection pool property, i.e. "eclipselink.jdbc.connection_pool.default.min" Specifies the minimum number of connections in EclipseLink connection pool.

Ignored in case external connection pools are used. Connections beyond the minimum will be disconnected when returned to the pool, so this should normally be equal to the number of active threads, or server's thread pool size. By default a single shared (exclusive) read/write pool is used with min/max 32 connections and 1 initial.

The value specified should be a string containing a positive integer value.

See Also:

CONNECTION_POOL, Constant Field Values

CONNECTION_POOL_INITIAL

public static final java.lang.String CONNECTION_POOL_INITIAL

The "initial" property. This can be append to any connection pool property, i.e. "eclipselink.jdbc.connection_pool.default.initial" EclipseLink JDBC (internal) connection pools properties. Initial number of connections in EclipseLink connection pool. This is the number of connections connected at startup. By default a single shared (exclusive) read/write pool is used with min/max 32 connections and 1 initial. Ignored in case external connection pools are used.

The value specified should be a string containing a positive integer value.

See Also:

CONNECTION_POOL, Constant Field Values

CONNECTION_POOL_SHARED

public static final java.lang.String CONNECTION_POOL_SHARED

The "shared" property. This can be append to the read connection pool, i.e. "eclipselink.jdbc.connection_pool.read.shared" Configures whether connections in EclipseLink read connection pool should be shared (not exclusive). Connection sharing means the same JDBC connection will be used concurrently for multiple reading threads.

This property is ignored in case external connection pools are used.

Values (case insensitive):

• "false" (DEFAULT): indicates read connections will not be shared
• "true": indicates read connections can be shared

See Also:

CONNECTION_POOL_READ, Constant Field Values

CONNECTION_POOL_URL

public static final java.lang.String CONNECTION_POOL_URL

The "url" property. This can be append to a connection pool property, i.e. "eclipselink.jdbc.connection_pool.node1.url" Configures the JDBC url to use for the connection pool. Only required if different than the default.

See Also:

CONNECTION_POOL, Constant Field Values

CONNECTION_POOL_JTA_DATA_SOURCE

public static final java.lang.String CONNECTION_POOL_JTA_DATA_SOURCE

The "jtaDataSource" property. This can be append to a connection pool property, i.e. "eclipselink.jdbc.connection_pool.node1.jtaDataSource" Configures the JTA DataSource name to use for the connection pool. Only required if different than the default.

See Also:

CONNECTION_POOL, Constant Field Values

CONNECTION_POOL_NON_JTA_DATA_SOURCE

public static final java.lang.String CONNECTION_POOL_NON_JTA_DATA_SOURCE

The "nonJtaDataSource" property. This can be append to a connection pool property, i.e. "eclipselink.jdbc.connection_pool.node1.nonJtaDataSource" Configures the non JTA DataSource name to use for the connection pool. Only required if different than the default.

See Also:

CONNECTION_POOL, Constant Field Values

CONNECTION_POOL_USER

public static final java.lang.String CONNECTION_POOL_USER

The "user" property. This can be append to a connection pool property, i.e. "eclipselink.jdbc.connection_pool.node1.user" Configures the user name to use for the connection pool. Only required if different than the default.

See Also:

CONNECTION_POOL, Constant Field Values

CONNECTION_POOL_PASSWORD

public static final java.lang.String CONNECTION_POOL_PASSWORD

The "password" property. This can be append to a connection pool property, i.e. "eclipselink.jdbc.connection_pool.node1.password" Configures the password to use for the connection pool. Only required if different than the default.

See Also:

CONNECTION_POOL, Constant Field Values

CONNECTION_POOL_FAILOVER

public static final java.lang.String CONNECTION_POOL_FAILOVER

The "failover" property. This can be append to a connection pool property, i.e. "eclipselink.jdbc.connection_pool.node1.failover" Configures the connection pool(s) to fail-over to if this connection pool fails. A comma separate list is allowed if multiple failover pools are required.

See Also:

CONNECTION_POOL, Constant Field Values

CONNECTION_POOL

public static final java.lang.String CONNECTION_POOL

Allow configuring a "eclipselink.connection-pool." properties. The name of the connection pool must be appended to configure the pool, if no name is appended the default (write) pool is configured. The name of the property to configure must also be appended.

A user defined connection pool can be configured or one of the following system pools:

• "read" - pool used for non-transactional read queries, (defaults to default pool if not specified).
• "default", "write", "" - default pool used for writing and reads if no read pool configured.
• "sequence" - pool used for sequencing, (default pool/write connection used if not specified).

A user defined pool is only used if specified in the EntityManager properties or ClientSession ConnectionPolicy, or if partitioning is used. *

The following connection pool properties can be configured:

• "initial" - number of initial connections.
• "min" - minimum number of connections.
• "max" - maximum number of connections.
• "wait" - amount of time to wait for a connection from the pool.
• "url" - JDBC URL for the connection.
• "shared" - only for the read connection pool, shares read connections across threads.
• "jtaDataSource" - JTA DataSource name to use for the connection, if different than the default.
• "nonJtaDataSource" - non JTA DataSource name to use for the connection, if different than the default.
• "user" - user to use for the connection, if different than the default.
• "password" - password to use for the connection, if different than the default.

Example:

 <property name="eclipselink.connection-pool.node2.min" value="16"/>
 <property name="eclipselink.connection-pool.node2.max" value="16"/>
 <property name="eclipselink.connection-pool.node2.url" value="jdbc:oracle:thin:@node2:1521:orcl"/>
 

See Also:

CONNECTION_POOL_READ, CONNECTION_POOL_SEQUENCE, CONNECTION_POOL_INITIAL, CONNECTION_POOL_MIN, CONNECTION_POOL_MAX, CONNECTION_POOL_WAIT, CONNECTION_POOL_USER, CONNECTION_POOL_PASSWORD, CONNECTION_POOL_URL, CONNECTION_POOL_JTA_DATA_SOURCE, CONNECTION_POOL_NON_JTA_DATA_SOURCE, CONNECTION_POOL_SHARED, ConnectionPool, Constant Field Values

CONNECTION_POOL_READ

public static final java.lang.String CONNECTION_POOL_READ

Allow configuring the "eclipselink.connection-pool.read." properties. The read connection pool is used for non-transaction read queries. By default a separate read connection pool is not used, and the default pool is used for read queries.

One of the following connection pool properties must be appended.

See Also:

CONNECTION_POOL_INITIAL, CONNECTION_POOL_MIN, CONNECTION_POOL_MAX, CONNECTION_POOL_WAIT, CONNECTION_POOL_USER, CONNECTION_POOL_PASSWORD, CONNECTION_POOL_URL, CONNECTION_POOL_JTA_DATA_SOURCE, CONNECTION_POOL_NON_JTA_DATA_SOURCE, ReadConnectionPool, Constant Field Values

CONNECTION_POOL_SEQUENCE

public static final java.lang.String CONNECTION_POOL_SEQUENCE

Allow configuring the "eclipselink.connection-pool.sequence." properties. The sequence connection pool is used to allocate generated Ids. This is only required for TABLE sequencing. By default a separate sequence connection pool is not used, and the default pool is used for sequencing.

One of the following connection pool properties must be appended.

See Also:

CONNECTION_POOL_INITIAL, CONNECTION_POOL_MIN, CONNECTION_POOL_MAX, CONNECTION_POOL_WAIT, CONNECTION_POOL_USER, CONNECTION_POOL_PASSWORD, CONNECTION_POOL_URL, CONNECTION_POOL_JTA_DATA_SOURCE, CONNECTION_POOL_NON_JTA_DATA_SOURCE, ReadConnectionPool, Constant Field Values

CONNECTION_POOL_INTERNALLY_POOL_DATASOURCE

public static final java.lang.String CONNECTION_POOL_INTERNALLY_POOL_DATASOURCE

Tell EclipseLink to use it's internal connection pool to pool connections from a datasource. This property is useful when using EclipseLink with Gemini JPA because it internally wraps local database information in a datasource. Default: false

See Also:

Constant Field Values

JDBC_CONNECTIONS_WAIT

@Deprecated
public static final java.lang.String JDBC_CONNECTIONS_WAIT

Deprecated. as of EclipseLink 2.2 replaced by CONNECTION_POOL_WAIT

The "eclipselink.jdbc.connections.wait-timeout" property which specifies the timeout time in milliseconds (ms) that will be waited for an available connection before an exception is thrown. Ignored in case external connection pools are used.

Default: 180000 ms (3 minutes).

The value specified should be a string containing a positive integer value. A value of 0 means wait forever.

See Also:

CONNECTION_POOL_WAIT, Constant Field Values

JDBC_CONNECTIONS_MAX

@Deprecated
public static final java.lang.String JDBC_CONNECTIONS_MAX

Deprecated. as of EclipseLink 2.2 replaced by CONNECTION_POOL_MAX

The "eclipselink.jdbc.connections.max" property specifies the maximum number of read connection in the internal connection pool. If the maximum size is reached, threads requiring a connection will wait until one is released back to the pool. By default a single shared (exclusive) read/write pool is used with min/max 32 connections and 1 initial. Ignored in case external connection pools are used.

The value specified should be a string containing a positive integer value.

See Also:

CONNECTION_POOL_MAX, Constant Field Values

JDBC_CONNECTIONS_MIN

@Deprecated
public static final java.lang.String JDBC_CONNECTIONS_MIN

Deprecated. as of EclipseLink 2.2 replaced by CONNECTION_POOL_MIN

The "eclipselink.jdbc.connections.min" property specifies the minimum number of connections in EclipseLink connection pool.

Ignored in case external connection pools are used. Connections beyond the minimum will be disconnected when returned to the pool, so this should normally be equal to the number of active threads, or server's thread pool size. By default a single shared (exclusive) read/write pool is used with min/max 32 connections and 1 initial.

The value specified should be a string containing a positive integer value.

See Also:

CONNECTION_POOL_MIN, Constant Field Values

JDBC_CONNECTIONS_INITIAL

@Deprecated
public static final java.lang.String JDBC_CONNECTIONS_INITIAL

Deprecated. as of EclipseLink 2.2 replaced by CONNECTION_POOL_INITIAL

The "eclipselink.jdbc.connections.initial" property EclipseLink JDBC (internal) connection pools properties. Initial number of connections in EclipseLink connection pool. This is the number of connections connected at startup. By default a single shared (exclusive) read/write pool is used with min/max 32 connections and 1 initial. Ignored in case external connection pools are used.

The value specified should be a string containing a positive integer value.

See Also:

CONNECTION_POOL_INITIAL, Constant Field Values

JDBC_WRITE_CONNECTIONS_MAX

@Deprecated
public static final java.lang.String JDBC_WRITE_CONNECTIONS_MAX

Deprecated. as of EclipseLink 2.2 replaced by CONNECTION_POOL_MAX

The "eclipselink.jdbc.write-connections.max" property specifies the maximum number of connections supported in the internal write connection pool. Maximum number of connections in EclipseLink write connection pool. If the maximum size is reached, threads requiring a connection will wait until one is released back to the pool. By default a single shared (exclusive) read/write pool is used with min/max 32 connections and 1 initial. Ignored in case external connection pools are used.

The value specified should be a string containing a positive integer value.

See Also:

CONNECTION_POOL_MAX, Constant Field Values

JDBC_WRITE_CONNECTIONS_MIN

@Deprecated
public static final java.lang.String JDBC_WRITE_CONNECTIONS_MIN

Deprecated. as of EclipseLink 2.2 replaced by CONNECTION_POOL_MIN

The "eclipselink.jdbc.write-connections.min" property specifies the minimum number of connections in the internal write connection pool. Connections beyond the minimum will be disconnected when returned to the pool, so this should normally be equal to the number of active threads, or server's thread pool size. By default a single shared (exclusive) read/write pool is used with min/max 32 connections and 1 initial. Ignored in case external connection pools are used.

The value specified should be a string containing a positive integer value.

See Also:

CONNECTION_POOL_MIN, Constant Field Values

JDBC_WRITE_CONNECTIONS_INITIAL

@Deprecated
public static final java.lang.String JDBC_WRITE_CONNECTIONS_INITIAL

Deprecated. as of EclipseLink 2.2 replaced by CONNECTION_POOL_INITIAL

The "eclipselink.jdbc.write-connections.initial" property configures the number of connections connected at created at startup in the write connection pool. By default a single shared (exclusive) read/write pool is used with min/max 32 connections and 1 initial.

This property is ignored in case external connection pools are used.

The value must be a string containing a zero or greater integer value.

See Also:

CONNECTION_POOL_INITIAL, Constant Field Values

JDBC_READ_CONNECTIONS_MAX

@Deprecated
public static final java.lang.String JDBC_READ_CONNECTIONS_MAX

Deprecated. as of EclipseLink 2.2 replaced by CONNECTION_POOL_MAX

The "eclipselink.jdbc.read-connections.max" property configures the maximum number of connections in the read connection pool. If the maximum size is reached, threads requiring a connection will wait until one is released back to the pool (unless shared). By default a separate read connection pool is not used. By default a single shared (exclusive) read/write pool is used with min/max 32 connections and 1 initial.

This property is ignored in case external connection pools are used.

The value specified should be a string containing a zero or greater integer value.

See Also:

to configure the timeout waiting on a connection., CONNECTION_POOL_MAX, Constant Field Values

JDBC_READ_CONNECTIONS_MIN

@Deprecated
public static final java.lang.String JDBC_READ_CONNECTIONS_MIN

Deprecated. as of EclipseLink 2.2 replaced by CONNECTION_POOL_MIN

The "eclipselink.jdbc.read-connections.min" property configures the minimum number of connections in read connection pool. Connections beyond the minimum will be disconnected when returned to the pool, so this should normally be equal to the number of active threads, or server's thread pool size. By default a separate read connection pool is not used. By default a single shared (exclusive) read/write pool is used with min/max 32 connections and 1 initial.

This property is ignored in case external connection pools are used.

The value specified should be a string containing a zero or greater integer value.

See Also:

CONNECTION_POOL_MIN, Constant Field Values

JDBC_READ_CONNECTIONS_INITIAL

@Deprecated
public static final java.lang.String JDBC_READ_CONNECTIONS_INITIAL

Deprecated. as of EclipseLink 2.2 replaced by CONNECTION_POOL_INITIAL

The "eclipselink.jdbc.read-connections.initial" property configures the number of connections connected at created at startup in the read connection pool. By default a single shared (exclusive) read/write pool is used with min/max 32 connections and 1 initial.

This property is ignored in case external connection pools are used.

The value must be a string containing a zero or greater integer value.

See Also:

CONNECTION_POOL_INITIAL, Constant Field Values

JDBC_READ_CONNECTIONS_SHARED

@Deprecated
public static final java.lang.String JDBC_READ_CONNECTIONS_SHARED

Deprecated. as of EclipseLink 2.2 replaced by CONNECTION_POOL_SHARED

The "eclipselink.jdbc.read-connections.shared" property configures whether connections in EclipseLink read connection pool should be shared (not exclusive). Connection sharing means the same JDBC connection will be used concurrently for multiple reading threads.

This property is ignored in case external connection pools are used.

Values (case insensitive):

• "false" (DEFAULT): indicates read connections will not be shared
• "true": indicates read connections can be shared

See Also:

CONNECTION_POOL_SHARED, Constant Field Values

JDBC_SEQUENCE_CONNECTION_POOL_MAX

@Deprecated
public static final java.lang.String JDBC_SEQUENCE_CONNECTION_POOL_MAX

Deprecated. as of EclipseLink 2.2 replaced by CONNECTION_POOL_MAX

The "eclipselink.jdbc.sequence-connection-pool.max" property configures the maximum number of connections in the sequence connection pool. If the maximum size is reached, threads requiring a connection will wait until one is released back to the pool.

By default a separate sequence connection pool is not used (the sequence is allocated on the write connection).

This property is ignored in case external connection pools are used.

The value must be a string containing a zero or greater integer value. The default value is two (2).

See Also:

Required to configure the use of a sequence pool/data-source, to configure the timeout, CONNECTION_POOL_MAX, Constant Field Values

JDBC_SEQUENCE_CONNECTION_POOL_MIN

@Deprecated
public static final java.lang.String JDBC_SEQUENCE_CONNECTION_POOL_MIN

Deprecated. as of EclipseLink 2.2 replaced by CONNECTION_POOL_MIN

The "eclipselink.jdbc.sequence-connection-pool.min" property configures the minimum number of connections in sequence connection pool. Connections beyond the minimum will be disconnected when returned to the pool, so this should normally be equal to the maximum to avoid connecting/disconnecting.

By default a separate sequence connection pool is not used (the sequence is allocated on the write connection).

This property is ignored in case external connection pools are used.

The value must be a string containing a zero or greater integer value. The default value is two (2).

See Also:

Required to configure the use of a sequence pool/data-source, CONNECTION_POOL_MIN, Constant Field Values

JDBC_SEQUENCE_CONNECTION_POOL_INITIAL

@Deprecated
public static final java.lang.String JDBC_SEQUENCE_CONNECTION_POOL_INITIAL

Deprecated. as of EclipseLink 2.2 replaced by CONNECTION_POOL_INITIAL

The "eclipselink.jdbc.sequence-connection-pool.initial property configures the initial number of connections in sequence connection pool. This is the number of connections connected at startup.

By default a separate sequence connection pool is not used (the sequence is allocated on the write connection).

This property is ignored in case external connection pools are used.

The value must be a string containing a zero or greater integer value. The default value is two (2).

See Also:

Required to configure the use of a sequence pool/data-source, CONNECTION_POOL_INITIAL, Constant Field Values

JDBC_SEQUENCE_CONNECTION_POOL

@Deprecated
public static final java.lang.String JDBC_SEQUENCE_CONNECTION_POOL

Deprecated. as of EclipseLink 2.2 replaced by CONNECTION_POOL_SEQUENCE

The "eclipselink.jdbc.sequence-connection-pool" property configures a separate connection pool should used for sequencing to retrieve new value(s). This improves sequence allocation by allocating sequencing outside the current transaction. This can be used with internal or external (DataSource) connection pooling, external must provide a non-jta-datasource resource name using JDBC_SEQUENCE_CONNECTION_POOL_DATASOURCE. A sequence connection pool is generally only used with using TABLE sequencing to minimize contention on the sequence table(s).

Values (case-insensitive):

• "false" (DEFAULT):
• "true":

See Also:

to configure the use of a non-JTA data source for sequence allocation call., to configure the initial connections size for internal connection pooling, to configure the minimum connections size for internal connection pooling, to configure the maximum connections size for internal connection pooling, CONNECTION_POOL_SEQUENCE, Constant Field Values

JDBC_SEQUENCE_CONNECTION_POOL_DATASOURCE

@Deprecated
public static final java.lang.String JDBC_SEQUENCE_CONNECTION_POOL_DATASOURCE

Deprecated. as of EclipseLink 2.2 replaced by CONNECTION_POOL_NON_JTA_DATA_SOURCE

The "eclipselink.jdbc.sequence-connection-pool.non-jta-data-source property configures the name of the non-JTA data source that will be used for sequencing calls.

See Also:

JDBC_SEQUENCE_CONNECTION_POOL, CONNECTION_POOL_NON_JTA_DATA_SOURCE, Constant Field Values

PARTITIONING

public static final java.lang.String PARTITIONING

"eclipselink.partitioning"

Used to set the default PartitioningPolicy for a persistence unit. A PartitioningPolicy is used to partition the data for a class across multiple difference databases or across a database cluster such as Oracle RAC. Partitioning can provide improved scalability by allowing multiple database machines to service requests.

If multiple partitions are used to process a single transaction, JTA should be used for proper XA transaction support.

The value must be set to the name of an existing defined PartitioningPolicy.

See Also:

Partitioning, PartitioningPolicy, Constant Field Values

PARTITIONING_CALLBACK

public static final java.lang.String PARTITIONING_CALLBACK

"eclipselink.partitioning.callback"

Used to integrate with an external DataSource's data affinity support, such as UCP.

The value must be set to the full class name of the implementor of the DataPartitioningCallback interface.

i.e. "org.eclipse.persistence.platform.database.oracle.ucp.UCPDataPartitioningCallback".

See Also:

DataPartitioningCallback, Partitioning, PartitioningPolicy, Constant Field Values

JDBC_BIND_PARAMETERS

public static final java.lang.String JDBC_BIND_PARAMETERS

Property "eclipselink.jdbc.bind-parameters configures whether parameter binding will be used in the creation of JDBC prepared statements. Usage of parameter binding is generally a performance optimization allowing for SQL and prepared statement caching as well as usage of batch writing.

Values:

• "true" (DEFAULT): binding will be used
• "false": values will be written literally into the generated SQL

See Also:

Constant Field Values

EXCLUSIVE_CONNECTION_MODE

public static final java.lang.String EXCLUSIVE_CONNECTION_MODE

The "eclipselink.jdbc.exclusive-connection.mode" property specifies when reads are performed through the write connection. You can set this property while creating either an EntityManagerFactory (either in the map passed to the createEntityManagerFactory method, or in the persistence.xml file), or an EntityManager (in the map passed to the createEntityManager method). Note that the latter overrides the former.

Values:

• "Transactional" (DEFAULT): ExclusiveConnectionMode.Transactional
• "Isolated" - ExclusiveConnectionMode.Isolated
• "Always" - ExclusiveConnectionMode.Always

See Also:

ExclusiveConnectionMode, Constant Field Values

EXCLUSIVE_CONNECTION_IS_LAZY

public static final java.lang.String EXCLUSIVE_CONNECTION_IS_LAZY

The "eclipselink.jdbc.exclusive-connection.is-lazy" property specifies when write connection is acquired lazily.

Values:

• "false"
• "true" (DEFAULT)

See Also:

Constant Field Values

CACHE_STATEMENTS_SIZE

public static final java.lang.String CACHE_STATEMENTS_SIZE

The "eclipselink.jdbc.cache-statements.size" property specifies the number of statements held when using internal statement caching. The value must be a string value containing a positive integer or zero.

Default: "50".

See Also:

Constant Field Values

CACHE_STATEMENTS

public static final java.lang.String CACHE_STATEMENTS

The "eclipselink.jdbc.cache-statements" property specifies whether JDBC statements should be cached. This is recommended when using EclipseLink's internal connection pooling.

Valid values:

• true - enable internal statement caching.
• false - disable internal statement caching. (DEFAULT)

Example: persistence.xml file Example: property Map propertiesMap.put(PersistenceUnitProperties.CACHE_STATEMENTS, "false");

See Also:

Constant Field Values

VALIDATOR_FACTORY

public static final java.lang.String VALIDATOR_FACTORY

The "javax.persistence.validation.factory" property specifies an instance of javax.validation.ValidatorFactory used by EclipseLink to perform Automatic Validation upon Lifecycle Events. If the property is not specified, and if Bean Validation API is visible to Eclipselink, it will try to instantiate an instance of javax.validation.ValidationFactory by calling Validation.buildDefaultValidatorFactory()

See Also:

Constant Field Values

VALIDATION_MODE

public static final java.lang.String VALIDATION_MODE

The "javax.persistence.validation.mode" property specifies whether the automatic lifecycle event validation is in effect.

Valid values for this property are "AUTO", "CALLBACK" or "NONE".

See Also:

Constant Field Values

VALIDATION_GROUP_PRE_PERSIST

public static final java.lang.String VALIDATION_GROUP_PRE_PERSIST

The "javax.persistence.validation.group.pre-persist" property specifies the name of the validator groups to execute for preUpdate event. The value should be a string with fully qualified classnames separated by a comma (','). If this value is not specified in both persistence.xml or using this property, the default Bean Validation group (the group Default) will be validated

See Also:

Constant Field Values

VALIDATION_GROUP_PRE_UPDATE

public static final java.lang.String VALIDATION_GROUP_PRE_UPDATE

The "javax.persistence.validation.group.pre-update" property specifies the name of the validator groups to execute for preUpdate event. The value should be a string with fully qualified classnames separated by a comma (','). If this value is not specified in both persistence.xml or using this property, the default Bean Validation group (the group Default) will be validated

See Also:

Constant Field Values

VALIDATION_GROUP_PRE_REMOVE

public static final java.lang.String VALIDATION_GROUP_PRE_REMOVE

The "javax.persistence.validation.group.pre-remove" property specifies the name of the validator groups to execute for preRemove event. The value should be a string with fully qualified classnames separated by a comma (','). If this value is not specified in both persistence.xml or using this property, no validation will occur on remove.

See Also:

Constant Field Values

DEFAULT

public static final java.lang.String DEFAULT

Default Suffix could be appended to some prefixes to form a property name setting the default for the persistence unit.

See Also:

CACHE_SIZE_, CACHE_TYPE_, CACHE_SHARED_, Constant Field Values

CACHE_SIZE_

public static final java.lang.String CACHE_SIZE_

Property prefix "eclipselink.cache.size. used to specify the cache size for a specific entity type. The prefix must be followed by a valid entity type name.

Property names formed out of these prefixes by appending either entity name, or class name (indicating that the property values applies only to a particular entity) or DEFAULT suffix (indicating that the property value applies to all entities). For most cache types, the size is only the initial size, not a fixed or maximum size. For CacheType.SoftCache and CacheType.HardCache the size is the sub-cache size. The default cache size is 100.

See Also:

CACHE_SIZE_DEFAULT, Constant Field Values

CACHE_TYPE_

public static final java.lang.String CACHE_TYPE_

All valid values for CACHE_TYPE_ properties are declared in CacheType class. The default cache type is SoftWeak. This sets the type of cache, if you do not wish to cache entities at all, then set CACHE_SHARED_.

See Also:

CACHE_SHARED_, CacheType, CACHE_TYPE_DEFAULT, Constant Field Values

CACHE_SHARED_

public static final java.lang.String CACHE_SHARED_

Indicates whether entity's cache should be shared (non-isolated). Valid values are case-insensitive "false" and "true"; "true" is default. If you do not wish to cache your entities, set this to "false".

See Also:

CACHE_SHARED_DEFAULT, Constant Field Values

CACHE_SIZE_DEFAULT

public static final java.lang.String CACHE_SIZE_DEFAULT

Default caching properties - apply to all entities. May be overridden by individual entity property with the same prefix. For most cache types, the size is only the initial size, not a fixed or maximum size. For CacheType.SoftCache and CacheType.HardCache the size is the sub-cache size. The default cache size is 100.

See Also:

Constant Field Values

CACHE_TYPE_DEFAULT

public static final java.lang.String CACHE_TYPE_DEFAULT

Default caching properties - apply to all entities. May be overridden by individual entity property with the same prefix. The default cache type is SoftWeak. This sets the type of cache, if you do not wish to cache entities at all, then set CACHE_SHARED_DEFAULT.

See Also:

CACHE_SHARED_DEFAULT, Constant Field Values

CANONICAL_MODEL_PREFIX

public static final java.lang.String CANONICAL_MODEL_PREFIX

This optional property specifies the prefix that will be added to the start of the class name of any canonical model class generated. By default the prefix is not used.

See Also:

Constant Field Values

CANONICAL_MODEL_PREFIX_DEFAULT

public static java.lang.String CANONICAL_MODEL_PREFIX_DEFAULT

CANONICAL_MODEL_SUFFIX

public static final java.lang.String CANONICAL_MODEL_SUFFIX

This optional property specifies the suffix that will be added to the end of the class name of any canonical model class generated. The suffix defaults to "_" unless a prefix is specified. If this property is specified, the value must be a non-empty string that contains valid characters for use in a Java class name.

See Also:

Constant Field Values

CANONICAL_MODEL_SUFFIX_DEFAULT

public static java.lang.String CANONICAL_MODEL_SUFFIX_DEFAULT

CANONICAL_MODEL_SUB_PACKAGE

public static final java.lang.String CANONICAL_MODEL_SUB_PACKAGE

This optional property specifies a sub-package name that can be used to have the canonical model generator generate its classes in a sub-package of the package where the corresponding entity class is located. By default the canonical model classes are generated into the same package as the entity classes.

See Also:

Constant Field Values

CANONICAL_MODEL_SUB_PACKAGE_DEFAULT

public static java.lang.String CANONICAL_MODEL_SUB_PACKAGE_DEFAULT

CANONICAL_MODEL_LOAD_XML

public static final java.lang.String CANONICAL_MODEL_LOAD_XML

This optional property can be used a performance enhancement between compile rounds. It is used to avoid reloading XML metadata on each compile which may only contain a single class etc. The default value is true and should be left as such for the initial generation to capture the XML metadata. Afterwards users may choose to set this flag if no changes to XML are expected thereafter.

See Also:

Constant Field Values

CANONICAL_MODEL_LOAD_XML_DEFAULT

public static final java.lang.String CANONICAL_MODEL_LOAD_XML_DEFAULT

See Also:

Constant Field Values

CANONICAL_MODEL_USE_STATIC_FACTORY

public static final java.lang.String CANONICAL_MODEL_USE_STATIC_FACTORY

This optional property can be used a performance enhancement between compile rounds within an IDE. It is used to avoid using a static metadata factory between 'cache' metadata from incremental builds. Turning this off in some use cases (IDE) could result in a loss of functionality. The default value is true and should be left as such for full feature support.

See Also:

Constant Field Values

CANONICAL_MODEL_USE_STATIC_FACTORY_DEFAULT

public static final java.lang.String CANONICAL_MODEL_USE_STATIC_FACTORY_DEFAULT

See Also:

Constant Field Values

CACHE_SHARED_DEFAULT

public static final java.lang.String CACHE_SHARED_DEFAULT

Default caching properties - apply to all entities. May be overridden by individual entity property with the same prefix. If you do not wish to cache your entities, set this to "false".

See Also:

Constant Field Values

QUERY_CACHE

public static final java.lang.String QUERY_CACHE

Property prefix "eclipselink.cache.query-results used to configure the default option for query results caching.

The query results cache is separate from the object cache. It caches the results of named query execution. The query results cache is not enabled by default, and can be enabled per query. This option allows it to be enabled for all named queries. Valid values are "true" or "false" (default).

See Also:

Constant Field Values

DATABASE_EVENT_LISTENER

public static final java.lang.String DATABASE_EVENT_LISTENER

Allows integration with a database event notification service. This allows the EclipseLink cache to be invalidated by database change events. This is used to support Oracle QCN/DCN (Database Change event Notification), but could also be used by triggers or other services, or other types of events. Must be set to the name of a class that implements DatabaseEventListener, such as the OracleChangeNotificationListener (org.eclipse.persistence.platform.database.oracle.dcn.OracleChangeNotificationListener). The values of "DCN" and "QCN" may also be used for Oracle.

See Also:

DatabaseEventListener, org.eclipse.persistence.platform.database.oracle.dcn.OracleChangeNotificationListener, Constant Field Values

LOGGING_LOGGER

public static final java.lang.String LOGGING_LOGGER

The type of logger. By default DefaultSessionLog is used. Valid values are the logger class name which implements org.eclipse.persistence.logging.SessionLog or one of values defined in LoggerType.

See Also:

LoggerType, Constant Field Values

LOGGING_LEVEL

public static final java.lang.String LOGGING_LEVEL

Property "eclipselink.logging.level allows the default logging levels to be specified.

Java example: props.put(PersistenceUnitProperties.LOGGING_LEVEL, SessionLog.FINE_LABEL);


XML example: ;


Logging Levels:

See Also:

= "OFF", = "SEVERE", = "WARNING", = "CONFIG", = "INFO" (DEFAULT), = "FINE", = "FINER", = "FINEST", = "ALL", for category specific level configuration, Constant Field Values

CATEGORY_LOGGING_LEVEL_

public static final java.lang.String CATEGORY_LOGGING_LEVEL_

Property prefix "eclipselink.logging.level. allows the category specific logging levels to be specified.

Java example: props.put(PersistenceUnitProperties.CATEGORY_LOGGING_LEVEL_ + SessionLog.EJB_OR_METADATA, SessionLog.WARNING_LABEL);


XML example: ;
specific Valid values are names of levels defined in java.util.logging.Level, default value is INFO.

Categories:

See Also:

SessionLog.SQL, SessionLog.TRANSACTION, SessionLog.EVENT, SessionLog.CONNECTION, SessionLog.QUERY, SessionLog.CACHE, SessionLog.PROPAGATION, SessionLog.SEQUENCING, SessionLog.METADATA, SessionLog.METAMODEL, SessionLog.WEAVER, SessionLog.PROPERTIES, SessionLog.SERVER, Constant Field Values

LOGGING_PARAMETERS

public static final java.lang.String LOGGING_PARAMETERS

By default sql bind paramters are displayed in exceptions and logs when the log level is FINE or greater. To override this behavior you may set this property to specify that the data should or should not be visible. Note: this property applies only to bind parameters. When not using binding, the parameters are always displayed.

See Also:

JDBC_BIND_PARAMETERS, Constant Field Values

LOGGING_TIMESTAMP

public static final java.lang.String LOGGING_TIMESTAMP

The "eclipselink.logging.timestamp" property configures if the current timestamp should be included in each log message.

Values:

• "true" (Default)
• "false"

See Also:

Constant Field Values

MULTITENANT_PROPERTY_DEFAULT

public static final java.lang.String MULTITENANT_PROPERTY_DEFAULT

The "eclipselink.tenant-id" property specifies the default context property used to populate multitenant entities. NOTE: This is merely a default multitenant property than can be used on its own or with other properties defined by the user. Users are not obligated to use this property and are free to specify their own.

See Also:

Multitenant, Example: persistence.xml file Example: property Map propertiesMap.put(PersistenceUnitProperties.MULTITENANT_PROPERTY_DEFAULT, "Oracle"); , Constant Field Values

MULTITENANT_SHARED_CACHE

public static final java.lang.String MULTITENANT_SHARED_CACHE

Property "eclipselink.multitenant.tenants-share-cache specifies that multitenant entities will share the L2 cache. By default this property is false meaning multitenant entities will have an ISOLATED setting. When setting it to true a PROTECTED cache setting will be used. WARNING: Queries that use the cache may return data from other tenants when using the PROTECTED setting.

See Also:

Java example: props.put(PersistenceUnitProperties.MULTITENANT_SHARED_CACHE, true);


XML example: ;
, Constant Field Values

MULTITENANT_SHARED_EMF

public static final java.lang.String MULTITENANT_SHARED_EMF

Property "eclipselink.multitenant.shared-emf is used to indicate that multitenant entities will be used within a shared entity manager factory. This property defaults to true (and applies to multitenant entities only). When setting it to false, users are required to provide a unique session name.

See Also:

eclipselink.session-name,

Java example: props.put(PersistenceUnitProperties.MULTITENANT_SHARED_EMF, true);


XML example: ;
, Constant Field Values

LOGGING_THREAD

public static final java.lang.String LOGGING_THREAD

Property "eclipselink.logging.thread" indicating if current thread should have its identity included in each log message.

By default ("true") the thread is logged at FINE or less level. This can be turned off ("false") or on ("true"). Values:

• "true" (Default)
• "false"

See Also:

Constant Field Values

LOGGING_SESSION

public static final java.lang.String LOGGING_SESSION

Property "eclipselink.logging.session" indicating if the session in use should have its identity included in each log message.

Values:

• "true" (Default)
• "false"

See Also:

Constant Field Values

LOGGING_CONNECTION

public static final java.lang.String LOGGING_CONNECTION

Property: "eclipselink.logging.connection"

Values:

• "true" (Default)
• "false"

See Also:

Constant Field Values

LOGGING_EXCEPTIONS

public static final java.lang.String LOGGING_EXCEPTIONS

Values:

• "true" (Default)
• "false"

See Also:

Constant Field Values

LOGGING_FILE

public static final java.lang.String LOGGING_FILE

The "eclipselink.logging.file" property configures a file location where the log will be output to instead of standard out.

See Also:

Constant Field Values

TABLE_CREATION_SUFFIX

public static final java.lang.String TABLE_CREATION_SUFFIX

The "eclipselink.ddl.table-creation-suffix" property is used in conjunction with DDL generation options to append a string to the end of generated CREATE Table statements This value is applied to all Table creation statements through the DDL generation feature ie

See Also:

Constant Field Values

TARGET_DATABASE

public static final java.lang.String TARGET_DATABASE

The "eclipselink.target-database" property configures the database that will be used controlling custom operations and SQL generation for the specified database.

Values: Either a short string values as defined in TargetDatabase or a fully qualified class name for a class that extends DatabasePlatform. The default value is TargetDatabase.Auto which means EclipseLink will try to automatically determine the correct database platform type.

Note: "eclipselink.target-database" must be specified with a non-"Auto" class name or short name when "eclipselink.validation-only" is set to "True".

See Also:

TargetDatabase, DatabasePlatform, Constant Field Values

EXCLUDE_ECLIPSELINK_ORM_FILE

public static final java.lang.String EXCLUDE_ECLIPSELINK_ORM_FILE

The "eclipselink.exclude-eclipselink-orm" property configures the exclusion of an EclipseLink ORM mapping file for a specific persistence unit. By default the first file found at the resource name: "META-INF/eclipselink-orm.xml" is processed and overrides configurations specified in annotations, and standard mapping files.

See Also:

Constant Field Values

SESSION_NAME

public static final java.lang.String SESSION_NAME

The "eclipselink.session-name" property configures a specific name to use when storing the singleton server session within the SessionManager.

By default a unique session name is generated by EclipseLink, but the user can provide a customary session name - and make sure it's unique. If a sessions-xml file is used this must be the name of the session in the sessions-xml file.

See Also:

Constant Field Values

WEAVING

public static final java.lang.String WEAVING

The "eclipselink.weaving" property configures whether weaving should be performed. Weaving is requires for lazy OneToOne, ManyToOne, Basic, attribute change tracking, fetch groups, and other optimizations.

Values (case insensitive):

• Not Set - defaults to "true" in Java SE using javaagent and within EJB 3+ compliant containers
• "true" - requires that weaving be done. Will throw an exception if entities are not woven
• "false" - forces weaving not to be done
• "static" - requires that the static weaving utility was used to weave the entities

Note: Any value specified that is not in the above list is treated as "static".

See Also:

Constant Field Values

WEAVING_INTERNAL

public static final java.lang.String WEAVING_INTERNAL

The "eclipselink.weaving.internal" property indicates whether internal optimizations should be enabled through weaving. Internal optimizations include caching of primary key and session, addition of a serialVersionUID if none exists, optimization of EclipseLink's cloning strategy and optimization of the way EclipseLink gets and sets values from fields mapped as Basic.

This property will only be considered if weaving is enabled.

Values (case insensitive):

• "true" (DEFAULT)
• "false"

See Also:

WEAVING, Constant Field Values

WEAVING_LAZY

public static final java.lang.String WEAVING_LAZY

The "eclipselink.weaving.lazy" property configures whether LAZY OneToOne and ManyToOne mappings should be enabled through weaving.

This property will only be considered if weaving is enabled.

Values (case insensitive):

• "true" (DEFAULT)
• "false"

See Also:

WEAVING, Constant Field Values

WEAVING_EAGER

public static final java.lang.String WEAVING_EAGER

The "eclipselink.weaving.eager" property configures whether EAGER mapping's attributes should be woven to use indirection.

This property will only be considered if weaving is enabled.

Values (case insensitive):

• "true"
• "false" (DEFAULT)

See Also:

WEAVING, Constant Field Values

WEAVING_CHANGE_TRACKING

public static final java.lang.String WEAVING_CHANGE_TRACKING

The "eclipselink.weaving.changetracking" property configures whether AttributeLevelChangeTracking should be enabled through weaving. When this is enabled, only classes with all mappings allowing change tracking will have change tracking enabled. Mutable basic attributes will prevent this.

This property will only be considered if weaving is enabled.

Values (case insensitive):

• "true" (DEFAULT)
• "false"

See Also:

WEAVING, Constant Field Values

WEAVING_FETCHGROUPS

public static final java.lang.String WEAVING_FETCHGROUPS

The "eclipselink.weaving.fetchgroups" property configures whether FetchGroup support should be enabled through weaving. When this is enabled, lazy direct mappings will be supported as well as descriptor and query level FetchGroups. FetchGroups allow partial objects to be read and written, access to un-fetched attributes will cause the object to be refreshed/fully-fetched.

This property will only be considered if weaving is enabled.

Values (case insensitive):

• "true" (DEFAULT)
• "false"

See Also:

WEAVING, FetchGroupManager, FetchGroup, Constant Field Values

TARGET_SERVER

public static final java.lang.String TARGET_SERVER

The "eclipselink.target-server" property configures the ServerPlatform that will be used to enable integration with a host container.

Valid values are defined in TargetServer class - they correspond to server platforms currently supported. Also a custom server platform may be specified by supplying a full class name. Specifying a name of the class implementing ExternalTransactionController sets CustomServerPlatform with this controller. Default is TargetServer.None.

See Also:

TargetServer, Constant Field Values

SCHEMA_GENERATION_DATABASE_ACTION

public static final java.lang.String SCHEMA_GENERATION_DATABASE_ACTION

The "javax.persistence.schema-generation.database.action" property specifies the action to be taken by the persistence provider with regard to the database artifacts.

The values for this property are "none", "create", "drop-and-create", "drop".

If the "javax.persistence.schema-generation.database.action" property is not specified, no schema generation actions must be taken on the database.

See Also:

Constant Field Values

SCHEMA_GENERATION_SCRIPTS_ACTION

public static final java.lang.String SCHEMA_GENERATION_SCRIPTS_ACTION

The "javax.persistence.schema-generation.scripts.action" property specifies which scripts are to be generated by the persistence provider.

The values for this property are "none", "create", "drop-and-create", "drop".

Scripts will only be generated if script targets are specified. If this property is not specified, no scripts will be generated.

See Also:

Constant Field Values

SCHEMA_GENERATION_CREATE_SOURCE

public static final java.lang.String SCHEMA_GENERATION_CREATE_SOURCE

The "javax.persistence.schema-generation.create-source" property specifies whether the creation of database artifacts is to occur on the basis of the object/relational mapping metadata, DDL script, or a combination of the two.

The values for this property are "metadata", "script", "metadata-then-script", "script-then-metadata".

If this property is not specified, and a script is specified by the "javax.persistence.schema-generation.create-script-source property", the script (only) will be used for schema generation; otherwise if this property is not specified, schema generation will occur on the basis of the object/relational mapping metadata (only).

The "metadata-then-script" and "script-then-metadata" values specify that a combination of metadata and script is to be used and the order in which this use is to occur. If either of these values is specified and the resulting database actions are not disjoint, the results are undefined and schema generation may fail.

See Also:

Constant Field Values

SCHEMA_GENERATION_DROP_SOURCE

public static final java.lang.String SCHEMA_GENERATION_DROP_SOURCE

The "javax.persistence.schema-generation.drop-source" property specifies whether the dropping of database artifacts is to occur on the basis of the object/relational mapping metadata, DDL script, or a combination of the two.

The values for this property are "metadata", "script", "metadata-then-script", "script-then-metadata".

If this property is not specified, and a script is specified by the "javax.persistence.schema-generation.drop-script-source" property, the script (only) will be used for the dropping of database artifacts; otherwise if this property is not specified, the dropping of database artifacts will occur on the basis of the object/relational mapping metadata (only).

The "metadata-then-script" and "script-then-metadata" values specify that a combination of metadata and script is to be used and the order in which this use is to occur. If either of these values is specified and the resulting database actions are not disjoint, the results are undefined and the dropping of database artifacts may fail.

See Also:

Constant Field Values

SCHEMA_GENERATION_CREATE_DATABASE_SCHEMAS

public static final java.lang.String SCHEMA_GENERATION_CREATE_DATABASE_SCHEMAS

In Java EE environments, it is anticipated that the Java EE platform provider may wish to control the creation of database schemas rather than delegate this task to the persistence provider.

The "javax.persistence.schema-generation.create-database-schemas" property specifies whether the persistence provider is to create the database schema(s) in addition to creating database objects such as tables, sequences, constraints, etc.

The value of this boolean property should be set to true if the persistence provider is to create schemas in the database or to generate DDL that contains "CREATE SCHEMA" commands. If this property is not supplied, the provider should not attempt to create database schemas. This property may also be specified in Java SE environments.

See Also:

Constant Field Values

SCHEMA_GENERATION_SCRIPTS_CREATE_TARGET

public static final java.lang.String SCHEMA_GENERATION_SCRIPTS_CREATE_TARGET

If scripts are to be generated, the target locations for the writing of these scripts must be specified.

The "javax.persistence.schema-generation.scripts.create-target" property specifies a java.IO.Writer configured for use by the persistence provider for output of the DDL script or a string specifying the file URL for the DDL script. This property should only be specified if scripts are to be generated.

See Also:

Constant Field Values

SCHEMA_GENERATION_SCRIPTS_DROP_TARGET

public static final java.lang.String SCHEMA_GENERATION_SCRIPTS_DROP_TARGET

If scripts are to be generated, the target locations for the writing of these scripts must be specified.

The "javax.persistence.schema-generation.scripts.drop-target" property specifies a java.IO.Writer configured for use by the persistence provider for output of the DDL script or a string specifying the file URL for the DDL script. This property should only be specified if scripts are to be generated.

See Also:

Constant Field Values

SCHEMA_DATABASE_PRODUCT_NAME

public static final java.lang.String SCHEMA_DATABASE_PRODUCT_NAME

If scripts are to be generated by the persistence provider and a connection to the target database is not supplied, the "javax.persistence.database-product-name" property must be specified.

The value of this property should be the value returned for the target database by the JDBC DatabaseMetaData method getDatabaseProductName.

If sufficient database version information is not included in the result of this method, the "javax.persistence.database-major-version" and "javax.persistence.database-minor-version" properties should be specified as needed. These should contain the values returned by the JDBC getDatabaseMajorVersion and getDatabaseMinor-Version methods respectively.

See Also:

Constant Field Values

SCHEMA_DATABASE_MAJOR_VERSION

public static final java.lang.String SCHEMA_DATABASE_MAJOR_VERSION

If sufficient database version information is not included from the JDBC DatabaseMetaData method getDatabaseProductName, the "javax.persistence.database-major-version" property should be specified as needed. This should contain the value returned by the JDBC getDatabaseMajor-Version method.

See Also:

Constant Field Values

SCHEMA_DATABASE_MINOR_VERSION

public static final java.lang.String SCHEMA_DATABASE_MINOR_VERSION

If sufficient database version information is not included from the JDBC DatabaseMetaData method getDatabaseProductName, the "javax.persistence.database-minor-version" property should be specified as needed. This should contain the value returned by the JDBC getDatabaseMinor-Version method.

See Also:

Constant Field Values

SCHEMA_GENERATION_CREATE_SCRIPT_SOURCE

public static final java.lang.String SCHEMA_GENERATION_CREATE_SCRIPT_SOURCE

The "javax.persistence.schema-generation.create-script-source" is used for script execution.

In Java EE container environments, it is generally expected that the container will be responsible for executing DDL scripts, although the container is permitted to delegate this task to the persistence provider.

If DDL scripts are to be used in Java SE environments or if the Java EE container delegates the execution of scripts to the persistence provider, this property must be specified.

The "javax.persistence.schema-generation.create-script-source" property specifies a java.IO.Reader configured for reading of the DDL script or a string designating a file URL for the DDL script.

See Also:

Constant Field Values

SCHEMA_GENERATION_DROP_SCRIPT_SOURCE

public static final java.lang.String SCHEMA_GENERATION_DROP_SCRIPT_SOURCE

The "javax.persistence.schema-generation.drop-script-source" is used for script execution.

In Java EE container environments, it is generally expected that the container will be responsible for executing DDL scripts, although the container is permitted to delegate this task to the persistence provider.

If DDL scripts are to be used in Java SE environments or if the Java EE container delegates the execution of scripts to the persistence provider, this property must be specified.

The "javax.persistence.schema-generation.drop-script-source" property specifies a java.IO.Reader configured for reading of the DDL script or a string designating a file URL for the DDL script.

See Also:

Constant Field Values

SCHEMA_GENERATION_CONNECTION

public static final java.lang.String SCHEMA_GENERATION_CONNECTION

The "javax.persistence.schema-generation.connection" property specifies the JDBC connection to be used for schema generation. This is intended for use in Java EE environments, where the platform provider may want to control the database privileges that are available to the persistence provider.

This connection is provided by the container, and should be closed by the container when the schema generation request or entity manager factory creation completes.

The connection provided must have credentials sufficient for the persistence provider to carry out the requested actions.

If this property is not specified, the persistence provider should use the DataSource that has otherwise been provided.

See Also:

Constant Field Values

SCHEMA_GENERATION_SQL_LOAD_SCRIPT_SOURCE

public static final java.lang.String SCHEMA_GENERATION_SQL_LOAD_SCRIPT_SOURCE

In Java EE container environments, it is generally expected that the container will be responsible for executing data load scripts, although the container is permitted to delegate this task to the persistence provider. If a load script is to be used in Java SE environments or if the Java EE container delegates the execution of the load script to the persistence provider, this property must be specified.

The "javax.persistence.sql-load-script-source" property specifies a java.IO.Reader configured for reading of the SQL load script for database initialization or a string designating a file URL for the script.

See Also:

Constant Field Values

SCHEMA_GENERATION_CREATE_ACTION

public static final java.lang.String SCHEMA_GENERATION_CREATE_ACTION

The parameter value "create"

For use with the "javax.persistence.schema-generation.database.action" and "javax.persistence.schema-generation.scripts.action" properties.

Specifies that database tables should be created.

See Also:

Constant Field Values

SCHEMA_GENERATION_DROP_AND_CREATE_ACTION

public static final java.lang.String SCHEMA_GENERATION_DROP_AND_CREATE_ACTION

The parameter value "drop-and-create"

For use with the "javax.persistence.schema-generation.database.action" and "javax.persistence.schema-generation.scripts.action" properties.

Specifies that database tables should be dropped, then created.

See Also:

Constant Field Values

SCHEMA_GENERATION_DROP_ACTION

public static final java.lang.String SCHEMA_GENERATION_DROP_ACTION

The parameter value "drop"

For use with the "javax.persistence.schema-generation.database.action" and "javax.persistence.schema-generation.scripts.action" properties.

Specifies that database tables should be dropped.

See Also:

Constant Field Values

SCHEMA_GENERATION_NONE_ACTION

public static final java.lang.String SCHEMA_GENERATION_NONE_ACTION

The parameter value "none"

For use with the "javax.persistence.schema-generation.database.action" and "javax.persistence.schema-generation.scripts.action" properties.

Specifies that database tables should not be created or dropped.

See Also:

Constant Field Values

SCHEMA_GENERATION_METADATA_SOURCE

public static final java.lang.String SCHEMA_GENERATION_METADATA_SOURCE

The parameter value "metadata"

For use with the "javax.persistence.schema-generation.create-source" and "javax.persistence.schema-generation.drop-source" properties.

Specifies that DDL generation source will come from the metadata only.

See Also:

Constant Field Values

SCHEMA_GENERATION_SCRIPT_SOURCE

public static final java.lang.String SCHEMA_GENERATION_SCRIPT_SOURCE

The parameter value "script"

For use with the "javax.persistence.schema-generation.create-source" and "javax.persistence.schema-generation.drop-source" properties.

Specifies that DDL generation source will come from scripts only.

See Also:

Constant Field Values

SCHEMA_GENERATION_METADATA_THEN_SCRIPT_SOURCE

public static final java.lang.String SCHEMA_GENERATION_METADATA_THEN_SCRIPT_SOURCE

The parameter value "metadata-then-script"

For use with the "javax.persistence.schema-generation.create-source" and "javax.persistence.schema-generation.drop-source" properties.

Specifies that DDL generation source will come from the metadata first followed with the scripts.

See Also:

Constant Field Values

SCHEMA_GENERATION_SCRIPT_THEN_METADATA_SOURCE

public static final java.lang.String SCHEMA_GENERATION_SCRIPT_THEN_METADATA_SOURCE

The parameter value "script-then-metadata"

For use with the "javax.persistence.schema-generation.create-source" and "javax.persistence.schema-generation.drop-source" properties.

Specifies that DDL generation source will come from the scripts first followed with the metadata.

See Also:

Constant Field Values

SEQUENCING_SEQUENCE_DEFAULT

public static final java.lang.String SEQUENCING_SEQUENCE_DEFAULT

The "eclipselink.sequencing.default-sequence-to-table" property determines the default behavior when a GeneratedValue of type SEQUENCE is used on a database platform that does not support SEQUENCE generation. By default IDENTITY generation is used if supported. If this property is set to true, then TABLE sequencing will be used instead.

See Also:

Constant Field Values

SESSION_CUSTOMIZER

public static final java.lang.String SESSION_CUSTOMIZER

The "eclipselink.session.customizer" property configures a SessionCustomizer used to alter the runtime configuration through API.

The value is a full name for a class which implements SessionCustomizer. Session customizer called after all other properties have been processed.

See Also:

SessionCustomizer, Constant Field Values

DESCRIPTOR_CUSTOMIZER_

public static final java.lang.String DESCRIPTOR_CUSTOMIZER_

The "eclipselink.descriptor.customizer." is a prefix for a property used to configure a DescriptorCustomizer. Customization Prefix Property names formed out of this prefix by appending either entity name, or class name (indicating that the property values applies only to a particular entity) Allows descriptor customization.

The value is a full name for a class which implements DescriptorCustomizer. Only session customizer is called after processing these properties.

See Also:

DescriptorCustomizer, Constant Field Values

NATIVE_QUERY_UPPERCASE_COLUMNS

public static final java.lang.String NATIVE_QUERY_UPPERCASE_COLUMNS

The "eclipselink.jdbc.uppercase-columns" property configures native SQL queries are used, the JDBC meta-data may return column names in lower case on some platforms. If the column names are upper-case in the mappings (default) then they will not match. This setting allows for forcing the column names from the meta-data to upper-case.

This setting has been replaced by UPPERCASE_COLUMN_NAMES, which should be used instead, as it ensure both sides use upper case for comparisons.

See Also:

UPPERCASE_COLUMN_NAMES, Constant Field Values

UPPERCASE_COLUMN_NAMES

public static final java.lang.String UPPERCASE_COLUMN_NAMES

The "eclipselink.jpa.uppercase-column-names" property configures JPA processing to uppercase all column name definitions. A value of true also sets the "eclipselink.jdbc.uppercase-columns" property to true, so that JDBC meta-data returned from the database is also returned in uppercase, ensuring fields are the same case. This gets around situations where user defined fields do not match the case returned by the database for native queries, simulating case insensitivity.

Values (case insensitive):

• "true" (DEFAULT)
• "false"

See Also:

Constant Field Values

BATCH_WRITING

public static final java.lang.String BATCH_WRITING

The "eclipselink.jdbc.batch-writing" property configures the use of batch writing to optimize transactions with multiple writes.

Batch writing allows multiple heterogeneous dynamic SQL statements to be sent to the database as a single execution, or multiple homogeneous parameterized SQL statements to be executed as a single batch execution.

Note that not all JDBC drivers, or databases support batch writing.

Values (case insensitive):

• "JDBC": use JDBC batch writing.
• "Buffered": do not use either JDBC batch writing nor native platform batch writing.
• "Oracle-JDBC": use Oracle's native batch writing. This requires the use of an Oracle JDBC driver.
• <custom-class> - A custom class that extends the BatchWritingMechansim class.
• "None" (DEFAULT): do not use batch writing (turn it off).

See Also:

BatchWriting, BatchWritingMechanism, Constant Field Values

BATCH_WRITING_SIZE

public static final java.lang.String BATCH_WRITING_SIZE

The "eclipselink.jdbc.batch-writing.size" property configures the batch size used for batch writing. For parameterized batch writing this is the number of statements to batch, default 100. For dynamic batch writing, this is the size of the batched SQL buffer, default 32k.

See Also:

BATCH_WRITING, Constant Field Values

ECLIPSELINK_PERSISTENCE_XML

public static final java.lang.String ECLIPSELINK_PERSISTENCE_XML

The "eclipselink.persistencexml" property specifies the full resource name to look for the persistence XML files in. If not specified the default value defined by ECLIPSELINK_PERSISTENCE_XML_DEFAULT will be used.

IMPORTANT: For now this property is used for the canonical model generator but it can later be used as a system property for customizing weaving and application bootstrap usage.

This property is only used by EclipseLink when it is locating the configuration file. When used within an EJB/Spring container in container managed mode the locating and reading of this file is done by the container and will not use this configuration.

See Also:

Constant Field Values

ECLIPSELINK_PERSISTENCE_XML_DEFAULT

public static final java.lang.String ECLIPSELINK_PERSISTENCE_XML_DEFAULT

The default resource location used to locate the persistence.xml configuration files. Default: "META-INF/persistence.xml"

See Also:

Constant Field Values

ECLIPSELINK_PERSISTENCE_UNITS

public static final java.lang.String ECLIPSELINK_PERSISTENCE_UNITS

This "eclipselink.persistenceunits" property specifies the set of persistence unit names that will be processed when generating the canonical model. By default all persistence units available in all persistence XML files will be used. The value of this property is a comma separated list. When specifying multiple persistence units it is not possible to have persistence units with a comma in their name.

Note: In the future this property can also be used to limit the persistence units that will be processed by the static or dynamic weaving.

See Also:

Constant Field Values

EXCEPTION_HANDLER_CLASS

public static final java.lang.String EXCEPTION_HANDLER_CLASS

The "eclipselink.exception-handler" property allows an ExceptionHandler to be specified. An ExceptionHandler handles exceptions when they are thrown so that an application might address address expected failures and continue.

See Also:

ExceptionHandler, Constant Field Values

INCLUDE_DESCRIPTOR_QUERIES

public static final java.lang.String INCLUDE_DESCRIPTOR_QUERIES

The "eclipselink.session.include.descriptor.queries" property configures whether to enable the copying of all descriptor named queries to the session to be usable from the entity manager.

Default: "false".

See Also:

Constant Field Values

SESSION_EVENT_LISTENER_CLASS

public static final java.lang.String SESSION_EVENT_LISTENER_CLASS

The "eclipselink.session-event-listener" property configures a session event listener class.

See Also:

SessionEventListener, as a means to configure multiple listeners using API, Constant Field Values

SESSIONS_XML

public static final java.lang.String SESSIONS_XML

The "eclipselink.sessions-xml" property configures the use of the specified native sessions.xml configuration file. When specified this file will load all of the session configuration and mapping information from the native XML. No JPA annotations or XML will be used.

See Also:

Constant Field Values

PROJECT_CACHE

public static final java.lang.String PROJECT_CACHE

The "eclipselink.project-cache"property configures the type of ProjectCacheAccessor implementation to use to retrieve and store projects representing the metadata for the project

Values (case insensitive):

• "java-serialization": Use FileBasedProjectCache
• Custom ProjectCacheAccessor - Specify a custom class name which implements ProjectCacheAccessor

See Also:

ProjectCacheAccessor, Constant Field Values

PROJECT_CACHE_FILE

public static final java.lang.String PROJECT_CACHE_FILE

The property "eclipselink.project-cache.java-serialization.file"

Specifies the name of the file to read/write a serialized project representing the application's metadata

*

Specifies the name of the metadata repository xml file to read from using classloader to find the resource

This property should be used in conjunction with "eclipselink.project-cache" when a project is serialized to a file for caching.

See Also:

PROJECT_CACHE, Constant Field Values

TEMPORAL_MUTABLE

public static final java.lang.String TEMPORAL_MUTABLE

The "eclipselink.temporal.mutable" property configures the default for detecting changes to temporal field (Date, Calendar). Default "false" (changes to date object itself are not detected). By default it is assumed that temporal fields are replaced, and the temporal object not changed directly. Enabling mutable temporal fields will cause weaving of attribute change tracking to be disabled.

See Also:

Constant Field Values

ALLOW_NATIVE_SQL_QUERIES

public static final java.lang.String ALLOW_NATIVE_SQL_QUERIES

The "eclipselink.jdbc.allow-native-sql-queries" property specifies whether any user defined SQL is allowed within a persistence unit. This is of particular importance within a multitenant to minimize the potential impact of revealing multi tenant information. By default any persistence unit containing at least one multitenant entity will cause this flag to be set to 'false'.

Allowed Values (String):

• "true" - (DEFAULT) allow native SQL
• "false" - do not allow native SQL.

See Also:

Project.setAllowNativeSQLQueries(boolean), Constant Field Values

ALLOW_ZERO_ID

public static final java.lang.String ALLOW_ZERO_ID

Deprecated. replaced by ID_VALIDATION property with value "NULL".

The "eclipselink.allow-zero-id" property configures if zero is considered a valid id on a new entity. If the id is not considered valid and sequencing is enabled for the entity a new value will be assigned when it is persisted to the database (INSERT)By default an id value of 0 is assumed to be null/unassigned. This allows 0 to be a valid id value. This can also be set per class using the @PrimaryKey annotation and IdValidation.

Caution: This property configures the static singleton on Helper.isZeroValidPrimaryKey which will be shared by all concurrent uses of EclipseLink.

See Also:

PrimaryKey, IdValidation, ID_VALIDATION, Constant Field Values

ID_VALIDATION

public static final java.lang.String ID_VALIDATION

The "eclipselink.id-validation" property defines which primary key components values are considered invalid. These values will be also overridden by sequencing. Note that Identity always overrides any existing id value and so does any sequence with shouldAlwaysOverrideExistingValue flag set to true.

See Also:

PrimaryKey, IdValidation, Constant Field Values

FLUSH_CLEAR_CACHE

public static final java.lang.String FLUSH_CLEAR_CACHE

Defines EntityManager cache behavior after a call to flush method followed by a call to clear method. This property could be specified while creating either EntityManagerFactory (either in the map passed to createEntityManagerFactory method or in persistence.xml) or EntityManager (in the map passed to createEntityManager method); the latter overrides the former.

See Also:

FlushClearCache, Constant Field Values

CLASSLOADER

public static final java.lang.String CLASSLOADER

Specify the classloader to use to create an EntityManagerFactory in the property map passed to Persistence.createEntityManagerFactory.

See Also:

Constant Field Values

THROW_EXCEPTIONS

public static final java.lang.String THROW_EXCEPTIONS

Configures if the first exception that occurs during deployment should be thrown, or if all exceptions should be caught and summary thrown at end of deployment attempt. "true" by default.

See Also:

Constant Field Values

ORM_SCHEMA_VALIDATION

public static final java.lang.String ORM_SCHEMA_VALIDATION

This property set on the session is used to override orm.xml schema validation from its default of false.

See Also:

Constant Field Values

DEPLOY_ON_STARTUP

public static final java.lang.String DEPLOY_ON_STARTUP

The "eclipselink.deploy-on-startup" property controls whether EclipseLink creates the persistence unit when the application starts up, or when the persistence unit is first actually accessed by the application. Setting this to true causes the persistence unit to be created when the EntityManagerFactory is created, usually during deployment to a Java EE 7 container or servlet container. Enabling this option may increase startup time of the container/server, but will prevent the first request to the application from pausing while the persistence unit is deployed. When this property is set to false the persistence unit is not initialized until the first EntityManager is created or until metadata is requested from the EntityManagerFactory. When set to False, there is a known issue with Fields of static metamodel classes ("Entity_" classes) being null until the persistence unit is initialized. This behaviour won't affect applications unless they use the static metamodel feature. (See bug 383199)

Values: A boolean value of "True" or (default "False").

See Also:

Constant Field Values

VALIDATION_ONLY_PROPERTY

public static final java.lang.String VALIDATION_ONLY_PROPERTY

The "eclipselink.validation-only" property validates deployment which includes initializing descriptors but does not connect (no login to the database).

Values: A boolean value of "True" or (default "False").

Note: "eclipselink.target-database" must be specified with a non-"Auto" class name or short name when "eclipselink.validation-only" is set to "True".

See Also:

TargetDatabase, Constant Field Values

DDL_GENERATION

public static final java.lang.String DDL_GENERATION

Allows the database schema to be generated on deployment. Valid values, CREATE_ONLY, DROP_AND_CREATE, CREATE_OR_EXTEND, NONE ("create-tables", "drop-and-create-tables", "create-or-extend-tables", "none"). Default is NONE.

See Also:

Constant Field Values

CREATE_ONLY

public static final java.lang.String CREATE_ONLY

The parameter value "create-tables"

For use with the "eclipselink.ddl-generation" property.

Specifies that database tables should be created.

See Also:

DDL_GENERATION, Constant Field Values

DROP_ONLY

public static final java.lang.String DROP_ONLY

The parameter value "drop-tables"

For use with the "eclipselink.ddl-generation" property.

Specifies that database tables should be dropped only.

See Also:

DDL_GENERATION, Constant Field Values

DROP_AND_CREATE

public static final java.lang.String DROP_AND_CREATE

The parameter value "drop-and-create-tables"

For use with the "eclipselink.ddl-generation" property.

Specifies that database tables should be dropped, then created.

See Also:

DDL_GENERATION, Constant Field Values

CREATE_OR_EXTEND

public static final java.lang.String CREATE_OR_EXTEND

The parameter value "create-or-extend-tables"

For use with the "eclipselink.ddl-generation" property.

Specifies that database tables should be created and if existing, missing columns will be added.

This can only be used with eclipselink.ddl-generation.output-mode with value of "database".

See Also:

DDL_GENERATION, Constant Field Values

NONE

public static final java.lang.String NONE

The parameter value "none"

For use with the "eclipselink.ddl-generation" property, and is the default parameter value.

Specifies that database tables should not be created or dropped.

See Also:

DDL_GENERATION, Constant Field Values

METADATA_SOURCE

public static final java.lang.String METADATA_SOURCE

The "eclipselink.metadata-source"property configures the type of MetadataSource implementation to use to read Metadata

Values (case insensitive):

• "XML": Use XMLMetadataSource
• Custom MetadataSource - Specify a custom class name which implements MetadataSource

See Also:

MetadataSource, Constant Field Values

METADATA_SOURCE_RCM_COMMAND

public static final java.lang.String METADATA_SOURCE_RCM_COMMAND

the "eclipselink.metadata-source.send-refresh-command" property works with cache coordination for a clustered environment to. If cache coordination is configured and the session is deployed on startup, this property controls the sending of RCM refresh metadata commands to the cluster. These commands will cause the remote instances to refresh their metadata. Defaults to true

See Also:

COORDINATION_PROTOCOL, DEPLOY_ON_STARTUP, Constant Field Values

METADATA_SOURCE_XML_FILE

public static final java.lang.String METADATA_SOURCE_XML_FILE

The property "eclipselink.metadata-source.xml.file"

Specifies the name of the metadata repository xml file to read from using classloader to find the resource

This property should be used in conjunction with the "eclipselink.metadata-repository" when an XML repository is being used.

See Also:

METADATA_SOURCE, Constant Field Values

METADATA_SOURCE_XML_URL

public static final java.lang.String METADATA_SOURCE_XML_URL

The property "eclipselink.metadata-source.xml.URL"

Specifies the name of the metadata repository xml URL to read from.

This property should be used in conjunction with the "eclipselink.metadata-repository" when an XML repository is being used.

See Also:

METADATA_SOURCE, Constant Field Values

METADATA_SOURCE_PROPERTIES_FILE

public static final java.lang.String METADATA_SOURCE_PROPERTIES_FILE

The property "eclipselink.metadata-source.properties.file"

Specifies the name of the metadata repository properties file to read from using classloader to find the resource

See Also:

METADATA_SOURCE, Constant Field Values

APP_LOCATION

public static final java.lang.String APP_LOCATION

The property "eclipselink.application-location"

Specifies the file system directory location where DDL files are written (output) to.

This property should be used in conjunction with the "eclipselink.ddl-generation.output-mode" property, with a setting of "sql-script" (or "both") for DDL file(s) to be written.

See Also:

DEFAULT_APP_LOCATION, DDL_GENERATION_MODE, DDL_SQL_SCRIPT_GENERATION, DDL_BOTH_GENERATION, Constant Field Values

CREATE_JDBC_DDL_FILE

public static final java.lang.String CREATE_JDBC_DDL_FILE

The property "eclipselink.create-ddl-jdbc-file-name"

Specifies the name of the DDL file which is used to create database tables.

This property should be used in conjunction with the "eclipselink.application-location" property to specify a location on the file system for DDL file(s) to be written.

See Also:

APP_LOCATION, DEFAULT_CREATE_JDBC_FILE_NAME, Constant Field Values

DROP_JDBC_DDL_FILE

public static final java.lang.String DROP_JDBC_DDL_FILE

The property "eclipselink.drop-ddl-jdbc-file-name"

Specifies the name of the DDL file which is used to drop database tables.

This property should be used in conjunction with the "eclipselink.application-location" property to specify a location on the file system for DDL file(s) to be written.

See Also:

APP_LOCATION, DEFAULT_DROP_JDBC_FILE_NAME, Constant Field Values

DEFAULT_APP_LOCATION

public static final java.lang.String DEFAULT_APP_LOCATION

The default location in the file system to output DDL files. Defaults to: the working directory.

See Also:

APP_LOCATION

DEFAULT_CREATE_JDBC_FILE_NAME

public static final java.lang.String DEFAULT_CREATE_JDBC_FILE_NAME

The default name of the DDL file which is used to create database tables. Defaults to: createDDL.jdbc

See Also:

CREATE_JDBC_DDL_FILE, Constant Field Values

DEFAULT_DROP_JDBC_FILE_NAME

public static final java.lang.String DEFAULT_DROP_JDBC_FILE_NAME

The default name of the DDL file which is used to drop database tables. Defaults to: dropDDL.jdbc

See Also:

DROP_JDBC_DDL_FILE, Constant Field Values

JAVASE_DB_INTERACTION

public static final java.lang.String JAVASE_DB_INTERACTION

The system property INTERACT_WITH_DB

Specified to enable or disable the execution of DDL (configured with the eclipselink.ddl-generation property) against a database.

e.g. a command line setting of -DINTERACT_WITH_DB=false will not output DDL to the database.

Valid values:

true - output DDL to the database
false - do not output DDL to the database

See Also:

DDL_GENERATION, Constant Field Values

DDL_GENERATION_MODE

public static final java.lang.String DDL_GENERATION_MODE

Configures if database schema should be generated on the database, to a file, or both. Valid values, DDL_SQL_SCRIPT_GENERATION, DDL_DATABASE_GENERATION, DDL_BOTH_GENERATION ("sql-script", "database", "both") DDL_GENERATION must also be set, for this to have an effect. Default is DDL_DATABASE_GENERATION.

See Also:

DEFAULT_DDL_GENERATION_MODE, DDL_DATABASE_GENERATION, DDL_SQL_SCRIPT_GENERATION, DDL_BOTH_GENERATION, Constant Field Values

DDL_GENERATION_INDEX_FOREIGN_KEYS

public static final java.lang.String DDL_GENERATION_INDEX_FOREIGN_KEYS

The "eclipselink.ddl-generation.index-foreign-keys" property. Configures if an index should be automatically generated for foreign key constraints. It is normally recommended to have an index for a foreign key. By default indexes are not generated, most database also do not auto generate indexes, although some do. Values: "true" or "false" (default).

See Also:

DDL_GENERATION, Constant Field Values

DDL_SQL_SCRIPT_GENERATION

public static final java.lang.String DDL_SQL_SCRIPT_GENERATION

The parameter value "sql-script"

For use with the "eclipselink.ddl-generation.output-mode" property.

Specifies that DDL will be written to file(s).

See Also:

DDL_GENERATION_MODE, CREATE_JDBC_DDL_FILE, DROP_JDBC_DDL_FILE, Constant Field Values

DDL_DATABASE_GENERATION

public static final java.lang.String DDL_DATABASE_GENERATION

The parameter value "database"

For use with the "eclipselink.ddl-generation.output-mode" property, and is the default parameter value

Specifies that DDL will be written to the database.

See Also:

DDL_GENERATION_MODE, CREATE_JDBC_DDL_FILE, DROP_JDBC_DDL_FILE, Constant Field Values

DDL_BOTH_GENERATION

public static final java.lang.String DDL_BOTH_GENERATION

The parameter value "both"

For use with the "eclipselink.ddl-generation.output-mode" property.

Specifies that DDL will be written to file(s) and the database.

See Also:

DDL_GENERATION_MODE, CREATE_JDBC_DDL_FILE, DROP_JDBC_DDL_FILE, Constant Field Values

DEFAULT_DDL_GENERATION_MODE

public static final java.lang.String DEFAULT_DDL_GENERATION_MODE

The eclipselink.ddl-generation.output-mode parameter is configured to the default value of database.

See Also:

DDL_GENERATION_MODE, DDL_DATABASE_GENERATION, Constant Field Values

VALIDATE_EXISTENCE

public static final java.lang.String VALIDATE_EXISTENCE

The "eclipselink.validate-existence" property configures if the existence of an object should be verified on persist(), otherwise it will assume to be new if not in the persistence context. If checked and existing and not in the persistence context and error will be thrown. "false" by default.

See Also:

Constant Field Values

ORDER_UPDATES

public static final java.lang.String ORDER_UPDATES

Configures if updates should be ordered by primary key. This can be used to avoid possible database deadlocks from concurrent threads updating the same objects in a different order. If not set to true, the order of updates is not guaranteed. "true" by default.

See Also:

Constant Field Values

PROFILER

public static final java.lang.String PROFILER

The "eclipselink.profiler"property configures the type of profiler used to capture runtime statistics.

Values (case insensitive):

• "NoProfiler" (DEFAULT)
• "PerformanceMonitor": Use PerformanceMonitor
• "PerformanceProfiler": Use PerformanceProfiler
• "QueryMonitor": Use QueryMonitor
• "DMSProfiler": Use DMSPerformanceProfiler
• Custom profiler - Specify a custom profiler class name which implements SessionProfiler

See Also:

ProfilerType, Constant Field Values

TUNING

public static final java.lang.String TUNING

The "eclipselink.tuning"property configures the type of tuner to use to configure the persistence unit. A SessionTuner can be used to define a template for a persistence unit configuration. It allows a set of configuration values to be configured as a single tuning option.

Values (case insensitive):

• "Standard" (DEFAULT)
• "Safe": See SafeModeTuner
• Custom tuner - Specify a full class name of an implementation of SessionTuner

See Also:

TunerType, Constant Field Values

FREE_METADATA

public static final java.lang.String FREE_METADATA

The "eclipselink.memory.free-metadata"property configures the JPA internal deployment metadata to be released after deployment. This conserves memory, as the metadata is no longer required, but make future deployments of any other application take longer, as the metadata must be re-allocated.

Values (case insensitive):

• "true"
• "false" (DEFAULT)

See Also:

Constant Field Values

JOIN_EXISTING_TRANSACTION

public static final java.lang.String JOIN_EXISTING_TRANSACTION

The "eclipselink.transaction.join-existing" property Set to "true" this property forces persistence context to read through JTA-managed ("write") connection in case there is an active transaction.The property set in persistence.xml or passed to createEntityManagerFactory affects all EntityManagers created by the factory. Note that if the property set to "true" then objects read during transaction won't be placed into the shared cache unless they have been updated. Alternatively, to apply the property only to some EntityManagers pass it to createEntityManager method.

Values (caseinsensitive):

• "false" (DEFAULT):
• "true":

See Also:

Constant Field Values

PERSISTENCE_CONTEXT_REFERENCE_MODE

public static final java.lang.String PERSISTENCE_CONTEXT_REFERENCE_MODE

The "eclipselink.persistence-context.reference-mode" property configures whether there should be hard or soft references used within the Persistence Context. Default is "HARD". With soft references entities no longer referenced by the application may be garbage collected freeing resources. Any changes that have not been flushed in these entities will be lost. The property set in persistence.xml or passed to createEntityManagerFactory affects all EntityManagers created by the factory. Alternatively, to apply the property only to some SessionManagers pass it to createEntityManager method.

Values:

• "HARD" (DEFAULT) - {@link ReferenceMode#HARD
• "WEAK" - {@link ReferenceMode#WEAK
• "FORCE_WEAK" - {@link ReferenceMode#FORCE_WEAK

See Also:

ReferenceMode, Constant Field Values

PESSIMISTIC_LOCK_TIMEOUT

public static final java.lang.String PESSIMISTIC_LOCK_TIMEOUT

The "javax.persistence.lock.timeout" property configures the WAIT timeout used in pessimistic locking, if the database query exceeds the timeout the database will terminate the query and return an exception.

Valid values are Strings containing integers zero or greater.

See Also:

Constant Field Values

QUERY_TIMEOUT

public static final java.lang.String QUERY_TIMEOUT

The "javax.persistence.query.timeout" property configures the default query timeout value.

Valid values are strings containing integers zero or greater.

See Also:

Constant Field Values

PERSISTENCE_CONTEXT_CLOSE_ON_COMMIT

public static final java.lang.String PERSISTENCE_CONTEXT_CLOSE_ON_COMMIT

The "eclipselink.persistence-context.close-on-commit" property specifies that the EntityManager will be closed or not used after commit (not extended). In general this is normally always the case for a container managed EntityManager, and common for application managed. This can be used to avoid additional performance overhead of resuming the persistence context after a commit(). The property set in persistence.xml or passed to createEntityManagerFactory affects all EntityManagers created by the factory. Alternatively, to apply the property only to some EntityManagers pass it to createEntityManager method.

Values (case insensitive):

• "false" (DEFAULT)
• "true"

See Also:

Constant Field Values

PERSISTENCE_CONTEXT_PERSIST_ON_COMMIT

public static final java.lang.String PERSISTENCE_CONTEXT_PERSIST_ON_COMMIT

The "eclipselink.persistence-context.persist-on-commit" property specifies that the EntityManager will search all managed objects and persist any related non-managed new objects that are cascade persist. This can be used to avoid the cost of performing this search if persist is always used for new objects. The property set in persistence.xml or passed to createEntityManagerFactory affects all EntityManagers created by the factory. Alternatively, to apply the property only to some EntityManagers pass it to createEntityManager method.

Values (case insensitive):

• "true" (DEFAULT)
• "false"

See Also:

Constant Field Values

PERSISTENCE_CONTEXT_COMMIT_WITHOUT_PERSIST_RULES

public static final java.lang.String PERSISTENCE_CONTEXT_COMMIT_WITHOUT_PERSIST_RULES

The "eclipselink.persistence-context.commit-without-persist-rules" property specifies that the EntityManager will search all managed objects and persist any related non-managed new objects that are found ignoring any absence of CascadeType.PERSIST settings. Also the Entity life-cycle Persist operation will not be cascaded to related entities. This setting replicates the traditional EclipseLink native functionality.

Values (case insensitive):

• "false" (DEFAULT)
• "true"

See Also:

Constant Field Values

PERSISTENCE_CONTEXT_FLUSH_MODE

public static final java.lang.String PERSISTENCE_CONTEXT_FLUSH_MODE

The "eclipselink.persistence-context.flush-mode property configures the EntityManager FlushMode to be set as a persistence property. This can be set to either "AUTO" or "COMMIT". By default the flush mode is AUTO, which requires an automatic flush before all query execution. This can be used to avoid any flushing until commit. The property set in persistence.xml or passed to createEntityManagerFactory affects all EntityManagers created by the factory. Alternatively, to apply the property only to some EntityManagers pass it to createEntityManager method.

See Also:

EntityManager.setFlushMode(javax.persistence.FlushModeType), FlushModeType, Constant Field Values

ORACLE_PROXY_TYPE

public static final java.lang.String ORACLE_PROXY_TYPE

The "eclipselink.oracle.proxy-type" property is used to specify proxy type that should be passed to OracleConnection.openProxySession method. Requires Oracle JDBC version 10.1.0.2 or later. Requires Oracle9Platform or later as a database platform (TARGET_DATABASE property value should be TargetDatabase.Oracle9 or later).

Values:

• oracle.jdbc.OracleConnection.PROXYTYPE_USER_NAME,
• oracle.jdbc.OracleConnection.PROXYTYPE_DISTINGUISHED_NAME,
• oracle.jdbc.OracleConnection.PROXYTYPE_CERTIFICATE.

Property values corresponding to the specified type should be also provided:

• oracle.jdbc.OracleConnection.PROXY_USER_NAME,
• oracle.jdbc.OracleConnection.PROXY_DISTINGUISHED_NAME,
• oracle.jdbc.OracleConnection.PROXY_CERTIFICATE.

  Typically these properties should be set into EntityManager (either through createEntityManager method or using proprietary setProperties method on EntityManagerImpl) - that causes EntityManager to use proxy connection for writing and reading inside transaction. If proxy-type and the corresponding proxy property set into EntityManagerFactory then all connections created by the factory will be proxy connections.

See Also:

Constant Field Values

COORDINATION_PROTOCOL

public static final java.lang.String COORDINATION_PROTOCOL

The "eclipselink.cache.coordination.protocol" property configures cache coordination for a clustered environment. This needs to be set on every persistence unit/session in the cluster. Depending on the cache configuration for each descriptor, this will broadcast cache updates or inserts to the cluster to update or invalidate each session's cache.

Values:

• "jms"
• "jms-publishing"
• "rmi"
• "rmi-iiop"
• a name of a subclass implementation of the TransportManager abstract class.

by default the cache is not coordinated.

See Also:

CacheCoordinationProtocol, Cache.coordinationType(), RemoteCommandManager.setTransportManager(TransportManager), Constant Field Values

COORDINATION_JMS_HOST

public static final java.lang.String COORDINATION_JMS_HOST

The "eclipselink.cache.coordination.jms.host" property configures cache coordination for a clustered environment. Only used for JMS coordination. Sets the URL for the JMS server hosting the topic. This is not required in the topic is distributed across the cluster (can be looked up in local JNDI).

See Also:

COORDINATION_PROTOCOL, JMSPublishingTransportManager.setTopicHostUrl(String), Constant Field Values

COORDINATION_JMS_TOPIC

public static final java.lang.String COORDINATION_JMS_TOPIC

The "eclipselink.cache.coordination.jms.topic" property configures cache coordination for a clustered environment. Only used for JMS coordination. Sets the JMS topic name. The default topic JNDI name is "jms/EclipseLinkTopic".

See Also:

COORDINATION_PROTOCOL, BroadcastTransportManager.setTopicName(String), Constant Field Values

COORDINATION_JMS_FACTORY

public static final java.lang.String COORDINATION_JMS_FACTORY

The "eclipselink.cache.coordination.jms.factory" property configures cache coordination for a clustered environment. Only used for JMS coordination. Sets the JMS topic connection factory name. The default topic connection factory JNDI name is "jms/EclipseLinkTopicConnectionFactory".

See Also:

COORDINATION_PROTOCOL, org.eclipse.persistence.sessions.coordination.broadcast.BroadcastTransportManager#setTopicConnectionFactoryName(String), Constant Field Values

COORDINATION_JMS_REUSE_PUBLISHER

public static final java.lang.String COORDINATION_JMS_REUSE_PUBLISHER

The "eclipselink.cache.coordination.jms.reuse-topic-publisher" property configures cache coordination for a clustered environment. Only used for JMS coordination. Sets the JSM transport manager to cache a TopicPubliser and reuse it for all cache coordination publishing. Default value if unset is false.

See Also:

COORDINATION_PROTOCOL, JMSPublishingTransportManager.setShouldReuseJMSTopicPublisher(boolean), Constant Field Values

COORDINATION_RMI_ANNOUNCEMENT_DELAY

public static final java.lang.String COORDINATION_RMI_ANNOUNCEMENT_DELAY

The "eclipselink.cache.coordination.rmi.announcement-delay" property configures cache coordination for a clustered environment. Only used for RMI coordination. Sets the number of milliseconds to wait for announcements from other cluster members on startup. Default is 1000 milliseconds.

See Also:

COORDINATION_PROTOCOL, DiscoveryManager.setAnnouncementDelay(int), Constant Field Values

COORDINATION_RMI_MULTICAST_GROUP

public static final java.lang.String COORDINATION_RMI_MULTICAST_GROUP

The "eclipselink.cache.coordination.rmi.multicast-group" property configures cache coordination for a clustered environment. Only used for RMI coordination. Sets the multicast socket group address. The multicast group is used to find other members of the cluster. The default address is 239.192.0.0.

See Also:

COORDINATION_PROTOCOL, DiscoveryManager.setMulticastGroupAddress(String), Constant Field Values

COORDINATION_RMI_MULTICAST_GROUP_PORT

public static final java.lang.String COORDINATION_RMI_MULTICAST_GROUP_PORT

The "eclipselink.cache.coordination.rmi.multicast-group.port" property configures cache coordination for a clustered environment. Only used for RMI coordination. Sets the multicast socket group port. The multicast group port is used to find other members of the cluster. The default port is 3121.

See Also:

COORDINATION_PROTOCOL, DiscoveryManager.setMulticastPort(int), Constant Field Values

COORDINATION_RMI_PACKET_TIME_TO_LIVE

public static final java.lang.String COORDINATION_RMI_PACKET_TIME_TO_LIVE

The "eclipselink.cache.coordination.rmi.packet-time-to-live" property configures cache coordination for a clustered environment. Only used for RMI coordination. Sets the multicast socket packet time to live. The multicast group is used to find other members of the cluster. Set the number of hops the data packets of the session announcement will take before expiring. The default is 2, a hub and an interface card to prevent the data packets from leaving the local network. Note that if sessions are hosted on different LANs that are part of WAN, the announcement sending by one session may not reach other sessions. In this case, consult your network administrator for the right time-to-live value or test your network by increase the value until sessions receive announcement sent by others.

See Also:

COORDINATION_PROTOCOL, DiscoveryManager.setPacketTimeToLive(int), Constant Field Values

COORDINATION_RMI_URL

public static final java.lang.String COORDINATION_RMI_URL

The "eclipselink.cache.coordination.rmi.url" property configures cache coordination for a clustered environment. Only used for RMI coordination. Sets the URL of the host server. This is the URL that other cluster member should use to connect to this host. This may not be required in a clustered environment where JNDI is replicated. This can also be set as a System property or using a SessionCustomizer to avoid a separate persistence.xml per server.

See Also:

COORDINATION_PROTOCOL, RemoteCommandManager.setUrl(String), Constant Field Values

COORDINATION_NAMING_SERVICE

public static final java.lang.String COORDINATION_NAMING_SERVICE

The "eclipselink.cache.coordination.naming-service" property configures cache coordination for a clustered environment. Set the naming service to use, either "jndi" or "rmi".

See Also:

COORDINATION_PROTOCOL, TransportManager.setNamingServiceType(int), Constant Field Values

COORDINATION_JNDI_USER

public static final java.lang.String COORDINATION_JNDI_USER

the "eclipselink.cache.coordination.jndi.user" property configures cache coordination for a clustered environment. Set the JNDI naming service user name. This is not normally require if connecting to the local server.

See Also:

COORDINATION_PROTOCOL, TransportManager.setUserName(String), Constant Field Values

COORDINATION_JNDI_PASSWORD

public static final java.lang.String COORDINATION_JNDI_PASSWORD

The "eclipselink.cache.coordination.jndi.password" property configures cache coordination for a clustered environment. Set the JNDI naming service user name. This is not normally require if connecting to the local server.

See Also:

COORDINATION_PROTOCOL, TransportManager.setPassword(String), Constant Field Values

COORDINATION_JNDI_CONTEXT

public static final java.lang.String COORDINATION_JNDI_CONTEXT

The "eclipselink.cache.coordination.jndi.initial-context-factory" property configures cache coordination for a clustered environment. Set the JNDI InitialContext factory. This is not normally require if connecting to the local server.

See Also:

COORDINATION_PROTOCOL, TransportManager.setInitialContextFactoryName(String), Constant Field Values

COORDINATION_REMOVE_CONNECTION

public static final java.lang.String COORDINATION_REMOVE_CONNECTION

The "eclipselink.cache.coordination.remove-connection-on-error" property configures cache coordination for a clustered environment. Set if the connection should be removed if a communication error occurs when coordinating with it. This is normally used for RMI coordination in case a server goes down (it will reconnect when it comes back up).

See Also:

COORDINATION_PROTOCOL, TransportManager.setShouldRemoveConnectionOnError(boolean), Constant Field Values

COORDINATION_ASYNCH

public static final java.lang.String COORDINATION_ASYNCH

the "eclipselink.cache.coordination.propagate-asynchronously" property configures cache coordination for a clustered environment. Set if the coordination broadcast should occur asynchronously with the committing thread. This means the coordination will be complete before the thread returns from the commit of the transaction. Note that JMS is always asynchronous. By default RMI is asynchronous.

See Also:

COORDINATION_PROTOCOL, RemoteCommandManager.setShouldPropagateAsynchronously(boolean), Constant Field Values

COORDINATION_THREAD_POOL_SIZE

public static final java.lang.String COORDINATION_THREAD_POOL_SIZE

the "eclipselink.cache.coordination.thread.pool.size" property configures thread pool size for cache coordination threads. RMI cache coordination will spawn one thread per node to send change notifications. RMI also spawns a thread to listen for new node notifications. JMS cache coordination will spawn one thread to receive JMS change notification messages (unless MDB is used). JMS also spawns a thread to process the change notificaiton (unless MDB is used). The default size is 32 threads. A size of 0 indicates no thread pool should be used, and threads will be spawned when required.

See Also:

COORDINATION_PROTOCOL, ServerPlatformBase.setThreadPoolSize(int), Constant Field Values

COORDINATION_SERIALIZER

public static final java.lang.String COORDINATION_SERIALIZER

the "eclipselink.cache.coordination.serializer" property configures how cache coordination serializes message sent between nodes. By default Java serialization is used. Other serializer can be used for improved performance or integration with other systems. The full class name of the serializer class should be provided.

See Also:

COORDINATION_PROTOCOL, Serializer, RemoteCommandManager.setSerializer(Serializer), Constant Field Values

COORDINATION_CHANNEL

public static final java.lang.String COORDINATION_CHANNEL

the "eclipselink.cache.coordination.channel" property configures cache coordination for a clustered environment. Set the channel for this cluster. All server's in the same channel will be coordinated. The default channel name is "EclipseLinkCommandChannel". If multiple EclipseLink deployment reside on the same network, they should use different channels.

See Also:

COORDINATION_PROTOCOL, RemoteCommandManager.setChannel(String), Constant Field Values

COMPOSITE_UNIT

public static final java.lang.String COMPOSITE_UNIT

Indicates if it's a composite persistence unit ("true"). The property must be specified in persistence.xml of a composite persistence unit. The property passed to createEntityManagerFactory method or in system properties is ignored. Composite persistence unit would contain all persistence units found in jar files specified by elements in persistence.xml. member1.jar member2.jar

See Also:

COMPOSITE_UNIT_MEMBER, COMPOSITE_UNIT_PROPERTIES, Constant Field Values

COMPOSITE_UNIT_MEMBER

public static final java.lang.String COMPOSITE_UNIT_MEMBER

Indicates if the persistence unit must be a member of a composite persistence unit ("true"), can't be used as an independent persistence unit. That happens if persistence unit has dependencies on other persistence unit(s). The property may be specified in persistence.xml. The property passed to createEntityManagerFactory method or in system properties is ignored. If this property is set to true, EntityManagerFactory still could be created, but it can't be connected: an attempt to create entity manager would cause an exception.

See Also:

COMPOSITE_UNIT, COMPOSITE_UNIT_PROPERTIES, Constant Field Values

COMPOSITE_UNIT_PROPERTIES

public static final java.lang.String COMPOSITE_UNIT_PROPERTIES

The property may be passed to createEntityManagerFactory method of a composite persistence unit to pass properties to member persistence units. The value is a map: the key is a member persistence unit's name, the value is a map of properties to be passed to this persistence unit. "eclipselink.composite-unit.properties" -> ( ("memberPu1" -> ( "javax.persistence.jdbc.user" -> "user1", "javax.persistence.jdbc.password" -> "password1", "javax.persistence.jdbc.driver" -> "oracle.jdbc.OracleDriver", "javax.persistence.jdbc.url" -> "jdbc:oracle:thin:@oracle_db_url:1521:db", ) , ("memberPu2" -> ( "javax.persistence.jdbc.user" -> "user2", "javax.persistence.jdbc.password" -> "password2" "javax.persistence.jdbc.driver" -> "com.mysql.jdbc.Driver", "javax.persistence.jdbc.url" -> "jdbc:mysql://my_sql_db_url:3306/user2", ) )

See Also:

COMPOSITE_UNIT, Constant Field Values

REMOTE_PROTOCOL

public static final java.lang.String REMOTE_PROTOCOL

The "eclipselink.remote.protocol" property configures remote JPA for a client or server. This allows JPA to be access over RMI or other protocol from a remote Java client.

Values:

• "rmi"
• a name of a subclass implementation of the RemoteConnection abstract class.

See Also:

RemoteProtocol, RemoteConnection, RemoteSession, Constant Field Values

REMOTE_URL

public static final java.lang.String REMOTE_URL

The "eclipselink.remote.client.url" property configures remote JPA for a client. This allows JPA to be access over RMI or other protocol from a remote Java client. The URL is the complete URL used to access the RMI server.

See Also:

REMOTE_PROTOCOL, Constant Field Values

REMOTE_SERVER_NAME

public static final java.lang.String REMOTE_SERVER_NAME

The "eclipselink.remote.server.name" property configures remote JPA for a server. This allows JPA to be access over RMI or other protocol from a remote Java client. The name is the name the server will be registered under in the RMI registry.

See Also:

REMOTE_PROTOCOL, Constant Field Values

NOSQL_CONNECTION_SPEC

public static final java.lang.String NOSQL_CONNECTION_SPEC

The "eclipselink.nosql.connection-spec" property.
Allows the connection information for an NoSQL or EIS datasource to be specified. An NoSQL datasource is a non-relational datasource such as a legacy database, NoSQL database, XML database, transactional and messaging systems, or ERP systems.

See Also:

EISConnectionSpec, org.eclipse.persistence.annotations.NoSQL, Constant Field Values

NOSQL_CONNECTION_FACTORY

public static final java.lang.String NOSQL_CONNECTION_FACTORY

The "eclipselink.nosql.connection-factory" property.
Allows the JCA ConnectionFactory to be specified for a NoSQL or EIS adapter. An NoSQL datasource is a non-relational datasource such as a legacy database, NoSQL database, XML database, transactional and messaging systems, or ERP systems.

See Also:

ConnectionFactory, Constant Field Values

JDBC_CONNECTOR

public static final java.lang.String JDBC_CONNECTOR

The "eclipselink.jdbc.connector" property.
Allows a custom connector to be used to define how to connect to the database. This is not required if a DataSource or JDBC DriverManager is used. It can be used to connect to a non standard connection pool, or provide additional customization in how a connection is obtained.

See Also:

JNDIConnector, DefaultConnector, Constant Field Values

NOSQL_PROPERTY

public static final java.lang.String NOSQL_PROPERTY

Allows setting of NoSQL connection properties. The NoSQL specific property name should be appended to this prefix.

i.e.
"eclipselink.nosql.property.nosql.host"="localhost:5000"

See Also:

EISConnectionSpec, org.eclipse.persistence.annotations.NoSQL, Constant Field Values

NOSQL_USER

public static final java.lang.String NOSQL_USER

Allows setting of NoSQL user property. Note that "javax.persistence.jdbc.user" is also supported.

See Also:

EISConnectionSpec, org.eclipse.persistence.annotations.NoSQL, Constant Field Values

NOSQL_PASSWORD

public static final java.lang.String NOSQL_PASSWORD

Allows setting of NoSQL password property. Note that "javax.persistence.jdbc.password" is also supported.

See Also:

EISConnectionSpec, org.eclipse.persistence.annotations.NoSQL, Constant Field Values

JDBC_PROPERTY

public static final java.lang.String JDBC_PROPERTY

Allows passing of JDBC driver specific connection properties. This allows for properties to be set on the JDBC connection. The JDBC driver specific property name should be appended to this prefix.

i.e.
"eclipselink.jdbc.property.defaultRowPrefetch"="25"

See Also:

DatasourceLogin.setProperty(String, Object), Constant Field Values

JDBC_RESULT_SET_ACCESS_OPTIMIZATION

public static final java.lang.String JDBC_RESULT_SET_ACCESS_OPTIMIZATION

Allows to set whether a query should by default use ResultSet Access optimization. The optimization allows to avoid getting objects from ResultSet if the cached object used. For instance, SELECT id, blob FROM .. with optimization would extract only "id" from ResultSet, and if there is a corresponding cached object and it's not a refresh query, "blob" would never be extracted. The draw back is keeping ResultSet and connection longer: until objects are built (or extracted from cache) for all rows and all eager references (direct and nested) for each row. Note that the optimization would not be used if it contradicts other query settings.

Allowed Values (String):

• "true" - use optimization
• "false" don't use optimization

Default value is ObjectLevelReadQuery.isResultSetAccessOptimizedQueryDefault = false;

See Also:

AbstractSession.setShouldOptimizeResultSetAccess(boolean), ObjectLevelReadQuery.setIsResultSetAccessOptimizedQuery(boolean), Constant Field Values

SERIALIZER

public static final java.lang.String SERIALIZER

Specifies class name for session serializer (must implement org.eclipse.persistence.sessions.serializers.Serializer)

Default value is "org.eclipse.persistence.sessions.serializers.JavaSerializer"

See Also:

AbstractSession.setSerializer(Serializer), Constant Field Values

PROPERTY_LOG_OVERRIDES

public static final java.util.Map<java.lang.String,java.lang.String> PROPERTY_LOG_OVERRIDES

INTERNAL: The following properties will not be displayed through logging but instead have an alternate value shown in the log.

WEAVING_REST

public static final java.lang.String WEAVING_REST

The "eclipselink.weaving.rest" property configures whether classes will be weaved to support our JPA_RS functionality

This property will only be considered if weaving is enabled.

Values (case insensitive):

• "true" (DEFAULT)
• "false"

See Also:

Constant Field Values

Constructor Detail

PersistenceUnitProperties

public PersistenceUnitProperties()

Method Detail

getOverriddenLogStringForProperty

public static java.lang.String getOverriddenLogStringForProperty(java.lang.String propertyName)

INTERNAL: Return the overridden log string.

getSupportedNonServerSessionProperties

public static java.util.Set<java.lang.String> getSupportedNonServerSessionProperties()