db-ojb-dev mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From arm...@apache.org
Subject svn commit: r374511 - /db/ojb/branches/OJB_1_0_RELEASE/src/doc/forrest/src/documentation/content/xdocs/docu/guides/repository.xml
Date Thu, 02 Feb 2006 21:32:10 GMT
Author: arminw
Date: Thu Feb  2 13:32:06 2006
New Revision: 374511

URL: http://svn.apache.org/viewcvs?rev=374511&view=rev
update "batch-mode" attribute section


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
+++ 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 @@
-                        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
+                        new obtained PB instance again.
+                    </p>
+                    <p>
+                        This setting can dramatically improve performance for mass insert/update/delete
+                        operations of same object type.
+                        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:
                         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/>
-                        This will be fixed and automatically handled by OJB till next major

To unsubscribe, e-mail: ojb-dev-unsubscribe@db.apache.org
For additional commands, e-mail: ojb-dev-help@db.apache.org

View raw message