5 Persistence Property Extensions Reference

This chapter describes the persistence property extensions.You configure persistence units in the JPA persistence descriptor file: persistence.xml. Oracle TopLink includes many persistence property enhancements and extensions that can be configured in the persistence.xml file.

This chapter includes the following sections:

• Functional Listing of Persistence Property Extensions

• Alphabetical Listing of Persistence Property Extensions

Functional Listing of Persistence Property Extensions

The following lists the Oracle TopLink persistence property (persistence.xml file) extensions, categorized by function:

• Weaving

• Customizers

• Validation and Optimization

• Caching

• Mapping

• Schema generation

• JDBC configuration

Weaving

TopLink includes the following persistence property extensions for weaving:

• weaving

• weaving.changetracking

• weaving.eager

• weaving.fetchgroups

• weaving.internal

• weaving.lazy

Customizers

TopLink includes the following persistence property extensions for customizing descriptors and sessions:

• deploy-on-startup

• descriptor.customizer

• session.customizer

• session.include.descriptor.queries

• session-event-listener

• session-name

• sessions-xml

• target-database

• target-server

• metadata-source

• metadata-source.properties.file

• metadata-source.send-refresh-command

• metadata-source.xml.url

Validation and Optimization

TopLink includes the following persistence property extensions for validation.

• exception-handler

• partitioning

• partitioning.callback

• profiler

Logging

TopLink includes the following persistence property extensions for logging.

• logging.connection

• logging.exceptions

• logging.file

• logging.level

• logging.session

• logging.thread

• logging.timestamp

Caching

TopLink includes the following persistence property extensions for caching:

• cache.coordination.channel

• cache.coordination.jms.factory

• cache.coordination.jms.host

• cache.coordination.jms.reuse-topic-publisher

• cache.coordination.jms.topic

• cache.coordination.jndi.initial-context-factory

• cache.coordination.jndi.password

• cache.coordination.jndi.user

• cache.coordination.naming-service

• cache.coordination.propagate-asynchronously

• cache.coordination.protocol

• cache.coordination.remove-connection-on-error

• cache.coordination.rmi.announcement-delay

• cache.coordination.rmi.multicast-group

• cache.coordination.rmi.multicast-group

• cache.coordination.rmi.packet-time-to-live

• cache.coordination.rmi.url

• cache.coordination.thread.pool.size

• cache.database-event-listener

• cache.shared

• cache.size

• cache.type

• flush-clear.cache

Mapping

TopLink includes the following persistence property extensions for mappings:

• composite-unit

• composite-unit.member

• composite-unit.properties

Schema generation

TopLink includes the following persistence property extensions for mappings:

• create-ddl-jdbc-file-name

• ddl.table-creation-suffix

• ddl-generation

• ddl-generation.output-mode

• drop-ddl-jdbc-file-name

JDBC configuration

TopLink includes the following persistence property extensions for configuring JDBC connections and connection pooling:

• connection-pool

• connection-pool.read

• connection-pool.sequence

• jdbc.allow-native-sql-queries

• jdbc.batch-writing

• jdbc.batch-writing.size

• jdbc.cache-statements

• jdbc.cache-statements.size

• jdbc.connector

• jdbc.exclusive-connection.is-lazy

• jdbc.exclusive-connection.mode

• jdbc.native-sql

• jdbc.property

• jdbc.sql-cast

• jdbc.uppercase-columns