svn commit: r682401 - in /db/derby/code/branches/10.4/java/client/org/apache/derby/client/am: Connection.java Cursor.java

[rh...@apache.org]

Author: rhillegas
Date: Mon Aug  4 07:25:34 2008
New Revision: 682401

URL: http://svn.apache.org/viewvc?rev=682401&view=rev
Log:
DERBY-3658: Port clarifying comment changes (652929) from trunk to 10.4 branch.

Modified:
    db/derby/code/branches/10.4/java/client/org/apache/derby/client/am/Connection.java
    db/derby/code/branches/10.4/java/client/org/apache/derby/client/am/Cursor.java

Modified: db/derby/code/branches/10.4/java/client/org/apache/derby/client/am/Connection.java
URL: http://svn.apache.org/viewvc/db/derby/code/branches/10.4/java/client/org/apache/derby/client/am/Connection.java?rev=682401&r1=682400&r2=682401&view=diff
==============================================================================
--- db/derby/code/branches/10.4/java/client/org/apache/derby/client/am/Connection.java (original)
+++ db/derby/code/branches/10.4/java/client/org/apache/derby/client/am/Connection.java Mon Aug  4 07:25:34 2008
@@ -983,6 +983,10 @@
 
     /**
      * Checks whether the server supports locators for large objects.
+     * Note that even though the server supports LOB locators, the database
+     * that is accessed through the server may not have the necessary stored
+     * procedures to support LOB locators (e.g., because the database is
+     * soft upgraded from an earlier version).
      *
      * @return {@code true} if LOB locators are supported.
      */

Modified: db/derby/code/branches/10.4/java/client/org/apache/derby/client/am/Cursor.java
URL: http://svn.apache.org/viewvc/db/derby/code/branches/10.4/java/client/org/apache/derby/client/am/Cursor.java?rev=682401&r1=682400&r2=682401&view=diff
==============================================================================
--- db/derby/code/branches/10.4/java/client/org/apache/derby/client/am/Cursor.java (original)
+++ db/derby/code/branches/10.4/java/client/org/apache/derby/client/am/Cursor.java Mon Aug  4 07:25:34 2008
@@ -676,7 +676,12 @@
     }
 
     /**
-     * Obtains the locator for the specified LOB column.
+     * Returns the locator for the specified LOB column, or {@link
+     * Lob#INVALID_LOCATOR} if the LOB was not sent as a locator. The server
+     * may send the LOB value instead of a locator if it is running an old
+     * version which doesn't support locators, or if the database it accesses
+     * is soft upgraded from a version that doesn't have the necessary
+     * stored procedures for locator support.
      * <p>
      * Note that this method cannot be invoked on a LOB column that is NULL.
      *