blob: 3def9deb5326d78a3fd98d4d1fdb34b09c14c90f [file] [log] [blame]
<html><head>
<meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1">
<title>Part&nbsp;3.&nbsp;Reference Guide</title><link rel="stylesheet" href="css/docbook.css" type="text/css"><meta name="generator" content="DocBook XSL Stylesheets V1.72.0"><link rel="start" href="manual.html" title="Apache OpenJPA User's Guide"><link rel="up" href="manual.html" title="Apache OpenJPA User's Guide"><link rel="prev" href="jpa_overview_conclusion.html" title="Chapter&nbsp;13.&nbsp; Conclusion"><link rel="next" href="ref_guide_intro.html" title="Chapter&nbsp;1.&nbsp; Introduction"></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="navheader"><table width="100%" summary="Navigation header"><tr><th colspan="3" align="center">Part&nbsp;3.&nbsp;Reference Guide</th></tr><tr><td width="20%" align="left"><a accesskey="p" href="jpa_overview_conclusion.html">Prev</a>&nbsp;</td><th width="60%" align="center">&nbsp;</th><td width="20%" align="right">&nbsp;<a accesskey="n" href="ref_guide_intro.html">Next</a></td></tr></table><hr></div><div class="part" lang="en" id="ref_guide"><div class="titlepage"><div><div><h1 class="title"><a name="ref_guide"></a>Part&nbsp;3.&nbsp;Reference Guide</h1></div></div></div><div class="toc"><p><b>Table of Contents</b></p><dl><dt><span class="chapter"><a href="ref_guide_intro.html">1.
Introduction
</a></span></dt><dd><dl><dt><span class="section"><a href="ref_guide_intro.html#ref_guide_intro_audience">1.
Intended Audience
</a></span></dt></dl></dd><dt><span class="chapter"><a href="ref_guide_conf.html">2.
Configuration
</a></span></dt><dd><dl><dt><span class="section"><a href="ref_guide_conf.html#ref_guide_conf_intro">1.
Introduction
</a></span></dt><dt><span class="section"><a href="ref_guide_conf_specify.html">2.
Runtime Configuration
</a></span></dt><dt><span class="section"><a href="ref_guide_conf_devtools.html">3.
Command Line Configuration
</a></span></dt><dd><dl><dt><span class="section"><a href="ref_guide_conf_devtools.html#ref_guide_conf_devtools_format">3.1.
Code Formatting
</a></span></dt></dl></dd><dt><span class="section"><a href="ref_guide_conf_plugins.html">4.
Plugin Configuration
</a></span></dt><dt><span class="section"><a href="ref_guide_conf_openjpa.html">5.
OpenJPA Properties
</a></span></dt><dd><dl><dt><span class="section"><a href="ref_guide_conf_openjpa.html#openjpa.AutoClear">5.1.
openjpa.AutoClear
</a></span></dt><dt><span class="section"><a href="ref_guide_conf_openjpa.html#openjpa.AutoDetach">5.2.
openjpa.AutoDetach
</a></span></dt><dt><span class="section"><a href="ref_guide_conf_openjpa.html#openjpa.BrokerFactory">5.3.
openjpa.BrokerFactory
</a></span></dt><dt><span class="section"><a href="ref_guide_conf_openjpa.html#openjpa.BrokerImpl">5.4.
openjpa.BrokerImpl
</a></span></dt><dt><span class="section"><a href="ref_guide_conf_openjpa.html#openjpa.ClassResolver">5.5.
openjpa.ClassResolver
</a></span></dt><dt><span class="section"><a href="ref_guide_conf_openjpa.html#openjpa.Compatibility">5.6.
openjpa.Compatibility
</a></span></dt><dt><span class="section"><a href="ref_guide_conf_openjpa.html#openjpa.ConnectionDriverName">5.7.
openjpa.ConnectionDriverName
</a></span></dt><dt><span class="section"><a href="ref_guide_conf_openjpa.html#openjpa.Connection2DriverName">5.8.
openjpa.Connection2DriverName
</a></span></dt><dt><span class="section"><a href="ref_guide_conf_openjpa.html#openjpa.ConnectionFactory">5.9.
openjpa.ConnectionFactory
</a></span></dt><dt><span class="section"><a href="ref_guide_conf_openjpa.html#openjpa.ConnectionFactory2">5.10.
openjpa.ConnectionFactory2
</a></span></dt><dt><span class="section"><a href="ref_guide_conf_openjpa.html#openjpa.ConnectionFactoryName">5.11.
openjpa.ConnectionFactoryName
</a></span></dt><dt><span class="section"><a href="ref_guide_conf_openjpa.html#openjpa.ConnectionFactory2Name">5.12.
openjpa.ConnectionFactory2Name
</a></span></dt><dt><span class="section"><a href="ref_guide_conf_openjpa.html#openjpa.ConnectionFactoryMode">5.13.
openjpa.ConnectionFactoryMode
</a></span></dt><dt><span class="section"><a href="ref_guide_conf_openjpa.html#openjpa.ConnectionFactoryProperties">5.14.
openjpa.ConnectionFactoryProperties
</a></span></dt><dt><span class="section"><a href="ref_guide_conf_openjpa.html#openjpa.ConnectionFactory2Properties">5.15.
openjpa.ConnectionFactory2Properties
</a></span></dt><dt><span class="section"><a href="ref_guide_conf_openjpa.html#openjpa.ConnectionPassword">5.16.
openjpa.ConnectionPassword
</a></span></dt><dt><span class="section"><a href="ref_guide_conf_openjpa.html#openjpa.Connection2Password">5.17.
openjpa.Connection2Password
</a></span></dt><dt><span class="section"><a href="ref_guide_conf_openjpa.html#openjpa.ConnectionProperties">5.18.
openjpa.ConnectionProperties
</a></span></dt><dt><span class="section"><a href="ref_guide_conf_openjpa.html#openjpa.Connection2Properties">5.19.
openjpa.Connection2Properties
</a></span></dt><dt><span class="section"><a href="ref_guide_conf_openjpa.html#openjpa.ConnectionURL">5.20.
openjpa.ConnectionURL
</a></span></dt><dt><span class="section"><a href="ref_guide_conf_openjpa.html#openjpa.Connection2URL">5.21.
openjpa.Connection2URL
</a></span></dt><dt><span class="section"><a href="ref_guide_conf_openjpa.html#openjpa.ConnectionUserName">5.22.
openjpa.ConnectionUserName
</a></span></dt><dt><span class="section"><a href="ref_guide_conf_openjpa.html#openjpa.Connection2UserName">5.23.
openjpa.Connection2UserName
</a></span></dt><dt><span class="section"><a href="ref_guide_conf_openjpa.html#openjpa.ConnectionRetainMode">5.24.
openjpa.ConnectionRetainMode
</a></span></dt><dt><span class="section"><a href="ref_guide_conf_openjpa.html#openjpa.DataCache">5.25.
openjpa.DataCache
</a></span></dt><dt><span class="section"><a href="ref_guide_conf_openjpa.html#openjpa.DataCacheManager">5.26.
openjpa.DataCacheManager
</a></span></dt><dt><span class="section"><a href="ref_guide_conf_openjpa.html#openjpa.DataCacheTimeout">5.27.
openjpa.DataCacheTimeout
</a></span></dt><dt><span class="section"><a href="ref_guide_conf_openjpa.html#openjpa.DetachState">5.28.
openjpa.DetachState
</a></span></dt><dt><span class="section"><a href="ref_guide_conf_openjpa.html#openjpa.DynamicDataStructs">5.29.
openjpa.DynamicDataStructs
</a></span></dt><dt><span class="section"><a href="ref_guide_conf_openjpa.html#openjpa.FetchBatchSize">5.30.
openjpa.FetchBatchSize
</a></span></dt><dt><span class="section"><a href="ref_guide_conf_openjpa.html#openjpa.FetchGroups">5.31.
openjpa.FetchGroups
</a></span></dt><dt><span class="section"><a href="ref_guide_conf_openjpa.html#openjpa.FlushBeforeQueries">5.32.
openjpa.FlushBeforeQueries
</a></span></dt><dt><span class="section"><a href="ref_guide_conf_openjpa.html#openjpa.IgnoreChanges">5.33.
openjpa.IgnoreChanges
</a></span></dt><dt><span class="section"><a href="ref_guide_conf_openjpa.html#openjpa.Id">5.34. openjpa.Id</a></span></dt><dt><span class="section"><a href="ref_guide_conf_openjpa.html#openjpa.InverseManager">5.35.
openjpa.InverseManager
</a></span></dt><dt><span class="section"><a href="ref_guide_conf_openjpa.html#openjpa.LockManager">5.36.
openjpa.LockManager
</a></span></dt><dt><span class="section"><a href="ref_guide_conf_openjpa.html#openjpa.LockTimeout">5.37.
openjpa.LockTimeout
</a></span></dt><dt><span class="section"><a href="ref_guide_conf_openjpa.html#openjpa.Log">5.38.
openjpa.Log
</a></span></dt><dt><span class="section"><a href="ref_guide_conf_openjpa.html#openjpa.ManagedRuntime">5.39.
openjpa.ManagedRuntime
</a></span></dt><dt><span class="section"><a href="ref_guide_conf_openjpa.html#openjpa.Mapping">5.40.
openjpa.Mapping
</a></span></dt><dt><span class="section"><a href="ref_guide_conf_openjpa.html#openjpa.MaxFetchDepth">5.41.
openjpa.MaxFetchDepth
</a></span></dt><dt><span class="section"><a href="ref_guide_conf_openjpa.html#openjpa.MetaDataFactory">5.42.
openjpa.MetaDataFactory
</a></span></dt><dt><span class="section"><a href="ref_guide_conf_openjpa.html#openjpa.Multithreaded">5.43.
openjpa.Multithreaded
</a></span></dt><dt><span class="section"><a href="ref_guide_conf_openjpa.html#openjpa.Optimistic">5.44.
openjpa.Optimistic
</a></span></dt><dt><span class="section"><a href="ref_guide_conf_openjpa.html#openjpa.OrphanedKeyAction">5.45.
openjpa.OrphanedKeyAction
</a></span></dt><dt><span class="section"><a href="ref_guide_conf_openjpa.html#openjpa.NontransactionalRead">5.46.
openjpa.NontransactionalRead
</a></span></dt><dt><span class="section"><a href="ref_guide_conf_openjpa.html#openjpa.NontransactionalWrite">5.47.
openjpa.NontransactionalWrite
</a></span></dt><dt><span class="section"><a href="ref_guide_conf_openjpa.html#openjpa.ProxyManager">5.48.
openjpa.ProxyManager
</a></span></dt><dt><span class="section"><a href="ref_guide_conf_openjpa.html#openjpa.QueryCache">5.49.
openjpa.QueryCache
</a></span></dt><dt><span class="section"><a href="ref_guide_conf_openjpa.html#openjpa.QueryCompilationCache">5.50.
openjpa.QueryCompilationCache
</a></span></dt><dt><span class="section"><a href="ref_guide_conf_openjpa.html#openjpa.ReadLockLevel">5.51.
openjpa.ReadLockLevel
</a></span></dt><dt><span class="section"><a href="ref_guide_conf_openjpa.html#openjpa.RemoteCommitProvider">5.52.
openjpa.RemoteCommitProvider
</a></span></dt><dt><span class="section"><a href="ref_guide_conf_openjpa.html#openjpa.RestoreState">5.53.
openjpa.RestoreState
</a></span></dt><dt><span class="section"><a href="ref_guide_conf_openjpa.html#openjpa.RetainState">5.54.
openjpa.RetainState
</a></span></dt><dt><span class="section"><a href="ref_guide_conf_openjpa.html#openjpa.RetryClassRegistration">5.55.
openjpa.RetryClassRegistration
</a></span></dt><dt><span class="section"><a href="ref_guide_conf_openjpa.html#openjpa.RuntimeUnenhancedClasses">5.56. openjpa.RuntimeUnenhancedClasses</a></span></dt><dt><span class="section"><a href="ref_guide_conf_openjpa.html#openjpa.SavepointManager">5.57.
openjpa.SavepointManager
</a></span></dt><dt><span class="section"><a href="ref_guide_conf_openjpa.html#openjpa.Sequence">5.58.
openjpa.Sequence
</a></span></dt><dt><span class="section"><a href="ref_guide_conf_openjpa.html#openjpa.TransactionMode">5.59.
openjpa.TransactionMode
</a></span></dt><dt><span class="section"><a href="ref_guide_conf_openjpa.html#openjpa.WriteLockLevel">5.60.
openjpa.WriteLockLevel
</a></span></dt></dl></dd><dt><span class="section"><a href="ref_guide_conf_jdbc.html">6.
OpenJPA JDBC Properties
</a></span></dt><dd><dl><dt><span class="section"><a href="ref_guide_conf_jdbc.html#openjpa.jdbc.ConnectionDecorators">6.1.
openjpa.jdbc.ConnectionDecorators
</a></span></dt><dt><span class="section"><a href="ref_guide_conf_jdbc.html#openjpa.jdbc.DBDictionary">6.2.
openjpa.jdbc.DBDictionary
</a></span></dt><dt><span class="section"><a href="ref_guide_conf_jdbc.html#openjpa.jdbc.DriverDataSource">6.3.
openjpa.jdbc.DriverDataSource
</a></span></dt><dt><span class="section"><a href="ref_guide_conf_jdbc.html#openjpa.jdbc.EagerFetchMode">6.4.
openjpa.jdbc.EagerFetchMode
</a></span></dt><dt><span class="section"><a href="ref_guide_conf_jdbc.html#openjpa.jdbc.FetchDirection">6.5.
openjpa.jdbc.FetchDirection
</a></span></dt><dt><span class="section"><a href="ref_guide_conf_jdbc.html#openjpa.jdbc.JDBCListeners">6.6.
openjpa.jdbc.JDBCListeners
</a></span></dt><dt><span class="section"><a href="ref_guide_conf_jdbc.html#openjpa.jdbc.LRSSize">6.7.
openjpa.jdbc.LRSSize
</a></span></dt><dt><span class="section"><a href="ref_guide_conf_jdbc.html#openjpa.jdbc.MappingDefaults">6.8.
openjpa.jdbc.MappingDefaults
</a></span></dt><dt><span class="section"><a href="ref_guide_conf_jdbc.html#openjpa.jdbc.MappingFactory">6.9.
openjpa.jdbc.MappingFactory
</a></span></dt><dt><span class="section"><a href="ref_guide_conf_jdbc.html#openjpa.jdbc.ResultSetType">6.10.
openjpa.jdbc.ResultSetType
</a></span></dt><dt><span class="section"><a href="ref_guide_conf_jdbc.html#openjpa.jdbc.Schema">6.11.
openjpa.jdbc.Schema
</a></span></dt><dt><span class="section"><a href="ref_guide_conf_jdbc.html#openjpa.jdbc.SchemaFactory">6.12.
openjpa.jdbc.SchemaFactory
</a></span></dt><dt><span class="section"><a href="ref_guide_conf_jdbc.html#openjpa.jdbc.Schemas">6.13.
openjpa.jdbc.Schemas
</a></span></dt><dt><span class="section"><a href="ref_guide_conf_jdbc.html#openjpa.jdbc.SQLFactory">6.14.
openjpa.jdbc.SQLFactory
</a></span></dt><dt><span class="section"><a href="ref_guide_conf_jdbc.html#openjpa.jdbc.SubclassFetchMode">6.15.
openjpa.jdbc.SubclassFetchMode
</a></span></dt><dt><span class="section"><a href="ref_guide_conf_jdbc.html#openjpa.jdbc.SynchronizeMappings">6.16.
openjpa.jdbc.SynchronizeMappings
</a></span></dt><dt><span class="section"><a href="ref_guide_conf_jdbc.html#openjpa.jdbc.TransactionIsolation">6.17.
openjpa.jdbc.TransactionIsolation
</a></span></dt><dt><span class="section"><a href="ref_guide_conf_jdbc.html#openjpa.jdbc.UpdateManager">6.18.
openjpa.jdbc.UpdateManager
</a></span></dt></dl></dd></dl></dd><dt><span class="chapter"><a href="ref_guide_logging.html">3.
Logging
</a></span></dt><dd><dl><dt><span class="section"><a href="ref_guide_logging.html#ref_guide_logging_channels">1.
Logging Channels
</a></span></dt><dt><span class="section"><a href="ref_guide_logging_openjpa.html">2.
OpenJPA Logging
</a></span></dt><dt><span class="section"><a href="ref_guide_logging_noop.html">3.
Disabling Logging
</a></span></dt><dt><span class="section"><a href="ref_guide_logging_log4j.html">4.
Log4J
</a></span></dt><dt><span class="section"><a href="ref_guide_logging_commons.html">5.
Apache Commons Logging
</a></span></dt><dd><dl><dt><span class="section"><a href="ref_guide_logging_commons.html#ref_guide_logging_jdk14">5.1.
JDK 1.4 java.util.logging
</a></span></dt></dl></dd><dt><span class="section"><a href="ref_guide_logging_custom.html">6.
Custom Log
</a></span></dt></dl></dd><dt><span class="chapter"><a href="ref_guide_dbsetup.html">4.
JDBC
</a></span></dt><dd><dl><dt><span class="section"><a href="ref_guide_dbsetup.html#ref_guide_dbsetup_builtin">1.
Using the OpenJPA DataSource
</a></span></dt><dt><span class="section"><a href="ref_guide_dbsetup_thirdparty.html">2.
Using a Third-Party DataSource
</a></span></dt><dd><dl><dt><span class="section"><a href="ref_guide_dbsetup_thirdparty.html#ref_guide_dbsetup_thirdparty_enlist">2.1.
Managed and XA DataSources
</a></span></dt></dl></dd><dt><span class="section"><a href="ref_guide_dbsetup_sqlconn.html">3.
Runtime Access to DataSource
</a></span></dt><dt><span class="section"><a href="ref_guide_dbsetup_dbsupport.html">4.
Database Support
</a></span></dt><dd><dl><dt><span class="section"><a href="ref_guide_dbsetup_dbsupport.html#ref_guide_dbsetup_dbdictprops">4.1.
DBDictionary Properties
</a></span></dt><dt><span class="section"><a href="ref_guide_dbsetup_dbsupport.html#ref_guide_dbsetup_dbsupport_mysql">4.2.
MySQLDictionary Properties
</a></span></dt><dt><span class="section"><a href="ref_guide_dbsetup_dbsupport.html#ref_guide_dbsetup_dbsupport_oracle">4.3.
OracleDictionary Properties
</a></span></dt></dl></dd><dt><span class="section"><a href="ref_guide_dbsetup_isolation.html">5.
Setting the Transaction Isolation
</a></span></dt><dt><span class="section"><a href="ref_guide_dbsetup_sql92.html">6.
Setting the SQL Join Syntax
</a></span></dt><dt><span class="section"><a href="ref_guide_dbsetup_multidb.html">7.
Accessing Multiple Databases
</a></span></dt><dt><span class="section"><a href="ref_guide_dbsetup_retain.html">8.
Configuring the Use of JDBC Connections
</a></span></dt><dt><span class="section"><a href="ref_guide_dbsetup_lrs.html">9.
Large Result Sets
</a></span></dt><dt><span class="section"><a href="ref_guide_schema_def.html">10.
Default Schema
</a></span></dt><dt><span class="section"><a href="ref_guide_schema_info.html">11.
Schema Reflection
</a></span></dt><dd><dl><dt><span class="section"><a href="ref_guide_schema_info.html#ref_guide_schema_info_list">11.1.
Schemas List
</a></span></dt><dt><span class="section"><a href="ref_guide_schema_info.html#ref_guide_schema_info_factory">11.2.
Schema Factory
</a></span></dt></dl></dd><dt><span class="section"><a href="ref_guide_schema_schematool.html">12.
Schema Tool
</a></span></dt><dt><span class="section"><a href="ref_guide_schema_xml.html">13.
XML Schema Format
</a></span></dt></dl></dd><dt><span class="chapter"><a href="ref_guide_pc.html">5.
Persistent Classes
</a></span></dt><dd><dl><dt><span class="section"><a href="ref_guide_pc.html#ref_guide_pc_pcclasses">1.
Persistent Class List
</a></span></dt><dt><span class="section"><a href="ref_guide_pc_enhance.html">2.
Enhancement
</a></span></dt><dd><dl><dt><span class="section"><a href="ref_guide_pc_enhance.html#ref_guide_pc_enhance_build">2.1.
Enhancing at Build Time
</a></span></dt><dt><span class="section"><a href="ref_guide_pc_enhance.html#ref_guide_pc_enhance_runtime_container">2.2.
Enhancing JPA Entities on Deployment
</a></span></dt><dt><span class="section"><a href="ref_guide_pc_enhance.html#ref_guide_pc_enhance_runtime">2.3.
Enhancing at Runtime
</a></span></dt><dt><span class="section"><a href="ref_guide_pc_enhance.html#ref_guide_pc_enhance_unenhanced_types">2.4.
Omitting the OpenJPA enhancer
</a></span></dt></dl></dd><dt><span class="section"><a href="ref_guide_pc_oid.html">3.
Object Identity
</a></span></dt><dd><dl><dt><span class="section"><a href="ref_guide_pc_oid.html#ref_guide_pc_oid_datastore">3.1.
Datastore Identity
</a></span></dt><dt><span class="section"><a href="ref_guide_pc_oid.html#ref_guide_pc_oid_entitypk">3.2.
Entities as Identity Fields
</a></span></dt><dt><span class="section"><a href="ref_guide_pc_oid.html#ref_guide_pc_oid_application">3.3.
Application Identity Tool
</a></span></dt><dt><span class="section"><a href="ref_guide_pc_oid.html#ref_guide_pc_oid_pkgen_autoinc">3.4.
Autoassign / Identity Strategy Caveats
</a></span></dt></dl></dd><dt><span class="section"><a href="ref_guide_inverses.html">4.
Managed Inverses
</a></span></dt><dt><span class="section"><a href="ref_guide_pc_scos.html">5.
Persistent Fields
</a></span></dt><dd><dl><dt><span class="section"><a href="ref_guide_pc_scos.html#ref_guide_pc_scos_restore">5.1.
Restoring State
</a></span></dt><dt><span class="section"><a href="ref_guide_pc_scos.html#ref_guide_pc_scos_order">5.2.
Typing and Ordering
</a></span></dt><dt><span class="section"><a href="ref_guide_pc_scos.html#ref_guide_pc_calendar_timezone">5.3.
Calendar Fields and TimeZones
</a></span></dt><dt><span class="section"><a href="ref_guide_pc_scos.html#ref_guide_pc_scos_proxy">5.4.
Proxies
</a></span></dt><dd><dl><dt><span class="section"><a href="ref_guide_pc_scos.html#ref_guide_pc_scos_proxy_smart">5.4.1.
Smart Proxies
</a></span></dt><dt><span class="section"><a href="ref_guide_pc_scos.html#ref_guide_pc_scos_proxy_lrs">5.4.2.
Large Result Set Proxies
</a></span></dt><dt><span class="section"><a href="ref_guide_pc_scos.html#ref_guide_pc_scos_proxy_custom">5.4.3.
Custom Proxies
</a></span></dt></dl></dd><dt><span class="section"><a href="ref_guide_pc_scos.html#ref_guide_pc_extern">5.5.
Externalization
</a></span></dt><dd><dl><dt><span class="section"><a href="ref_guide_pc_scos.html#ref_guide_pc_extern_values">5.5.1.
External Values
</a></span></dt></dl></dd></dl></dd><dt><span class="section"><a href="ref_guide_fetch.html">6.
Fetch Groups
</a></span></dt><dd><dl><dt><span class="section"><a href="ref_guide_fetch.html#ref_guide_fetch_custom">6.1.
Custom Fetch Groups
</a></span></dt><dt><span class="section"><a href="ref_guide_fetch.html#ref_guide_fetch_conf">6.2.
Custom Fetch Group Configuration
</a></span></dt><dt><span class="section"><a href="ref_guide_fetch.html#ref_guide_fetch_single_field">6.3.
Per-field Fetch Configuration
</a></span></dt><dt><span class="section"><a href="ref_guide_fetch.html#ref_guide_fetch_impl">6.4.
Implementation Notes
</a></span></dt></dl></dd><dt><span class="section"><a href="ref_guide_perfpack_eager.html">7.
Eager Fetching
</a></span></dt><dd><dl><dt><span class="section"><a href="ref_guide_perfpack_eager.html#ref_guide_perfpack_eager_conf">7.1.
Configuring Eager Fetching
</a></span></dt><dt><span class="section"><a href="ref_guide_perfpack_eager.html#ref_guide_perfpack_eager_consider">7.2.
Eager Fetching Considerations and Limitations
</a></span></dt></dl></dd></dl></dd><dt><span class="chapter"><a href="ref_guide_meta.html">6.
Metadata
</a></span></dt><dd><dl><dt><span class="section"><a href="ref_guide_meta.html#ref_guide_meta_factory">1.
Metadata Factory
</a></span></dt><dt><span class="section"><a href="ref_guide_meta_jpa.html">2.
Additional JPA Metadata
</a></span></dt><dd><dl><dt><span class="section"><a href="ref_guide_meta_jpa.html#ref_guide_meta_jpa_datastoreid">2.1.
Datastore Identity
</a></span></dt><dt><span class="section"><a href="ref_guide_meta_jpa.html#ref_guide_meta_jpa_version">2.2.
Surrogate Version
</a></span></dt><dt><span class="section"><a href="ref_guide_meta_jpa.html#ref_guide_meta_jpa_persistent">2.3.
Persistent Field Values
</a></span></dt><dt><span class="section"><a href="ref_guide_meta_jpa.html#ref_guide_meta_jpa_persistent_coll">2.4. Persistent Collection Fields</a></span></dt><dt><span class="section"><a href="ref_guide_meta_jpa.html#ref_guide_meta_jpa_persistent_map">2.5. Persistent Map Fields</a></span></dt></dl></dd><dt><span class="section"><a href="ref_guide_meta_ext.html">3.
Metadata Extensions
</a></span></dt><dd><dl><dt><span class="section"><a href="ref_guide_meta_ext.html#ref_guide_meta_class">3.1.
Class Extensions
</a></span></dt><dd><dl><dt><span class="section"><a href="ref_guide_meta_ext.html#fetch-groups">3.1.1.
Fetch Groups
</a></span></dt><dt><span class="section"><a href="ref_guide_meta_ext.html#data-cache">3.1.2.
Data Cache
</a></span></dt><dt><span class="section"><a href="ref_guide_meta_ext.html#detached-state-field">3.1.3.
Detached State
</a></span></dt></dl></dd><dt><span class="section"><a href="ref_guide_meta_ext.html#ref_guide_meta_field">3.2.
Field Extensions
</a></span></dt><dd><dl><dt><span class="section"><a href="ref_guide_meta_ext.html#dependent">3.2.1.
Dependent
</a></span></dt><dt><span class="section"><a href="ref_guide_meta_ext.html#load-fetch-group">3.2.2.
Load Fetch Group
</a></span></dt><dt><span class="section"><a href="ref_guide_meta_ext.html#lrs">3.2.3.
LRS
</a></span></dt><dt><span class="section"><a href="ref_guide_meta_ext.html#inverse-logical">3.2.4.
Inverse-Logical
</a></span></dt><dt><span class="section"><a href="ref_guide_meta_ext.html#read-only">3.2.5.
Read-Only
</a></span></dt><dt><span class="section"><a href="ref_guide_meta_ext.html#type">3.2.6.
Type
</a></span></dt><dt><span class="section"><a href="ref_guide_meta_ext.html#externalizer">3.2.7.
Externalizer
</a></span></dt><dt><span class="section"><a href="ref_guide_meta_ext.html#factory">3.2.8.
Factory
</a></span></dt><dt><span class="section"><a href="ref_guide_meta_ext.html#external-values">3.2.9.
External Values
</a></span></dt></dl></dd><dt><span class="section"><a href="ref_guide_meta_ext.html#ref_guide_meta_example">3.3.
Example
</a></span></dt></dl></dd></dl></dd><dt><span class="chapter"><a href="ref_guide_mapping.html">7.
Mapping
</a></span></dt><dd><dl><dt><span class="section"><a href="ref_guide_mapping.html#ref_guide_mapping_mappingtool">1.
Forward Mapping
</a></span></dt><dd><dl><dt><span class="section"><a href="ref_guide_mapping.html#ref_guide_mapping_mappingtool_examples">1.1.
Using the Mapping Tool
</a></span></dt><dt><span class="section"><a href="ref_guide_mapping.html#ref_guide_ddl_examples">1.2.
Generating DDL SQL
</a></span></dt><dt><span class="section"><a href="ref_guide_mapping.html#ref_guide_mapping_synch">1.3.
Runtime Forward Mapping
</a></span></dt></dl></dd><dt><span class="section"><a href="ref_guide_pc_reverse.html">2.
Reverse Mapping
</a></span></dt><dd><dl><dt><span class="section"><a href="ref_guide_pc_reverse.html#ref_guide_pc_reverse_custom">2.1.
Customizing Reverse Mapping
</a></span></dt></dl></dd><dt><span class="section"><a href="ref_guide_mapping_middle.html">3.
Meet-in-the-Middle Mapping
</a></span></dt><dt><span class="section"><a href="ref_guide_mapping_defaults.html">4.
Mapping Defaults
</a></span></dt><dt><span class="section"><a href="ref_guide_mapping_factory.html">5.
Mapping Factory
</a></span></dt><dt><span class="section"><a href="ref_guide_mapping_notes_nonstdjoins.html">6.
Non-Standard Joins
</a></span></dt><dt><span class="section"><a href="ref_guide_mapping_jpa.html">7.
Additional JPA Mappings
</a></span></dt><dd><dl><dt><span class="section"><a href="ref_guide_mapping_jpa.html#ref_guide_mapping_jpa_datastoreid">7.1.
Datastore Identity Mapping
</a></span></dt><dt><span class="section"><a href="ref_guide_mapping_jpa.html#ref_guide_mapping_jpa_version">7.2.
Surrogate Version Mapping
</a></span></dt><dt><span class="section"><a href="ref_guide_mapping_jpa.html#ref_guide_mapping_jpa_columns">7.3.
Multi-Column Mappings
</a></span></dt><dt><span class="section"><a href="ref_guide_mapping_jpa.html#ref_guide_mapping_jpa_fieldjoin">7.4.
Join Column Attribute Targets
</a></span></dt><dt><span class="section"><a href="ref_guide_mapping_jpa.html#ref_guide_mapping_jpa_embed">7.5.
Embedded Mapping
</a></span></dt><dt><span class="section"><a href="ref_guide_mapping_jpa.html#ref_guide_mapping_jpa_coll">7.6.
Collections
</a></span></dt><dd><dl><dt><span class="section"><a href="ref_guide_mapping_jpa.html#ref_guide_mapping_jpa_coll_table">7.6.1.
Container Table
</a></span></dt><dt><span class="section"><a href="ref_guide_mapping_jpa.html#ref_guide_mapping_jpa_coll_joincols">7.6.2.
Element Join Columns
</a></span></dt><dt><span class="section"><a href="ref_guide_mapping_jpa.html#ref_guide_mapping_jpa_coll_order">7.6.3.
Order Column
</a></span></dt></dl></dd><dt><span class="section"><a href="ref_guide_mapping_jpa.html#ref_guide_mapping_jpa_onemany">7.7.
One-Sided One-Many Mapping
</a></span></dt><dt><span class="section"><a href="ref_guide_mapping_jpa.html#ref_guide_mapping_jpa_map">7.8.
Maps
</a></span></dt><dt><span class="section"><a href="ref_guide_mapping_jpa.html#ref_guide_mapping_jpa_constraints">7.9.
Indexes and Constraints
</a></span></dt><dd><dl><dt><span class="section"><a href="ref_guide_mapping_jpa.html#ref_guide_mapping_jpa_index">7.9.1.
Indexes
</a></span></dt><dt><span class="section"><a href="ref_guide_mapping_jpa.html#ref_guide_mapping_jpa_fk">7.9.2.
Foreign Keys
</a></span></dt><dt><span class="section"><a href="ref_guide_mapping_jpa.html#ref_guide_mapping_jpa_unique">7.9.3.
Unique Constraints
</a></span></dt></dl></dd><dt><span class="section"><a href="ref_guide_mapping_jpa.html#ref_guide_xmlmapping">7.10.
XML Column Mapping
</a></span></dt></dl></dd><dt><span class="section"><a href="ref_guide_mapping_limits.html">8.
Mapping Limitations
</a></span></dt><dd><dl><dt><span class="section"><a href="ref_guide_mapping_limits.html#ref_guide_mapping_limits_tpc">8.1.
Table Per Class
</a></span></dt></dl></dd><dt><span class="section"><a href="ref_guide_mapping_ext.html">9.
Mapping Extensions
</a></span></dt><dd><dl><dt><span class="section"><a href="ref_guide_mapping_ext.html#ref_guide_mapping_ext_cls">9.1.
Class Extensions
</a></span></dt><dd><dl><dt><span class="section"><a href="ref_guide_mapping_ext.html#subclass-fetch-mode">9.1.1.
Subclass Fetch Mode
</a></span></dt><dt><span class="section"><a href="ref_guide_mapping_ext.html#class-strategy">9.1.2.
Strategy
</a></span></dt><dt><span class="section"><a href="ref_guide_mapping_ext.html#discriminator-strategy">9.1.3.
Discriminator Strategy
</a></span></dt><dt><span class="section"><a href="ref_guide_mapping_ext.html#version-strategy">9.1.4.
Version Strategy
</a></span></dt></dl></dd><dt><span class="section"><a href="ref_guide_mapping_ext.html#ref_guide_mapping_ext_field">9.2.
Field Extensions
</a></span></dt><dd><dl><dt><span class="section"><a href="ref_guide_mapping_ext.html#eager-fetch-mode">9.2.1.
Eager Fetch Mode
</a></span></dt><dt><span class="section"><a href="ref_guide_mapping_ext.html#nonpolymorphic">9.2.2.
Nonpolymorphic
</a></span></dt><dt><span class="section"><a href="ref_guide_mapping_ext.html#class-criteria">9.2.3.
Class Criteria
</a></span></dt><dt><span class="section"><a href="ref_guide_mapping_ext.html#strategy">9.2.4.
Strategy
</a></span></dt></dl></dd></dl></dd><dt><span class="section"><a href="ref_guide_mapping_custom.html">10.
Custom Mappings
</a></span></dt><dd><dl><dt><span class="section"><a href="ref_guide_mapping_custom.html#ref_guide_mapping_custom_class">10.1.
Custom Class Mapping
</a></span></dt><dt><span class="section"><a href="ref_guide_mapping_custom.html#ref_guide_mapping_custom_versdiscrim">10.2.
Custom Discriminator and Version Strategies
</a></span></dt><dt><span class="section"><a href="ref_guide_mapping_custom.html#ref_guide_mapping_custom_field">10.3.
Custom Field Mapping
</a></span></dt><dd><dl><dt><span class="section"><a href="ref_guide_mapping_custom.html#ref_guide_mapping_custom_vhandler">10.3.1.
Value Handlers
</a></span></dt><dt><span class="section"><a href="ref_guide_mapping_custom.html#ref_guide_mapping_custom_fieldstrat">10.3.2.
Field Strategies
</a></span></dt><dt><span class="section"><a href="ref_guide_mapping_custom.html#ref_guide_mapping_custom_field_conf">10.3.3.
Configuration
</a></span></dt></dl></dd></dl></dd><dt><span class="section"><a href="ref_guide_orphan.html">11.
Orphaned Keys
</a></span></dt></dl></dd><dt><span class="chapter"><a href="ref_guide_deploy.html">8.
Deployment
</a></span></dt><dd><dl><dt><span class="section"><a href="ref_guide_deploy.html#ref_guide_deploy_factory">1.
Factory Deployment
</a></span></dt><dd><dl><dt><span class="section"><a href="ref_guide_deploy.html#ref_guide_deploy_factory_standalone">1.1.
Standalone Deployment
</a></span></dt><dt><span class="section"><a href="ref_guide_deploy.html#ref_guide_deploy_inject">1.2.
EntityManager Injection
</a></span></dt></dl></dd><dt><span class="section"><a href="ref_guide_enterprise_trans.html">2.
Integrating with the Transaction Manager
</a></span></dt><dt><span class="section"><a href="ref_guide_enterprise_xa.html">3.
XA Transactions
</a></span></dt><dd><dl><dt><span class="section"><a href="ref_guide_enterprise_xa.html#ref_guide_enterprise_xa_req">3.1.
Using OpenJPA with XA Transactions
</a></span></dt></dl></dd></dl></dd><dt><span class="chapter"><a href="ref_guide_runtime.html">9.
Runtime Extensions
</a></span></dt><dd><dl><dt><span class="section"><a href="ref_guide_runtime.html#ref_guide_runtime_arch">1.
Architecture
</a></span></dt><dd><dl><dt><span class="section"><a href="ref_guide_runtime.html#ref_guide_runtime_broker_finalization">1.1.
Broker Finalization
</a></span></dt><dt><span class="section"><a href="ref_guide_runtime.html#ref_guide_runtime_broker_extension">1.2.
Broker Customization and Finalization
</a></span></dt></dl></dd><dt><span class="section"><a href="ref_guide_runtime_jpa.html">2.
JPA Extensions
</a></span></dt><dd><dl><dt><span class="section"><a href="ref_guide_runtime_jpa.html#ref_guide_runtime_emfactory">2.1.
OpenJPAEntityManagerFactory
</a></span></dt><dt><span class="section"><a href="ref_guide_runtime_jpa.html#ref_guide_runtime_em">2.2.
OpenJPAEntityManager
</a></span></dt><dt><span class="section"><a href="ref_guide_runtime_jpa.html#ref_guide_runtime_jpaquery">2.3.
OpenJPAQuery
</a></span></dt><dt><span class="section"><a href="ref_guide_runtime_jpa.html#ref_guide_runtime_jpaextent">2.4.
Extent
</a></span></dt><dt><span class="section"><a href="ref_guide_runtime_jpa.html#ref_guide_runtime_jpacache">2.5.
StoreCache
</a></span></dt><dt><span class="section"><a href="ref_guide_runtime_jpa.html#ref_guide_runtime_jpaquerycache">2.6.
QueryResultCache
</a></span></dt><dt><span class="section"><a href="ref_guide_runtime_jpa.html#ref_guide_runtime_jpafetch">2.7.
FetchPlan
</a></span></dt><dt><span class="section"><a href="ref_guide_runtime_jpa.html#ref_guide_runtime_openjpapersistence">2.8.
OpenJPAPersistence
</a></span></dt></dl></dd><dt><span class="section"><a href="ref_guide_locking.html">3.
Object Locking
</a></span></dt><dd><dl><dt><span class="section"><a href="ref_guide_locking.html#ref_guide_locking_default">3.1.
Configuring Default Locking
</a></span></dt><dt><span class="section"><a href="ref_guide_locking.html#ref_guide_locking_runtime">3.2.
Configuring Lock Levels at Runtime
</a></span></dt><dt><span class="section"><a href="ref_guide_locking.html#ref_guide_locking_apis">3.3.
Object Locking APIs
</a></span></dt><dt><span class="section"><a href="ref_guide_locking.html#ref_guide_locking_lockmgr">3.4.
Lock Manager
</a></span></dt><dt><span class="section"><a href="ref_guide_locking.html#ref_guide_locking_rules">3.5.
Rules for Locking Behavior
</a></span></dt><dt><span class="section"><a href="ref_guide_locking.html#ref_guide_locking_issues">3.6.
Known Issues and Limitations
</a></span></dt></dl></dd><dt><span class="section"><a href="ref_guide_savepoints.html">4.
Savepoints
</a></span></dt><dd><dl><dt><span class="section"><a href="ref_guide_savepoints.html#reg_guide_savepoints_using">4.1.
Using Savepoints
</a></span></dt><dt><span class="section"><a href="ref_guide_savepoints.html#ref_guide_savepoints_conf">4.2.
Configuring Savepoints
</a></span></dt></dl></dd><dt><span class="section"><a href="ref_guide_enterprise_methodql.html">5.
MethodQL
</a></span></dt><dt><span class="section"><a href="ref_guide_sequence.html">6.
Generators
</a></span></dt><dd><dl><dt><span class="section"><a href="ref_guide_sequence.html#ref_guide_sequence_runtime">6.1.
Runtime Access
</a></span></dt></dl></dd><dt><span class="section"><a href="ref_guide_runtime_pm_event.html">7.
Transaction Events
</a></span></dt><dt><span class="section"><a href="ref_guide_enterprise_abstractstore.html">8.
Non-Relational Stores
</a></span></dt></dl></dd><dt><span class="chapter"><a href="ref_guide_caching.html">10.
Caching
</a></span></dt><dd><dl><dt><span class="section"><a href="ref_guide_caching.html#ref_guide_cache">1.
Data Cache
</a></span></dt><dd><dl><dt><span class="section"><a href="ref_guide_caching.html#ref_guide_cache_conf">1.1.
Data Cache Configuration
</a></span></dt><dt><span class="section"><a href="ref_guide_caching.html#ref_guide_cache_use">1.2.
Data Cache Usage
</a></span></dt><dt><span class="section"><a href="ref_guide_caching.html#ref_guide_cache_query">1.3.
Query Cache
</a></span></dt><dt><span class="section"><a href="ref_guide_caching.html#ref_guide_cache_extension">1.4.
Cache Extension
</a></span></dt><dt><span class="section"><a href="ref_guide_caching.html#ref_guide_cache_notes">1.5.
Important Notes
</a></span></dt><dt><span class="section"><a href="ref_guide_caching.html#datastore_cache_issues">1.6.
Known Issues and Limitations
</a></span></dt></dl></dd><dt><span class="section"><a href="ref_guide_cache_querycomp.html">2.
Query Compilation Cache
</a></span></dt></dl></dd><dt><span class="chapter"><a href="ref_guide_remote.html">11.
Remote and Offline Operation
</a></span></dt><dd><dl><dt><span class="section"><a href="ref_guide_remote.html#ref_guide_detach">1.
Detach and Attach
</a></span></dt><dd><dl><dt><span class="section"><a href="ref_guide_remote.html#ref_guide_detach_behavior">1.1.
Detach Behavior
</a></span></dt><dt><span class="section"><a href="ref_guide_remote.html#ref_guide_attach_behavior">1.2.
Attach Behavior
</a></span></dt><dt><span class="section"><a href="ref_guide_remote.html#ref_guide_detach_graph">1.3.
Defining the Detached Object Graph
</a></span></dt><dd><dl><dt><span class="section"><a href="ref_guide_remote.html#ref_guide_detach_field">1.3.1.
Detached State Field
</a></span></dt></dl></dd></dl></dd><dt><span class="section"><a href="ref_guide_event.html">2.
Remote Event Notification Framework
</a></span></dt><dd><dl><dt><span class="section"><a href="ref_guide_event.html#ref_guide_event_conf">2.1.
Remote Commit Provider Configuration
</a></span></dt><dd><dl><dt><span class="section"><a href="ref_guide_event.html#ref_guide_event_conf_jms">2.1.1.
JMS
</a></span></dt><dt><span class="section"><a href="ref_guide_event.html#ref_guide_event_conf_tcp">2.1.2.
TCP
</a></span></dt><dt><span class="section"><a href="ref_guide_event.html#ref_guide_event_conf_common">2.1.3.
Common Properties
</a></span></dt></dl></dd><dt><span class="section"><a href="ref_guide_event.html#ref_guide_event_customization">2.2.
Customization
</a></span></dt></dl></dd></dl></dd><dt><span class="chapter"><a href="ref_guide_integration.html">12.
Third Party Integration
</a></span></dt><dd><dl><dt><span class="section"><a href="ref_guide_integration.html#ref_guide_integration_ant">1.
Apache Ant
</a></span></dt><dd><dl><dt><span class="section"><a href="ref_guide_integration.html#ref_guide_integration_conf">1.1.
Common Ant Configuration Options
</a></span></dt><dt><span class="section"><a href="ref_guide_integration.html#ref_guide_integration_enhance">1.2.
Enhancer Ant Task
</a></span></dt><dt><span class="section"><a href="ref_guide_integration.html#ref_guide_integration_appidtool">1.3.
Application Identity Tool Ant Task
</a></span></dt><dt><span class="section"><a href="ref_guide_integration.html#ref_guide_integration_mappingtool">1.4.
Mapping Tool Ant Task
</a></span></dt><dt><span class="section"><a href="ref_guide_integration.html#ref_guide_integration_revmappingtool">1.5.
Reverse Mapping Tool Ant Task
</a></span></dt><dt><span class="section"><a href="ref_guide_integration.html#ref_guide_integration_schematool">1.6.
Schema Tool Ant Task
</a></span></dt></dl></dd></dl></dd><dt><span class="chapter"><a href="ref_guide_optimization.html">13.
Optimization Guidelines
</a></span></dt></dl></div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="jpa_overview_conclusion.html">Prev</a>&nbsp;</td><td width="20%" align="center">&nbsp;</td><td width="40%" align="right">&nbsp;<a accesskey="n" href="ref_guide_intro.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top">Chapter&nbsp;13.&nbsp;
Conclusion
&nbsp;</td><td width="20%" align="center"><a accesskey="h" href="manual.html">Home</a></td><td width="40%" align="right" valign="top">&nbsp;Chapter&nbsp;1.&nbsp;
Introduction
</td></tr></table></div></body></html>