Added:
websites/production/openjpa/content/builds/2.3.0/apache-openjpa/docs/ref_guide_conf_jdbc.html
==============================================================================
---
websites/production/openjpa/content/builds/2.3.0/apache-openjpa/docs/ref_guide_conf_jdbc.html
(added)
+++
websites/production/openjpa/content/builds/2.3.0/apache-openjpa/docs/ref_guide_conf_jdbc.html
Wed May 14 22:22:23 2014
@@ -0,0 +1,769 @@
+<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.3 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, or to plug in your own dictionary for a database
+OpenJPA does not support out-of-the-box. 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.3.0/apache-openjpa/docs/ref_guide_conf_jdbc.html
------------------------------------------------------------------------------
svn:mime-type = text/plain
