Added: websites/production/openjpa/content/builds/2.4.2/apache-openjpa/docs/ref_guide_conf_openjpa.html ============================================================================== --- websites/production/openjpa/content/builds/2.4.2/apache-openjpa/docs/ref_guide_conf_openjpa.html (added) +++ websites/production/openjpa/content/builds/2.4.2/apache-openjpa/docs/ref_guide_conf_openjpa.html Fri Jan 6 19:19:20 2017 @@ -0,0 +1,2611 @@ +<html><head> + <meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1"> + <title>5. OpenJPA Properties</title><base href="display"><link rel="stylesheet" type="text/css" href="css/docbook.css"><meta name="generator" content="DocBook XSL Stylesheets V1.79.1"><link rel="home" href="manual.html" title="Apache OpenJPA 2.4 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" id="ref_guide_conf_openjpa"><div class="titlepage"><div><div><h2 class="title" style="clear: both">5. + OpenJPA Properties + </h2></div></div></div><div class="toc"><dl class="toc"><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.Callbacks">5.5. openjpa.Callbacks</a></span></dt><dt><span class="section"><a href="ref_guide_conf_openjpa.html#openjpa.ClassResolver">5.6. + openjpa.ClassResolver + </a></span></dt><dt><span class="section"><a href="ref_guide_conf_openjpa.html#openjpa.Compatibility">5.7. + openjpa.Compatibility + </a></span></dt><dt><span class="section"><a href="ref_guide_conf_openjpa.html#openjpa.ConnectionDriverName">5.8. + openjpa.ConnectionDriverName + </a></span></dt><dt><span class="section"><a href="ref_guide_conf_openjpa.html#openjpa.Connection2DriverName">5.9. + openjpa.Connection2DriverName + </a></span></dt><dt><span class="section"><a href="ref_guide_conf_openjpa.html#openjpa.ConnectionFactory">5.10. + openjpa.ConnectionFactory + </a></span></dt><dt><span class="section"><a href="ref_guide_conf_openjpa.html#openjpa.ConnectionFactory2">5.11. + openjpa.ConnectionFactory2 + </a></span></dt><dt><span class="section"><a href="ref_guide_conf_openjpa.html#openjpa.ConnectionFactoryName">5.12. + openjpa.ConnectionFactoryName + </a></span></dt><dt><span class="section"><a href="ref_guide_conf_openjpa.html#openjpa.ConnectionFactory2Name">5.13. + openjpa.ConnectionFactory2Name + </a></span></dt><dt><span class="section"><a href="ref_guide_conf_openjpa.html#openjpa.ConnectionFactoryMode">5.14. + openjpa.ConnectionFactoryMode + </a></span></dt><dt><span class="section"><a href="ref_guide_conf_openjpa.html#openjpa.ConnectionFactoryProperties">5.15. + openjpa.ConnectionFactoryProperties + </a></span></dt><dt><span class="section"><a href="ref_guide_conf_openjpa.html#openjpa.ConnectionFactory2Properties">5.16. + openjpa.ConnectionFactory2Properties + </a></span></dt><dt><span class="section"><a href="ref_guide_conf_openjpa.html#openjpa.ConnectionPassword">5.17. + openjpa.ConnectionPassword + </a></span></dt><dt><span class="section"><a href="ref_guide_conf_openjpa.html#openjpa.Connection2Password">5.18. + openjpa.Connection2Password + </a></span></dt><dt><span class="section"><a href="ref_guide_conf_openjpa.html#openjpa.ConnectionProperties">5.19. + openjpa.ConnectionProperties + </a></span></dt><dt><span class="section"><a href="ref_guide_conf_openjpa.html#openjpa.Connection2Properties">5.20. + openjpa.Connection2Properties + </a></span></dt><dt><span class="section"><a href="ref_guide_conf_openjpa.html#openjpa.ConnectionURL">5.21. + openjpa.ConnectionURL + </a></span></dt><dt><span class="section"><a href="ref_guide_conf_openjpa.html#openjpa.Connection2URL">5.22. + openjpa.Connection2URL + </a></span></dt><dt><span class="section"><a href="ref_guide_conf_openjpa.html#openjpa.ConnectionUserName">5.23. + openjpa.ConnectionUserName + </a></span></dt><dt><span class="section"><a href="ref_guide_conf_openjpa.html#openjpa.Connection2UserName">5.24. + openjpa.Connection2UserName + </a></span></dt><dt><span class="section"><a href="ref_guide_conf_openjpa.html#openjpa.ConnectionRetainMode">5.25. + openjpa.ConnectionRetainMode + </a></span></dt><dt><span class="section"><a href="ref_guide_conf_openjpa.html#openjpa.DataCache">5.26. + openjpa.DataCache + </a></span></dt><dt><span class="section"><a href="ref_guide_conf_openjpa.html#openjpa.DataCacheManager">5.27. + openjpa.DataCacheManager + </a></span></dt><dt><span class="section"><a href="ref_guide_conf_openjpa.html#openjpa.DataCacheMode">5.28. + openjpa.DataCacheMode + </a></span></dt><dt><span class="section"><a href="ref_guide_conf_openjpa.html#openjpa.DataCacheTimeout">5.29. + openjpa.DataCacheTimeout + </a></span></dt><dt><span class="section"><a href="ref_guide_conf_openjpa.html#openjpa.DetachState">5.30. + openjpa.DetachState + </a></span></dt><dt><span class="section"><a href="ref_guide_conf_openjpa.html#openjpa.DynamicDataStructs">5.31. + openjpa.DynamicDataStructs + </a></span></dt><dt><span class="section"><a href="ref_guide_conf_openjpa.html#openjpa.DynamicEnhancementAgent">5.32. openjpa.DynamicEnhancementAgent</a></span></dt><dt><span class="section"><a href="ref_guide_conf_openjpa.html#openjpa.FetchBatchSize">5.33. + openjpa.FetchBatchSize + </a></span></dt><dt><span class="section"><a href="ref_guide_conf_openjpa.html#openjpa.EncryptionProvider">5.34. + openjpa.EncryptionProvider + </a></span></dt><dt><span class="section"><a href="ref_guide_conf_openjpa.html#openjpa.FetchGroups">5.35. + openjpa.FetchGroups + </a></span></dt><dt><span class="section"><a href="ref_guide_conf_openjpa.html#openjpa.FlushBeforeQueries">5.36. + openjpa.FlushBeforeQueries + </a></span></dt><dt><span class="section"><a href="ref_guide_conf_openjpa.html#openjpa.IgnoreChanges">5.37. + openjpa.IgnoreChanges + </a></span></dt><dt><span class="section"><a href="ref_guide_conf_openjpa.html#openjpa.Id">5.38. openjpa.Id</a></span></dt><dt><span class="section"><a href="ref_guide_conf_openjpa.html#openjpa.InitializeEagerly">5.39. + openjpa.InitializeEagerly + </a></span></dt><dt><span class="section"><a href="ref_guide_conf_openjpa.html#openjpa.Instrumentation">5.40. + openjpa.Instrumentation + </a></span></dt><dt><span class="section"><a href="ref_guide_conf_openjpa.html#openjpa.InverseManager">5.41. + openjpa.InverseManager + </a></span></dt><dt><span class="section"><a href="ref_guide_conf_openjpa.html#openjpa.LockManager">5.42. + openjpa.LockManager + </a></span></dt><dt><span class="section"><a href="ref_guide_conf_openjpa.html#openjpa.LockTimeout">5.43. + openjpa.LockTimeout + </a></span></dt><dt><span class="section"><a href="ref_guide_conf_openjpa.html#openjpa.Log">5.44. + openjpa.Log + </a></span></dt><dt><span class="section"><a href="ref_guide_conf_openjpa.html#openjpa.ManagedRuntime">5.45. + openjpa.ManagedRuntime + </a></span></dt><dt><span class="section"><a href="ref_guide_conf_openjpa.html#openjpa.Mapping">5.46. + openjpa.Mapping + </a></span></dt><dt><span class="section"><a href="ref_guide_conf_openjpa.html#openjpa.MaxFetchDepth">5.47. + openjpa.MaxFetchDepth + </a></span></dt><dt><span class="section"><a href="ref_guide_conf_openjpa.html#openjpa.MetaDataFactory">5.48. + openjpa.MetaDataFactory + </a></span></dt><dt><span class="section"><a href="ref_guide_conf_openjpa.html#openjpa.MetaDataRepository">5.49. + openjpa.MetaDataRepository + </a></span></dt><dt><span class="section"><a href="ref_guide_conf_openjpa.html#openjpa.Multithreaded">5.50. + openjpa.Multithreaded + </a></span></dt><dt><span class="section"><a href="ref_guide_conf_openjpa.html#openjpa.Optimistic">5.51. + openjpa.Optimistic + </a></span></dt><dt><span class="section"><a href="ref_guide_conf_openjpa.html#openjpa.OptimizeIdCopy">5.52. + openjpa.OptimizeIdCopy + </a></span></dt><dt><span class="section"><a href="ref_guide_conf_openjpa.html#openjpa.OrphanedKeyAction">5.53. + openjpa.OrphanedKeyAction + </a></span></dt><dt><span class="section"><a href="ref_guide_conf_openjpa.html#openjpa.NontransactionalRead">5.54. + openjpa.NontransactionalRead + </a></span></dt><dt><span class="section"><a href="ref_guide_conf_openjpa.html#openjpa.NontransactionalWrite">5.55. + openjpa.NontransactionalWrite + </a></span></dt><dt><span class="section"><a href="ref_guide_conf_openjpa.html#openjpa.ProxyManager">5.56. + openjpa.ProxyManager + </a></span></dt><dt><span class="section"><a href="ref_guide_conf_openjpa.html#openjpa.PostLoadOnMerge">5.57. + openjpa.PostLoadOnMerge + </a></span></dt><dt><span class="section"><a href="ref_guide_conf_openjpa.html#openjpa.QueryCache">5.58. + openjpa.QueryCache + </a></span></dt><dt><span class="section"><a href="ref_guide_conf_openjpa.html#openjpa.QueryCompilationCache">5.59. + openjpa.QueryCompilationCache + </a></span></dt><dt><span class="section"><a href="ref_guide_conf_openjpa.html#openjpa.ReadLockLevel">5.60. + openjpa.ReadLockLevel + </a></span></dt><dt><span class="section"><a href="ref_guide_conf_openjpa.html#openjpa.RemoteCommitProvider">5.61. + openjpa.RemoteCommitProvider + </a></span></dt><dt><span class="section"><a href="ref_guide_conf_openjpa.html#openjpa.RestoreState">5.62. + openjpa.RestoreState + </a></span></dt><dt><span class="section"><a href="ref_guide_conf_openjpa.html#openjpa.RetainState">5.63. + openjpa.RetainState + </a></span></dt><dt><span class="section"><a href="ref_guide_conf_openjpa.html#openjpa.RetryClassRegistration">5.64. + openjpa.RetryClassRegistration + </a></span></dt><dt><span class="section"><a href="ref_guide_conf_openjpa.html#openjpa.RuntimeUnenhancedClasses">5.65. openjpa.RuntimeUnenhancedClasses</a></span></dt><dt><span class="section"><a href="ref_guide_conf_openjpa.html#openjpa.SavepointManager">5.66. + openjpa.SavepointManager + </a></span></dt><dt><span class="section"><a href="ref_guide_conf_openjpa.html#openjpa.Sequence">5.67. + openjpa.Sequence + </a></span></dt><dt><span class="section"><a href="ref_guide_conf_openjpa.html#openjpa.Specification">5.68. + openjpa.Specification + </a></span></dt><dt><span class="section"><a href="ref_guide_conf_openjpa.html#openjpa.TransactionMode">5.69. + openjpa.TransactionMode + </a></span></dt><dt><span class="section"><a href="ref_guide_conf_openjpa.html#openjpa.UseTCCLinSelectNew">5.70. + openjpa.UseTCCLinSelectNew + </a></span></dt><dt><span class="section"><a href="ref_guide_conf_openjpa.html#openjpa.WriteLockLevel">5.71. + openjpa.WriteLockLevel + </a></span></dt></dl></div> + + <a class="indexterm" name="d5e6860"></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> + + <p> +A few of the properties recognized by OpenJPA have been standardized in JPA 2.0 +specification using equivalent names. These properties can be specified either +by the JPA standard key or equivalent OpenJPA key. Specifying the same key once +as JPA standard key and again as equivalent OpenJPA key in the same configuration, +however, is not allowed. The following table lists these standard JPA properties +and their OpenJPA equivalent. + </p> + <div class="table" id="d5e6865"><p class="title"><b>Table 2.1. + Standard JPA Properties and OpenJPA equivalents + </b></p><div class="table-contents"> + + <table class="table" summary="
 Standard JPA Properties and OpenJPA equivalents
 " border="1"><colgroup><col align="left" class="StandardJPA"><col align="left" class="OpenJPAEquivalent"></colgroup><thead><tr><th align="left">Standard JPA 2.0</th><th align="left">OpenJPA Equivalent</th></tr></thead><tbody><tr><td align="left">javax.persistence.jdbc.driver</td><td align="left">openjpa.ConnectionDriverName</td></tr><tr><td align="left">javax.persistence.jdbc.url</td><td align="left">openjpa.ConnectionURL</td></tr><tr><td align="left">javax.persistence.jdbc.user</td><td align="left">openjpa.ConnectionUserName</td></tr><tr><td align="left">javax.persistence.jdbc.password</td><td align="left">openjpa.ConnectionPassword</td></tr></tbody></table> + </div></div><br class="table-break"> + + + + + <div class="section" id="openjpa.AutoClear"><div class="titlepage"><div><div><h3 class="title">5.1. + openjpa.AutoClear + </h3></div></div></div> + + <a class="indexterm" name="d5e6889"></a> + <a class="indexterm" name="d5e6891"></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 class="ulink" 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" id="openjpa.AutoDetach"><div class="titlepage"><div><div><h3 class="title">5.2. + openjpa.AutoDetach + </h3></div></div></div> + + <a class="indexterm" name="d5e6916"></a> + <a class="indexterm" name="d5e6918"></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 class="ulink" 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> - null + </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>, <code class="literal">rollback</code>, <code class="literal">none</code> + </p> + <p> +<span class="bold"><strong>Description:</strong></span> A comma-separated list of events +when managed instances will be automatically detached. When using the OpenJPA EntityManager this defaults to +<code class="literal">close</code>, and <code class="literal">rollback</code> per the JPA spec. If you need to change this setting, you +need to set it directly on an instantiated EntityManager. + </p> + + <p> +<code class="literal">none</code> option is exclusive. It can not be specified with any other option. +<code class="literal">none</code> option implies that managed objects will not be detached from the persistence context, +the second-class object fields such as collections or date will <span class="emphasis"><em>not</em></span> be proxied unlike normal +circumstances. This option is relevant for specific use cases where the user application would not refer to the +managed objects after the transaction and/or the context ends e.g. typical batch insertion scenario. + </p> + + </div> + <div class="section" id="openjpa.BrokerFactory"><div class="titlepage"><div><div><h3 class="title">5.3. + openjpa.BrokerFactory + </h3></div></div></div> + + <a class="indexterm" name="d5e6951"></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 class="ulink" 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 class="xref" href="ref_guide_conf_plugins.html" title="4. Plugin Configuration">Section 4, “ + Plugin Configuration + ”</a>) describing the +<a class="ulink" 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" id="openjpa.BrokerImpl"><div class="titlepage"><div><div><h3 class="title">5.4. + openjpa.BrokerImpl + </h3></div></div></div> + + <a class="indexterm" name="d5e6978"></a> + <a class="indexterm" name="d5e6980"></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 class="ulink" 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 class="xref" href="ref_guide_conf_plugins.html" title="4. Plugin Configuration">Section 4, “ + Plugin Configuration + ”</a>) describing the +<a class="ulink" 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 class="xref" href="ref_guide_runtime.html#ref_guide_runtime_broker_extension" title="1.2. Broker Customization and Eviction">Section 1.2, “ + Broker Customization and Eviction + ”</a> on for details. + </p> + </div> + +<div class="section" id="openjpa.Callbacks"><div class="titlepage"><div><div><h3 class="title">5.5. openjpa.Callbacks</h3></div></div></div> + + <a class="indexterm" name="d5e7004"></a> + <a class="indexterm" name="d5e7006"></a> + <p> + <span class="bold"><strong>Property name: </strong></span><code class="literal">openjpa.Callbacks</code> + </p> + <p> + <span class="bold"><strong>Configuration API:</strong></span> + <a class="ulink" href="../javadoc/org/apache/openjpa/conf/OpenJPAConfiguration.html#getCallbackOptionsInstance()" target="_top"> + <code class="methodname">org.apache.openjpa.conf.OpenJPAConfiguration.getCallbackOptionsInstance</code></a> + </p> + <p> + <span class="bold"><strong>Resource adaptor config-property: </strong></span><code class="literal">Callbacks</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 class="xref" href="ref_guide_conf_plugins.html" title="4. Plugin Configuration">Section 4, “ + Plugin Configuration + ”</a>) to fine tune some of the configurable +properties related to callbacks. The plug-in supports two boolean properties: + </p> + <div class="itemizedlist"><ul class="itemizedlist" style="list-style-type: disc; "><li class="listitem"> + <p><code class="literal">PostPersistCallbackImmediate</code>: whether the + post-persist callback is invoked as soon as a new instance + is managed. The default is <code class="literal">false</code>, implies that + the post-persist callback is invoked after the instance been committed + or flushed to the datastore. + </p> + </li><li class="listitem"> + <p><code class="literal">AllowsMultipleMethodsForSameCallback</code>: whether + multiple methods of the same class can handle the same callback event. + Defaults to <code class="literal">false</code>. + </p> + </li></ul></div> +</div> + + <div class="section" id="openjpa.ClassResolver"><div class="titlepage"><div><div><h3 class="title">5.6. + openjpa.ClassResolver + </h3></div></div></div> + + <a class="indexterm" name="d5e7036"></a> + <a class="indexterm" name="d5e7038"></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 class="ulink" 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 class="xref" href="ref_guide_conf_plugins.html" title="4. Plugin Configuration">Section 4, “ + Plugin Configuration + ”</a>) describing the +<a class="ulink" 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" id="openjpa.Compatibility"><div class="titlepage"><div><div><h3 class="title">5.7. + openjpa.Compatibility + </h3></div></div></div> + + <a class="indexterm" name="d5e7061"></a> + <a class="indexterm" name="d5e7063"></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 class="ulink" 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" id="openjpa.ConnectionDriverName"><div class="titlepage"><div><div><h3 class="title">5.8. + openjpa.ConnectionDriverName + </h3></div></div></div> + + <a class="indexterm" name="d5e7081"></a> + <a class="indexterm" name="d5e7083"></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 class="ulink" 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 class="xref" href="ref_guide_dbsetup.html" title="Chapter 4. JDBC">Chapter 4, <i> + JDBC + </i></a> for details. + </p> + </div> + <div class="section" id="openjpa.Connection2DriverName"><div class="titlepage"><div><div><h3 class="title">5.9. + openjpa.Connection2DriverName + </h3></div></div></div> + + <a class="indexterm" name="d5e7105"></a> + <a class="indexterm" name="d5e7107"></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 class="ulink" 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 class="xref" href="ref_guide_conf_openjpa.html#openjpa.ConnectionDriverName" title="5.8. openjpa.ConnectionDriverName">Section 5.8, “ + openjpa.ConnectionDriverName + ”</a>, but applies to the +alternate connection factory used for unmanaged connections. See +<a class="xref" 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" id="openjpa.ConnectionFactory"><div class="titlepage"><div><div><h3 class="title">5.10. + openjpa.ConnectionFactory + </h3></div></div></div> + + <a class="indexterm" name="d5e7129"></a> + <a class="indexterm" name="d5e7131"></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 class="ulink" 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 class="xref" href="ref_guide_dbsetup.html" title="Chapter 4. JDBC">Chapter 4, <i> + JDBC + </i></a> for details. + </p> + </div> + <div class="section" id="openjpa.ConnectionFactory2"><div class="titlepage"><div><div><h3 class="title">5.11. + openjpa.ConnectionFactory2 + </h3></div></div></div> + + <a class="indexterm" name="d5e7152"></a> + <a class="indexterm" name="d5e7154"></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 class="ulink" 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 class="xref" href="ref_guide_dbsetup.html" title="Chapter 4. JDBC">Chapter 4, <i> + JDBC + </i></a> for details. + </p> + </div> + <div class="section" id="openjpa.ConnectionFactoryName"><div class="titlepage"><div><div><h3 class="title">5.12. + openjpa.ConnectionFactoryName + </h3></div></div></div> + + <a class="indexterm" name="d5e7175"></a> + <a class="indexterm" name="d5e7177"></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 class="ulink" 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 class="xref" href="ref_guide_dbsetup.html" title="Chapter 4. JDBC">Chapter 4, <i> + JDBC + </i></a> for details. + </p> + </div> + <div class="section" id="openjpa.ConnectionFactory2Name"><div class="titlepage"><div><div><h3 class="title">5.13. + openjpa.ConnectionFactory2Name + </h3></div></div></div> + + <a class="indexterm" name="d5e7198"></a> + <a class="indexterm" name="d5e7200"></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 class="ulink" 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 class="xref" href="ref_guide_enterprise_xa.html" title="3. XA Transactions">Section 3, “ + XA Transactions + ”</a> for details. + </p> + </div> + <div class="section" id="openjpa.ConnectionFactoryMode"><div class="titlepage"><div><div><h3 class="title">5.14. + openjpa.ConnectionFactoryMode + </h3></div></div></div> + + <a class="indexterm" name="d5e7221"></a> + <a class="indexterm" name="d5e7223"></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 class="ulink" 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 class="xref" 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" id="openjpa.ConnectionFactoryProperties"><div class="titlepage"><div><div><h3 class="title">5.15. + openjpa.ConnectionFactoryProperties + </h3></div></div></div> + + <a class="indexterm" name="d5e7248"></a> + <a class="indexterm" name="d5e7250"></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 class="ulink" 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 class="xref" 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 class="xref" href="ref_guide_dbsetup.html" title="Chapter 4. JDBC">Chapter 4, <i> + JDBC + </i></a> for details. + </p> + </div> + <div class="section" id="openjpa.ConnectionFactory2Properties"><div class="titlepage"><div><div><h3 class="title">5.16. + openjpa.ConnectionFactory2Properties + </h3></div></div></div> + + <a class="indexterm" name="d5e7271"></a> + <a class="indexterm" name="d5e7273"></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 class="ulink" 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 class="xref" href="ref_guide_conf_openjpa.html#openjpa.ConnectionFactoryProperties" title="5.15. openjpa.ConnectionFactoryProperties">Section 5.15, “ + openjpa.ConnectionFactoryProperties + ”</a>, but applies to the +alternate connection factory used for unmanaged connections. See +<a class="xref" 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" id="openjpa.ConnectionPassword"><div class="titlepage"><div><div><h3 class="title">5.17. + openjpa.ConnectionPassword + </h3></div></div></div> + + <a class="indexterm" name="d5e7295"></a> + <a class="indexterm" name="d5e7297"></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 class="ulink" 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 class="xref" href="ref_guide_dbsetup.html" title="Chapter 4. JDBC">Chapter 4, <i> + JDBC + </i></a> for details. + </p> + </div> + <div class="section" id="openjpa.Connection2Password"><div class="titlepage"><div><div><h3 class="title">5.18. + openjpa.Connection2Password + </h3></div></div></div> + + <a class="indexterm" name="d5e7318"></a> + <a class="indexterm" name="d5e7320"></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 class="ulink" 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 class="xref" href="ref_guide_conf_openjpa.html#openjpa.ConnectionPassword" title="5.17. openjpa.ConnectionPassword">Section 5.17, “ + openjpa.ConnectionPassword + ”</a>, but applies to the +alternate connection factory used for unmanaged connections. See +<a class="xref" 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" id="openjpa.ConnectionProperties"><div class="titlepage"><div><div><h3 class="title">5.19. + openjpa.ConnectionProperties + </h3></div></div></div> + + <a class="indexterm" name="d5e7342"></a> + <a class="indexterm" name="d5e7344"></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 class="ulink" 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 class="xref" 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 class="xref" href="ref_guide_dbsetup.html" title="Chapter 4. JDBC">Chapter 4, <i> + JDBC + </i></a> for details. + </p> + </div> + <div class="section" id="openjpa.Connection2Properties"><div class="titlepage"><div><div><h3 class="title">5.20. + openjpa.Connection2Properties + </h3></div></div></div> + + <a class="indexterm" name="d5e7366"></a> + <a class="indexterm" name="d5e7368"></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 class="ulink" 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 class="xref" href="ref_guide_conf_openjpa.html#openjpa.ConnectionProperties" title="5.19. openjpa.ConnectionProperties">Section 5.19, “ + openjpa.ConnectionProperties + ”</a>, but applies to the +alternate connection factory used for unmanaged connections. See +<a class="xref" 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" id="openjpa.ConnectionURL"><div class="titlepage"><div><div><h3 class="title">5.21. + openjpa.ConnectionURL + </h3></div></div></div> + + <a class="indexterm" name="d5e7390"></a> + <a class="indexterm" name="d5e7392"></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 class="ulink" 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 class="xref" href="ref_guide_dbsetup.html" title="Chapter 4. JDBC">Chapter 4, <i> + JDBC + </i></a> for details. + </p> + </div> + <div class="section" id="openjpa.Connection2URL"><div class="titlepage"><div><div><h3 class="title">5.22. + openjpa.Connection2URL + </h3></div></div></div> + + <a class="indexterm" name="d5e7412"></a> + <a class="indexterm" name="d5e7414"></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 class="ulink" 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 class="xref" href="ref_guide_conf_openjpa.html#openjpa.ConnectionURL" title="5.21. openjpa.ConnectionURL">Section 5.21, “ + openjpa.ConnectionURL + ”</a>, but applies to the alternate +connection factory used for unmanaged connections. See +<a class="xref" 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" id="openjpa.ConnectionUserName"><div class="titlepage"><div><div><h3 class="title">5.23. + openjpa.ConnectionUserName + </h3></div></div></div> + + <a class="indexterm" name="d5e7436"></a> + <a class="indexterm" name="d5e7438"></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 class="ulink" 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 class="xref" href="ref_guide_dbsetup.html" title="Chapter 4. JDBC">Chapter 4, <i> + JDBC + </i></a> +for details. + </p> + </div> + <div class="section" id="openjpa.Connection2UserName"><div class="titlepage"><div><div><h3 class="title">5.24. + openjpa.Connection2UserName + </h3></div></div></div> + + <a class="indexterm" name="d5e7458"></a> + <a class="indexterm" name="d5e7460"></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 class="ulink" 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 class="xref" href="ref_guide_conf_openjpa.html#openjpa.ConnectionUserName" title="5.23. openjpa.ConnectionUserName">Section 5.23, “ + openjpa.ConnectionUserName + ”</a>, but applies to the +alternate connection factory used for unmanaged connections. See +<a class="xref" 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" id="openjpa.ConnectionRetainMode"><div class="titlepage"><div><div><h3 class="title">5.25. + openjpa.ConnectionRetainMode + </h3></div></div></div> + + <a class="indexterm" name="d5e7482"></a> + <a class="indexterm" name="d5e7484"></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 class="ulink" 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 class="xref" 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" id="openjpa.DataCache"><div class="titlepage"><div><div><h3 class="title">5.26. + openjpa.DataCache + </h3></div></div></div> + + <a class="indexterm" name="d5e7505"></a> + <a class="indexterm" name="d5e7507"></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 class="ulink" 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 class="xref" href="ref_guide_conf_plugins.html" title="4. Plugin Configuration">Section 4, “ + Plugin Configuration + ”</a>) describing the +<a class="ulink" 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 class="xref" 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" id="openjpa.DataCacheManager"><div class="titlepage"><div><div><h3 class="title">5.27. + openjpa.DataCacheManager + </h3></div></div></div> + + <a class="indexterm" name="d5e7531"></a> + <a class="indexterm" name="d5e7533"></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 class="ulink" 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 class="xref" href="ref_guide_conf_plugins.html" title="4. Plugin Configuration">Section 4, “ + Plugin Configuration + ”</a>) describing the +<a class="ulink" 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 class="xref" 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" id="openjpa.DataCacheMode"><div class="titlepage"><div><div><h3 class="title">5.28. + openjpa.DataCacheMode + </h3></div></div></div> + + <a class="indexterm" name="d5e7557"></a> + <a class="indexterm" name="d5e7559"></a> + <p> +<span class="bold"><strong>Property name: </strong></span><code class="literal"> +openjpa.DataCacheMode</code> + </p> + <p> +<span class="bold"><strong>Configuration API:</strong></span> +<a class="ulink" href="../javadoc/org/apache/openjpa/conf/OpenJPAConfiguration.html#getDataCacheMode()" target="_top"> +<code class="methodname">org.apache.openjpa.conf.OpenJPAConfiguration.getDataCacheMode +</code></a> + </p> + <p> +<span class="bold"><strong>Resource adaptor config-property: </strong></span><code class="literal"> +DataCacheMode</code> + </p> + <p> +<span class="bold"><strong>Default: </strong></span><code class="literal">DataCacheMode.UNSPECIFIED (see javadoc for details)</code> + </p> + <p> +<span class="bold"><strong>Description:</strong></span>Determines which entities will be included in the DataCache. May be any of the values defined in <a class="ulink" href="../javadoc/org/apache/openjpa/datacache/DataCacheMode.html" target="_top">../javadoc/org/apache/openjpa/datacache/DataCacheMode.html</a>. + </p> + </div> + + <div class="section" id="openjpa.DataCacheTimeout"><div class="titlepage"><div><div><h3 class="title">5.29. + openjpa.DataCacheTimeout + </h3></div></div></div> + + <a class="indexterm" name="d5e7580"></a> + <a class="indexterm" name="d5e7582"></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 class="ulink" 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 class="xref" 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" id="openjpa.DetachState"><div class="titlepage"><div><div><h3 class="title">5.30. + openjpa.DetachState + </h3></div></div></div> + + <a class="indexterm" name="d5e7603"></a> + <a class="indexterm" name="d5e7605"></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 class="ulink" href="../javadoc/org/apache/openjpa/conf/OpenJPAConfigurationImpl.html#getDetachState()" target="_top"> +<code class="methodname">org.apache.openjpa.conf.OpenJPAConfigurationImpl.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 class="xref" 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" id="openjpa.DynamicDataStructs"><div class="titlepage"><div><div><h3 class="title">5.31. + openjpa.DynamicDataStructs + </h3></div></div></div> + + <a class="indexterm" name="d5e7632"></a> + <a class="indexterm" name="d5e7634"></a> + <a class="indexterm" name="d5e7637"></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 class="ulink" 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" id="openjpa.DynamicEnhancementAgent"><div class="titlepage"><div><div><h3 class="title">5.32. openjpa.DynamicEnhancementAgent</h3></div></div></div> + + <p> + <span class="bold"><strong>Property name: </strong></span> + <code class="literal">openjpa.DynamicEnhancementAgent</code> + </p> + <p> + <span class="bold"><strong>Configuration API: </strong></span> + <a class="ulink" href="../javadoc/org/apache/openjpa/conf/OpenJPAConfiguration.html#getDynamicEnhancementAgent()" target="_top">org.apache.openjpa.conf.OpenJPAConfiguration.getDynamicEnhancementAgent</a> + </p> + <p> + <span class="bold"><strong>Resource adaptor config property:</strong></span> + DynamicEnhancementAgent + </p> + <p> + <span class="bold"><strong>Default: </strong></span> + <code class="literal">true</code> + + </p> + <p> + <span class="bold"><strong>Description:</strong></span> + The DynamicEnhancementAgent property controls whether or not + OpenJPA will attempt to dynamically load the PCEnhancer + javaagent. + </p> + <p> + See the reference guide for more information + <a class="xref" href="ref_guide_pc_enhance.html#ref_guide_pc_enhance_dynamic" title="2.4. Enhancing Dynamically at Runtime">Section 2.4, “ + Enhancing Dynamically at Runtime + ”</a> + </p> + </div> + <div class="section" id="openjpa.FetchBatchSize"><div class="titlepage"><div><div><h3 class="title">5.33. + openjpa.FetchBatchSize + </h3></div></div></div> + + <a class="indexterm" name="d5e7675"></a> + <a class="indexterm" name="d5e7677"></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 class="ulink" 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 class="xref" href="ref_guide_dbsetup_lrs.html" title="10. Large Result Sets">Section 10, “ + Large Result Sets + ”</a> for details. + </p> + </div> + +<div class="section" id="openjpa.EncryptionProvider"><div class="titlepage"><div><div><h3 class="title">5.34. + openjpa.EncryptionProvider + </h3></div></div></div> + + <a class="indexterm" name="d5e7698"></a> + <a class="indexterm" name="d5e7700"></a> + <p> + <span class="bold"><strong>Property name: </strong></span><code class="literal">openjpa.EncryptionProvider</code> + </p> + <p> + <span class="bold"><strong>Configuration API:</strong></span> + <a class="ulink" href="../javadoc/org/apache/openjpa/conf/OpenJPAConfiguration.html#getEncryptionProvider()" target="_top"> + <code class="methodname">org.apache.openjpa.conf.OpenJPAConfiguration.getEncryptionProvider</code> + </a> + </p> + <p> + <span class="bold"><strong>Resource adaptor config-property: </strong></span> + <code class="literal">EncryptionProvider</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 class="xref" href="ref_guide_conf_plugins.html" title="4. Plugin Configuration">Section 4, “ + Plugin Configuration + ”</a>) describing the +<a class="ulink" href="../javadoc/org/apache/openjpa/lib/encryption/EncryptionProvider.html" target="_top"><code class="classname"> +org.apache.openjpa.lib.encryption.EncryptionProvider</code></a>s to use for connection password +encryption. See <a class="xref" href="ref_guide_encryption.html" title="Chapter 11. Encryption Provider">Chapter 11, <i> + Encryption Provider + </i></a> for details. + </p> + </div> + + + <div class="section" id="openjpa.FetchGroups"><div class="titlepage"><div><div><h3 class="title">5.35. + openjpa.FetchGroups + </h3></div></div></div> + + <a class="indexterm" name="d5e7723"></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 class="ulink" 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 class="xref" href="ref_guide_fetch.html" title="7. Fetch Groups">Section 7, “ + Fetch Groups + ”</a> + for details. + </p> + </div> + + <div class="section" id="openjpa.FlushBeforeQueries"><div class="titlepage"><div><div><h3 class="title">5.36. + openjpa.FlushBeforeQueries + </h3></div></div></div> + + <a class="indexterm" name="d5e7743"></a> + <a class="indexterm" name="d5e7745"></a> + <a class="indexterm" name="d5e7748"></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 class="ulink" 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 class="xref" 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" id="openjpa.IgnoreChanges"><div class="titlepage"><div><div><h3 class="title">5.37. + openjpa.IgnoreChanges + </h3></div></div></div> + + <a class="indexterm" name="d5e7772"></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 class="ulink" 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" id="openjpa.Id"><div class="titlepage"><div><div><h3 class="title">5.38. openjpa.Id</h3></div></div></div> + + <a class="indexterm" name="d5e7793"></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" id="openjpa.InitializeEagerly"><div class="titlepage"><div><div><h3 class="title">5.39. + openjpa.InitializeEagerly + </h3></div></div></div> + + <a class="indexterm" name="d5e7807"></a> + <a class="indexterm" name="d5e7809"></a> + <p> +<span class="bold"><strong>Property name: </strong></span><code class="literal">openjpa.InitializeEagerly +</code> + </p> + <p> +<span class="bold"><strong>Configuration API:</strong></span> +<a class="ulink" href="../javadoc/org/apache/openjpa/conf/OpenJPAConfiguration.html#isInitializeEagerly()" target="_top"> +<code class="methodname">org.apache.openjpa.conf.OpenJPAConfiguration.isInitializeEagerly +</code></a> + </p> + <p> +<span class="bold"><strong>Resource adaptor config-property: </strong></span><code class="literal"> +InitializeEagerly</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> Controls whether initialization +is eager or lazy. Eager initialization imply all persistent classes, their +mapping information, database connectivity and all other resources specified in +the configuration of a persistence unit will be initialized when a persistent +unit is constructed. The default behavior is +lazy i.e. persistent classes, database and other resources are initialized only +when the application refers to a resource for the first time. + </p> + </div> + + <div class="section" id="openjpa.Instrumentation"><div class="titlepage"><div><div><h3 class="title">5.40. + openjpa.Instrumentation + </h3></div></div></div> + + <a class="indexterm" name="d5e7833"></a> + <a class="indexterm" name="d5e7835"></a> + <p> +<span class="bold"><strong>Property name: </strong></span><code class="literal"> +openjpa.Instrumentation</code> + </p> + <p> +<span class="bold"><strong>Configuration API:</strong></span> +<a class="ulink" href="../javadoc/org/apache/openjpa/conf/OpenJPAConfiguration.html#getInstrumentation()" target="_top"> +<code class="methodname"> +org.apache.openjpa.conf.OpenJPAConfiguration.getInstrumentation +</code></a> + </p> + <p> +<span class="bold"><strong>Resource adaptor config-property: </strong></span><code class="literal"> +Instrumentation</code> + </p> + <p> +<span class="bold"><strong>Default: </strong></span><code class="literal">-</code> + </p> + <p> +<span class="bold"><strong>Possible values: </strong></span><code class="literal">jmx</code>, +<code class="literal">custom plugin string</code> + </p> + <p> +<span class="bold"><strong>Description:</strong></span> A plugin string (see +<a class="xref" href="ref_guide_conf_plugins.html" title="4. Plugin Configuration">Section 4, “ + Plugin Configuration + ”</a>) describing one or more instances of +<a class="ulink" href="../javadoc/org/apache/openjpa/lib/instrumentation/InstrumentationProvider.html" target="_top"> +<code class="classname">org.apache.openjpa.lib.instrumentation.InstrumentationProvider</code></a> and +specific instruments to enable. See <a class="xref" href="ref_guide_instrumentation.html" title="Chapter 16. Instrumentation">Chapter 16, <i> + Instrumentation + </i></a> for details. + </p> + </div> + + <div class="section" id="openjpa.InverseManager"><div class="titlepage"><div><div><h3 class="title">5.41. + openjpa.InverseManager + </h3></div></div></div> + + <a class="indexterm" name="d5e7862"></a> + <a class="indexterm" name="d5e7864"></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 class="ulink" 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 class="xref" href="ref_guide_conf_plugins.html" title="4. Plugin Configuration">Section 4, “ + Plugin Configuration + ”</a>) describing a +<a class="ulink" 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 class="xref" href="ref_guide_inverses.html" title="5. Managed Inverses">Section 5, “ + Managed Inverses + ”</a> for usage documentation. + </p> + </div> + <div class="section" id="openjpa.LockManager"><div class="titlepage"><div><div><h3 class="title">5.42. + openjpa.LockManager + </h3></div></div></div> + + <a class="indexterm" name="d5e7892"></a> + <a class="indexterm" name="d5e7894"></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 class="ulink" 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">mixed</code> + </p> + <p> +<span class="bold"><strong>Possible values: </strong></span><code class="literal">none</code>, <code class="literal">version</code>, +<code class="literal">pessimistic</code>, <code class="literal">mixed</code> + </p> + <p> +<span class="bold"><strong>Description:</strong></span> A plugin string (see +<a class="xref" href="ref_guide_conf_plugins.html" title="4. Plugin Configuration">Section 4, “ + Plugin Configuration + ”</a>) describing a +<a class="ulink" 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 class="xref" 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" id="openjpa.LockTimeout"><div class="titlepage"><div><div><h3 class="title">5.43. + openjpa.LockTimeout + </h3></div></div></div> + + <a class="indexterm" name="d5e7924"></a> + <a class="indexterm" name="d5e7926"></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 class="ulink" 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 class="xref" href="ref_guide_locking.html" title="3. Object Locking">Section 3, “ + Object Locking + ”</a> for details. + </p> + </div> + <div class="section" id="openjpa.Log"><div class="titlepage"><div><div><h3 class="title">5.44. + openjpa.Log + </h3></div></div></div> + + <a class="indexterm" name="d5e7947"></a> + <a class="indexterm" name="d5e7949"></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 class="ulink" href="../javadoc/org/apache/openjpa/lib/conf/Configuration.html#getLog()" target="_top"> +<code class="methodname">org.apache.openjpa.lib.conf.Configuration.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">slf4j</code>, +<code class="literal">none</code> + </p> + <p> +<span class="bold"><strong>Description:</strong></span> A plugin string (see +<a class="xref" href="ref_guide_conf_plugins.html" title="4. Plugin Configuration">Section 4, “ + Plugin Configuration + ”</a>) describing a +<a class="ulink" 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 class="xref" href="ref_guide_logging.html" title="Chapter 3. Logging and Auditing">Chapter 3, <i> + Logging and Auditing + </i></a>. + </p> + </div> + <div class="section" id="openjpa.ManagedRuntime"><div class="titlepage"><div><div><h3 class="title">5.45. + openjpa.ManagedRuntime + </h3></div></div></div> + + <a class="indexterm" name="d5e7980"></a> + <a class="indexterm" name="d5e7982"></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>
[... 923 lines stripped ...]
