svn commit: r1768514 - in /db/jdo/trunk/api/src/java/javax/jdo: Extent.java Query.java

[an...@apache.org]

Author: andyj
Date: Mon Nov  7 14:02:27 2016
New Revision: 1768514

URL: http://svn.apache.org/viewvc?rev=1768514&view=rev
Log:
JDO-735 Javadocs for close() to match what DN has

Modified:
    db/jdo/trunk/api/src/java/javax/jdo/Extent.java
    db/jdo/trunk/api/src/java/javax/jdo/Query.java

Modified: db/jdo/trunk/api/src/java/javax/jdo/Extent.java
URL: http://svn.apache.org/viewvc/db/jdo/trunk/api/src/java/javax/jdo/Extent.java?rev=1768514&r1=1768513&r2=1768514&view=diff
==============================================================================
--- db/jdo/trunk/api/src/java/javax/jdo/Extent.java (original)
+++ db/jdo/trunk/api/src/java/javax/jdo/Extent.java Mon Nov  7 14:02:27 2016
@@ -83,7 +83,13 @@ public interface Extent<E> extends Itera
      * <code>iterator()</code> on this <code>Extent</code> instance.
      */    
     void close (Iterator<E> it);
-    
+
+    /**
+     * Don't use this method directly; use <code>closeAll()</code> instead. It is intended for use with try-with-resources.
+     * @throws Exception if this resource cannot be closed
+     */
+    void close() throws Exception;
+
     /** Get the fetch plan associated with this Extent.
      * @return the fetch plan
      * @since 2.0

Modified: db/jdo/trunk/api/src/java/javax/jdo/Query.java
URL: http://svn.apache.org/viewvc/db/jdo/trunk/api/src/java/javax/jdo/Query.java?rev=1768514&r1=1768513&r2=1768514&view=diff
==============================================================================
--- db/jdo/trunk/api/src/java/javax/jdo/Query.java (original)
+++ db/jdo/trunk/api/src/java/javax/jdo/Query.java Mon Nov  7 14:02:27 2016
@@ -374,6 +374,12 @@ public interface Query<T> extends AutoCl
     void closeAll();
 
     /**
+     * Don't use this method directly; use <code>closeAll()</code> instead. It is intended for use with try-with-resources.
+     * @throws Exception if this resource cannot be closed
+     */
+    void close() throws Exception;
+
+    /**
      * Set the grouping expressions, optionally including a "having"
      * clause. When grouping is specified, each result expression
      * must either be an expression contained in the grouping, or an