You are viewing a plain text version of this content. The canonical link for it is here.
Posted to derby-commits@db.apache.org by ka...@apache.org on 2008/05/03 00:13:05 UTC
svn commit: r652929 - in
/db/derby/code/trunk/java/client/org/apache/derby/client/am:
Connection.java Cursor.java
Author: kahatlen
Date: Fri May 2 15:13:03 2008
New Revision: 652929
URL: http://svn.apache.org/viewvc?rev=652929&view=rev
Log:
DERBY-3658: Clarified in some comments that the server may send LOB values instead of locators even if it supports locators.
Modified:
db/derby/code/trunk/java/client/org/apache/derby/client/am/Connection.java
db/derby/code/trunk/java/client/org/apache/derby/client/am/Cursor.java
Modified: db/derby/code/trunk/java/client/org/apache/derby/client/am/Connection.java
URL: http://svn.apache.org/viewvc/db/derby/code/trunk/java/client/org/apache/derby/client/am/Connection.java?rev=652929&r1=652928&r2=652929&view=diff
==============================================================================
--- db/derby/code/trunk/java/client/org/apache/derby/client/am/Connection.java (original)
+++ db/derby/code/trunk/java/client/org/apache/derby/client/am/Connection.java Fri May 2 15:13:03 2008
@@ -990,6 +990,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/trunk/java/client/org/apache/derby/client/am/Cursor.java
URL: http://svn.apache.org/viewvc/db/derby/code/trunk/java/client/org/apache/derby/client/am/Cursor.java?rev=652929&r1=652928&r2=652929&view=diff
==============================================================================
--- db/derby/code/trunk/java/client/org/apache/derby/client/am/Cursor.java (original)
+++ db/derby/code/trunk/java/client/org/apache/derby/client/am/Cursor.java Fri May 2 15:13:03 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.
*