You are viewing a plain text version of this content. The canonical link for it is here.
Posted to ojb-dev@db.apache.org by ar...@apache.org on 2006/02/02 22:32:10 UTC
svn commit: r374511 -
/db/ojb/branches/OJB_1_0_RELEASE/src/doc/forrest/src/documentation/content/xdocs/docu/guides/repository.xml
Author: arminw
Date: Thu Feb 2 13:32:06 2006
New Revision: 374511
URL: http://svn.apache.org/viewcvs?rev=374511&view=rev
Log:
update "batch-mode" attribute section
Modified:
db/ojb/branches/OJB_1_0_RELEASE/src/doc/forrest/src/documentation/content/xdocs/docu/guides/repository.xml
Modified: db/ojb/branches/OJB_1_0_RELEASE/src/doc/forrest/src/documentation/content/xdocs/docu/guides/repository.xml
URL: http://svn.apache.org/viewcvs/db/ojb/branches/OJB_1_0_RELEASE/src/doc/forrest/src/documentation/content/xdocs/docu/guides/repository.xml?rev=374511&r1=374510&r2=374511&view=diff
==============================================================================
--- db/ojb/branches/OJB_1_0_RELEASE/src/doc/forrest/src/documentation/content/xdocs/docu/guides/repository.xml (original)
+++ db/ojb/branches/OJB_1_0_RELEASE/src/doc/forrest/src/documentation/content/xdocs/docu/guides/repository.xml Thu Feb 2 13:32:06 2006
@@ -272,16 +272,37 @@
<p>
The
<em>batch-mode</em>
- attribute allow to enable JDBC connection batch support
+ attribute allow to enable JDBC batch statement support
(if supported by used database), 'true' value allows to enable per-session
batch mode, whereas 'false' prohibits it.
- <em>PB.serviceConnectionManager.setBatchMode(...)
- </em> method can be used
- to switch on/off batch modus, if batch-mode is enabled. On PB.close()
- OJB switches off batch modus, thus you have to do
- '...setBatchMode(true)' on each obtained PB instance again.
+ <br/>
+ To switch on/off batch modus at runtime use method
+ <code>PersistenceBroker.serviceConnectionManager.setBatchMode(...)
+ </code>.
+ <br/>
+ Mandatory: this setting have to be enabled, else <code>setBatchMode(true)</code>
+ will not have effect.
+ <br/>
+ On <code>PersistenceBroker.close()</code> call
+ OJB always switches off batch mode, thus you have to call
+ <code>ConnectionManager.setBatchMode(true)</code> on each
+ new obtained PB instance again.
+ </p>
+ <p>
+ This setting can dramatically improve performance for mass insert/update/delete
+ operations of same object type.
</p>
<note>
+ OJB 1.0.5 and later:
+ <br/>
+ The issue caused by <a href="site:sequence-manager/identity-columns">database identity columns</a>
+ on insert is fixed.
+ <br/>
+ The issue caused by classes using optimistic locking is fixed by temporarily diable
+ batch-mode for all objects with optimistic locking. A more sophisticated solution will
+ be provided in next major release.
+ <br/>
+ <br/>
OJB 1.0.4 and earlier:
<br/>
When using <a href="site:sequence-manager/identity-columns">database identity columns</a>
@@ -291,8 +312,6 @@
version check will always succeed for update operations when <em>batch-mode</em>
is enabled - take care!!.
<br/>
- <br/>
- This will be fixed and automatically handled by OJB till next major release.
</note>
<p>
The
---------------------------------------------------------------------
To unsubscribe, e-mail: ojb-dev-unsubscribe@db.apache.org
For additional commands, e-mail: ojb-dev-help@db.apache.org