Added convenience method, Query.exists()

5 files changed, 31 insertions, 0 deletions

diff --git a/RELEASE-NOTES.txt b/RELEASE-NOTES.txt
index 02d3591..4e6c3c3 100644
--- a/RELEASE-NOTES.txt
+++ b/RELEASE-NOTES.txt
@@ -29,6 +29,7 @@ Carbonado change history
 - JDBCRepository supports char and Character property if column is char type of length 1.

 - JDBCRepository allows non-null column to be @Nullable if also @Independent.

 - Fixed bug in generating SQL with nullable primary key properties.

+- Added convenience method, Query.exists().

 

 1.1 to 1.1.2

 -------------------------------

diff --git a/src/main/java/com/amazon/carbonado/Query.java b/src/main/java/com/amazon/carbonado/Query.java
index e27e484..a729331 100644
--- a/src/main/java/com/amazon/carbonado/Query.java
+++ b/src/main/java/com/amazon/carbonado/Query.java
@@ -352,6 +352,16 @@ public interface Query<S extends Storable> {
     long count() throws FetchException;

 

     /**

+     * Returns true if any results are matched by this query.

+     *

+     * @return true if any matches

+     * @throws IllegalStateException if any blank parameters in this query

+     * @throws FetchException if storage layer throws an exception

+     * @since 1.2

+     */

+    boolean exists() throws FetchException;

+

+    /**

      * Print the native query to standard out, which is useful for performance

      * analysis. Not all repositories have a native query format. An example

      * native format is SQL.

diff --git a/src/main/java/com/amazon/carbonado/qe/EmptyQuery.java b/src/main/java/com/amazon/carbonado/qe/EmptyQuery.java
index 31d9dd3..1a970e0 100644
--- a/src/main/java/com/amazon/carbonado/qe/EmptyQuery.java
+++ b/src/main/java/com/amazon/carbonado/qe/EmptyQuery.java
@@ -107,6 +107,13 @@ public final class EmptyQuery<S extends Storable> extends AbstractQuery<S> {
     }

 

     /**

+     * Always returns false.

+     */

+    public boolean exists() {

+        return false;

+    }

+

+    /**

      * Always throws an IllegalStateException.

      */

     public Query<S> with(int value) {

diff --git a/src/main/java/com/amazon/carbonado/qe/StandardQuery.java b/src/main/java/com/amazon/carbonado/qe/StandardQuery.java
index ec9bf4e..2d7995e 100644
--- a/src/main/java/com/amazon/carbonado/qe/StandardQuery.java
+++ b/src/main/java/com/amazon/carbonado/qe/StandardQuery.java
@@ -294,6 +294,15 @@ public abstract class StandardQuery<S extends Storable> extends AbstractQuery<S>
         }

     }

 

+    public boolean exists() throws FetchException {

+        Cursor<S> cursor = fetch();

+        try {

+            return cursor.skipNext(1) > 0;

+        } finally {

+            cursor.close();

+        }

+    }

+

     public boolean printNative(Appendable app, int indentLevel) throws IOException {

         try {

             return executor().printNative(app, indentLevel, mValues);

diff --git a/src/main/java/com/amazon/carbonado/spi/WrappedQuery.java b/src/main/java/com/amazon/carbonado/spi/WrappedQuery.java
index ba3c013..bee05f0 100644
--- a/src/main/java/com/amazon/carbonado/spi/WrappedQuery.java
+++ b/src/main/java/com/amazon/carbonado/spi/WrappedQuery.java
@@ -167,6 +167,10 @@ public abstract class WrappedQuery<S extends Storable> implements Query<S> {
         return mQuery.count();

     }

 

+    public boolean exists() throws FetchException {

+        return mQuery.exists();

+    }

+

     public boolean printNative() {

         return mQuery.printNative();

     }