svn commit: r532922 - /xml/xindice/trunk/java/src/org/apache/xindice/client/xmldb/embed/DatabaseImpl.java

[vg...@apache.org]

Author: vgritsenko
Date: Thu Apr 26 17:44:57 2007
New Revision: 532922

URL: http://svn.apache.org/viewvc?view=rev&rev=532922
Log:
javadoc

Modified:
    xml/xindice/trunk/java/src/org/apache/xindice/client/xmldb/embed/DatabaseImpl.java

Modified: xml/xindice/trunk/java/src/org/apache/xindice/client/xmldb/embed/DatabaseImpl.java
URL: http://svn.apache.org/viewvc/xml/xindice/trunk/java/src/org/apache/xindice/client/xmldb/embed/DatabaseImpl.java?view=diff&rev=532922&r1=532921&r2=532922
==============================================================================
--- xml/xindice/trunk/java/src/org/apache/xindice/client/xmldb/embed/DatabaseImpl.java (original)
+++ xml/xindice/trunk/java/src/org/apache/xindice/client/xmldb/embed/DatabaseImpl.java Thu Apr 26 17:44:57 2007
@@ -156,6 +156,9 @@
     /**
      * Get named database instance. If database is not loaded yet, load it.
      *
+     * @param dbName Database name
+     * @param uri Database URI
+     * @return Database instance
      * @throws XMLDBException if configuration for this database is not found,
      *                        or could not be read.
      */
@@ -186,7 +189,8 @@
         try {
             // Try configuration first
             managed = getProperty(PROP_XINDICE_MANAGED);
-        } catch (XMLDBException ignored) {
+        } catch (XMLDBException e) {
+            /* ignored */
         }
         if (managed == null) {
             // Fallback to system property
@@ -197,8 +201,12 @@
 
     /**
      * Get configuration for the named database
+     *
+     * @param dbName Database name
+     * @return Database configuration
+     * @throws XMLDBException if unable to load database configuration
      */
-    protected Configuration getConfiguration(String dbName) throws XMLDBException  {
+    protected Configuration getConfiguration(String dbName) throws XMLDBException {
         Configuration config = loadConfiguration();
 
         // Find database config with the given database name
@@ -223,7 +231,8 @@
             try {
                 // Try configuration first
                 home = getProperty(PROP_XINDICE_DB_HOME);
-            } catch (XMLDBException ignored) {
+            } catch (XMLDBException e) {
+                /* ignored */
             }
             if (home == null) {
                 // Fallback to system property
@@ -253,7 +262,8 @@
             }
             try {
                 config.setAttribute(Database.DBROOT, dbRoot);
-            } catch (ReadOnlyException ignore) {
+            } catch (ReadOnlyException e) {
+                /* ignored */
             }
         }
 
@@ -267,7 +277,8 @@
             try {
                 // Try configuration first
                 configFile = getProperty(PROP_XINDICE_CONFIGURATION);
-            } catch (XMLDBException ignored) {
+            } catch (XMLDBException e) {
+                /* ignored */
             }
             if (configFile == null) {
                 // Fallback to system property
@@ -339,7 +350,6 @@
      *    null if the database does not support authentication.
      * @return A <code>Collection</code> instance for the requested collection or
      *  null if the collection could not be found.
-     * @return The <code>Collection</code> instance
      * @exception XMLDBException with expected error codes.<br />
      *  <code>ErrorCodes.VENDOR_ERROR</code> for any vendor
      *  specific errors that occur.<br />