| <html><head> |
| <meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1"> |
| <title>5. OpenJPA Properties</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="ref_guide_conf.html" title="Chapter 2. Configuration"><link rel="prev" href="ref_guide_conf_plugins.html" title="4. Plugin Configuration"><link rel="next" href="ref_guide_conf_jdbc.html" title="6. OpenJPA JDBC Properties"></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">5. |
| OpenJPA Properties |
| </th></tr><tr><td width="20%" align="left"><a accesskey="p" href="ref_guide_conf_plugins.html">Prev</a> </td><th width="60%" align="center">Chapter 2. |
| Configuration |
| </th><td width="20%" align="right"> <a accesskey="n" href="ref_guide_conf_jdbc.html">Next</a></td></tr></table><hr></div><div class="section" lang="en"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="ref_guide_conf_openjpa"></a>5. |
| OpenJPA Properties |
| </h2></div></div></div><div class="toc"><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></div><a class="indexterm" name="d0e12362"></a><p> |
| OpenJPA defines many configuration properties. Most of these properties are |
| provided for advanced users who wish to customize OpenJPA's behavior; the |
| majority of developers can omit them. The following properties apply to any |
| OpenJPA back-end, though the given descriptions are tailored to OpenJPA's |
| default JDBC store. |
| </p><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="openjpa.AutoClear"></a>5.1. |
| openjpa.AutoClear |
| </h3></div></div></div><a class="indexterm" name="d0e12373"></a><a class="indexterm" name="d0e12376"></a><p> |
| <span class="bold"><strong>Property name: </strong></span><code class="literal">openjpa.AutoClear |
| </code> |
| </p><p> |
| <span class="bold"><strong>Configuration API:</strong></span> |
| <a xmlns:xlink="http://www.w3.org/1999/xlink" href="../javadoc/org/apache/openjpa/conf/OpenJPAConfiguration.html#getAutoClear" target="_top"> |
| <code class="methodname">org.apache.openjpa.conf.OpenJPAConfiguration.getAutoClear |
| </code></a> |
| </p><p> |
| <span class="bold"><strong>Resource adaptor config-property: </strong></span><code class="literal"> |
| AutoClear</code> |
| </p><p> |
| <span class="bold"><strong>Default: </strong></span><code class="literal">datastore</code> |
| </p><p> |
| <span class="bold"><strong>Possible values: </strong></span><code class="literal">datastore</code>, |
| <code class="literal">all</code> |
| </p><p> |
| <span class="bold"><strong>Description:</strong></span> When to automatically clear |
| instance state: on entering a datastore transaction, or on entering any |
| transaction. |
| </p></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="openjpa.AutoDetach"></a>5.2. |
| openjpa.AutoDetach |
| </h3></div></div></div><a class="indexterm" name="d0e12432"></a><a class="indexterm" name="d0e12435"></a><p> |
| <span class="bold"><strong>Property name: </strong></span><code class="literal">openjpa.AutoDetach |
| </code> |
| </p><p> |
| <span class="bold"><strong>Configuration API:</strong></span> |
| <a xmlns:xlink="http://www.w3.org/1999/xlink" href="../javadoc/org/apache/openjpa/conf/OpenJPAConfiguration.html#getAutoDetach" target="_top"> |
| <code class="methodname">org.apache.openjpa.conf.OpenJPAConfiguration.getAutoDetach |
| </code></a> |
| </p><p> |
| <span class="bold"><strong>Resource adaptor config-property: </strong></span><code class="literal"> |
| AutoDetach</code> |
| </p><p> |
| <span class="bold"><strong>Default:</strong></span> - |
| </p><p> |
| <span class="bold"><strong>Possible values: </strong></span><code class="literal">close</code>, |
| <code class="literal">commit</code>, <code class="literal">nontx-read</code> |
| </p><p> |
| <span class="bold"><strong>Description:</strong></span> A comma-separated list of events |
| when managed instances will be automatically detached. |
| </p></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="openjpa.BrokerFactory"></a>5.3. |
| openjpa.BrokerFactory |
| </h3></div></div></div><a class="indexterm" name="d0e12492"></a><p> |
| <span class="bold"><strong>Property name: </strong></span><code class="literal">openjpa.BrokerFactory |
| </code> |
| </p><p> |
| <span class="bold"><strong>Configuration API:</strong></span> |
| <a xmlns:xlink="http://www.w3.org/1999/xlink" href="../javadoc/org/apache/openjpa/conf/OpenJPAConfiguration.html#getBrokerFactory" target="_top"> |
| <code class="methodname">org.apache.openjpa.conf.OpenJPAConfiguration.getBrokerFactory |
| </code></a> |
| </p><p> |
| <span class="bold"><strong>Resource adaptor config-property: </strong></span><code class="literal"> |
| BrokerFactory</code> |
| </p><p> |
| <span class="bold"><strong>Default: </strong></span><code class="literal">jdbc</code> |
| </p><p> |
| <span class="bold"><strong>Possible values: </strong></span><code class="literal">jdbc</code>, |
| <code class="literal">abstractstore</code>, <code class="literal">remote</code> |
| </p><p> |
| <span class="bold"><strong>Description:</strong></span> A plugin string (see |
| <a href="ref_guide_conf_plugins.html" title="4. Plugin Configuration">Section 4, “ |
| Plugin Configuration |
| ”</a>) describing the |
| <a xmlns:xlink="http://www.w3.org/1999/xlink" href="../javadoc/org/apache/openjpa/kernel/BrokerFactory.html" target="_top"> |
| <code class="classname">org.apache.openjpa.kernel.BrokerFactory</code></a> type to |
| use. |
| </p></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="openjpa.BrokerImpl"></a>5.4. |
| openjpa.BrokerImpl |
| </h3></div></div></div><a class="indexterm" name="d0e12554"></a><a class="indexterm" name="d0e12557"></a><p> |
| <span class="bold"><strong>Property name: </strong></span><code class="literal">openjpa.BrokerImpl |
| </code> |
| </p><p> |
| <span class="bold"><strong>Configuration API:</strong></span> |
| <a xmlns:xlink="http://www.w3.org/1999/xlink" href="../javadoc/org/apache/openjpa/conf/OpenJPAConfiguration.html#getBrokerImpl" target="_top"> |
| <code class="methodname">org.apache.openjpa.conf.OpenJPAConfiguration.getBrokerImpl |
| </code></a> |
| </p><p> |
| <span class="bold"><strong>Resource adaptor config-property: </strong></span><code class="literal"> |
| BrokerImpl</code> |
| </p><p> |
| <span class="bold"><strong>Default: </strong></span><code class="literal">default</code> |
| </p><p> |
| <span class="bold"><strong>Description:</strong></span> A plugin string (see |
| <a href="ref_guide_conf_plugins.html" title="4. Plugin Configuration">Section 4, “ |
| Plugin Configuration |
| ”</a>) describing the |
| <a xmlns:xlink="http://www.w3.org/1999/xlink" href="../javadoc/org/apache/openjpa/kernel/Broker.html" target="_top"><code class="classname"> |
| org.apache.openjpa.kernel.Broker</code></a> type to use at runtime. See |
| <a href="ref_guide_runtime.html#ref_guide_runtime_broker_extension" title="1.2. Broker Customization and Finalization">Section 1.2, “ |
| Broker Customization and Finalization |
| ”</a> on for details. |
| </p></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="openjpa.ClassResolver"></a>5.5. |
| openjpa.ClassResolver |
| </h3></div></div></div><a class="indexterm" name="d0e12609"></a><a class="indexterm" name="d0e12612"></a><p> |
| <span class="bold"><strong>Property name: </strong></span><code class="literal">openjpa.ClassResolver |
| </code> |
| </p><p> |
| <span class="bold"><strong>Configuration API:</strong></span> |
| <a xmlns:xlink="http://www.w3.org/1999/xlink" href="../javadoc/org/apache/openjpa/conf/OpenJPAConfiguration.html#getClassResolver" target="_top"> |
| <code class="methodname">org.apache.openjpa.conf.OpenJPAConfiguration.getClassResolver |
| </code></a> |
| </p><p> |
| <span class="bold"><strong>Resource adaptor config-property: </strong></span><code class="literal"> |
| ClassResolver</code> |
| </p><p> |
| <span class="bold"><strong>Default: </strong></span><code class="literal">default</code> |
| </p><p> |
| <span class="bold"><strong>Description:</strong></span> A plugin string (see |
| <a href="ref_guide_conf_plugins.html" title="4. Plugin Configuration">Section 4, “ |
| Plugin Configuration |
| ”</a>) describing the |
| <a xmlns:xlink="http://www.w3.org/1999/xlink" href="../javadoc/org/apache/openjpa/util/ClassResolver.html" target="_top"><code class="classname"> |
| org.apache.openjpa.util.ClassResolver</code></a> implementation to use |
| for class name resolution. You may wish to plug in your own resolver if you have |
| special classloading needs. |
| </p></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="openjpa.Compatibility"></a>5.6. |
| openjpa.Compatibility |
| </h3></div></div></div><a class="indexterm" name="d0e12662"></a><a class="indexterm" name="d0e12665"></a><p> |
| <span class="bold"><strong>Property name: </strong></span><code class="literal">openjpa.Compatibility |
| </code> |
| </p><p> |
| <span class="bold"><strong>Configuration API:</strong></span> |
| <a xmlns:xlink="http://www.w3.org/1999/xlink" href="../javadoc/org/apache/openjpa/conf/OpenJPAConfiguration.html#getCompatibility" target="_top"> |
| <code class="methodname">org.apache.openjpa.conf.OpenJPAConfiguration.getCompatibility |
| </code></a> |
| </p><p> |
| <span class="bold"><strong>Resource adaptor config-property: </strong></span><code class="literal"> |
| Compatibility</code> |
| </p><p> |
| <span class="bold"><strong>Default:</strong></span> - |
| </p><p> |
| <span class="bold"><strong>Description:</strong></span> Encapsulates options to mimic the |
| behavior of previous OpenJPA releases. |
| </p></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="openjpa.ConnectionDriverName"></a>5.7. |
| openjpa.ConnectionDriverName |
| </h3></div></div></div><a class="indexterm" name="d0e12705"></a><a class="indexterm" name="d0e12708"></a><p> |
| <span class="bold"><strong>Property name: </strong></span><code class="literal"> |
| openjpa.ConnectionDriverName</code> |
| </p><p> |
| <span class="bold"><strong>Configuration API:</strong></span> |
| <a xmlns:xlink="http://www.w3.org/1999/xlink" href="../javadoc/org/apache/openjpa/conf/OpenJPAConfiguration.html#getConnectionDriverName" target="_top"> |
| <code class="methodname"> |
| org.apache.openjpa.conf.OpenJPAConfiguration.getConnectionDriverName |
| </code></a> |
| </p><p> |
| <span class="bold"><strong>Resource adaptor config-property: </strong></span><code class="literal"> |
| ConnectionDriverName</code> |
| </p><p> |
| <span class="bold"><strong>Default:</strong></span> - |
| </p><p> |
| <span class="bold"><strong>Description:</strong></span> The full class name of either the |
| JDBC <code class="classname">java.sql.Driver</code>, or a <code class="classname"> |
| javax.sql.DataSource</code> implementation to use to connect to the |
| database. See <a href="ref_guide_dbsetup.html" title="Chapter 4. JDBC">Chapter 4, <i xmlns:xlink="http://www.w3.org/1999/xlink"> |
| JDBC |
| </i></a> for details. |
| </p></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="openjpa.Connection2DriverName"></a>5.8. |
| openjpa.Connection2DriverName |
| </h3></div></div></div><a class="indexterm" name="d0e12758"></a><a class="indexterm" name="d0e12761"></a><p> |
| <span class="bold"><strong>Property name: </strong></span><code class="literal"> |
| openjpa.Connection2DriverName</code> |
| </p><p> |
| <span class="bold"><strong>Configuration API:</strong></span> |
| <a xmlns:xlink="http://www.w3.org/1999/xlink" href="../javadoc/org/apache/openjpa/conf/OpenJPAConfiguration.html#getConnection2DriverName" target="_top"> |
| <code class="methodname"> |
| org.apache.openjpa.conf.OpenJPAConfiguration.getConnection2DriverName |
| </code></a> |
| </p><p> |
| <span class="bold"><strong>Resource adaptor config-property: </strong></span><code class="literal"> |
| Connection2DriverName</code> |
| </p><p> |
| <span class="bold"><strong>Default:</strong></span> - |
| </p><p> |
| <span class="bold"><strong>Description:</strong></span> This property is equivalent to the |
| <code class="literal">openjpa.ConnectionDriverName</code> property described in |
| <a href="ref_guide_conf_openjpa.html#openjpa.ConnectionDriverName" title="5.7. openjpa.ConnectionDriverName">Section 5.7, “ |
| openjpa.ConnectionDriverName |
| ”</a>, but applies to the |
| alternate connection factory used for unmanaged connections. See |
| <a href="ref_guide_dbsetup_thirdparty.html#ref_guide_dbsetup_thirdparty_enlist" title="2.1. Managed and XA DataSources">Section 2.1, “ |
| Managed and XA DataSources |
| ”</a> for details. |
| </p></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="openjpa.ConnectionFactory"></a>5.9. |
| openjpa.ConnectionFactory |
| </h3></div></div></div><a class="indexterm" name="d0e12810"></a><a class="indexterm" name="d0e12813"></a><p> |
| <span class="bold"><strong>Property name: </strong></span><code class="literal"> |
| openjpa.ConnectionFactory</code> |
| </p><p> |
| <span class="bold"><strong>Configuration API:</strong></span> |
| <a xmlns:xlink="http://www.w3.org/1999/xlink" href="../javadoc/org/apache/openjpa/conf/OpenJPAConfiguration.html#getConnectionFactory" target="_top"> |
| <code class="methodname">org.apache.openjpa.conf.OpenJPAConfiguration.getConnectionFactory |
| </code></a> |
| </p><p> |
| <span class="bold"><strong>Resource adaptor config-property: </strong></span><code class="literal"> |
| ConnectionFactory</code> |
| </p><p> |
| <span class="bold"><strong>Default:</strong></span> - |
| </p><p> |
| <span class="bold"><strong>Description:</strong></span> A <code class="classname">javax.sql.DataSource |
| </code> to use to connect to the database. See |
| <a href="ref_guide_dbsetup.html" title="Chapter 4. JDBC">Chapter 4, <i xmlns:xlink="http://www.w3.org/1999/xlink"> |
| JDBC |
| </i></a> for details. |
| </p></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="openjpa.ConnectionFactory2"></a>5.10. |
| openjpa.ConnectionFactory2 |
| </h3></div></div></div><a class="indexterm" name="d0e12860"></a><a class="indexterm" name="d0e12863"></a><p> |
| <span class="bold"><strong>Property name: </strong></span><code class="literal"> |
| openjpa.ConnectionFactory2</code> |
| </p><p> |
| <span class="bold"><strong>Configuration API:</strong></span> |
| <a xmlns:xlink="http://www.w3.org/1999/xlink" href="../javadoc/org/apache/openjpa/conf/OpenJPAConfiguration.html#getConnectionFactory2" target="_top"> |
| <code class="methodname">org.apache.openjpa.conf.OpenJPAConfiguration.getConnectionFactory2 |
| </code></a> |
| </p><p> |
| <span class="bold"><strong>Resource adaptor config-property: </strong></span><code class="literal"> |
| ConnectionFactory2</code> |
| </p><p> |
| <span class="bold"><strong>Default:</strong></span> - |
| </p><p> |
| <span class="bold"><strong>Description:</strong></span> An unmanaged <code class="classname"> |
| javax.sql.DataSource</code> to use to connect to the database. See |
| <a href="ref_guide_dbsetup.html" title="Chapter 4. JDBC">Chapter 4, <i xmlns:xlink="http://www.w3.org/1999/xlink"> |
| JDBC |
| </i></a> for details. |
| </p></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="openjpa.ConnectionFactoryName"></a>5.11. |
| openjpa.ConnectionFactoryName |
| </h3></div></div></div><a class="indexterm" name="d0e12910"></a><a class="indexterm" name="d0e12913"></a><p> |
| <span class="bold"><strong>Property name: </strong></span><code class="literal"> |
| openjpa.ConnectionFactoryName</code> |
| </p><p> |
| <span class="bold"><strong>Configuration API:</strong></span> |
| <a xmlns:xlink="http://www.w3.org/1999/xlink" href="../javadoc/org/apache/openjpa/conf/OpenJPAConfiguration.html#getConnectionFactoryName" target="_top"> |
| <code class="methodname"> |
| org.apache.openjpa.conf.OpenJPAConfiguration.getConnectionFactoryName |
| </code></a> |
| </p><p> |
| <span class="bold"><strong>Resource adaptor config-property: </strong></span><code class="literal"> |
| ConnectionFactoryName</code> |
| </p><p> |
| <span class="bold"><strong>Default:</strong></span> - |
| </p><p> |
| <span class="bold"><strong>Description:</strong></span> The JNDI location of a <code class="classname"> |
| javax.sql.DataSource</code> to use to connect to the database. See |
| <a href="ref_guide_dbsetup.html" title="Chapter 4. JDBC">Chapter 4, <i xmlns:xlink="http://www.w3.org/1999/xlink"> |
| JDBC |
| </i></a> for details. |
| </p></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="openjpa.ConnectionFactory2Name"></a>5.12. |
| openjpa.ConnectionFactory2Name |
| </h3></div></div></div><a class="indexterm" name="d0e12960"></a><a class="indexterm" name="d0e12963"></a><p> |
| <span class="bold"><strong>Property name: </strong></span><code class="literal"> |
| openjpa.ConnectionFactory2Name</code> |
| </p><p> |
| <span class="bold"><strong>Configuration API:</strong></span> |
| <a xmlns:xlink="http://www.w3.org/1999/xlink" href="../javadoc/org/apache/openjpa/conf/OpenJPAConfiguration.html#getConnectionFactory2Name" target="_top"> |
| <code class="methodname"> |
| org.apache.openjpa.conf.OpenJPAConfiguration.getConnectionFactory2Name |
| </code></a> |
| </p><p> |
| <span class="bold"><strong>Resource adaptor config-property: </strong></span><code class="literal"> |
| ConnectionFactory2Name</code> |
| </p><p> |
| <span class="bold"><strong>Default:</strong></span> - |
| </p><p> |
| <span class="bold"><strong>Description:</strong></span> The JNDI location of an unmanaged |
| <code class="classname">javax.sql.DataSource</code> to use to connect to the database. |
| See <a href="ref_guide_enterprise_xa.html" title="3. XA Transactions">Section 3, “ |
| XA Transactions |
| ”</a> for details. |
| </p></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="openjpa.ConnectionFactoryMode"></a>5.13. |
| openjpa.ConnectionFactoryMode |
| </h3></div></div></div><a class="indexterm" name="d0e13010"></a><a class="indexterm" name="d0e13013"></a><p> |
| <span class="bold"><strong>Property name: </strong></span><code class="literal"> |
| openjpa.ConnectionFactoryMode</code> |
| </p><p> |
| <span class="bold"><strong>Configuration API:</strong></span> |
| <a xmlns:xlink="http://www.w3.org/1999/xlink" href="../javadoc/org/apache/openjpa/conf/OpenJPAConfiguration.html#getConnectionFactoryMode" target="_top"> |
| <code class="methodname"> |
| org.apache.openjpa.conf.OpenJPAConfiguration.getConnectionFactoryMode |
| </code></a> |
| </p><p> |
| <span class="bold"><strong>Resource adaptor config-property: </strong></span><code class="literal"> |
| ConnectionFactoryMode</code> |
| </p><p> |
| <span class="bold"><strong>Default: </strong></span><code class="literal">local</code> |
| </p><p> |
| <span class="bold"><strong>Possible values: </strong></span><code class="literal">local</code>, |
| <code class="literal">managed</code> |
| </p><p> |
| <span class="bold"><strong>Description:</strong></span> The connection factory mode to use |
| when integrating with the application server's managed transactions. See |
| <a href="ref_guide_dbsetup_thirdparty.html#ref_guide_dbsetup_thirdparty_enlist" title="2.1. Managed and XA DataSources">Section 2.1, “ |
| Managed and XA DataSources |
| ”</a> for details. |
| </p></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="openjpa.ConnectionFactoryProperties"></a>5.14. |
| openjpa.ConnectionFactoryProperties |
| </h3></div></div></div><a class="indexterm" name="d0e13069"></a><a class="indexterm" name="d0e13072"></a><p> |
| <span class="bold"><strong>Property name: </strong></span><code class="literal"> |
| openjpa.ConnectionFactoryProperties</code> |
| </p><p> |
| <span class="bold"><strong>Configuration API:</strong></span> |
| <a xmlns:xlink="http://www.w3.org/1999/xlink" href="../javadoc/org/apache/openjpa/conf/OpenJPAConfiguration.html#getConnectionFactoryProperties" target="_top"> |
| <code class="methodname"> |
| org.apache.openjpa.conf.OpenJPAConfiguration.getConnectionFactoryProperties |
| </code></a> |
| </p><p> |
| <span class="bold"><strong>Resource adaptor config-property: </strong></span><code class="literal"> |
| ConnectionFactoryProperties</code> |
| </p><p> |
| <span class="bold"><strong>Default:</strong></span> - |
| </p><p> |
| <span class="bold"><strong>Description:</strong></span> A plugin string (see |
| <a href="ref_guide_conf_plugins.html" title="4. Plugin Configuration">Section 4, “ |
| Plugin Configuration |
| ”</a>) listing properties for |
| configuration of the datasource in use. See the |
| <a href="ref_guide_dbsetup.html" title="Chapter 4. JDBC">Chapter 4, <i xmlns:xlink="http://www.w3.org/1999/xlink"> |
| JDBC |
| </i></a> for details. |
| </p></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="openjpa.ConnectionFactory2Properties"></a>5.15. |
| openjpa.ConnectionFactory2Properties |
| </h3></div></div></div><a class="indexterm" name="d0e13118"></a><a class="indexterm" name="d0e13121"></a><p> |
| <span class="bold"><strong>Property name: </strong></span><code class="literal"> |
| openjpa.ConnectionFactory2Properties</code> |
| </p><p> |
| <span class="bold"><strong>Configuration API:</strong></span> |
| <a xmlns:xlink="http://www.w3.org/1999/xlink" href="../javadoc/org/apache/openjpa/conf/OpenJPAConfiguration.html#getConnectionFactory2Properties" target="_top"> |
| <code class="methodname"> |
| org.apache.openjpa.conf.OpenJPAConfiguration.getConnectionFactory2Properties |
| </code></a> |
| </p><p> |
| <span class="bold"><strong>Resource adaptor config-property: </strong></span><code class="literal"> |
| ConnectionFactory2Properties</code> |
| </p><p> |
| <span class="bold"><strong>Default:</strong></span> - |
| </p><p> |
| <span class="bold"><strong>Description:</strong></span> This property is equivalent to the |
| <code class="literal">openjpa.ConnectionFactoryProperties</code> property described in |
| <a href="ref_guide_conf_openjpa.html#openjpa.ConnectionFactoryProperties" title="5.14. openjpa.ConnectionFactoryProperties">Section 5.14, “ |
| openjpa.ConnectionFactoryProperties |
| ”</a>, but applies to the |
| alternate connection factory used for unmanaged connections. See |
| <a href="ref_guide_dbsetup_thirdparty.html#ref_guide_dbsetup_thirdparty_enlist" title="2.1. Managed and XA DataSources">Section 2.1, “ |
| Managed and XA DataSources |
| ”</a> for details. |
| </p></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="openjpa.ConnectionPassword"></a>5.16. |
| openjpa.ConnectionPassword |
| </h3></div></div></div><a class="indexterm" name="d0e13170"></a><a class="indexterm" name="d0e13173"></a><p> |
| <span class="bold"><strong>Property name: </strong></span><code class="literal"> |
| openjpa.ConnectionPassword</code> |
| </p><p> |
| <span class="bold"><strong>Configuration API:</strong></span> |
| <a xmlns:xlink="http://www.w3.org/1999/xlink" href="../javadoc/org/apache/openjpa/conf/OpenJPAConfiguration.html#getConnectionPassword" target="_top"> |
| <code class="methodname">org.apache.openjpa.conf.OpenJPAConfiguration.getConnectionPassword |
| </code></a> |
| </p><p> |
| <span class="bold"><strong>Resource adaptor config-property: </strong></span><code class="literal"> |
| ConnectionPassword</code> |
| </p><p> |
| <span class="bold"><strong>Default:</strong></span> - |
| </p><p> |
| <span class="bold"><strong>Description:</strong></span> The password for the user |
| specified in the <code class="literal">ConnectionUserName</code> property. See |
| <a href="ref_guide_dbsetup.html" title="Chapter 4. JDBC">Chapter 4, <i xmlns:xlink="http://www.w3.org/1999/xlink"> |
| JDBC |
| </i></a> for details. |
| </p></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="openjpa.Connection2Password"></a>5.17. |
| openjpa.Connection2Password |
| </h3></div></div></div><a class="indexterm" name="d0e13220"></a><a class="indexterm" name="d0e13223"></a><p> |
| <span class="bold"><strong>Property name: </strong></span><code class="literal"> |
| openjpa.Connection2Password</code> |
| </p><p> |
| <span class="bold"><strong>Configuration API:</strong></span> |
| <a xmlns:xlink="http://www.w3.org/1999/xlink" href="../javadoc/org/apache/openjpa/conf/OpenJPAConfiguration.html#getConnection2Password" target="_top"> |
| <code class="methodname">org.apache.openjpa.conf.OpenJPAConfiguration.getConnection2Password |
| </code></a> |
| </p><p> |
| <span class="bold"><strong>Resource adaptor config-property: </strong></span><code class="literal"> |
| Connection2Password</code> |
| </p><p> |
| <span class="bold"><strong>Default:</strong></span> - |
| </p><p> |
| <span class="bold"><strong>Description:</strong></span> This property is equivalent to the |
| <code class="literal">openjpa.ConnectionPassword</code> property described in |
| <a href="ref_guide_conf_openjpa.html#openjpa.ConnectionPassword" title="5.16. openjpa.ConnectionPassword">Section 5.16, “ |
| openjpa.ConnectionPassword |
| ”</a>, but applies to the |
| alternate connection factory used for unmanaged connections. See |
| <a href="ref_guide_dbsetup_thirdparty.html#ref_guide_dbsetup_thirdparty_enlist" title="2.1. Managed and XA DataSources">Section 2.1, “ |
| Managed and XA DataSources |
| ”</a> for details. |
| </p></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="openjpa.ConnectionProperties"></a>5.18. |
| openjpa.ConnectionProperties |
| </h3></div></div></div><a class="indexterm" name="d0e13272"></a><a class="indexterm" name="d0e13275"></a><p> |
| <span class="bold"><strong>Property name: </strong></span><code class="literal"> |
| openjpa.ConnectionProperties</code> |
| </p><p> |
| <span class="bold"><strong>Configuration API:</strong></span> |
| <a xmlns:xlink="http://www.w3.org/1999/xlink" href="../javadoc/org/apache/openjpa/conf/OpenJPAConfiguration.html#getConnectionProperties" target="_top"> |
| <code class="methodname"> |
| org.apache.openjpa.conf.OpenJPAConfiguration.getConnectionProperties |
| </code></a> |
| </p><p> |
| <span class="bold"><strong>Resource adaptor config-property: </strong></span><code class="literal"> |
| ConnectionProperties</code> |
| </p><p> |
| <span class="bold"><strong>Default:</strong></span> - |
| </p><p> |
| <span class="bold"><strong>Description:</strong></span> A plugin string (see |
| <a href="ref_guide_conf_plugins.html" title="4. Plugin Configuration">Section 4, “ |
| Plugin Configuration |
| ”</a>) listing properties to configure |
| the driver listed in the <code class="literal">ConnectionDriverName</code> property |
| described below. See <a href="ref_guide_dbsetup.html" title="Chapter 4. JDBC">Chapter 4, <i xmlns:xlink="http://www.w3.org/1999/xlink"> |
| JDBC |
| </i></a> for details. |
| </p></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="openjpa.Connection2Properties"></a>5.19. |
| openjpa.Connection2Properties |
| </h3></div></div></div><a class="indexterm" name="d0e13324"></a><a class="indexterm" name="d0e13327"></a><p> |
| <span class="bold"><strong>Property name: </strong></span><code class="literal"> |
| openjpa.Connection2Properties</code> |
| </p><p> |
| <span class="bold"><strong>Configuration API:</strong></span> |
| <a xmlns:xlink="http://www.w3.org/1999/xlink" href="../javadoc/org/apache/openjpa/conf/OpenJPAConfiguration.html#getConnection2Properties" target="_top"> |
| <code class="methodname"> |
| org.apache.openjpa.conf.OpenJPAConfiguration.getConnection2Properties |
| </code></a> |
| </p><p> |
| <span class="bold"><strong>Resource adaptor config-property: </strong></span><code class="literal"> |
| Connection2Properties</code> |
| </p><p> |
| <span class="bold"><strong>Default:</strong></span> - |
| </p><p> |
| <span class="bold"><strong>Description:</strong></span> This property is equivalent to the |
| <code class="literal">openjpa.ConnectionProperties</code> property described in |
| <a href="ref_guide_conf_openjpa.html#openjpa.ConnectionProperties" title="5.18. openjpa.ConnectionProperties">Section 5.18, “ |
| openjpa.ConnectionProperties |
| ”</a>, but applies to the |
| alternate connection factory used for unmanaged connections. See |
| <a href="ref_guide_dbsetup_thirdparty.html#ref_guide_dbsetup_thirdparty_enlist" title="2.1. Managed and XA DataSources">Section 2.1, “ |
| Managed and XA DataSources |
| ”</a> for details. |
| </p></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="openjpa.ConnectionURL"></a>5.20. |
| openjpa.ConnectionURL |
| </h3></div></div></div><a class="indexterm" name="d0e13376"></a><a class="indexterm" name="d0e13379"></a><p> |
| <span class="bold"><strong>Property name: </strong></span><code class="literal">openjpa.ConnectionURL |
| </code> |
| </p><p> |
| <span class="bold"><strong>Configuration API:</strong></span> |
| <a xmlns:xlink="http://www.w3.org/1999/xlink" href="../javadoc/org/apache/openjpa/conf/OpenJPAConfiguration.html#getConnectionURL" target="_top"> |
| <code class="methodname">org.apache.openjpa.conf.OpenJPAConfiguration.getConnectionURL |
| </code></a> |
| </p><p> |
| <span class="bold"><strong>Resource adaptor config-property: </strong></span><code class="literal"> |
| ConnectionURL</code> |
| </p><p> |
| <span class="bold"><strong>Default:</strong></span> - |
| </p><p> |
| <span class="bold"><strong>Description:</strong></span> The JDBC URL for the database. See |
| <a href="ref_guide_dbsetup.html" title="Chapter 4. JDBC">Chapter 4, <i xmlns:xlink="http://www.w3.org/1999/xlink"> |
| JDBC |
| </i></a> for details. |
| </p></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="openjpa.Connection2URL"></a>5.21. |
| openjpa.Connection2URL |
| </h3></div></div></div><a class="indexterm" name="d0e13423"></a><a class="indexterm" name="d0e13426"></a><p> |
| <span class="bold"><strong>Property name: </strong></span><code class="literal">openjpa.Connection2URL |
| </code> |
| </p><p> |
| <span class="bold"><strong>Configuration API:</strong></span> |
| <a xmlns:xlink="http://www.w3.org/1999/xlink" href="../javadoc/org/apache/openjpa/conf/OpenJPAConfiguration.html#getConnection2URL" target="_top"> |
| <code class="methodname">org.apache.openjpa.conf.OpenJPAConfiguration.getConnection2URL |
| </code></a> |
| </p><p> |
| <span class="bold"><strong>Resource adaptor config-property: </strong></span><code class="literal"> |
| Connection2URL</code> |
| </p><p> |
| <span class="bold"><strong>Default:</strong></span> - |
| </p><p> |
| <span class="bold"><strong>Description:</strong></span> This property is equivalent to the |
| <code class="literal">openjpa.ConnectionURL</code> property described in |
| <a href="ref_guide_conf_openjpa.html#openjpa.ConnectionURL" title="5.20. openjpa.ConnectionURL">Section 5.20, “ |
| openjpa.ConnectionURL |
| ”</a>, but applies to the alternate |
| connection factory used for unmanaged connections. See |
| <a href="ref_guide_dbsetup_thirdparty.html#ref_guide_dbsetup_thirdparty_enlist" title="2.1. Managed and XA DataSources">Section 2.1, “ |
| Managed and XA DataSources |
| ”</a> for details. |
| </p></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="openjpa.ConnectionUserName"></a>5.22. |
| openjpa.ConnectionUserName |
| </h3></div></div></div><a class="indexterm" name="d0e13475"></a><a class="indexterm" name="d0e13478"></a><p> |
| <span class="bold"><strong>Property name: </strong></span><code class="literal"> |
| openjpa.ConnectionUserName</code> |
| </p><p> |
| <span class="bold"><strong>Configuration API:</strong></span> |
| <a xmlns:xlink="http://www.w3.org/1999/xlink" href="../javadoc/org/apache/openjpa/conf/OpenJPAConfiguration.html#getConnectionUserName" target="_top"> |
| <code class="methodname">org.apache.openjpa.conf.OpenJPAConfiguration.getConnectionUserName |
| </code></a> |
| </p><p> |
| <span class="bold"><strong>Resource adaptor config-property: </strong></span><code class="literal"> |
| ConnectionUserName</code> |
| </p><p> |
| <span class="bold"><strong>Default:</strong></span> - |
| </p><p> |
| <span class="bold"><strong>Description:</strong></span> The user name to use when |
| connecting to the database. See the <a href="ref_guide_dbsetup.html" title="Chapter 4. JDBC">Chapter 4, <i xmlns:xlink="http://www.w3.org/1999/xlink"> |
| JDBC |
| </i></a> |
| for details. |
| </p></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="openjpa.Connection2UserName"></a>5.23. |
| openjpa.Connection2UserName |
| </h3></div></div></div><a class="indexterm" name="d0e13522"></a><a class="indexterm" name="d0e13525"></a><p> |
| <span class="bold"><strong>Property name: </strong></span><code class="literal"> |
| openjpa.Connection2UserName</code> |
| </p><p> |
| <span class="bold"><strong>Configuration API:</strong></span> |
| <a xmlns:xlink="http://www.w3.org/1999/xlink" href="../javadoc/org/apache/openjpa/conf/OpenJPAConfiguration.html#getConnection2UserName" target="_top"> |
| <code class="methodname">org.apache.openjpa.conf.OpenJPAConfiguration.getConnection2UserName |
| </code></a> |
| </p><p> |
| <span class="bold"><strong>Resource adaptor config-property: </strong></span><code class="literal"> |
| Connection2UserName</code> |
| </p><p> |
| <span class="bold"><strong>Default:</strong></span> - |
| </p><p> |
| <span class="bold"><strong>Description:</strong></span> This property is equivalent to the |
| <code class="literal">openjpa.ConnectionUserName</code> property described in |
| <a href="ref_guide_conf_openjpa.html#openjpa.ConnectionUserName" title="5.22. openjpa.ConnectionUserName">Section 5.22, “ |
| openjpa.ConnectionUserName |
| ”</a>, but applies to the |
| alternate connection factory used for unmanaged connections. See |
| <a href="ref_guide_dbsetup_thirdparty.html#ref_guide_dbsetup_thirdparty_enlist" title="2.1. Managed and XA DataSources">Section 2.1, “ |
| Managed and XA DataSources |
| ”</a> for details. |
| </p></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="openjpa.ConnectionRetainMode"></a>5.24. |
| openjpa.ConnectionRetainMode |
| </h3></div></div></div><a class="indexterm" name="d0e13574"></a><a class="indexterm" name="d0e13577"></a><p> |
| <span class="bold"><strong>Property name: </strong></span><code class="literal"> |
| openjpa.ConnectionRetainMode</code> |
| </p><p> |
| <span class="bold"><strong>Configuration API:</strong></span> |
| <a xmlns:xlink="http://www.w3.org/1999/xlink" href="../javadoc/org/apache/openjpa/conf/OpenJPAConfiguration.html#getConnectionRetainMode" target="_top"> |
| <code class="methodname"> |
| org.apache.openjpa.conf.OpenJPAConfiguration.getConnectionRetainMode |
| </code></a> |
| </p><p> |
| <span class="bold"><strong>Resource adaptor config-property: </strong></span><code class="literal"> |
| ConnectionRetainMode</code> |
| </p><p> |
| <span class="bold"><strong>Default: </strong></span><code class="literal">on-demand</code> |
| </p><p> |
| <span class="bold"><strong>Description:</strong></span> Controls how OpenJPA uses |
| datastore connections. This property can also be specified for individual |
| sessions. See <a href="ref_guide_dbsetup_retain.html" title="8. Configuring the Use of JDBC Connections">Section 8, “ |
| Configuring the Use of JDBC Connections |
| ”</a> for details. |
| </p></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="openjpa.DataCache"></a>5.25. |
| openjpa.DataCache |
| </h3></div></div></div><a class="indexterm" name="d0e13623"></a><a class="indexterm" name="d0e13626"></a><p> |
| <span class="bold"><strong>Property name: </strong></span><code class="literal">openjpa.DataCache |
| </code> |
| </p><p> |
| <span class="bold"><strong>Configuration API:</strong></span> |
| <a xmlns:xlink="http://www.w3.org/1999/xlink" href="../javadoc/org/apache/openjpa/conf/OpenJPAConfiguration.html#getDataCache" target="_top"> |
| <code class="methodname">org.apache.openjpa.conf.OpenJPAConfiguration.getDataCache |
| </code></a> |
| </p><p> |
| <span class="bold"><strong>Resource adaptor config-property: </strong></span><code class="literal"> |
| DataCache</code> |
| </p><p> |
| <span class="bold"><strong>Default: </strong></span><code class="literal">false</code> |
| </p><p> |
| <span class="bold"><strong>Description:</strong></span> A plugin list string (see |
| <a href="ref_guide_conf_plugins.html" title="4. Plugin Configuration">Section 4, “ |
| Plugin Configuration |
| ”</a>) describing the |
| <a xmlns:xlink="http://www.w3.org/1999/xlink" href="../javadoc/org/apache/openjpa/datacache/DataCache.html" target="_top"><code class="classname"> |
| org.apache.openjpa.datacache.DataCache</code></a>s to use for data |
| caching. See <a href="ref_guide_caching.html#ref_guide_cache_conf" title="1.1. Data Cache Configuration">Section 1.1, “ |
| Data Cache Configuration |
| ”</a> for details. |
| </p></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="openjpa.DataCacheManager"></a>5.26. |
| openjpa.DataCacheManager |
| </h3></div></div></div><a class="indexterm" name="d0e13678"></a><a class="indexterm" name="d0e13681"></a><p> |
| <span class="bold"><strong>Property name: </strong></span><code class="literal"> |
| openjpa.DataCacheManager</code> |
| </p><p> |
| <span class="bold"><strong>Configuration API:</strong></span> |
| <a xmlns:xlink="http://www.w3.org/1999/xlink" href="../javadoc/org/apache/openjpa/conf/OpenJPAConfiguration.html#getDataCacheManager" target="_top"> |
| <code class="methodname">org.apache.openjpa.conf.OpenJPAConfiguration.getDataCacheManager |
| </code></a> |
| </p><p> |
| <span class="bold"><strong>Resource adaptor config-property: </strong></span><code class="literal"> |
| DataCacheManager</code> |
| </p><p> |
| <span class="bold"><strong>Default: </strong></span><code class="literal">default</code> |
| </p><p> |
| <span class="bold"><strong>Description:</strong></span> A plugin string (see |
| <a href="ref_guide_conf_plugins.html" title="4. Plugin Configuration">Section 4, “ |
| Plugin Configuration |
| ”</a>) describing the |
| <a xmlns:xlink="http://www.w3.org/1999/xlink" href="../javadoc/org/apache/openjpa/datacache/DataCacheManager.html" target="_top"> |
| <code class="classname">openjpa.datacache.DataCacheManager</code></a> that manages |
| the system data caches. See <a href="ref_guide_caching.html#ref_guide_cache" title="1. Data Cache">Section 1, “ |
| Data Cache |
| ”</a> for details |
| on data caching. |
| </p></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="openjpa.DataCacheTimeout"></a>5.27. |
| openjpa.DataCacheTimeout |
| </h3></div></div></div><a class="indexterm" name="d0e13734"></a><a class="indexterm" name="d0e13737"></a><p> |
| <span class="bold"><strong>Property name: </strong></span><code class="literal"> |
| openjpa.DataCacheTimeout</code> |
| </p><p> |
| <span class="bold"><strong>Configuration API:</strong></span> |
| <a xmlns:xlink="http://www.w3.org/1999/xlink" href="../javadoc/org/apache/openjpa/conf/OpenJPAConfiguration.html#getDataCacheTimeout" target="_top"> |
| <code class="methodname">org.apache.openjpa.conf.OpenJPAConfiguration.getDataCacheTimeout |
| </code></a> |
| </p><p> |
| <span class="bold"><strong>Resource adaptor config-property: </strong></span><code class="literal"> |
| DataCacheTimeout</code> |
| </p><p> |
| <span class="bold"><strong>Default: </strong></span><code class="literal">-1</code> |
| </p><p> |
| <span class="bold"><strong>Description:</strong></span> The number of milliseconds that |
| data in the data cache is valid. Set this to -1 to indicate that data should not |
| expire from the cache. This property can also be specified for individual |
| classes. See <a href="ref_guide_caching.html#ref_guide_cache_conf" title="1.1. Data Cache Configuration">Section 1.1, “ |
| Data Cache Configuration |
| ”</a> for details. |
| </p></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="openjpa.DetachState"></a>5.28. |
| openjpa.DetachState |
| </h3></div></div></div><a class="indexterm" name="d0e13783"></a><a class="indexterm" name="d0e13786"></a><p> |
| <span class="bold"><strong>Property name: </strong></span><code class="literal">openjpa.DetachState |
| </code> |
| </p><p> |
| <span class="bold"><strong>Configuration API:</strong></span> |
| <a xmlns:xlink="http://www.w3.org/1999/xlink" href="../javadoc/org/apache/openjpa/conf/OpenJPAConfiguration.html#getDetachState" target="_top"> |
| <code class="methodname">org.apache.openjpa.conf.OpenJPAConfiguration.getDetachState |
| </code></a> |
| </p><p> |
| <span class="bold"><strong>Resource adaptor config-property: </strong></span><code class="literal"> |
| DetachState</code> |
| </p><p> |
| <span class="bold"><strong>Default: </strong></span><code class="literal">loaded</code> |
| </p><p> |
| <span class="bold"><strong>Possible values: </strong></span><code class="literal">loaded</code>, |
| <code class="literal">fetch-groups</code>, <code class="literal">all</code> |
| </p><p> |
| <span class="bold"><strong>Description:</strong></span> Determines which fields are part |
| of the detached graph and related options. For more details, see |
| <a href="ref_guide_remote.html#ref_guide_detach_graph" title="1.3. Defining the Detached Object Graph">Section 1.3, “ |
| Defining the Detached Object Graph |
| ”</a>. |
| </p></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="openjpa.DynamicDataStructs"></a>5.29. |
| openjpa.DynamicDataStructs |
| </h3></div></div></div><a class="indexterm" name="d0e13847"></a><a class="indexterm" name="d0e13850"></a><a class="indexterm" name="d0e13855"></a><p> |
| <span class="bold"><strong>Property name: </strong></span><code class="literal"> |
| openjpa.DynamicDataStructs</code> |
| </p><p> |
| <span class="bold"><strong>Configuration API:</strong></span> |
| <a xmlns:xlink="http://www.w3.org/1999/xlink" href="../javadoc/org/apache/openjpa/conf/OpenJPAConfiguration.html#getDynamicDataStructs" target="_top"> |
| <code class="methodname">org.apache.openjpa.conf.OpenJPAConfiguration.getDynamicDataStructs |
| </code></a> |
| </p><p> |
| <span class="bold"><strong>Resource adaptor config-property: </strong></span><code class="literal"> |
| DynamicDataStructs</code> |
| </p><p> |
| <span class="bold"><strong>Default: </strong></span><code class="literal">false</code> |
| </p><p> |
| <span class="bold"><strong>Description:</strong></span> Whether to dynamically generate |
| customized structs to hold persistent data. Both the OpenJPA data cache and the |
| remote framework rely on data structs to cache and transfer persistent state. |
| With dynamic structs, OpenJPA can customize data storage for each class, |
| eliminating the need to generate primitive wrapper objects. This saves memory |
| and speeds up certain runtime operations. The price is a longer warm-up time for |
| the application - generating and loading custom classes into the JVM takes time. |
| Therefore, only set this property to <code class="literal">true</code> if you have a |
| long-running application where the initial cost of class generation is offset by |
| memory and speed optimization over time. |
| </p></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="openjpa.FetchBatchSize"></a>5.30. |
| openjpa.FetchBatchSize |
| </h3></div></div></div><a class="indexterm" name="d0e13902"></a><a class="indexterm" name="d0e13905"></a><p> |
| <span class="bold"><strong>Property name: </strong></span><code class="literal">openjpa.FetchBatchSize |
| </code> |
| </p><p> |
| <span class="bold"><strong>Configuration API:</strong></span> |
| <a xmlns:xlink="http://www.w3.org/1999/xlink" href="../javadoc/org/apache/openjpa/conf/OpenJPAConfiguration.html#getFetchBatchSize" target="_top"> |
| <code class="methodname">org.apache.openjpa.conf.OpenJPAConfiguration.getFetchBatchSize |
| </code></a> |
| </p><p> |
| <span class="bold"><strong>Resource adaptor config-property: </strong></span><code class="literal"> |
| FetchBatchSize</code> |
| </p><p> |
| <span class="bold"><strong>Default: </strong></span><code class="literal">-1</code> |
| </p><p> |
| <span class="bold"><strong>Description:</strong></span> The number of rows to fetch at |
| once when scrolling through a result set. The fetch size can also be set at |
| runtime. See <a href="ref_guide_dbsetup_lrs.html" title="9. Large Result Sets">Section 9, “ |
| Large Result Sets |
| ”</a> for details. |
| </p></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="openjpa.FetchGroups"></a>5.31. |
| openjpa.FetchGroups |
| </h3></div></div></div><a class="indexterm" name="d0e13951"></a><p> |
| <span class="bold"><strong>Property name: </strong></span><code class="literal">openjpa.FetchGroups |
| </code> |
| </p><p> |
| <span class="bold"><strong>Configuration API:</strong></span> |
| <a xmlns:xlink="http://www.w3.org/1999/xlink" href="../javadoc/org/apache/openjpa/conf/OpenJPAConfiguration.html#getFetchGroups" target="_top"> |
| <code class="methodname">org.apache.openjpa.conf.OpenJPAConfiguration.getFetchGroups |
| </code></a> |
| </p><p> |
| <span class="bold"><strong>Resource adaptor config-property: </strong></span><code class="literal"> |
| FetchGroups</code> |
| </p><p> |
| <span class="bold"><strong>Default:</strong></span> - |
| </p><p> |
| <span class="bold"><strong>Description:</strong></span> A comma-separated list of fetch |
| group names that are to be loaded when retrieving objects from the datastore. |
| Fetch groups can also be set at runtime. See <a href="ref_guide_fetch.html" title="6. Fetch Groups">Section 6, “ |
| Fetch Groups |
| ”</a> |
| for details. |
| </p></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="openjpa.FlushBeforeQueries"></a>5.32. |
| openjpa.FlushBeforeQueries |
| </h3></div></div></div><a class="indexterm" name="d0e13996"></a><a class="indexterm" name="d0e13999"></a><a class="indexterm" name="d0e14004"></a><p> |
| <span class="bold"><strong>Property name: </strong></span><code class="literal"> |
| openjpa.FlushBeforeQueries</code> |
| </p><p> |
| <span class="bold"><strong>Property name: </strong></span><code class="literal"> |
| openjpa.FlushBeforeQueries</code> |
| </p><p> |
| <span class="bold"><strong>Configuration API:</strong></span> |
| <a xmlns:xlink="http://www.w3.org/1999/xlink" href="../javadoc/org/apache/openjpa/conf/OpenJPAConfiguration.html#getFlushBeforeQueries" target="_top"> |
| <code class="methodname">org.apache.openjpa.conf.OpenJPAConfiguration.getFlushBeforeQueries |
| </code></a> |
| </p><p> |
| <span class="bold"><strong>Resource adaptor config-property: </strong></span><code class="literal"> |
| FlushBeforeQueries</code> |
| </p><p> |
| <span class="bold"><strong>Default: </strong></span><code class="literal">true</code> |
| </p><p> |
| <span class="bold"><strong>Description:</strong></span> Whether or not to flush any |
| changes made in the current transaction to the datastore before executing a |
| query. See <a href="ref_guide_dbsetup_retain.html" title="8. Configuring the Use of JDBC Connections">Section 8, “ |
| Configuring the Use of JDBC Connections |
| ”</a> for details. |
| </p></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="openjpa.IgnoreChanges"></a>5.33. |
| openjpa.IgnoreChanges |
| </h3></div></div></div><a class="indexterm" name="d0e14057"></a><p> |
| <span class="bold"><strong>Property name: </strong></span><code class="literal">openjpa.IgnoreChanges |
| </code> |
| </p><p> |
| <span class="bold"><strong>Configuration API:</strong></span> |
| <a xmlns:xlink="http://www.w3.org/1999/xlink" href="../javadoc/org/apache/openjpa/conf/OpenJPAConfiguration.html#getIgnoreChanges" target="_top"> |
| <code class="methodname">org.apache.openjpa.conf.OpenJPAConfiguration.getIgnoreChanges |
| </code></a> |
| </p><p> |
| <span class="bold"><strong>Resource adaptor config-property: </strong></span><code class="literal"> |
| IgnoreChanges</code> |
| </p><p> |
| <span class="bold"><strong>Default: </strong></span><code class="literal">false</code> |
| </p><p> |
| <span class="bold"><strong>Description:</strong></span> Whether to consider modifications |
| to persistent objects made in the current transaction when evaluating queries. |
| Setting this to <code class="literal">true</code> allows OpenJPA to ignore changes and |
| execute the query directly against the datastore. A value of <code class="literal">false |
| </code> forces OpenJPA to consider whether the changes in the current |
| transaction affect the query, and if so to either evaluate the query in-memory |
| or flush before running it against the datastore. |
| </p></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="openjpa.Id"></a>5.34. openjpa.Id</h3></div></div></div><a class="indexterm" name="d0e14105"></a><p> |
| <span class="bold"><strong>Property name:</strong></span> |
| <code class="literal">openjpa.Id</code> |
| </p><p> |
| <span class="bold"><strong>Resource adaptor config-property:</strong></span> |
| <code class="literal">Id</code> |
| </p><p> |
| <span class="bold"><strong>Default:</strong></span> none |
| </p><p> |
| <span class="bold"><strong>Description:</strong></span> An |
| environment-specific identifier for this configuration. This |
| might correspond to a JPA persistence-unit name, or to some other |
| more-unique value available in the current environment. |
| </p></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="openjpa.InverseManager"></a>5.35. |
| openjpa.InverseManager |
| </h3></div></div></div><a class="indexterm" name="d0e14137"></a><a class="indexterm" name="d0e14140"></a><p> |
| <span class="bold"><strong>Property name: </strong></span><code class="literal">openjpa.InverseManager |
| </code> |
| </p><p> |
| <span class="bold"><strong>Configuration API:</strong></span> |
| <a xmlns:xlink="http://www.w3.org/1999/xlink" href="../javadoc/org/apache/openjpa/conf/OpenJPAConfiguration.html#getInverseManager" target="_top"> |
| <code class="methodname">org.apache.openjpa.conf.OpenJPAConfiguration.getInverseManager |
| </code></a> |
| </p><p> |
| <span class="bold"><strong>Resource adaptor config-property: </strong></span><code class="literal"> |
| InverseManager</code> |
| </p><p> |
| <span class="bold"><strong>Default: </strong></span><code class="literal">false</code> |
| </p><p> |
| <span class="bold"><strong>Possible values: </strong></span><code class="literal">false</code>, |
| <code class="literal">true</code> |
| </p><p> |
| <span class="bold"><strong>Description:</strong></span> A plugin string (see |
| <a href="ref_guide_conf_plugins.html" title="4. Plugin Configuration">Section 4, “ |
| Plugin Configuration |
| ”</a>) describing a |
| <a xmlns:xlink="http://www.w3.org/1999/xlink" href="../javadoc/org/apache/openjpa/kernel/InverseManager.html" target="_top"> |
| <code class="classname">org.apache.openjpa.kernel.InverseManager</code></a> to use |
| for managing bidirectional relations upon a flush. See |
| <a href="ref_guide_inverses.html" title="4. Managed Inverses">Section 4, “ |
| Managed Inverses |
| ”</a> for usage documentation. |
| </p></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="openjpa.LockManager"></a>5.36. |
| openjpa.LockManager |
| </h3></div></div></div><a class="indexterm" name="d0e14203"></a><a class="indexterm" name="d0e14206"></a><p> |
| <span class="bold"><strong>Property name: </strong></span><code class="literal">openjpa.LockManager |
| </code> |
| </p><p> |
| <span class="bold"><strong>Configuration API:</strong></span> |
| <a xmlns:xlink="http://www.w3.org/1999/xlink" href="../javadoc/org/apache/openjpa/conf/OpenJPAConfiguration.html#getLockManager" target="_top"> |
| <code class="methodname">org.apache.openjpa.conf.OpenJPAConfiguration.getLockManager |
| </code></a> |
| </p><p> |
| <span class="bold"><strong>Resource adaptor config-property: </strong></span><code class="literal"> |
| LockManager</code> |
| </p><p> |
| <span class="bold"><strong>Default: </strong></span><code class="literal">version</code> |
| </p><p> |
| <span class="bold"><strong>Possible values: </strong></span><code class="literal">none</code>, |
| <code class="literal">sjvm</code>, <code class="literal">pessimistic</code>, |
| <code class="literal">version</code> |
| </p><p> |
| <span class="bold"><strong>Description:</strong></span> A plugin string (see |
| <a href="ref_guide_conf_plugins.html" title="4. Plugin Configuration">Section 4, “ |
| Plugin Configuration |
| ”</a>) describing a |
| <a xmlns:xlink="http://www.w3.org/1999/xlink" href="../javadoc/org/apache/openjpa/kernel/LockManager.html" target="_top"><code class="classname"> |
| org.apache.openjpa.kernel.LockManager</code></a> to use for acquiring |
| locks on persistent instances during transactions. See |
| <a href="ref_guide_locking.html#ref_guide_locking_lockmgr" title="3.4. Lock Manager">Section 3.4, “ |
| Lock Manager |
| ”</a> for more information. |
| </p></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="openjpa.LockTimeout"></a>5.37. |
| openjpa.LockTimeout |
| </h3></div></div></div><a class="indexterm" name="d0e14274"></a><a class="indexterm" name="d0e14277"></a><p> |
| <span class="bold"><strong>Property name: </strong></span><code class="literal">openjpa.LockTimeout |
| </code> |
| </p><p> |
| <span class="bold"><strong>Configuration API:</strong></span> |
| <a xmlns:xlink="http://www.w3.org/1999/xlink" href="../javadoc/org/apache/openjpa/conf/OpenJPAConfiguration.html#getLockTimeout" target="_top"> |
| <code class="methodname">org.apache.openjpa.conf.OpenJPAConfiguration.getLockTimeout |
| </code></a> |
| </p><p> |
| <span class="bold"><strong>Resource adaptor config-property: </strong></span><code class="literal"> |
| LockTimeout</code> |
| </p><p> |
| <span class="bold"><strong>Default: </strong></span><code class="literal">-1</code> |
| </p><p> |
| <span class="bold"><strong>Description:</strong></span> The number of milliseconds to wait |
| for an object lock before throwing an exception, or -1 for no limit. See |
| <a href="ref_guide_locking.html" title="3. Object Locking">Section 3, “ |
| Object Locking |
| ”</a> for details. |
| </p></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="openjpa.Log"></a>5.38. |
| openjpa.Log |
| </h3></div></div></div><a class="indexterm" name="d0e14323"></a><a class="indexterm" name="d0e14326"></a><p> |
| <span class="bold"><strong>Property name: </strong></span><code class="literal">openjpa.Log</code> |
| </p><p> |
| <span class="bold"><strong>Configuration API:</strong></span> |
| <a xmlns:xlink="http://www.w3.org/1999/xlink" href="../javadoc/org/apache/openjpa/conf/OpenJPAConfiguration.html#getLog" target="_top"> |
| <code class="methodname">org.apache.openjpa.conf.OpenJPAConfiguration.getLog</code> |
| </a> |
| </p><p> |
| <span class="bold"><strong>Resource adaptor config-property: </strong></span><code class="literal">Log |
| </code> |
| </p><p> |
| <span class="bold"><strong>Default: </strong></span><code class="literal">true</code> |
| </p><p> |
| <span class="bold"><strong>Possible values: </strong></span><code class="literal">openjpa</code>, |
| <code class="literal">commons</code>, <code class="literal">log4j</code>, <code class="literal">none</code> |
| </p><p> |
| <span class="bold"><strong>Description:</strong></span> A plugin string (see |
| <a href="ref_guide_conf_plugins.html" title="4. Plugin Configuration">Section 4, “ |
| Plugin Configuration |
| ”</a>) describing a |
| <a xmlns:xlink="http://www.w3.org/1999/xlink" href="../javadoc/org/apache/openjpa/lib/log/LogFactory.html" target="_top"><code class="classname"> |
| org.apache.openjpa.lib.log.LogFactory</code></a> to use for logging. |
| For details on logging, see <a href="ref_guide_logging.html" title="Chapter 3. Logging">Chapter 3, <i xmlns:xlink="http://www.w3.org/1999/xlink"> |
| Logging |
| </i></a>. |
| </p></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="openjpa.ManagedRuntime"></a>5.39. |
| openjpa.ManagedRuntime |
| </h3></div></div></div><a class="indexterm" name="d0e14395"></a><a class="indexterm" name="d0e14398"></a><p> |
| <span class="bold"><strong>Property name: </strong></span><code class="literal">openjpa.ManagedRuntime |
| </code> |
| </p><p> |
| <span class="bold"><strong>Configuration API:</strong></span> |
| <a xmlns:xlink="http://www.w3.org/1999/xlink" href="../javadoc/org/apache/openjpa/conf/OpenJPAConfiguration.html#getManagedRuntime" target="_top"> |
| <code class="methodname">org.apache.openjpa.conf.OpenJPAConfiguration.getManagedRuntime |
| </code></a> |
| </p><p> |
| <span class="bold"><strong>Resource adaptor config-property: </strong></span><code class="literal"> |
| ManagedRuntime</code> |
| </p><p> |
| <span class="bold"><strong>Default: </strong></span><code class="literal">auto</code> |
| </p><p> |
| <span class="bold"><strong>Description:</strong></span> A plugin string (see |
| <a href="ref_guide_conf_plugins.html" title="4. Plugin Configuration">Section 4, “ |
| Plugin Configuration |
| ”</a>) describing the |
| <a xmlns:xlink="http://www.w3.org/1999/xlink" href="../javadoc/org/apache/openjpa/ee/ManagedRuntime.html" target="_top"><code class="classname"> |
| org.apache.openjpa.ee.ManagedRuntime</code></a> implementation to use |
| for obtaining a reference to the <code class="classname">TransactionManager</code> in an |
| enterprise environment. |
| </p></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="openjpa.Mapping"></a>5.40. |
| openjpa.Mapping |
| </h3></div></div></div><a class="indexterm" name="d0e14453"></a><p> |
| <span class="bold"><strong>Property name: </strong></span><code class="literal">openjpa.Mapping |
| </code> |
| </p><p> |
| <span class="bold"><strong>Configuration API:</strong></span> |
| <a xmlns:xlink="http://www.w3.org/1999/xlink" href="../javadoc/org/apache/openjpa/conf/OpenJPAConfiguration.html#getMapping" target="_top"> |
| <code class="methodname">org.apache.openjpa.conf.OpenJPAConfiguration.getMapping</code> |
| </a> |
| </p><p> |
| <span class="bold"><strong>Resource adaptor config-property: </strong></span><code class="literal"> |
| Mapping</code> |
| </p><p> |
| <span class="bold"><strong>Default:</strong></span> - |
| </p><p> |
| <span class="bold"><strong>Description:</strong></span> The symbolic name of the |
| object-to-datastore mapping to use. |
| </p></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="openjpa.MaxFetchDepth"></a>5.41. |
| openjpa.MaxFetchDepth |
| </h3></div></div></div><a class="indexterm" name="d0e14494"></a><a class="indexterm" name="d0e14497"></a><p> |
| <span class="bold"><strong>Property name: </strong></span><code class="literal">openjpa.MaxFetchDepth |
| </code> |
| </p><p> |
| <span class="bold"><strong>Configuration API:</strong></span> |
| <a xmlns:xlink="http://www.w3.org/1999/xlink" href="../javadoc/org/apache/openjpa/conf/OpenJPAConfiguration.html#getMaxFetchDepth" target="_top"> |
| <code class="methodname">org.apache.openjpa.conf.OpenJPAConfiguration.getMaxFetchDepth |
| </code></a> |
| </p><p> |
| <span class="bold"><strong>Resource adaptor config-property: </strong></span><code class="literal"> |
| MaxFetchDepth</code> |
| </p><p> |
| <span class="bold"><strong>Default: </strong></span><code class="literal">-1</code> |
| </p><p> |
| <span class="bold"><strong>Description:</strong></span> The maximum depth of relations to |
| traverse when eager fetching. Use -1 for no limit. Defaults to no limit. See |
| <a href="ref_guide_perfpack_eager.html" title="7. Eager Fetching">Section 7, “ |
| Eager Fetching |
| ”</a> for details on eager fetching. |
| </p></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="openjpa.MetaDataFactory"></a>5.42. |
| openjpa.MetaDataFactory |
| </h3></div></div></div><a class="indexterm" name="d0e14543"></a><a class="indexterm" name="d0e14546"></a><p> |
| <span class="bold"><strong>Property name: </strong></span><code class="literal">openjpa.MetaDataFactory |
| </code> |
| </p><p> |
| <span class="bold"><strong>Configuration API:</strong></span> |
| <a xmlns:xlink="http://www.w3.org/1999/xlink" href="../javadoc/org/apache/openjpa/conf/OpenJPAConfiguration.html#getMetaDataFactory" target="_top"> |
| <code class="methodname">org.apache.openjpa.conf.OpenJPAConfiguration.getMetaDataFactory |
| </code></a> |
| </p><p> |
| <span class="bold"><strong>Resource adaptor config-property: </strong></span><code class="literal"> |
| MetaDataFactory</code> |
| </p><p> |
| <span class="bold"><strong>Default:</strong></span> <code class="literal">jpa</code> |
| </p><p> |
| <span class="bold"><strong>Description:</strong></span> A plugin string (see |
| <a href="ref_guide_conf_plugins.html" title="4. Plugin Configuration">Section 4, “ |
| Plugin Configuration |
| ”</a>) describing the |
| <a xmlns:xlink="http://www.w3.org/1999/xlink" href="../javadoc/org/apache/openjpa/meta/MetaDataFactory.html" target="_top"> |
| <code class="classname">openjpa.meta.MetaDataFactory</code></a> to use to store and |
| retrieve metadata for your persistent classes. See |
| <a href="ref_guide_meta.html#ref_guide_meta_factory" title="1. Metadata Factory">Section 1, “ |
| Metadata Factory |
| ”</a> for details. |
| </p></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="openjpa.Multithreaded"></a>5.43. |
| openjpa.Multithreaded |
| </h3></div></div></div><a class="indexterm" name="d0e14600"></a><a class="indexterm" name="d0e14603"></a><p> |
| <span class="bold"><strong>Property name: </strong></span><code class="literal">openjpa.Multithreaded |
| </code> |
| </p><p> |
| <span class="bold"><strong>Configuration API:</strong></span> |
| <a xmlns:xlink="http://www.w3.org/1999/xlink" href="../javadoc/org/apache/openjpa/conf/OpenJPAConfiguration.html#getMultithreaded" target="_top"> |
| <code class="methodname">org.apache.openjpa.conf.OpenJPAConfiguration.getMultithreaded |
| </code></a> |
| </p><p> |
| <span class="bold"><strong>Resource adaptor config-property: </strong></span><code class="literal"> |
| Multithreaded</code> |
| </p><p> |
| <span class="bold"><strong>Default: </strong></span><code class="literal">false</code> |
| </p><p> |
| <span class="bold"><strong>Description:</strong></span> Whether persistent instances and |
| OpenJPA components other than the <code class="classname">EntityManagerFactory</code> |
| will be accessed by multiple threads at once. |
| </p></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="openjpa.Optimistic"></a>5.44. |
| openjpa.Optimistic |
| </h3></div></div></div><a class="indexterm" name="d0e14650"></a><a class="indexterm" name="d0e14653"></a><p> |
| <span class="bold"><strong>Property name: </strong></span><code class="literal">openjpa.Optimistic |
| </code> |
| </p><p> |
| <span class="bold"><strong>Configuration API:</strong></span> |
| <a xmlns:xlink="http://www.w3.org/1999/xlink" href="../javadoc/org/apache/openjpa/conf/OpenJPAConfiguration.html#getOptimistic" target="_top"> |
| <code class="methodname">org.apache.openjpa.conf.OpenJPAConfiguration.getOptimistic |
| </code></a> |
| </p><p> |
| <span class="bold"><strong>Resource adaptor config-property: </strong></span><code class="literal"> |
| Optimistic</code> |
| </p><p> |
| <span class="bold"><strong>Default: </strong></span><code class="literal">true</code> |
| </p><p> |
| <span class="bold"><strong>Description:</strong></span> Selects between optimistic and |
| pessimistic (datastore) transactional modes. |
| </p></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="openjpa.OrphanedKeyAction"></a>5.45. |
| openjpa.OrphanedKeyAction |
| </h3></div></div></div><a class="indexterm" name="d0e14697"></a><a class="indexterm" name="d0e14700"></a><p> |
| <span class="bold"><strong>Property name: </strong></span><code class="literal"> |
| openjpa.OrphanedKeyAction</code> |
| </p><p> |
| <span class="bold"><strong>Configuration API:</strong></span> |
| <a xmlns:xlink="http://www.w3.org/1999/xlink" href="../javadoc/org/apache/openjpa/conf/OpenJPAConfiguration.html#getOrphanedKeyAction" target="_top"> |
| <code class="methodname">org.apache.openjpa.conf.OpenJPAConfiguration.getOrphanedKeyAction |
| </code></a> |
| </p><p> |
| <span class="bold"><strong>Resource adaptor config-property: </strong></span><code class="literal"> |
| OrphanedKeyAction</code> |
| </p><p> |
| <span class="bold"><strong>Default: </strong></span><code class="literal">log</code> |
| </p><p> |
| <span class="bold"><strong>Possible values: </strong></span><code class="literal">log</code>, |
| <code class="literal">exception</code>, <code class="literal">none</code> |
| </p><p> |
| <span class="bold"><strong>Description:</strong></span> A plugin string (see |
| <a href="ref_guide_conf_plugins.html" title="4. Plugin Configuration">Section 4, “ |
| Plugin Configuration |
| ”</a>) describing a |
| <a xmlns:xlink="http://www.w3.org/1999/xlink" href="../javadoc/org/apache/openjpa/event/OrphanedKeyAction.html" target="_top"> |
| <code class="classname">org.apache.openjpa.event.OrphanedKeyAction</code></a> to |
| invoke when OpenJPA discovers an orphaned datastore key. See |
| <a href="ref_guide_orphan.html" title="11. Orphaned Keys">Section 11, “ |
| Orphaned Keys |
| ”</a> for details. |
| </p></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="openjpa.NontransactionalRead"></a>5.46. |
| openjpa.NontransactionalRead |
| </h3></div></div></div><a class="indexterm" name="d0e14766"></a><p> |
| <span class="bold"><strong>Property name: </strong></span><code class="literal"> |
| openjpa.NontransactionalRead</code> |
| </p><p> |
| <span class="bold"><strong>Configuration API:</strong></span> |
| <a xmlns:xlink="http://www.w3.org/1999/xlink" href="../javadoc/org/apache/openjpa/conf/OpenJPAConfiguration.html#getNontransactionalRead" target="_top"> |
| <code class="methodname"> |
| org.apache.openjpa.conf.OpenJPAConfiguration.getNontransactionalRead |
| </code></a> |
| </p><p> |
| <span class="bold"><strong>Resource adaptor config-property: </strong></span><code class="literal"> |
| NontransactionalRead</code> |
| </p><p> |
| <span class="bold"><strong>Default: </strong></span><code class="literal">true</code> |
| </p><p> |
| <span class="bold"><strong>Description:</strong></span> Whether the OpenJPA runtime will |
| allow you to read data outside of a transaction. |
| </p></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="openjpa.NontransactionalWrite"></a>5.47. |
| openjpa.NontransactionalWrite |
| </h3></div></div></div><a class="indexterm" name="d0e14808"></a><p> |
| <span class="bold"><strong>Property name: </strong></span><code class="literal"> |
| openjpa.NontransactionalWrite</code> |
| </p><p> |
| <span class="bold"><strong>Configuration API:</strong></span> |
| <a xmlns:xlink="http://www.w3.org/1999/xlink" href="../javadoc/org/apache/openjpa/conf/OpenJPAConfiguration.html#getNontransactionalWrite" target="_top"> |
| <code class="methodname"> |
| org.apache.openjpa.conf.OpenJPAConfiguration.getNontransactionalWrite |
| </code></a> |
| </p><p> |
| <span class="bold"><strong>Resource adaptor config-property: </strong></span><code class="literal"> |
| NontransactionalWrite</code> |
| </p><p> |
| <span class="bold"><strong>Default:</strong></span> <code class="literal">false</code> |
| </p><p> |
| <span class="bold"><strong>Description:</strong></span> Whether you can modify persistent |
| objects and perform persistence operations outside of a transaction. Changes |
| will take effect on the next transaction. |
| </p></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="openjpa.ProxyManager"></a>5.48. |
| openjpa.ProxyManager |
| </h3></div></div></div><a class="indexterm" name="d0e14851"></a><a class="indexterm" name="d0e14854"></a><p> |
| <span class="bold"><strong>Property name: </strong></span><code class="literal">openjpa.ProxyManager |
| </code> |
| </p><p> |
| <span class="bold"><strong>Configuration API:</strong></span> |
| <a xmlns:xlink="http://www.w3.org/1999/xlink" href="../javadoc/org/apache/openjpa/conf/OpenJPAConfiguration.html#getProxyManager" target="_top"> |
| <code class="methodname">org.apache.openjpa.conf.OpenJPAConfiguration.getProxyManager |
| </code></a> |
| </p><p> |
| <span class="bold"><strong>Resource adaptor config-property: </strong></span><code class="literal"> |
| ProxyManager</code> |
| </p><p> |
| <span class="bold"><strong>Default: </strong></span><code class="literal">default</code> |
| </p><p> |
| <span class="bold"><strong>Description:</strong></span> A plugin string (see |
| <a href="ref_guide_conf_plugins.html" title="4. Plugin Configuration">Section 4, “ |
| Plugin Configuration |
| ”</a>) describing a |
| <a xmlns:xlink="http://www.w3.org/1999/xlink" href="../javadoc/org/apache/openjpa/util/ProxyManager.html" target="_top"><code class="classname"> |
| org.apache.openjpa.util.ProxyManager</code></a> to use for proxying |
| mutable second class objects. See |
| <a href="ref_guide_pc_scos.html#ref_guide_pc_scos_proxy_custom" title="5.4.3. Custom Proxies">Section 5.4.3, “ |
| Custom Proxies |
| ”</a> for details. |
| </p></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="openjpa.QueryCache"></a>5.49. |
| openjpa.QueryCache |
| </h3></div></div></div><a class="indexterm" name="d0e14906"></a><a class="indexterm" name="d0e14909"></a><p> |
| <span class="bold"><strong>Property name: </strong></span><code class="literal">openjpa.QueryCache |
| </code> |
| </p><p> |
| <span class="bold"><strong>Configuration API:</strong></span> |
| <a xmlns:xlink="http://www.w3.org/1999/xlink" href="../javadoc/org/apache/openjpa/conf/OpenJPAConfiguration.html#getQueryCache" target="_top"> |
| <code class="methodname">org.apache.openjpa.conf.OpenJPAConfiguration.getQueryCache |
| </code></a> |
| </p><p> |
| <span class="bold"><strong>Resource adaptor config-property: </strong></span><code class="literal"> |
| QueryCache</code> |
| </p><p> |
| <span class="bold"><strong>Default: </strong></span><code class="literal">true</code>, when the data |
| cache (see <a href="ref_guide_conf_openjpa.html#openjpa.DataCache" title="5.25. openjpa.DataCache">Section 5.25, “ |
| openjpa.DataCache |
| ”</a>) is also enabled, <code class="literal"> |
| false</code> otherwise. |
| </p><p> |
| <span class="bold"><strong>Description:</strong></span> A plugin string (see |
| <a href="ref_guide_conf_plugins.html" title="4. Plugin Configuration">Section 4, “ |
| Plugin Configuration |
| ”</a>) describing the |
| <a xmlns:xlink="http://www.w3.org/1999/xlink" href="../javadoc/org/apache/openjpa/datacache/QueryCache.html" target="_top"> |
| <code class="classname">org.apache.openjpa.datacache.QueryCache</code></a> |
| implementation to use for caching of queries loaded from the data store. See |
| <a href="ref_guide_caching.html#ref_guide_cache_query" title="1.3. Query Cache">Section 1.3, “ |
| Query Cache |
| ”</a> for details. |
| </p></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="openjpa.QueryCompilationCache"></a>5.50. |
| openjpa.QueryCompilationCache |
| </h3></div></div></div><a class="indexterm" name="d0e14967"></a><a class="indexterm" name="d0e14970"></a><p> |
| <span class="bold"><strong>Property name:</strong></span> |
| <code class="literal">openjpa.QueryCompilationCache</code> |
| </p><p> |
| <span class="bold"><strong>Resource adaptor config-property:</strong></span> |
| <code class="literal">QueryCompilationCache</code> |
| </p><p> |
| <span class="bold"><strong>Default:</strong></span> <code class="literal">true</code>. |
| </p><p> |
| <span class="bold"><strong>Description:</strong></span> A plugin string (see |
| <a href="ref_guide_conf_plugins.html" title="4. Plugin Configuration">Section 4, “ |
| Plugin Configuration |
| ”</a>) describing the |
| <code class="classname">java.util.Map</code> to use for caching of data used during |
| query compilation. See <a href="ref_guide_cache_querycomp.html" title="2. Query Compilation Cache">Section 2, “ |
| Query Compilation Cache |
| ”</a> for details. |
| </p></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="openjpa.ReadLockLevel"></a>5.51. |
| openjpa.ReadLockLevel |
| </h3></div></div></div><a class="indexterm" name="d0e15014"></a><a class="indexterm" name="d0e15017"></a><p> |
| <span class="bold"><strong>Property name: </strong></span><code class="literal">openjpa.ReadLockLevel |
| </code> |
| </p><p> |
| <span class="bold"><strong>Configuration API:</strong></span> |
| <a xmlns:xlink="http://www.w3.org/1999/xlink" href="../javadoc/org/apache/openjpa/conf/OpenJPAConfiguration.html#getReadLockLevel" target="_top"> |
| <code class="methodname">org.apache.openjpa.conf.OpenJPAConfiguration.getReadLockLevel |
| </code></a> |
| </p><p> |
| <span class="bold"><strong>Resource adaptor config-property: </strong></span><code class="literal"> |
| ReadLockLevel</code> |
| </p><p> |
| <span class="bold"><strong>Default: </strong></span><code class="literal">read</code> |
| </p><p> |
| <span class="bold"><strong>Possible values: </strong></span><code class="literal">none</code>, |
| <code class="literal">read</code>, <code class="literal">write</code>, numeric values for |
| lock-manager specific lock levels |
| </p><p> |
| <span class="bold"><strong>Description:</strong></span> The default level at which to lock |
| objects retrieved during a non-optimistic transaction. Note that for the default |
| JDBC lock manager, <code class="literal"> read</code> and <code class="literal">write</code> lock |
| levels are equivalent. |
| </p></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="openjpa.RemoteCommitProvider"></a>5.52. |
| openjpa.RemoteCommitProvider |
| </h3></div></div></div><a class="indexterm" name="d0e15080"></a><a class="indexterm" name="d0e15083"></a><a class="indexterm" name="d0e15088"></a><p> |
| <span class="bold"><strong>Property name: </strong></span><code class="literal"> |
| openjpa.RemoteCommitProvider</code> |
| </p><p> |
| <span class="bold"><strong>Configuration API:</strong></span> |
| <a xmlns:xlink="http://www.w3.org/1999/xlink" href="../javadoc/org/apache/openjpa/conf/OpenJPAConfiguration.html#getRemoteCommitProvider" target="_top"> |
| <code class="methodname"> |
| org.apache.openjpa.conf.OpenJPAConfiguration.getRemoteCommitProvider |
| </code></a> |
| </p><p> |
| <span class="bold"><strong>Resource adaptor config-property: </strong></span><code class="literal"> |
| RemoteCommitProvider</code> |
| </p><p> |
| <span class="bold"><strong>Default:</strong></span> - |
| </p><p> |
| <span class="bold"><strong>Description:</strong></span> A plugin string (see |
| <a href="ref_guide_conf_plugins.html" title="4. Plugin Configuration">Section 4, “ |
| Plugin Configuration |
| ”</a>) describing the |
| <a xmlns:xlink="http://www.w3.org/1999/xlink" href="../javadoc/org/apache/openjpa/event/RemoteCommitProvider.html" target="_top"> |
| <code class="classname">org.apache.openjpa.event.RemoteCommitProvider</code></a> |
| implementation to use for distributed event notification. See |
| <a href="ref_guide_event.html#ref_guide_event_conf" title="2.1. Remote Commit Provider Configuration">Section 2.1, “ |
| Remote Commit Provider Configuration |
| ”</a> for more information. |
| </p></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="openjpa.RestoreState"></a>5.53. |
| openjpa.RestoreState |
| </h3></div></div></div><a class="indexterm" name="d0e15139"></a><p> |
| <span class="bold"><strong>Property name: </strong></span><code class="literal">openjpa.RestoreState |
| </code> |
| </p><p> |
| <span class="bold"><strong>Configuration API:</strong></span> |
| <a xmlns:xlink="http://www.w3.org/1999/xlink" href="../javadoc/org/apache/openjpa/conf/OpenJPAConfiguration.html#getRestoreState" target="_top"> |
| <code class="methodname">org.apache.openjpa.conf.OpenJPAConfiguration.getRestoreState |
| </code></a> |
| </p><p> |
| <span class="bold"><strong>Resource adaptor config-property: </strong></span><code class="literal"> |
| RestoreState</code> |
| </p><p> |
| <span class="bold"><strong>Default: </strong></span><code class="literal">none</code> |
| </p><p> |
| <span class="bold"><strong>Possible values: </strong></span><code class="literal">none</code>, |
| <code class="literal">immutable</code>, <code class="literal">all</code> |
| </p><p> |
| <span class="bold"><strong>Description:</strong></span> Whether to restore managed fields |
| to their pre-transaction values when a rollback occurs. |
| </p></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="openjpa.RetainState"></a>5.54. |
| openjpa.RetainState |
| </h3></div></div></div><a class="indexterm" name="d0e15194"></a><p> |
| <span class="bold"><strong>Property name: </strong></span><code class="literal">openjpa.RetainState |
| </code> |
| </p><p> |
| <span class="bold"><strong>Configuration API:</strong></span> |
| <a xmlns:xlink="http://www.w3.org/1999/xlink" href="../javadoc/org/apache/openjpa/conf/OpenJPAConfiguration.html#getRetainState" target="_top"> |
| <code class="methodname">org.apache.openjpa.conf.OpenJPAConfiguration.getRetainState |
| </code></a> |
| </p><p> |
| <span class="bold"><strong>Resource adaptor config-property: </strong></span><code class="literal"> |
| RetainState</code> |
| </p><p> |
| <span class="bold"><strong>Default: </strong></span><code class="literal">true</code> |
| </p><p> |
| <span class="bold"><strong>Description:</strong></span> Whether persistent fields retain |
| their values on transaction commit. |
| </p></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="openjpa.RetryClassRegistration"></a>5.55. |
| openjpa.RetryClassRegistration |
| </h3></div></div></div><a class="indexterm" name="d0e15236"></a><a class="indexterm" name="d0e15239"></a><p> |
| <span class="bold"><strong>Property name: </strong></span><code class="literal"> |
| openjpa.RetryClassRegistration</code> |
| </p><p> |
| <span class="bold"><strong>Configuration API:</strong></span> |
| <a xmlns:xlink="http://www.w3.org/1999/xlink" href="../javadoc/org/apache/openjpa/conf/OpenJPAConfiguration.html#getRetryClassRegistration" target="_top"> |
| <code class="methodname"> |
| org.apache.openjpa.conf.OpenJPAConfiguration.getRetryClassRegistration |
| </code></a> |
| </p><p> |
| <span class="bold"><strong>Resource adaptor config-property: </strong></span><code class="literal"> |
| RetryClassRegistration</code> |
| </p><p> |
| <span class="bold"><strong>Default: </strong></span><code class="literal">false</code> |
| </p><p> |
| <span class="bold"><strong>Description:</strong></span> Controls whether to log a warning |
| and defer registration instead of throwing an exception when a persistent class |
| cannot be fully processed. This property should <span class="emphasis"><em>only</em></span> be |
| used in complex classloader situations where security is preventing OpenJPA from |
| reading registered classes. Setting this to true unnecessarily may obscure more |
| serious problems. |
| </p></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="openjpa.RuntimeUnenhancedClasses"></a>5.56. openjpa.RuntimeUnenhancedClasses</h3></div></div></div><p> |
| <span class="bold"><strong>Property name: </strong></span> |
| <code class="literal">openjpa.RuntimeUnenhancedClasses</code> |
| </p><p> |
| <span class="bold"><strong>Configuration API: </strong></span> |
| <a xmlns:xlink="http://www.w3.org/1999/xlink" href="../javadoc/org/apache/openjpa/conf/OpenJPAConfiguration.html#getRuntimeUnenhancedClasses()" target="_top">org.apache.openjpa.conf.OpenJPAConfiguration.getRuntimeUnenhancedClasses</a> |
| </p><p> |
| <span class="bold"><strong>Resource adaptor config property:</strong></span> |
| RuntimeUnenhancedClasses |
| </p><p> |
| <span class="bold"><strong>Default: </strong></span> |
| <code class="literal">supported</code> |
| |
| </p><p> |
| <span class="bold"><strong>Possible values:</strong></span> |
| <code class="literal">supported</code>, |
| <code class="literal">unsupported</code>, |
| <code class="literal">warn</code> |
| </p><p> |
| <span class="bold"><strong>Description:</strong></span> |
| The RuntimeUnenhancedClasses property controls how OpenJPA |
| handles classes that have not been enhanced byt the PCEnhancer |
| tool or automatically by a javaagent. If RuntimeUnenhanced is |
| set to <code class="literal">supported</code> OpenJPA will automatically |
| create subclasses for unenhanced entity classes. If set to |
| <code class="literal">unsupported</code>OpenJPA will not create subclasses |
| for unenhanced entity classes and will throw an exception when |
| they are detected. If set to <code class="literal">warn</code> OpenJPA |
| will not create subclasses for unenhanced entity classes |
| but will log a warning message. |
| </p><p> |
| See the reference guide section on unenhanced types for more |
| information |
| <a href="ref_guide_pc_enhance.html#ref_guide_pc_enhance_unenhanced_types" title="2.4. Omitting the OpenJPA enhancer">Section 2.4, “ |
| Omitting the OpenJPA enhancer |
| ”</a> |
| </p></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="openjpa.SavepointManager"></a>5.57. |
| openjpa.SavepointManager |
| </h3></div></div></div><p> |
| <span class="bold"><strong>Property name: </strong></span><code class="literal"> |
| openjpa.SavepointManager</code> |
| </p><p> |
| <span class="bold"><strong>Configuration API:</strong></span> |
| <a xmlns:xlink="http://www.w3.org/1999/xlink" href="../javadoc/org/apache/openjpa/conf/OpenJPAConfiguration.html#getSavepointManager" target="_top"> |
| org.apache.openjpa.conf.OpenJPAConfiguration.getSavepointManager</a> |
| </p><p> |
| <span class="bold"><strong>Resource adaptor config-property:</strong></span> |
| SavepointManager |
| </p><p> |
| <span class="bold"><strong>Default: </strong></span><code class="literal">in-mem</code> |
| </p><p> |
| <span class="bold"><strong>Possible values: </strong></span><code class="literal">in-mem</code>, |
| <code class="literal">jdbc</code>, <code class="literal">oracle</code> |
| </p><p> |
| <span class="bold"><strong>Description:</strong></span> A plugin string (see |
| <a href="ref_guide_conf_plugins.html" title="4. Plugin Configuration">Section 4, “ |
| Plugin Configuration |
| ”</a>) describing a |
| <a xmlns:xlink="http://www.w3.org/1999/xlink" href="../javadoc/org/apache/openjpa/kernel/SavepointManager.html" target="_top"> |
| <code class="classname">org.apache.openjpa.kernel.SavepointManager</code></a> to |
| use for managing transaction savepoints. See |
| <a href="ref_guide_savepoints.html" title="4. Savepoints">Section 4, “ |
| Savepoints |
| ”</a> for details. |
| </p></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="openjpa.Sequence"></a>5.58. |
| openjpa.Sequence |
| </h3></div></div></div><a class="indexterm" name="d0e15407"></a><p> |
| <span class="bold"><strong>Property name: </strong></span><code class="literal">openjpa.Sequence |
| </code> |
| </p><p> |
| <span class="bold"><strong>Configuration API:</strong></span> |
| <a xmlns:xlink="http://www.w3.org/1999/xlink" href="../javadoc/org/apache/openjpa/conf/OpenJPAConfiguration.html#getSequence" target="_top"> |
| <code class="methodname">org.apache.openjpa.conf.OpenJPAConfiguration.getSequence |
| </code></a> |
| </p><p> |
| <span class="bold"><strong>Resource adaptor config-property: </strong></span><code class="literal"> |
| Sequence</code> |
| </p><p> |
| <span class="bold"><strong>Default: </strong></span><code class="literal">table</code> |
| </p><p> |
| <span class="bold"><strong>Description:</strong></span> A plugin string (see |
| <a href="ref_guide_conf_plugins.html" title="4. Plugin Configuration">Section 4, “ |
| Plugin Configuration |
| ”</a>) describing the |
| <a xmlns:xlink="http://www.w3.org/1999/xlink" href="../javadoc/org/apache/openjpa/kernel/Seq.html" target="_top"><code class="classname"> |
| org.apache.openjpa.kernel.Seq</code></a> implementation to use for the |
| system sequence. See <a href="ref_guide_sequence.html" title="6. Generators">Section 6, “ |
| Generators |
| ”</a> for more |
| information. |
| </p></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="openjpa.TransactionMode"></a>5.59. |
| openjpa.TransactionMode |
| </h3></div></div></div><a class="indexterm" name="d0e15457"></a><a class="indexterm" name="d0e15460"></a><p> |
| <span class="bold"><strong>Property name: </strong></span><code class="literal">openjpa.TransactionMode |
| </code> |
| </p><p> |
| <span class="bold"><strong>Configuration API:</strong></span> |
| <a xmlns:xlink="http://www.w3.org/1999/xlink" href="../javadoc/org/apache/openjpa/conf/OpenJPAConfiguration.html#getTransactionMode" target="_top"> |
| <code class="methodname">org.apache.openjpa.conf.OpenJPAConfiguration.getTransactionMode |
| </code></a> |
| </p><p> |
| <span class="bold"><strong>Resource adaptor config-property: </strong></span><code class="literal"> |
| TransactionMode</code> |
| </p><p> |
| <span class="bold"><strong>Default: </strong></span><code class="literal">local</code> |
| </p><p> |
| <span class="bold"><strong>Possible values: </strong></span><code class="literal">local</code>, |
| <code class="literal">managed</code> |
| </p><p> |
| <span class="bold"><strong>Description:</strong></span> The default transaction mode to |
| use. You can override this setting per-session. |
| </p></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="openjpa.WriteLockLevel"></a>5.60. |
| openjpa.WriteLockLevel |
| </h3></div></div></div><a class="indexterm" name="d0e15514"></a><a class="indexterm" name="d0e15517"></a><p> |
| <span class="bold"><strong>Property name: </strong></span><code class="literal">openjpa.WriteLockLevel |
| </code> |
| </p><p> |
| <span class="bold"><strong>Configuration API:</strong></span> |
| <a xmlns:xlink="http://www.w3.org/1999/xlink" href="../javadoc/org/apache/openjpa/conf/OpenJPAConfiguration.html#getWriteLockLevel" target="_top"> |
| <code class="methodname">org.apache.openjpa.conf.OpenJPAConfiguration.getWriteLockLevel |
| </code></a> |
| </p><p> |
| <span class="bold"><strong>Resource adaptor config-property: </strong></span><code class="literal"> |
| WriteLockLevel</code> |
| </p><p> |
| <span class="bold"><strong>Default: </strong></span><code class="literal">write</code> |
| </p><p> |
| <span class="bold"><strong>Possible values: </strong></span><code class="literal">none</code>, |
| <code class="literal">read</code>, <code class="literal">write</code>, numeric values for |
| lock-manager specific lock levels |
| </p><p> |
| <span class="bold"><strong>Description:</strong></span> The default level at which to lock |
| objects changed during a non-optimistic transaction. Note that for the default |
| JDBC lock manager, <code class="literal"> read</code> and <code class="literal">write</code> lock |
| levels are equivalent. |
| </p></div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="ref_guide_conf_plugins.html">Prev</a> </td><td width="20%" align="center"><a accesskey="u" href="ref_guide_conf.html">Up</a></td><td width="40%" align="right"> <a accesskey="n" href="ref_guide_conf_jdbc.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top">4. |
| Plugin Configuration |
| </td><td width="20%" align="center"><a accesskey="h" href="manual.html">Home</a></td><td width="40%" align="right" valign="top"> 6. |
| OpenJPA JDBC Properties |
| </td></tr></table></div></body></html> |