Author: kristwaa
Date: Thu May 10 05:58:39 2007
New Revision: 536856
URL: http://svn.apache.org/viewvc?view=rev&rev=536856
Log:
DERBY-2556: Replaced tabs with spaces and updated JavaDoc for method privExists.
Patch file: derby-2556-2a_whitespace-javadoc.diff
Modified:
db/derby/code/trunk/java/engine/org/apache/derby/impl/services/monitor/StorageFactoryService.java
Modified: db/derby/code/trunk/java/engine/org/apache/derby/impl/services/monitor/StorageFactoryService.java
URL: http://svn.apache.org/viewvc/db/derby/code/trunk/java/engine/org/apache/derby/impl/services/monitor/StorageFactoryService.java?view=diff&rev=536856&r1=536855&r2=536856
==============================================================================
--- db/derby/code/trunk/java/engine/org/apache/derby/impl/services/monitor/StorageFactoryService.java
(original)
+++ db/derby/code/trunk/java/engine/org/apache/derby/impl/services/monitor/StorageFactoryService.java
Thu May 10 05:58:39 2007
@@ -911,11 +911,18 @@
} // end of class DirectoryList
/**
- * Wrap File.exists() in a priv block to avoid Security exceptions
- * @param fileToCheck
- * @return true if file exists, false if it does not
- * @throws SecurityException
- */
+ * Wrap {@link File#exists} in a priv block to avoid security exceptions.
+ * <p>
+ * This method allows Derby to check if a file exists even when the higher
+ * layer code (application code) does not have the required privileges to
+ * do so. Note that the Derby code base must be granted the appropriate
+ * permissions (typically {@link java.io.FilePermission}).
+ *
+ * @param fileToCheck the pathname to check the existence of
+ * @return <code>true</code> if file exists, <code>false</code>
if not.
+ * @throws SecurityException if the required privileges to check if the file
+ * exists are missing
+ */
private boolean privExists(final File fileToCheck) throws SecurityException{
try {
|