Added: websites/production/openjpa/content/builds/2.4.2/apache-openjpa/docs/ref_guide_conf_plugins.html ============================================================================== --- websites/production/openjpa/content/builds/2.4.2/apache-openjpa/docs/ref_guide_conf_plugins.html (added) +++ websites/production/openjpa/content/builds/2.4.2/apache-openjpa/docs/ref_guide_conf_plugins.html Fri Jan 6 19:19:20 2017 @@ -0,0 +1,91 @@ +<html><head> + <meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1"> + <title>4. Plugin Configuration</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_devtools.html" title="3. Command Line Configuration"><link rel="next" href="ref_guide_conf_openjpa.html" title="5. OpenJPA 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">4. + Plugin Configuration + </th></tr><tr><td width="20%" align="left"><a accesskey="p" href="ref_guide_conf_devtools.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_openjpa.html">Next</a></td></tr></table><hr></div><div class="section" id="ref_guide_conf_plugins"><div class="titlepage"><div><div><h2 class="title" style="clear: both">4. + Plugin Configuration + </h2></div></div></div> + + <a class="indexterm" name="d5e6829"></a> + <a class="indexterm" name="d5e6832"></a> + <p> +Because OpenJPA is a highly customizable environment, many configuration +properties relate to the creation and configuration of system plugins. Plugin +properties have a syntax very similar to that of Java annotations. They allow +you to specify both what class to use for the plugin and how to configure the +public fields or bean properties of the instantiated plugin instance. The +easiest way to describe the plugin syntax is by example: + </p> + <p> +OpenJPA has a pluggable L2 caching mechanism that is controlled by the <code class="literal"> +openjpa.DataCache</code> configuration property. Suppose that you have +created a new class, <code class="classname">com.xyz.MyDataCache</code>, that you want +OpenJPA to use for caching. You've made instances of <code class="literal">MyDataCache +</code> configurable via two methods, <code class="methodname">setCacheSize(int size) +</code> and <code class="methodname">setRemoteHost(String host)</code>. The +sample below shows how you would tell OpenJPA to use an instance of your custom +plugin with a max size of 1000 and a remote host of <code class="literal">cacheserver +</code>. + </p> +<pre class="programlisting"> +<property name="openjpa.DataCache" + value="com.xyz.MyDataCache(CacheSize=1000, RemoteHost=cacheserver)"/> +</pre> + <p> +As you can see, plugin properties take a class name, followed by a +comma-separated list of values for the plugin's public fields or bean properties +in parentheses. OpenJPA will match each named property to a field or setter +method in the instantiated plugin instance, and set the field or invoke the +method with the given value (after converting the value to the right type, of +course). The first letter of the property names can be in either upper or lower +case. The following would also have been valid: + </p> +<pre class="programlisting"> +com.xyz.MyDataCache(cacheSize=1000, remoteHost=cacheserver) +</pre> + <p> +If you do not need to pass any property settings to a plugin, you can just name +the class to use: + </p> +<pre class="programlisting"> +com.xyz.MyDataCache +</pre> + <p> +Similarly, if the plugin has a default class that you do not want to change, you +can simply specify a list of property settings, without a class name. For +example, OpenJPA's query cache companion to the data cache has a default +implementation suitable to most users, but you still might want to change the +query cache's size. It has a <code class="literal">CacheSize</code> property for this +purpose: + </p> +<pre class="programlisting"> +CacheSize=1000 +</pre> + <p> +Finally, many of OpenJPA's built-in options for plugins have short alias names +that you can use in place of the full class name. The data cache property, for +example, has an available alias of <code class="literal">true</code> for the standard +cache implementation. The property value simply becomes: + </p> +<pre class="programlisting"> +true +</pre> + <p> +The standard cache implementation class also has a <code class="literal">CacheSize</code> +property, so to use the standard implementation and configure the size, specify: + </p> +<pre class="programlisting"> +true(CacheSize=1000) +</pre> + + <p> +The remainder of this chapter reviews the set of configuration properties +OpenJPA recognizes. + </p> + </div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="ref_guide_conf_devtools.html">Prev</a> </td><td width="20%" align="center"><a accesskey="u" href="ref_guide_conf.html">Up</a></td><td width="40%" align="right"> <a accesskey="n" href="ref_guide_conf_openjpa.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top">3. + Command Line Configuration + </td><td width="20%" align="center"><a accesskey="h" href="manual.html">Home</a></td><td width="40%" align="right" valign="top"> 5. + OpenJPA Properties + </td></tr></table></div></body></html> \ No newline at end of file
Added: websites/production/openjpa/content/builds/2.4.2/apache-openjpa/docs/ref_guide_conf_specify.html ============================================================================== --- websites/production/openjpa/content/builds/2.4.2/apache-openjpa/docs/ref_guide_conf_specify.html (added) +++ websites/production/openjpa/content/builds/2.4.2/apache-openjpa/docs/ref_guide_conf_specify.html Fri Jan 6 19:19:20 2017 @@ -0,0 +1,91 @@ +<html><head> + <meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1"> + <title>2. Runtime Configuration</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.html" title="Chapter 2. Configuration"><link rel="next" href="ref_guide_conf_devtools.html" title="3. Command Line Configuration"></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">2. + Runtime Configuration + </th></tr><tr><td width="20%" align="left"><a accesskey="p" href="ref_guide_conf.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_devtools.html">Next</a></td></tr></table><hr></div><div class="section" id="ref_guide_conf_specify"><div class="titlepage"><div><div><h2 class="title" style="clear: both">2. + Runtime Configuration + </h2></div></div></div> + + <a class="indexterm" name="d5e6711"></a> + <p> +The OpenJPA runtime includes a comprehensive system of configuration defaults +and overrides: + </p> + <div class="itemizedlist"><ul class="itemizedlist" style="list-style-type: disc; "><li class="listitem"> + <p> + <a class="indexterm" name="d5e6718"></a> +OpenJPA first looks for an optional <code class="filename">openjpa.xml</code> resource. +OpenJPA searches for this resource in each top-level directory of your <code class="literal"> +CLASSPATH</code>. OpenJPA will also find the resource if you place it within +a <code class="filename">META-INF</code> directory in any top-level directory of the +<code class="literal">CLASSPATH</code>. The <code class="filename">openjpa.xml</code> resource +contains property settings in <a class="link" href="jpa_overview_persistence.html#jpa_overview_persistence_xml" title="1. persistence.xml"> +JPA's XML format</a>. + </p> + </li><li class="listitem"> + <p> +You can customize the name or location of the above resource by specifying the +correct resource path in the <code class="literal">openjpa.properties</code> System +property. + </p> + </li><li class="listitem"> + <p> +You can override any value defined in the above resource by setting the System +property of the same name to the desired value. + </p> + </li><li class="listitem"> + <p> + <a class="indexterm" name="d5e6733"></a> +In JPA, the values in the standard <code class="filename"> META-INF/persistence.xml +</code> bootstrapping file used by the +<a class="link" href="jpa_overview_persistence.html" title="Chapter 6. Persistence"><code class="classname">Persistence</code> +</a> class at runtime override the values in the above resource, as well as +any System property settings. The <code class="classname">Map</code> passed to +<code class="methodname">Persistence.createEntityManagerFactory</code> at runtime also +overrides previous settings, including properties defined in <code class="filename"> +persistence.xml</code>. + </p> + </li><li class="listitem"> + <p> +In JPA, The <code class="classname">Map</code> passed to the methods defined in the +<code class="classname">Query</code> and <code class="classname">EntityManager</code> interfaces +at runtime also overrides previous settings, including properties defined in +<code class="filename">persistence.xml</code>. The <code class="classname">Map</code> is in +effect only during the method invocation. + </p> + </li><li class="listitem"> + <p> +When using JCA deployment the <code class="literal">config-property</code> values in your +<code class="filename">ra.xml</code> file override other settings. + </p> + </li><li class="listitem"> + <p> +All OpenJPA command-line tools accept flags that allow you to specify the +configuration resource to use, and to override any property. +<a class="xref" href="ref_guide_conf_devtools.html" title="3. Command Line Configuration">Section 3, “ + Command Line Configuration + ”</a> describes these flags. + </p> + </li></ul></div> + <div class="note" style="margin-left: 0.5in; margin-right: 0.5in;"><h3 class="title">Note</h3> + <p> +Internally, the OpenJPA runtime environment and development +tools manipulate property settings through a general +<a class="ulink" href="../javadoc/org/apache/openjpa/lib/conf/Configuration.html" target="_top"> +<code class="classname">Configuration</code></a> interface, and in particular its +<a class="ulink" href="../javadoc/org/apache/openjpa/conf/OpenJPAConfiguration.html" target="_top"> +<code class="classname">OpenJPAConfiguration</code></a> and +<a class="ulink" href="../javadoc/org/apache/openjpa/jdbc/conf/JDBCConfiguration.html" target="_top"> +<code class="classname">JDBCConfiguration</code></a> subclasses. For advanced +customization, OpenJPA's extended runtime interfaces and its development tools +allow you to access these interfaces directly. See the <a class="ulink" href="../javadoc/" target="_top"> +Javadoc</a> for details. + </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.html">Prev</a> </td><td width="20%" align="center"><a accesskey="u" href="ref_guide_conf.html">Up</a></td><td width="40%" align="right"> <a accesskey="n" href="ref_guide_conf_devtools.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top">Chapter 2. + Configuration + </td><td width="20%" align="center"><a accesskey="h" href="manual.html">Home</a></td><td width="40%" align="right" valign="top"> 3. + Command Line Configuration + </td></tr></table></div></body></html> \ No newline at end of file Added: websites/production/openjpa/content/builds/2.4.2/apache-openjpa/docs/ref_guide_dbsetup.html ============================================================================== --- websites/production/openjpa/content/builds/2.4.2/apache-openjpa/docs/ref_guide_dbsetup.html (added) +++ websites/production/openjpa/content/builds/2.4.2/apache-openjpa/docs/ref_guide_dbsetup.html Fri Jan 6 19:19:20 2017 @@ -0,0 +1,252 @@ +<html><head> + <meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1"> + <title>Chapter 4. JDBC</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.html" title="Part 3. Reference Guide"><link rel="prev" href="ref_guide_audit.html" title="8. OpenJPA Audit"><link rel="next" href="ref_guide_dbsetup_thirdparty.html" title="2. Using a Third-Party DataSource"></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">Chapter 4. + JDBC + </th></tr><tr><td width="20%" align="left"><a accesskey="p" href="ref_guide_audit.html">Prev</a> </td><th width="60%" align="center">Part 3. Reference Guide</th><td width="20%" align="right"> <a accesskey="n" href="ref_guide_dbsetup_thirdparty.html">Next</a></td></tr></table><hr></div><div class="chapter" id="ref_guide_dbsetup"><div class="titlepage"><div><div><h2 class="title">Chapter 4. + JDBC + </h2></div></div></div><div class="toc"><p><b>Table of Contents</b></p><dl class="toc"><dt><span class="section"><a href="ref_guide_dbsetup.html#ref_guide_dbsetup_builtin">1. + Using the OpenJPA DataSource + </a></span></dt><dd><dl><dt><span class="section"><a href="ref_guide_dbsetup.html#ref_guide_dbsetup_auto">1.1. + Optional Connection Pooling + </a></span></dt><dt><span class="section"><a href="ref_guide_dbsetup.html#ref_guide_dbsetup_config">1.2. + Configuring the OpenJPA DataSource + </a></span></dt><dt><span class="section"><a href="ref_guide_dbsetup.html#ref_guide_dbsetup_dbcp">1.3. + Configuring Apache Commons DBCP + </a></span></dt></dl></dd><dt><span class="section"><a href="ref_guide_dbsetup_thirdparty.html">2. + Using a Third-Party DataSource + </a></span></dt><dd><dl><dt><span class="section"><a href="ref_guide_dbsetup_thirdparty.html#ref_guide_dbsetup_thirdparty_enlist">2.1. + Managed and XA DataSources + </a></span></dt><dt><span class="section"><a href="ref_guide_dbsetup_thirdparty.html#ref_guide_dbsetup_setDSatRuntime">2.2. Setting the DataSource at runtime</a></span></dt><dd><dl><dt><span class="section"><a href="ref_guide_dbsetup_thirdparty.html#ref_guide_dbsetup_setDSPerEM">2.2.1. Using different DataSources for each EntityManager</a></span></dt><dd><dl><dt><span class="section"><a href="ref_guide_dbsetup_thirdparty.html#ref_guide_dbsetup_setDSBenefits">2.2.1.1. Benefits</a></span></dt><dt><span class="section"><a href="ref_guide_dbsetup_thirdparty.html#ref_guide_dbsetup_setDSLimitations">2.2.1.2. Limitations</a></span></dt><dt><span class="section"><a href="ref_guide_dbsetup_thirdparty.html#ref_guide_dbsetup_setDSError">2.2.1.3. Error handling</a></span></dt></dl></dd></dl></dd></dl></dd><dt><span class="section"><a href="ref_guide_dbsetup_sqlconn.html">3. + Runtime Access to DataSource + </a></span></dt><dt><span class="section"><a href="ref_guide_dbsetup_dbsupport.html">4. + Database Support + </a></span></dt><dd><dl><dt><span class="section"><a href="ref_guide_dbsetup_dbsupport.html#ref_guide_dbsetup_dbdictprops">4.1. + DBDictionary Properties + </a></span></dt><dt><span class="section"><a href="ref_guide_dbsetup_dbsupport.html#ref_guide_dbsetup_dbsupport_firebird">4.2. + FirebirdDictionary Properties + </a></span></dt><dt><span class="section"><a href="ref_guide_dbsetup_dbsupport.html#ref_guide_dbsetup_dbsupport_mysql">4.3. + MySQLDictionary Properties + </a></span></dt><dt><span class="section"><a href="ref_guide_dbsetup_dbsupport.html#ref_guide_dbsetup_dbsupport_oracle">4.4. + OracleDictionary Properties + </a></span></dt><dt><span class="section"><a href="ref_guide_dbsetup_dbsupport.html#ref_guide_dbsetup_dbsupport_sybase">4.5. + SybaseDictionary Properties + </a></span></dt><dt><span class="section"><a href="ref_guide_dbsetup_dbsupport.html#ref_guide_dbsetup_dbsupport_db2">4.6. + DB2 Properties + </a></span></dt><dt><span class="section"><a href="ref_guide_dbsetup_dbsupport.html#ref_guide_dbsetup_dbsupport_delim_id">4.7. + Delimited Identifiers Support + </a></span></dt></dl></dd><dt><span class="section"><a href="ref_guide_dbsetup_isolation.html">5. + Setting the Transaction Isolation + </a></span></dt><dt><span class="section"><a href="ref_guide_dbsetup_sql92.html">6. + Setting the SQL Join Syntax + </a></span></dt><dt><span class="section"><a href="ref_guide_dbsetup_multidb.html">7. + Accessing Multiple Databases + </a></span></dt><dt><span class="section"><a href="ref_guide_dbsetup_retain.html">8. + Configuring the Use of JDBC Connections + </a></span></dt><dt><span class="section"><a href="ref_guide_dbsetup_stmtbatch.html">9. + Statement Batching + </a></span></dt><dt><span class="section"><a href="ref_guide_dbsetup_lrs.html">10. + Large Result Sets + </a></span></dt><dt><span class="section"><a href="ref_guide_schema_def.html">11. + Default Schema + </a></span></dt><dt><span class="section"><a href="ref_guide_schema_info.html">12. + Schema Reflection + </a></span></dt><dd><dl><dt><span class="section"><a href="ref_guide_schema_info.html#ref_guide_schema_info_list">12.1. + Schemas List + </a></span></dt><dt><span class="section"><a href="ref_guide_schema_info.html#ref_guide_schema_info_factory">12.2. + Schema Factory + </a></span></dt></dl></dd><dt><span class="section"><a href="ref_guide_schema_schematool.html">13. + Schema Tool + </a></span></dt><dt><span class="section"><a href="ref_guide_schema_xml.html">14. + XML Schema Format + </a></span></dt></dl></div> + + <a class="indexterm" name="d5e9470"></a> + <p> +OpenJPA uses a relational database for object persistence. +It communicates with the database using the Java DataBase Connectivity (JDBC) +APIs. This chapter describes how to configure OpenJPA to work with the JDBC +driver for your database, and how to access JDBC functionality at runtime. + </p> + <div class="section" id="ref_guide_dbsetup_builtin"><div class="titlepage"><div><div><h2 class="title" style="clear: both">1. + Using the OpenJPA DataSource + </h2></div></div></div><div class="toc"><dl class="toc"><dt><span class="section"><a href="ref_guide_dbsetup.html#ref_guide_dbsetup_auto">1.1. + Optional Connection Pooling + </a></span></dt><dt><span class="section"><a href="ref_guide_dbsetup.html#ref_guide_dbsetup_config">1.2. + Configuring the OpenJPA DataSource + </a></span></dt><dt><span class="section"><a href="ref_guide_dbsetup.html#ref_guide_dbsetup_dbcp">1.3. + Configuring Apache Commons DBCP + </a></span></dt></dl></div> + + <a class="indexterm" name="d5e9475"></a> + <a class="indexterm" name="d5e9478"></a> + <p> +OpenJPA defines a <code class="classname">org.apache.openjpa.jdbc.schema.DriverDataSource</code> interface, which provides a simple <code class="classname">javax.sql.DataSource</code> wrapper implementation for the normal cases where <code class="literal">openjpa.ConnectionDriverName</code> refers to a <code class="classname">java.sql.Driver</code>. +See <a class="link" href="ref_guide_conf_jdbc.html#openjpa.jdbc.DriverDataSource" title="6.3. openjpa.jdbc.DriverDataSource"> +<code class="literal">openjpa.jdbc.DriverDataSource</code></a> for the list of +provided implementations. + </p> + <div class="section" id="ref_guide_dbsetup_auto"><div class="titlepage"><div><div><h3 class="title">1.1. + Optional Connection Pooling + </h3></div></div></div> + + <a class="indexterm" name="d5e9490"></a> + <a class="indexterm" name="d5e9493"></a> + <p> +Starting with OpenJPA 2.1, a new <code class="classname">org.apache.openjpa.jdbc.schema.AutoDriverDataSource</code> is provided as the default, which will automatically +select between the old <code class="classname">SimpleDriverDataSource</code> and a new +<code class="classname">DBCPDriverDataSource</code> implementation based on if +<a class="ulink" href="http://commons.apache.org/dbcp/"; target="_top">Apache Commons DBCP</a> +has been provided on the classpath and OpenJPA is not running in a container +managed mode or with managed transactions. Note, that only the +<code class="literal">openjpa-all.jar</code> includes Commons DBCP, so you will need to +include the <code class="literal">commons-dbcp.jar</code> from the OpenJPA binary +distribution if you are using the normal <code class="literal">openjpa.jar</code>. + </p> + <p> +To disable the automatic usage of Apache Commons DBCP when it is discovered +on the classpath, set +<code class="literal">openjpa.jdbc.DriverDataSource=simple</code>, which will revert +OpenJPA to the prior behavior of using <code class="classname">org.apache.openjpa.jdbc.schema.SimpleDriverDataSource</code> + </p> + <p> +To force usage of Apache Commons DBCP, which will cause a fatal exception to +be thrown if it cannot be loaded from the classpath, set +<code class="literal">openjpa.jdbc.DriverDataSource=dbcp</code>, which will cause +OpenJPA to use <code class="classname">org.apache.openjpa.jdbc.schema.DBCPDriverDataSource</code> + </p> + </div> + <div class="section" id="ref_guide_dbsetup_config"><div class="titlepage"><div><div><h3 class="title">1.2. + Configuring the OpenJPA DataSource + </h3></div></div></div> + + <a class="indexterm" name="d5e9512"></a> + <p> +If you choose to use OpenJPA's <code class="classname">DataSource</code>, +then you must specify the following properties: + </p> + <div class="itemizedlist"><ul class="itemizedlist" style="list-style-type: disc; "><li class="listitem"> + <p> + <a class="indexterm" name="d5e9520"></a> +<code class="literal">openjpa.ConnectionUserName</code>: The JDBC user name for +connecting to the database. + </p> + </li><li class="listitem"> + <p> + <a class="indexterm" name="d5e9525"></a> +<code class="literal">openjpa.ConnectionPassword</code>: The JDBC password for the above +user. + </p> + </li><li class="listitem"> + <p> + <a class="indexterm" name="d5e9530"></a> +<code class="literal">openjpa.ConnectionURL</code>: The JDBC URL for the database. + </p> + </li><li class="listitem"> + <p> + <a class="indexterm" name="d5e9535"></a> +<code class="literal">openjpa.ConnectionDriverName</code>: The JDBC driver class. + </p> + </li></ul></div> + <p> +To configure advanced features, use the following optional +properties. The syntax of these property strings follows the syntax of OpenJPA +plugin parameters described in <a class="xref" href="ref_guide_conf_plugins.html" title="4. Plugin Configuration">Section 4, “ + Plugin Configuration + ”</a>. + </p> + <div class="itemizedlist"><ul class="itemizedlist" style="list-style-type: disc; "><li class="listitem"> + <p> + <a class="indexterm" name="d5e9543"></a> +<a class="link" href="ref_guide_conf_openjpa.html#openjpa.ConnectionProperties" title="5.19. openjpa.ConnectionProperties"> +<code class="literal">openjpa.ConnectionProperties</code></a>: If the listed driver is an +instance of <code class="classname">java.sql.Driver</code>, this string will be parsed +into a <code class="classname">Properties</code> instance, which will then be used to +obtain database connections through the <code class="methodname">Driver.connect(String url, +Properties props)</code> method. If, on the other hand, the listed driver +is a <code class="classname"> javax.sql.DataSource</code>, the string will be treated +as a plugin properties string, and matched to the bean setter methods of the +<code class="classname">DataSource</code> instance. + </p> + </li><li class="listitem"> + <p> + <a class="indexterm" name="d5e9554"></a> +<a class="link" href="ref_guide_conf_openjpa.html#openjpa.ConnectionFactoryProperties" title="5.15. openjpa.ConnectionFactoryProperties"> +<code class="literal">openjpa.ConnectionFactoryProperties</code></a>: OpenJPA's built-in +<code class="classname">DataSource</code> allows you to set the following options via +this plugin string: + </p> + <div class="itemizedlist"><ul class="itemizedlist" style="list-style-type: circle; "><li class="listitem"> + <p> + <a class="indexterm" name="d5e9562"></a> +<code class="literal">QueryTimeout</code>: The maximum number of seconds the JDBC driver +will wait for a statement to execute. + </p> + </li><li class="listitem"> + <p> + <a class="indexterm" name="d5e9568"></a> +<code class="literal">PrettyPrint</code>: Boolean indicating whether to pretty-print +logged SQL statements. + </p> + </li><li class="listitem"> + <p> + <a class="indexterm" name="d5e9574"></a> +<code class="literal">PrettyPrintLineLength</code>: The maximum number of characters in +each pretty-printed SQL line. + </p> + </li><li class="listitem"> + <p> + <a class="indexterm" name="d5e9580"></a> +<code class="literal">PrintParameters</code>: A boolean indicating whether SQL parameter +values will be included in exception text and when logging is enabled. Since +the parameter values may contain sensitive information the default value is +false. + </p> + </li></ul></div> + </li></ul></div> + <div class="example" id="ref_guide_dbsetup_builtin_ex"><p class="title"><b>Example 4.1. + Properties for the OpenJPA DataSource + </b></p><div class="example-contents"> + +<pre class="programlisting"> +<property name="openjpa.ConnectionUserName" value="user"/> +<property name="openjpa.ConnectionPassword" value="pass"/> +<property name="openjpa.ConnectionURL" value="jdbc:hsqldb:db-hypersonic"/> +<property name="openjpa.ConnectionDriverName" value="org.hsqldb.jdbcDriver"/> +<property name="openjpa.ConnectionFactoryProperties" + value="PrettyPrint=true, PrettyPrintLineLength=80, PrintParameters=true"/> +</pre> + </div></div><br class="example-break"> + </div> + <div class="section" id="ref_guide_dbsetup_dbcp"><div class="titlepage"><div><div><h3 class="title">1.3. + Configuring Apache Commons DBCP + </h3></div></div></div> + + <a class="indexterm" name="d5e9589"></a> + <p> +Additional Commons DBCP arguments can be provided in +<code class="literal">openjpa.connectionProperties</code>, such as: +</p><pre class="programlisting"> + MaxActive=10,MaxIdle=5,MinIdle=2,MaxWait=60000 +</pre><p> +Please visit the Commons DBCP website for the entire list of +<a class="ulink" href="http://commons.apache.org/dbcp/configuration.html"; target="_top">configuration options</a> and explanations. + </p> + </div> + </div> + + + + + + + + + + + + + + +</div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="ref_guide_audit.html">Prev</a> </td><td width="20%" align="center"><a accesskey="u" href="ref_guide.html">Up</a></td><td width="40%" align="right"> <a accesskey="n" href="ref_guide_dbsetup_thirdparty.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top">8. OpenJPA Audit </td><td width="20%" align="center"><a accesskey="h" href="manual.html">Home</a></td><td width="40%" align="right" valign="top"> 2. + Using a Third-Party DataSource + </td></tr></table></div></body></html> \ No newline at end of file
