svn commit: r568169 - /lenya/trunk/src/modules-core/usecase/java/src/org/apache/lenya/cms/usecase/AbstractUsecase.java

Author: andreas
Date: Tue Aug 21 08:38:50 2007
New Revision: 568169

URL: http://svn.apache.org/viewvc?rev=568169&view=rev
Log:
[minor change] added some javadocs

Modified:
    lenya/trunk/src/modules-core/usecase/java/src/org/apache/lenya/cms/usecase/AbstractUsecase.java

Modified: lenya/trunk/src/modules-core/usecase/java/src/org/apache/lenya/cms/usecase/AbstractUsecase.java
URL: http://svn.apache.org/viewvc/lenya/trunk/src/modules-core/usecase/java/src/org/apache/lenya/cms/usecase/AbstractUsecase.java?rev=568169&r1=568168&r2=568169&view=diff
==============================================================================
--- lenya/trunk/src/modules-core/usecase/java/src/org/apache/lenya/cms/usecase/AbstractUsecase.java (original)
+++ lenya/trunk/src/modules-core/usecase/java/src/org/apache/lenya/cms/usecase/AbstractUsecase.java Tue Aug 21 08:38:50 2007
@@ -757,6 +757,11 @@
 
     /**
      * <p>
+     * This method starts the transaction and locks all involved objects immediately.
+     * This way, all changes to the objects in the session occur after the locking,
+     * avoiding overriding changes of other sessions.
+     * </p>
+     * <p>
      * This method is locked via the class lock to avoid inter-usecase synchronization issues.
      * </p>
      * @see org.apache.lenya.cms.usecase.Usecase#lockInvolvedObjects()
@@ -773,6 +778,10 @@
         advanceState("lockInvolvedObjects");
     }
 
+    /**
+     * Start a transaction by using a new, modifiable session.
+     * @throws RepositoryException if an error occurs.
+     */
     protected void startTransaction() throws RepositoryException {
         if (this.commitEnabled) {
             setSession(RepositoryUtil.createSession(this.manager, getSession().getIdentity(), true));