db-derby-commits mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From kmars...@apache.org
Subject svn commit: r548465 - /db/derby/code/trunk/java/engine/org/apache/derby/io/StorageFile.java
Date Mon, 18 Jun 2007 19:52:09 GMT
Author: kmarsden
Date: Mon Jun 18 12:52:08 2007
New Revision: 548465

URL: http://svn.apache.org/viewvc?view=rev&rev=548465
Log:
update javadoc comments per Dan's comments in DERBY-700


Modified:
    db/derby/code/trunk/java/engine/org/apache/derby/io/StorageFile.java

Modified: db/derby/code/trunk/java/engine/org/apache/derby/io/StorageFile.java
URL: http://svn.apache.org/viewvc/db/derby/code/trunk/java/engine/org/apache/derby/io/StorageFile.java?view=diff&rev=548465&r1=548464&r2=548465
==============================================================================
--- db/derby/code/trunk/java/engine/org/apache/derby/io/StorageFile.java (original)
+++ db/derby/code/trunk/java/engine/org/apache/derby/io/StorageFile.java Mon Jun 18 12:52:08
2007
@@ -245,7 +245,9 @@
 
     /**
      * Get an exclusive lock with this name. This is used to ensure that two or more JVMs
do not open the same database
-     * at the same time.
+     * at the same time. ny StorageFile that has getExclusiveFileLock() called on it is not
intended to be read from or written to. It's sole purpose is to provide
+     * a locked entity to avoid multiple instances of Derby accessing the same database.
+     * getExclusiveFileLock() may delete or overwrite any existing file. 
      *
      * @return EXCLUSIVE_FILE_LOCK_NOT_AVAILABLE if the lock cannot be acquired because it
is already held.<br>
      *    EXCLUSIVE_FILE_LOCK if the lock was successfully acquired.<br>
@@ -255,7 +257,8 @@
 
 	/**
      * Release the resource associated with an earlier acquired exclusive lock
-     *
+     * releaseExclusiveFileLock() may delete the file
+
      * @see #getExclusiveFileLock
      */
 	public void releaseExclusiveFileLock();



Mime
View raw message