google#972 - Fixed the UnitOfWork.begin() JavaDoc to reflect the actu…

…al implementation which is to throw an exception when an existing session is in progress.
jccarrillo · Jan 7, 2016 · ac9d913 · ac9d913
1 parent 2e620fa
commit ac9d913
Showing 1 changed file with 2 additions and 2 deletions.
diff --git a/extensions/persist/src/com/google/inject/persist/UnitOfWork.java b/extensions/persist/src/com/google/inject/persist/UnitOfWork.java
@@ -39,8 +39,8 @@ public interface UnitOfWork {
 
   /**
    * Starts a Unit Of Work. Underneath, causes a session to the data layer to be opened. If there
-   * is already one open, the invocation will do nothing. In this way, you can define arbitrary
-   * units-of-work that nest within one another safely.
+   * is already one opened, the invocation will throw an {@code IllegalStateException} to prevent
+   * unbalanced calls between end() and begin().
    *
    * Transaction semantics are not affected.
    */