You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@openjpa.apache.org by st...@apache.org on 2015/06/01 22:19:02 UTC
svn commit: r953480 [22/37] - in
/websites/production/openjpa/content/builds/2.4.0: ./ apache-openjpa/
apache-openjpa/docs/
Added: websites/production/openjpa/content/builds/2.4.0/apache-openjpa/docs/ref_guide_conf_jdbc.html
==============================================================================
--- websites/production/openjpa/content/builds/2.4.0/apache-openjpa/docs/ref_guide_conf_jdbc.html (added)
+++ websites/production/openjpa/content/builds/2.4.0/apache-openjpa/docs/ref_guide_conf_jdbc.html Mon Jun 1 20:19:00 2015
@@ -0,0 +1,770 @@
+<html><head>
+ <meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1">
+ <title>6. OpenJPA JDBC Properties</title><base href="display"><link rel="stylesheet" type="text/css" href="css/docbook.css"><meta name="generator" content="DocBook XSL-NS Stylesheets V1.76.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_openjpa.html" title="5. OpenJPA Properties"><link rel="next" href="ref_guide_logging.html" title="Chapter 3. Logging and Auditing"></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">6.
+ OpenJPA JDBC Properties
+ </th></tr><tr><td width="20%" align="left"><a accesskey="p" href="ref_guide_conf_openjpa.html">Prev</a> </td><th width="60%" align="center">Chapter 2.
+ Configuration
+ </th><td width="20%" align="right"> <a accesskey="n" href="ref_guide_logging.html">Next</a></td></tr></table><hr></div><div class="section" title="6. OpenJPA JDBC Properties"><div class="titlepage"><div><div><h2 class="title" style="clear: both" id="ref_guide_conf_jdbc">6.
+ OpenJPA JDBC Properties
+ </h2></div></div></div><div class="toc"><dl><dt><span class="section"><a href="ref_guide_conf_jdbc.html#openjpa.jdbc.ConnectionDecorators">6.1.
+ openjpa.jdbc.ConnectionDecorators
+ </a></span></dt><dt><span class="section"><a href="ref_guide_conf_jdbc.html#openjpa.jdbc.DBDictionary">6.2.
+ openjpa.jdbc.DBDictionary
+ </a></span></dt><dt><span class="section"><a href="ref_guide_conf_jdbc.html#openjpa.jdbc.DriverDataSource">6.3.
+ openjpa.jdbc.DriverDataSource
+ </a></span></dt><dt><span class="section"><a href="ref_guide_conf_jdbc.html#openjpa.jdbc.EagerFetchMode">6.4.
+ openjpa.jdbc.EagerFetchMode
+ </a></span></dt><dt><span class="section"><a href="ref_guide_conf_jdbc.html#openjpa.jdbc.FetchDirection">6.5.
+ openjpa.jdbc.FetchDirection
+ </a></span></dt><dt><span class="section"><a href="ref_guide_conf_jdbc.html#openjpa.jdbc.JDBCListeners">6.6.
+ openjpa.jdbc.JDBCListeners
+ </a></span></dt><dt><span class="section"><a href="ref_guide_conf_jdbc.html#openjpa.jdbc.LRSSize">6.7.
+ openjpa.jdbc.LRSSize
+ </a></span></dt><dt><span class="section"><a href="ref_guide_conf_jdbc.html#openjpa.jdbc.MappingDefaults">6.8.
+ openjpa.jdbc.MappingDefaults
+ </a></span></dt><dt><span class="section"><a href="ref_guide_conf_jdbc.html#openjpa.jdbc.MappingFactory">6.9.
+ openjpa.jdbc.MappingFactory
+ </a></span></dt><dt><span class="section"><a href="ref_guide_conf_jdbc.html#openjpa.jdbc.QuerySQLCache">6.10.
+ openjpa.jdbc.QuerySQLCache
+ </a></span></dt><dt><span class="section"><a href="ref_guide_conf_jdbc.html#openjpa.jdbc.ResultSetType">6.11.
+ openjpa.jdbc.ResultSetType
+ </a></span></dt><dt><span class="section"><a href="ref_guide_conf_jdbc.html#openjpa.jdbc.Schema">6.12.
+ openjpa.jdbc.Schema
+ </a></span></dt><dt><span class="section"><a href="ref_guide_conf_jdbc.html#openjpa.jdbc.SchemaFactory">6.13.
+ openjpa.jdbc.SchemaFactory
+ </a></span></dt><dt><span class="section"><a href="ref_guide_conf_jdbc.html#openjpa.jdbc.Schemas">6.14.
+ openjpa.jdbc.Schemas
+ </a></span></dt><dt><span class="section"><a href="ref_guide_conf_jdbc.html#openjpa.jdbc.SQLFactory">6.15.
+ openjpa.jdbc.SQLFactory
+ </a></span></dt><dt><span class="section"><a href="ref_guide_conf_jdbc.html#openjpa.jdbc.SubclassFetchMode">6.16.
+ openjpa.jdbc.SubclassFetchMode
+ </a></span></dt><dt><span class="section"><a href="ref_guide_conf_jdbc.html#openjpa.jdbc.SynchronizeMappings">6.17.
+ openjpa.jdbc.SynchronizeMappings
+ </a></span></dt><dt><span class="section"><a href="ref_guide_conf_jdbc.html#openjpa.jdbc.TransactionIsolation">6.18.
+ openjpa.jdbc.TransactionIsolation
+ </a></span></dt><dt><span class="section"><a href="ref_guide_conf_jdbc.html#openjpa.jdbc.UpdateManager">6.19.
+ openjpa.jdbc.UpdateManager
+ </a></span></dt><dt><span class="section"><a href="ref_guide_conf_jdbc.html#ref_guide_spec_compatibility">6.20. Compatibility with Specification</a></span></dt></dl></div>
+
+ <a class="indexterm" name="d5e8625"></a>
+ <p>
+The following properties apply exclusively to the OpenJPA JDBC back-end.
+ </p>
+ <div class="section" title="6.1. openjpa.jdbc.ConnectionDecorators"><div class="titlepage"><div><div><h3 class="title" id="openjpa.jdbc.ConnectionDecorators">6.1.
+ openjpa.jdbc.ConnectionDecorators
+ </h3></div></div></div>
+
+ <a class="indexterm" name="d5e8631"></a>
+ <a class="indexterm" name="d5e8633"></a>
+ <p>
+<span class="bold"><strong>Property name: </strong></span><code class="literal">
+openjpa.jdbc.ConnectionDecorators</code>
+ </p>
+ <p>
+<span class="bold"><strong>Configuration API:</strong></span>
+<a class="ulink" href="../javadoc/org/apache/openjpa/jdbc/conf/JDBCConfiguration.html#getConnectionDecorators()" target="_top">
+<code class="methodname">
+org.apache.openjpa.jdbc.conf.JDBCConfiguration.getConnectionDecorators
+</code></a>
+ </p>
+ <p>
+<span class="bold"><strong>Resource adaptor config-property: </strong></span><code class="literal">
+ConnectionDecorators</code>
+ </p>
+ <p>
+<span class="bold"><strong>Default:</strong></span> -
+ </p>
+ <p>
+<span class="bold"><strong>Description:</strong></span> A comma-separated list of plugin
+strings (see <a class="xref" href="ref_guide_conf_plugins.html" title="4. Plugin Configuration">Section 4, “
+ Plugin Configuration
+ ”</a>) describing
+<a class="ulink" href="../javadoc/org/apache/openjpa/lib/jdbc/ConnectionDecorator.html" target="_top">
+<code class="classname">org.apache.openjpa.lib.jdbc.ConnectionDecorator</code></a>
+instances to install on the connection factory. These decorators can wrap
+connections passed from the underlying <code class="classname">DataSource</code> to add
+functionality. OpenJPA will pass all connections through the list of decorators
+before using them. Note that by default OpenJPA employs all
+of the built-in decorators in the <code class="classname">org.apache.openjpa.lib.jdbc
+</code> package already; you do not need to list them here.
+ </p>
+ </div>
+ <div class="section" title="6.2. openjpa.jdbc.DBDictionary"><div class="titlepage"><div><div><h3 class="title" id="openjpa.jdbc.DBDictionary">6.2.
+ openjpa.jdbc.DBDictionary
+ </h3></div></div></div>
+
+ <a class="indexterm" name="d5e8657"></a>
+ <a class="indexterm" name="d5e8659"></a>
+ <p>
+<span class="bold"><strong>Property name: </strong></span><code class="literal">
+openjpa.jdbc.DBDictionary</code>
+ </p>
+ <p>
+<span class="bold"><strong>Configuration API:</strong></span>
+<a class="ulink" href="../javadoc/org/apache/openjpa/jdbc/conf/JDBCConfiguration.html#getDBDictionary()" target="_top">
+<code class="methodname">org.apache.openjpa.jdbc.conf.JDBCConfiguration.getDBDictionary
+</code></a>
+ </p>
+ <p>
+<span class="bold"><strong>Resource adaptor config-property: </strong></span><code class="literal">
+DBDictionary</code>
+ </p>
+ <p>
+<span class="bold"><strong>Default:</strong></span> Based on the
+<a class="link" href="ref_guide_conf_openjpa.html#openjpa.ConnectionURL" title="5.21. openjpa.ConnectionURL"><code class="literal">openjpa.ConnectionURL</code>
+</a><a class="link" href="ref_guide_conf_openjpa.html#openjpa.ConnectionDriverName" title="5.8. openjpa.ConnectionDriverName"><code class="literal">
+openjpa.ConnectionDriverName</code></a>
+ </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/jdbc/sql/DBDictionary.html" target="_top">
+<code class="classname">org.apache.openjpa.jdbc.sql.DBDictionary</code></a> to use
+for database interaction. OpenJPA typically auto-configures the dictionary based
+on the JDBC URL, but you may have to set this property explicitly if you are
+using an unrecognized driver, to plug in your own dictionary for a database
+OpenJPA does not support out-of-the-box, or if you like to change the default
+configuration of an existing dictionary. See
+<a class="xref" href="ref_guide_dbsetup_dbsupport.html" title="4. Database Support">Section 4, “
+ Database Support
+ ”</a> for details.
+ </p>
+ </div>
+ <div class="section" title="6.3. openjpa.jdbc.DriverDataSource"><div class="titlepage"><div><div><h3 class="title" id="openjpa.jdbc.DriverDataSource">6.3.
+ openjpa.jdbc.DriverDataSource
+ </h3></div></div></div>
+
+ <a class="indexterm" name="d5e8686"></a>
+ <a class="indexterm" name="d5e8688"></a>
+ <p>
+<span class="bold"><strong>Property name: </strong></span><code class="literal">
+openjpa.jdbc.DriverDataSource</code>
+ </p>
+ <p>
+<span class="bold"><strong>Configuration API:</strong></span>
+<a class="ulink" href="../javadoc/org/apache/openjpa/jdbc/conf/JDBCConfiguration.html#getDriverDataSource()" target="_top">
+<code class="methodname">org.apache.openjpa.jdbc.conf.JDBCConfiguration.getDriverDataSource
+</code></a>
+ </p>
+ <p>
+<span class="bold"><strong>Resource adaptor config-property: </strong></span><code class="literal">
+DriverDataSource</code>
+ </p>
+ <p>
+<span class="bold"><strong>Default: </strong></span><code class="literal">auto</code>
+ </p>
+ <p>
+<span class="bold"><strong>Possible values: </strong></span><code class="literal">auto</code>,
+<code class="literal">dbcp</code>, <code class="literal">simple</code>
+ </p>
+ <p>
+<span class="bold"><strong>Description:</strong></span> The alias or full class name of
+the
+<a class="ulink" href="../javadoc/org/apache/openjpa/jdbc/schema/DriverDataSource.html" target="_top">
+<code class="classname">org.apache.openjpa.jdbc.schema.DriverDataSource</code></a>
+implementation to use to wrap JDBC Driver classes with javax.sql.DataSource
+instances. The <code class="classname">org.apache.openjpa.jdbc.schema.AutoDriverDataSource</code> implementation is the default and will select either the DBCPDriverDataSource or SimpleDriverDataSource based on if Apache Commons DBCP is available
+on the classpath.
+The <code class="classname">org.apache.openjpa.jdbc.schema.DBCPDriverDataSource</code> implementation requires Apache Commons DBCP to be available on the classpath and uses <code class="classname">org.apache.commons.dbcp.BasicDataSource</code> to provide connection pooling.
+ </p>
+ </div>
+ <div class="section" title="6.4. openjpa.jdbc.EagerFetchMode"><div class="titlepage"><div><div><h3 class="title" id="openjpa.jdbc.EagerFetchMode">6.4.
+ openjpa.jdbc.EagerFetchMode
+ </h3></div></div></div>
+
+ <a class="indexterm" name="d5e8718"></a>
+ <a class="indexterm" name="d5e8720"></a>
+ <p>
+<span class="bold"><strong>Property name: </strong></span><code class="literal">
+openjpa.jdbc.EagerFetchMode</code>
+ </p>
+ <p>
+<span class="bold"><strong>Configuration API:</strong></span>
+<a class="ulink" href="../javadoc/org/apache/openjpa/jdbc/conf/JDBCConfiguration.html#getEagerFetchMode()" target="_top">
+<code class="methodname">org.apache.openjpa.jdbc.conf.JDBCConfiguration.getEagerFetchMode
+</code></a>
+ </p>
+ <p>
+<span class="bold"><strong>Resource adaptor config-property: </strong></span><code class="literal">
+EagerFetchMode</code>
+ </p>
+ <p>
+<span class="bold"><strong>Default: </strong></span><code class="literal">parallel</code>
+ </p>
+ <p>
+<span class="bold"><strong>Possible values: </strong></span><code class="literal">parallel</code>,
+<code class="literal">join</code>, <code class="literal">none</code>
+ </p>
+ <p>
+<span class="bold"><strong>Description:</strong></span> Optimizes how OpenJPA loads
+persistent relations. This setting can also be varied at runtime. See
+<a class="xref" href="ref_guide_perfpack_eager.html" title="8. Eager Fetching">Section 8, “
+ Eager Fetching
+ ”</a> for details.
+ </p>
+ </div>
+ <div class="section" title="6.5. openjpa.jdbc.FetchDirection"><div class="titlepage"><div><div><h3 class="title" id="openjpa.jdbc.FetchDirection">6.5.
+ openjpa.jdbc.FetchDirection
+ </h3></div></div></div>
+
+ <a class="indexterm" name="d5e8746"></a>
+ <a class="indexterm" name="d5e8748"></a>
+ <p>
+<span class="bold"><strong>Property name: </strong></span><code class="literal">
+openjpa.jdbc.FetchDirection</code>
+ </p>
+ <p>
+<span class="bold"><strong>Configuration API:</strong></span>
+<a class="ulink" href="../javadoc/org/apache/openjpa/jdbc/conf/JDBCConfiguration.html#getFetchDirection()" target="_top">
+<code class="methodname">org.apache.openjpa.jdbc.conf.JDBCConfiguration.getFetchDirection
+</code></a>
+ </p>
+ <p>
+<span class="bold"><strong>Resource adaptor config-property: </strong></span><code class="literal">
+FetchDirection</code>
+ </p>
+ <p>
+<span class="bold"><strong>Default: </strong></span><code class="literal">forward</code>
+ </p>
+ <p>
+<span class="bold"><strong>Possible values: </strong></span><code class="literal">forward</code>,
+<code class="literal">reverse</code>, <code class="literal">unknown</code>
+ </p>
+ <p>
+<span class="bold"><strong>Description:</strong></span> The expected order in which query
+result lists will be accessed. This property can also be varied 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" title="6.6. openjpa.jdbc.JDBCListeners"><div class="titlepage"><div><div><h3 class="title" id="openjpa.jdbc.JDBCListeners">6.6.
+ openjpa.jdbc.JDBCListeners
+ </h3></div></div></div>
+
+ <a class="indexterm" name="d5e8774"></a>
+ <a class="indexterm" name="d5e8776"></a>
+ <p>
+<span class="bold"><strong>Property name: </strong></span><code class="literal">
+openjpa.jdbc.JDBCListeners</code>
+ </p>
+ <p>
+<span class="bold"><strong>Configuration API:</strong></span>
+<a class="ulink" href="../javadoc/org/apache/openjpa/jdbc/conf/JDBCConfiguration.html#getJDBCListeners()" target="_top">
+<code class="methodname">org.apache.openjpa.jdbc.conf.JDBCConfiguration.getJDBCListeners
+</code></a>
+ </p>
+ <p>
+<span class="bold"><strong>Resource adaptor config-property: </strong></span><code class="literal">
+JDBCListeners</code>
+ </p>
+ <p>
+<span class="bold"><strong>Default:</strong></span> -
+ </p>
+ <p>
+<span class="bold"><strong>Description:</strong></span> A comma-separated list of plugin
+strings (see <a class="xref" href="ref_guide_conf_plugins.html" title="4. Plugin Configuration">Section 4, “
+ Plugin Configuration
+ ”</a>) describing
+<a class="ulink" href="../javadoc/org/apache/openjpa/lib/jdbc/JDBCListener.html" target="_top">
+<code class="classname">org.apache.openjpa.lib.jdbc.JDBCListener</code></a> event
+listeners to install. These listeners will be notified on various JDBC-related
+events.
+ </p>
+ </div>
+ <div class="section" title="6.7. openjpa.jdbc.LRSSize"><div class="titlepage"><div><div><h3 class="title" id="openjpa.jdbc.LRSSize">6.7.
+ openjpa.jdbc.LRSSize
+ </h3></div></div></div>
+
+ <a class="indexterm" name="d5e8798"></a>
+ <a class="indexterm" name="d5e8800"></a>
+ <p>
+<span class="bold"><strong>Property name: </strong></span><code class="literal">openjpa.jdbc.LRSSize
+</code>
+ </p>
+ <p>
+<span class="bold"><strong>Configuration API:</strong></span>
+<a class="ulink" href="../javadoc/org/apache/openjpa/jdbc/conf/JDBCConfiguration.html#getLRSSize()" target="_top">
+<code class="methodname">org.apache.openjpa.jdbc.conf.JDBCConfiguration.getLRSSize
+</code></a>
+ </p>
+ <p>
+<span class="bold"><strong>Resource adaptor config-property: </strong></span><code class="literal">
+LRSSize</code>
+ </p>
+ <p>
+<span class="bold"><strong>Default: </strong></span><code class="literal">query</code>
+ </p>
+ <p>
+<span class="bold"><strong>Possible values: </strong></span><code class="literal">query</code>,
+<code class="literal">last</code>, <code class="literal">unknown</code>
+ </p>
+ <p>
+<span class="bold"><strong>Description:</strong></span> The strategy to use to calculate
+the size of a result list. This property can also be varied 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" title="6.8. openjpa.jdbc.MappingDefaults"><div class="titlepage"><div><div><h3 class="title" id="openjpa.jdbc.MappingDefaults">6.8.
+ openjpa.jdbc.MappingDefaults
+ </h3></div></div></div>
+
+ <a class="indexterm" name="d5e8826"></a>
+ <a class="indexterm" name="d5e8828"></a>
+ <p>
+<span class="bold"><strong>Property name: </strong></span><code class="literal">
+openjpa.jdbc.MappingDefaults</code>
+ </p>
+ <p>
+<span class="bold"><strong>Configuration API:</strong></span>
+<a class="ulink" href="../javadoc/org/apache/openjpa/jdbc/conf/JDBCConfiguration.html#getMappingDefaults()" target="_top">
+<code class="methodname">org.apache.openjpa.jdbc.conf.JDBCConfiguration.getMappingDefaults
+</code></a>
+ </p>
+ <p>
+<span class="bold"><strong>Resource adaptor config-property: </strong></span><code class="literal">
+MappingDefaults</code>
+ </p>
+ <p>
+<span class="bold"><strong>Default:</strong></span> jpa
+ </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/jdbc/meta/MappingDefaults.html" target="_top">
+<code class="classname">org.apache.openjpa.jdbc.meta.MappingDefaults</code></a> to
+use to define default column names, table names, and constraints for your
+persistent classes. See <a class="xref" href="ref_guide_mapping_factory.html" title="5. Mapping Factory">Section 5, “
+ Mapping Factory
+ ”</a> for
+details.
+ </p>
+ </div>
+ <div class="section" title="6.9. openjpa.jdbc.MappingFactory"><div class="titlepage"><div><div><h3 class="title" id="openjpa.jdbc.MappingFactory">6.9.
+ openjpa.jdbc.MappingFactory
+ </h3></div></div></div>
+
+ <a class="indexterm" name="d5e8851"></a>
+ <a class="indexterm" name="d5e8853"></a>
+ <p>
+<span class="bold"><strong>Property name: </strong></span><code class="literal">
+openjpa.jdbc.MappingFactory</code>
+ </p>
+ <p>
+<span class="bold"><strong>Configuration API:</strong></span>
+<a class="ulink" href="../javadoc/org/apache/openjpa/jdbc/conf/JDBCConfiguration.html#getMappingFactory()" target="_top">
+<code class="methodname">org.apache.openjpa.jdbc.conf.JDBCConfiguration.getMappingFactory
+</code></a>
+ </p>
+ <p>
+<span class="bold"><strong>Resource adaptor config-property: </strong></span><code class="literal">
+MappingFactory</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>) describing the
+<a class="ulink" href="../javadoc/org/apache/openjpa/meta/MetaDataFactory.html" target="_top">
+<code class="classname">org.apache.openjpa.meta.MetaDataFactory</code></a> to use to
+store and retrieve object-relational mapping information for your persistent
+classes. See <a class="xref" href="ref_guide_mapping_factory.html" title="5. Mapping Factory">Section 5, “
+ Mapping Factory
+ ”</a> for details.
+ </p>
+
+ </div>
+ <div class="section" title="6.10. openjpa.jdbc.QuerySQLCache"><div class="titlepage"><div><div><h3 class="title" id="openjpa.jdbc.QuerySQLCache">6.10.
+ openjpa.jdbc.QuerySQLCache
+ </h3></div></div></div>
+
+ <a class="indexterm" name="d5e8876"></a>
+ <a class="indexterm" name="d5e8878"></a>
+ <p>
+<span class="bold"><strong>Property name:</strong></span>
+<code class="literal">openjpa.jdbc.QuerySQLCache</code>
+ </p>
+ <p>
+<span class="bold"><strong>Resource adaptor config-property:</strong></span>
+<code class="literal">QuerySQLCache</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 class="xref" href="ref_guide_conf_plugins.html" title="4. Plugin Configuration">Section 4, “
+ Plugin Configuration
+ ”</a>) describing the options to cache and
+reuse SQL statements generated for JPQL queries.
+See <a class="xref" href="ref_guide_cache_querysql.html" title="3. Prepared SQL Cache">Section 3, “Prepared SQL Cache”</a> for details.
+ </p>
+ </div>
+ <div class="section" title="6.11. openjpa.jdbc.ResultSetType"><div class="titlepage"><div><div><h3 class="title" id="openjpa.jdbc.ResultSetType">6.11.
+ openjpa.jdbc.ResultSetType
+ </h3></div></div></div>
+
+ <a class="indexterm" name="d5e8896"></a>
+ <a class="indexterm" name="d5e8898"></a>
+ <p>
+<span class="bold"><strong>Property name: </strong></span><code class="literal">
+openjpa.jdbc.ResultSetType</code>
+ </p>
+ <p>
+<span class="bold"><strong>Configuration API:</strong></span>
+<a class="ulink" href="../javadoc/org/apache/openjpa/jdbc/conf/JDBCConfiguration.html#getResultSetType()" target="_top">
+<code class="methodname">org.apache.openjpa.jdbc.conf.JDBCConfiguration.getResultSetType
+</code></a>
+ </p>
+ <p>
+<span class="bold"><strong>Resource adaptor config-property: </strong></span><code class="literal">
+ResultSetType</code>
+ </p>
+ <p>
+<span class="bold"><strong>Default: </strong></span><code class="literal">forward-only</code>
+ </p>
+ <p>
+<span class="bold"><strong>Possible values: </strong></span><code class="literal">forward-only</code>
+, <code class="literal">scroll-sensitive</code>, <code class="literal">scroll-insensitive</code>
+ </p>
+ <p>
+<span class="bold"><strong>Description:</strong></span> The JDBC result set type to use
+when fetching result lists. This property can also be varied 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" title="6.12. openjpa.jdbc.Schema"><div class="titlepage"><div><div><h3 class="title" id="openjpa.jdbc.Schema">6.12.
+ openjpa.jdbc.Schema
+ </h3></div></div></div>
+
+ <a class="indexterm" name="d5e8924"></a>
+ <p>
+<span class="bold"><strong>Property name: </strong></span><code class="literal">openjpa.jdbc.Schema
+</code>
+ </p>
+ <p>
+<span class="bold"><strong>Configuration API:</strong></span>
+<a class="ulink" href="../javadoc/org/apache/openjpa/jdbc/conf/JDBCConfiguration.html#getSchema()" target="_top">
+<code class="methodname">org.apache.openjpa.jdbc.conf.JDBCConfiguration.getSchema
+</code></a>
+ </p>
+ <p>
+<span class="bold"><strong>Resource adaptor config-property: </strong></span><code class="literal">
+Schema</code>
+ </p>
+ <p>
+<span class="bold"><strong>Default:</strong></span> -
+ </p>
+ <p>
+<span class="bold"><strong>Description:</strong></span> The default schema name to prepend
+to unqualified table names. Also, the schema in which OpenJPA will create new
+tables. See <a class="xref" href="ref_guide_schema_def.html" title="11. Default Schema">Section 11, “
+ Default Schema
+ ”</a> for details.
+ </p>
+ </div>
+ <div class="section" title="6.13. openjpa.jdbc.SchemaFactory"><div class="titlepage"><div><div><h3 class="title" id="openjpa.jdbc.SchemaFactory">6.13.
+ openjpa.jdbc.SchemaFactory
+ </h3></div></div></div>
+
+ <a class="indexterm" name="d5e8944"></a>
+ <a class="indexterm" name="d5e8946"></a>
+ <p>
+<span class="bold"><strong>Property name: </strong></span><code class="literal">
+openjpa.jdbc.SchemaFactory</code>
+ </p>
+ <p>
+<span class="bold"><strong>Configuration API:</strong></span>
+<a class="ulink" href="../javadoc/org/apache/openjpa/jdbc/conf/JDBCConfiguration.html#getSchemaFactory()" target="_top">
+<code class="methodname">org.apache.openjpa.jdbc.conf.JDBCConfiguration.getSchemaFactory
+</code></a>
+ </p>
+ <p>
+<span class="bold"><strong>Resource adaptor config-property: </strong></span><code class="literal">
+SchemaFactory</code>
+ </p>
+ <p>
+<span class="bold"><strong>Default: </strong></span><code class="literal">dynamic</code>
+ </p>
+ <p>
+<span class="bold"><strong>Possible values: </strong></span><code class="literal">dynamic</code>,
+<code class="literal">native</code>, <code class="literal">file</code>, <code class="literal">table</code>,
+others
+ </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/jdbc/schema/SchemaFactory.html" target="_top">
+<code class="classname">org.apache.openjpa.jdbc.schema.SchemaFactory</code></a> to
+use to store and retrieve information about the database schema. See
+<a class="xref" href="ref_guide_schema_info.html#ref_guide_schema_info_factory" title="12.2. Schema Factory">Section 12.2, “
+ Schema Factory
+ ”</a> for details.
+ </p>
+ </div>
+ <div class="section" title="6.14. openjpa.jdbc.Schemas"><div class="titlepage"><div><div><h3 class="title" id="openjpa.jdbc.Schemas">6.14.
+ openjpa.jdbc.Schemas
+ </h3></div></div></div>
+
+ <a class="indexterm" name="d5e8976"></a>
+ <p>
+<span class="bold"><strong>Property name: </strong></span><code class="literal">openjpa.jdbc.Schemas
+</code>
+ </p>
+ <p>
+<span class="bold"><strong>Configuration API:</strong></span>
+<a class="ulink" href="../javadoc/org/apache/openjpa/jdbc/conf/JDBCConfiguration.html#getSchemas()" target="_top">
+<code class="methodname">org.apache.openjpa.jdbc.conf.JDBCConfiguration.getSchemas
+</code></a>
+ </p>
+ <p>
+<span class="bold"><strong>Resource adaptor config-property: </strong></span><code class="literal">
+Schemas</code>
+ </p>
+ <p>
+<span class="bold"><strong>Default:</strong></span> -
+ </p>
+ <p>
+<span class="bold"><strong>Description:</strong></span> A comma-separated list of the
+schemas and/or tables used for your persistent data. See
+<a class="xref" href="ref_guide_schema_info.html#ref_guide_schema_info_list" title="12.1. Schemas List">Section 12.1, “
+ Schemas List
+ ”</a> for details.
+ </p>
+ </div>
+ <div class="section" title="6.15. openjpa.jdbc.SQLFactory"><div class="titlepage"><div><div><h3 class="title" id="openjpa.jdbc.SQLFactory">6.15.
+ openjpa.jdbc.SQLFactory
+ </h3></div></div></div>
+
+ <a class="indexterm" name="d5e8996"></a>
+ <a class="indexterm" name="d5e8998"></a>
+ <p>
+<span class="bold"><strong>Property name: </strong></span><code class="literal">openjpa.jdbc.SQLFactory
+</code>
+ </p>
+ <p>
+<span class="bold"><strong>Configuration API:</strong></span>
+<a class="ulink" href="../javadoc/org/apache/openjpa/jdbc/conf/JDBCConfiguration.html#getSQLFactory()" target="_top">
+<code class="methodname">org.apache.openjpa.jdbc.conf.JDBCConfiguration.getSQLFactory
+</code></a>
+ </p>
+ <p>
+<span class="bold"><strong>Resource adaptor config-property: </strong></span><code class="literal">
+SQLFactory</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/jdbc/sql/SQLFactory.html" target="_top"><code class="classname">
+org.apache.openjpa.jdbc.sql.SQLFactory</code></a> to use to abstract
+common SQL constructs.
+ </p>
+ </div>
+ <div class="section" title="6.16. openjpa.jdbc.SubclassFetchMode"><div class="titlepage"><div><div><h3 class="title" id="openjpa.jdbc.SubclassFetchMode">6.16.
+ openjpa.jdbc.SubclassFetchMode
+ </h3></div></div></div>
+
+ <a class="indexterm" name="d5e9021"></a>
+ <a class="indexterm" name="d5e9023"></a>
+ <a class="indexterm" name="d5e9026"></a>
+ <p>
+<span class="bold"><strong>Property name: </strong></span><code class="literal">
+openjpa.jdbc.SubclassFetchMode</code>
+ </p>
+ <p>
+<span class="bold"><strong>Configuration API:</strong></span>
+<a class="ulink" href="../javadoc/org/apache/openjpa/jdbc/conf/JDBCConfiguration.html#getSubclassFetchMode()" target="_top">
+<code class="methodname">org.apache.openjpa.jdbc.conf.JDBCConfiguration.getSubclassFetchMode
+</code></a>
+ </p>
+ <p>
+<span class="bold"><strong>Resource adaptor config-property: </strong></span><code class="literal">
+SubclassFetchMode</code>
+ </p>
+ <p>
+<span class="bold"><strong>Default: </strong></span><code class="literal">parallel</code>
+ </p>
+ <p>
+<span class="bold"><strong>Possible values: </strong></span><code class="literal">parallel</code>,
+<code class="literal">join</code>, <code class="literal">none</code>
+ </p>
+ <p>
+<span class="bold"><strong>Description:</strong></span> How to select subclass data when
+it is in other tables. This setting can also be varied at runtime. See
+<a class="xref" href="ref_guide_perfpack_eager.html" title="8. Eager Fetching">Section 8, “
+ Eager Fetching
+ ”</a>.
+ </p>
+ </div>
+ <div class="section" title="6.17. openjpa.jdbc.SynchronizeMappings"><div class="titlepage"><div><div><h3 class="title" id="openjpa.jdbc.SynchronizeMappings">6.17.
+ openjpa.jdbc.SynchronizeMappings
+ </h3></div></div></div>
+
+ <a class="indexterm" name="d5e9052"></a>
+ <a class="indexterm" name="d5e9054"></a>
+ <p>
+<span class="bold"><strong>Property name: </strong></span><code class="literal">
+openjpa.jdbc.SynchronizeMappings</code>
+ </p>
+ <p>
+<span class="bold"><strong>Configuration API:</strong></span>
+<a class="ulink" href="../javadoc/org/apache/openjpa/jdbc/conf/JDBCConfiguration.html#getSynchronizeMappings()" target="_top">
+<code class="methodname">
+org.apache.openjpa.jdbc.conf.JDBCConfiguration.getSynchronizeMappings
+</code></a>
+ </p>
+ <p>
+<span class="bold"><strong>Resource adaptor config-property: </strong></span><code class="literal">
+SynchronizeMappings</code>
+ </p>
+ <p>
+<span class="bold"><strong>Default:</strong></span> -
+ </p>
+ <p>
+<span class="bold"><strong>Description:</strong></span> Controls whether OpenJPA will
+attempt to run the mapping tool on all persistent classes to synchronize their
+mappings and schema at runtime. Useful for rapid test/debug cycles. See
+<a class="xref" href="ref_guide_mapping.html#ref_guide_mapping_synch" title="1.3. Runtime Forward Mapping">Section 1.3, “
+ Runtime Forward Mapping
+ ”</a> for more information.
+ </p>
+ </div>
+ <div class="section" title="6.18. openjpa.jdbc.TransactionIsolation"><div class="titlepage"><div><div><h3 class="title" id="openjpa.jdbc.TransactionIsolation">6.18.
+ openjpa.jdbc.TransactionIsolation
+ </h3></div></div></div>
+
+ <a class="indexterm" name="d5e9074"></a>
+ <a class="indexterm" name="d5e9076"></a>
+ <a class="indexterm" name="d5e9079"></a>
+ <p>
+<span class="bold"><strong>Property name: </strong></span><code class="literal">
+openjpa.jdbc.TransactionIsolation</code>
+ </p>
+ <p>
+<span class="bold"><strong>Configuration API:</strong></span>
+<a class="ulink" href="../javadoc/org/apache/openjpa/jdbc/conf/JDBCConfiguration.html#getTransactionIsolation()" target="_top">
+<code class="methodname">
+org.apache.openjpa.jdbc.conf.JDBCConfiguration.getTransactionIsolation
+</code></a>
+ </p>
+ <p>
+<span class="bold"><strong>Resource adaptor config-property: </strong></span><code class="literal">
+TransactionIsolation</code>
+ </p>
+ <p>
+<span class="bold"><strong>Default: </strong></span><code class="literal">default</code>
+ </p>
+ <p>
+<span class="bold"><strong>Possible values: </strong></span><code class="literal">default</code>,
+<code class="literal">none</code>, <code class="literal">read-committed</code>, <code class="literal">
+read-uncommitted</code>, <code class="literal">repeatable-read</code>, <code class="literal">
+serializable</code>
+ </p>
+ <p>
+<span class="bold"><strong>Description:</strong></span> The JDBC transaction isolation
+level to use. See <a class="xref" href="ref_guide_dbsetup_isolation.html" title="5. Setting the Transaction Isolation">Section 5, “
+ Setting the Transaction Isolation
+ ”</a> for
+details.
+ </p>
+ </div>
+ <div class="section" title="6.19. openjpa.jdbc.UpdateManager"><div class="titlepage"><div><div><h3 class="title" id="openjpa.jdbc.UpdateManager">6.19.
+ openjpa.jdbc.UpdateManager
+ </h3></div></div></div>
+
+ <a class="indexterm" name="d5e9108"></a>
+ <a class="indexterm" name="d5e9110"></a>
+ <p>
+<span class="bold"><strong>Property name: </strong></span><code class="literal">
+openjpa.jdbc.UpdateManager</code>
+ </p>
+ <p>
+<span class="bold"><strong>Configuration API:</strong></span>
+<a class="ulink" href="../javadoc/org/apache/openjpa/jdbc/conf/JDBCConfiguration.html#getUpdateManager()" target="_top">
+<code class="methodname">org.apache.openjpa.jdbc.conf.JDBCConfiguration.getUpdateManager
+</code></a>
+ </p>
+ <p>
+<span class="bold"><strong>Resource adaptor config-property: </strong></span><code class="literal">
+UpdateManager</code>
+ </p>
+ <p>
+<span class="bold"><strong>Default: </strong></span><code class="literal">batching-constraint</code>
+ </p>
+ <p>
+ <span class="bold"><strong>Possible values: </strong></span><code class="literal">default</code>,
+<code class="literal">operation-order</code>, <code class="literal">constraint</code>, <code class="literal">
+batching-constraint</code>, <code class="literal">batching-operation-order</code>
+ </p>
+ <p>
+<span class="bold"><strong>Description:</strong></span> The full class name of the
+<a class="ulink" href="../javadoc/org/apache/openjpa/jdbc/kernel/UpdateManager.html" target="_top">
+<code class="classname">org.apache.openjpa.jdbc.kernel.UpdateManager</code></a> to
+use to flush persistent object changes to the datastore. The provided default
+implementation is
+<a class="ulink" href="../javadoc/org/apache/openjpa/jdbc/kernel/BatchingConstraintUpdateManager" target="_top">
+<code class="classname">org.apache.openjpa.jdbc.kernel.BatchingConstraintUpdateManager</code>
+</a>.
+
+ </p>
+ </div>
+
+ <div class="section" title="6.20. Compatibility with Specification"><div class="titlepage"><div><div><h3 class="title" id="ref_guide_spec_compatibility">6.20. Compatibility with Specification</h3></div></div></div>
+
+ <p>
+The default behavior of certain OpenJPA API methods can evolve to align with the behaviors
+defined in JPA specification. To maintain backward compatibility, OpenJPA allows configuration
+options such that while the default behavior changes to align with current JPA specification, the
+previous behaviors can always be emulated.
+ </p>
+ <p>
+For example, JPA 2.0 specification
+introduces a new API <code class="literal">void EntityManager.detach(Object entity)</code> that detaches
+the given entity from the current persistence context. OpenJPA has provided similar
+feature via <code class="literal"><T> T OpenJPAEntityManager.detach(T entity)</code> prior to JPA 2.0.
+OpenJPA <code class="literal">detach()</code>, however, has different default behavior than what JPA 2.0
+specification mandates. Firstly, OpenJPA creates a copy of the given entity as a detached instance
+and returns it, whereas JPA 2.0 behavior requires the same given entity instance be detached.
+Secondly, the given instance is removed from the persistence context for JPA 2.0, whereas
+OpenJPA <code class="literal">detach()</code> method, prior to JPA 2.0, does not remove the instance
+from the persistence context as a copy is returned. Thirdly, OpenJPA will flush before
+detaching a dirty instance so that the detached instance can later be merged, whereas
+JPA 2.0 <code class="literal">detach()</code> semantics does not require a dirty instance be flushed
+before detach.
+ </p>
+ <p>
+A user application running with OpenJPA that is compliant to a specific version of JPA specification
+can emulate the older behavior by configuring OpenJPA compatibility options.
+For example, <code class="literal">openjpa.Compatibility=FlushBeforeDetach=false,CopyOnDetach=true</code>
+will emulate the older behavior of detach even when running with OpenJPA that is
+compliant to JPA 2.0 specification. The configuration can also be set to a different version of the specification.
+For example, <code class="literal">openjpa.Specification="JPA 1.0"</code> configuration setting will emulate
+default OpenJPA behavior as it were for JPA specification version 1.0. Setting
+<code class="literal">openjpa.Specification</code> is a shorthand for more fine-grained control available via
+<code class="literal">openjpa.Compatibility</code>.
+
+ </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_openjpa.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_logging.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top">5.
+ OpenJPA Properties
+ </td><td width="20%" align="center"><a accesskey="h" href="manual.html">Home</a></td><td width="40%" align="right" valign="top"> Chapter 3.
+ Logging and Auditing
+ </td></tr></table></div></body></html>
\ No newline at end of file
Propchange: websites/production/openjpa/content/builds/2.4.0/apache-openjpa/docs/ref_guide_conf_jdbc.html
------------------------------------------------------------------------------
svn:eol-style = native