summaryrefslogtreecommitdiff
path: root/apidocs/com/amazon/carbonado/Query.html
diff options
context:
space:
mode:
Diffstat (limited to 'apidocs/com/amazon/carbonado/Query.html')
-rw-r--r--apidocs/com/amazon/carbonado/Query.html1431
1 files changed, 1431 insertions, 0 deletions
diff --git a/apidocs/com/amazon/carbonado/Query.html b/apidocs/com/amazon/carbonado/Query.html
new file mode 100644
index 0000000..9b7d5af
--- /dev/null
+++ b/apidocs/com/amazon/carbonado/Query.html
@@ -0,0 +1,1431 @@
+<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
+<!-- NewPage -->
+<html lang="en">
+<head>
+<!-- Generated by javadoc (version 1.7.0_25) on Tue Dec 03 13:53:40 PST 2013 -->
+<meta http-equiv="Content-Type" content="text/html" charset="UTF-8">
+<title>Query (Carbonado 1.2.3 API)</title>
+<meta name="date" content="2013-12-03">
+<link rel="stylesheet" type="text/css" href="../../../stylesheet.css" title="Style">
+</head>
+<body>
+<script type="text/javascript"><!--
+ if (location.href.indexOf('is-external=true') == -1) {
+ parent.document.title="Query (Carbonado 1.2.3 API)";
+ }
+//-->
+</script>
+<noscript>
+<div>JavaScript is disabled on your browser.</div>
+</noscript>
+<!-- ========= START OF TOP NAVBAR ======= -->
+<div class="topNav"><a name="navbar_top">
+<!-- -->
+</a><a href="#skip-navbar_top" title="Skip navigation links"></a><a name="navbar_top_firstrow">
+<!-- -->
+</a>
+<ul class="navList" title="Navigation">
+<li><a href="../../../overview-summary.html">Overview</a></li>
+<li><a href="package-summary.html">Package</a></li>
+<li class="navBarCell1Rev">Class</li>
+<li><a href="class-use/Query.html">Use</a></li>
+<li><a href="package-tree.html">Tree</a></li>
+<li><a href="../../../deprecated-list.html">Deprecated</a></li>
+<li><a href="../../../index-files/index-1.html">Index</a></li>
+<li><a href="../../../help-doc.html">Help</a></li>
+</ul>
+</div>
+<div class="subNav">
+<ul class="navList">
+<li><a href="../../../com/amazon/carbonado/PrimaryKey.html" title="annotation in com.amazon.carbonado"><span class="strong">Prev Class</span></a></li>
+<li><a href="../../../com/amazon/carbonado/Query.Controller.html" title="interface in com.amazon.carbonado"><span class="strong">Next Class</span></a></li>
+</ul>
+<ul class="navList">
+<li><a href="../../../index.html?com/amazon/carbonado/Query.html" target="_top">Frames</a></li>
+<li><a href="Query.html" target="_top">No Frames</a></li>
+</ul>
+<ul class="navList" id="allclasses_navbar_top">
+<li><a href="../../../allclasses-noframe.html">All Classes</a></li>
+</ul>
+<div>
+<script type="text/javascript"><!--
+ allClassesLink = document.getElementById("allclasses_navbar_top");
+ if(window==top) {
+ allClassesLink.style.display = "block";
+ }
+ else {
+ allClassesLink.style.display = "none";
+ }
+ //-->
+</script>
+</div>
+<div>
+<ul class="subNavList">
+<li>Summary:&nbsp;</li>
+<li><a href="#nested_class_summary">Nested</a>&nbsp;|&nbsp;</li>
+<li>Field&nbsp;|&nbsp;</li>
+<li>Constr&nbsp;|&nbsp;</li>
+<li><a href="#method_summary">Method</a></li>
+</ul>
+<ul class="subNavList">
+<li>Detail:&nbsp;</li>
+<li>Field&nbsp;|&nbsp;</li>
+<li>Constr&nbsp;|&nbsp;</li>
+<li><a href="#method_detail">Method</a></li>
+</ul>
+</div>
+<a name="skip-navbar_top">
+<!-- -->
+</a></div>
+<!-- ========= END OF TOP NAVBAR ========= -->
+<!-- ======== START OF CLASS DATA ======== -->
+<div class="header">
+<div class="subTitle">com.amazon.carbonado</div>
+<h2 title="Interface Query" class="title">Interface Query&lt;S extends <a href="../../../com/amazon/carbonado/Storable.html" title="interface in com.amazon.carbonado">Storable</a>&gt;</h2>
+</div>
+<div class="contentContainer">
+<div class="description">
+<ul class="blockList">
+<li class="blockList">
+<dl>
+<dt>All Known Implementing Classes:</dt>
+<dd><a href="../../../com/amazon/carbonado/qe/AbstractQuery.html" title="class in com.amazon.carbonado.qe">AbstractQuery</a>, <a href="../../../com/amazon/carbonado/qe/EmptyQuery.html" title="class in com.amazon.carbonado.qe">EmptyQuery</a>, <a href="../../../com/amazon/carbonado/qe/StandardQuery.html" title="class in com.amazon.carbonado.qe">StandardQuery</a></dd>
+</dl>
+<hr>
+<br>
+<pre>public interface <span class="strong">Query&lt;S extends <a href="../../../com/amazon/carbonado/Storable.html" title="interface in com.amazon.carbonado">Storable</a>&gt;</span></pre>
+<div class="block">Supports complex retrieval and deletion of <a href="../../../com/amazon/carbonado/Storable.html" title="interface in com.amazon.carbonado"><code>Storable</code></a> objects.
+ Queries are immutable representations of an action – they do not
+ contain any Storable instances. The apparent mutators (with, et al) do not
+ actually modify the Query. Instead, they return another Query instance which
+ has the requested modification. To obtain an initial Query instance, call
+ one of the <a href="../../../com/amazon/carbonado/Storage.html" title="interface in com.amazon.carbonado"><code>Storage</code></a> query methods.
+
+ <p>Query objects are usually compiled and cached, and the same instance can
+ be re-used for future queries. This is possible because queries are
+ immutable and naturally thread-safe.</div>
+<dl><dt><span class="strong">Author:</span></dt>
+ <dd>Brian S O'Neill</dd></dl>
+</li>
+</ul>
+</div>
+<div class="summary">
+<ul class="blockList">
+<li class="blockList">
+<!-- ======== NESTED CLASS SUMMARY ======== -->
+<ul class="blockList">
+<li class="blockList"><a name="nested_class_summary">
+<!-- -->
+</a>
+<h3>Nested Class Summary</h3>
+<table class="overviewSummary" border="0" cellpadding="3" cellspacing="0" summary="Nested Class Summary table, listing nested classes, and an explanation">
+<caption><span>Nested Classes</span><span class="tabEnd">&nbsp;</span></caption>
+<tr>
+<th class="colFirst" scope="col">Modifier and Type</th>
+<th class="colLast" scope="col">Interface and Description</th>
+</tr>
+<tr class="altColor">
+<td class="colFirst"><code>static interface&nbsp;</code></td>
+<td class="colLast"><code><strong><a href="../../../com/amazon/carbonado/Query.Controller.html" title="interface in com.amazon.carbonado">Query.Controller</a></strong></code>
+<div class="block">Controller instance can be used to abort query operations.</div>
+</td>
+</tr>
+<tr class="rowColor">
+<td class="colFirst"><code>static class&nbsp;</code></td>
+<td class="colLast"><code><strong><a href="../../../com/amazon/carbonado/Query.Timeout.html" title="class in com.amazon.carbonado">Query.Timeout</a></strong></code>
+<div class="block">Timeout controller, for aborting long running queries.</div>
+</td>
+</tr>
+</table>
+</li>
+</ul>
+<!-- ========== METHOD SUMMARY =========== -->
+<ul class="blockList">
+<li class="blockList"><a name="method_summary">
+<!-- -->
+</a>
+<h3>Method Summary</h3>
+<table class="overviewSummary" border="0" cellpadding="3" cellspacing="0" summary="Method Summary table, listing methods, and an explanation">
+<caption><span>Methods</span><span class="tabEnd">&nbsp;</span></caption>
+<tr>
+<th class="colFirst" scope="col">Modifier and Type</th>
+<th class="colLast" scope="col">Method and Description</th>
+</tr>
+<tr class="altColor">
+<td class="colFirst"><code>&lt;T extends <a href="../../../com/amazon/carbonado/Query.html" title="type parameter in Query">S</a>&gt;&nbsp;<br><a href="../../../com/amazon/carbonado/Query.html" title="interface in com.amazon.carbonado">Query</a>&lt;<a href="../../../com/amazon/carbonado/Query.html" title="type parameter in Query">S</a>&gt;</code></td>
+<td class="colLast"><code><strong><a href="../../../com/amazon/carbonado/Query.html#after(T)">after</a></strong>(T&nbsp;start)</code>
+<div class="block">Returns a query which fetches results for this query after a given
+ starting point, which is useful for re-opening a cursor.</div>
+</td>
+</tr>
+<tr class="rowColor">
+<td class="colFirst"><code><a href="../../../com/amazon/carbonado/Query.html" title="interface in com.amazon.carbonado">Query</a>&lt;<a href="../../../com/amazon/carbonado/Query.html" title="type parameter in Query">S</a>&gt;</code></td>
+<td class="colLast"><code><strong><a href="../../../com/amazon/carbonado/Query.html#and(com.amazon.carbonado.filter.Filter)">and</a></strong>(<a href="../../../com/amazon/carbonado/filter/Filter.html" title="class in com.amazon.carbonado.filter">Filter</a>&lt;<a href="../../../com/amazon/carbonado/Query.html" title="type parameter in Query">S</a>&gt;&nbsp;filter)</code>
+<div class="block">Returns a new query which has another <a href="../../../com/amazon/carbonado/Storage.html#query(java.lang.String)"><code>filter</code></a> logically "and"ed to this, potentially reducing the amount of
+ results.</div>
+</td>
+</tr>
+<tr class="altColor">
+<td class="colFirst"><code><a href="../../../com/amazon/carbonado/Query.html" title="interface in com.amazon.carbonado">Query</a>&lt;<a href="../../../com/amazon/carbonado/Query.html" title="type parameter in Query">S</a>&gt;</code></td>
+<td class="colLast"><code><strong><a href="../../../com/amazon/carbonado/Query.html#and(java.lang.String)">and</a></strong>(java.lang.String&nbsp;filter)</code>
+<div class="block">Returns a new query which has another <a href="../../../com/amazon/carbonado/Storage.html#query(java.lang.String)"><code>filter</code></a> logically "and"ed to this, potentially reducing the amount of
+ results.</div>
+</td>
+</tr>
+<tr class="rowColor">
+<td class="colFirst"><code>long</code></td>
+<td class="colLast"><code><strong><a href="../../../com/amazon/carbonado/Query.html#count()">count</a></strong>()</code>
+<div class="block">Returns a count of all results matched by this query.</div>
+</td>
+</tr>
+<tr class="altColor">
+<td class="colFirst"><code>long</code></td>
+<td class="colLast"><code><strong><a href="../../../com/amazon/carbonado/Query.html#count(com.amazon.carbonado.Query.Controller)">count</a></strong>(<a href="../../../com/amazon/carbonado/Query.Controller.html" title="interface in com.amazon.carbonado">Query.Controller</a>&nbsp;controller)</code>
+<div class="block">Returns a count of all results matched by this query.</div>
+</td>
+</tr>
+<tr class="rowColor">
+<td class="colFirst"><code>void</code></td>
+<td class="colLast"><code><strong><a href="../../../com/amazon/carbonado/Query.html#deleteAll()">deleteAll</a></strong>()</code>
+<div class="block">Deletes zero or more matching objects.</div>
+</td>
+</tr>
+<tr class="altColor">
+<td class="colFirst"><code>void</code></td>
+<td class="colLast"><code><strong><a href="../../../com/amazon/carbonado/Query.html#deleteAll(com.amazon.carbonado.Query.Controller)">deleteAll</a></strong>(<a href="../../../com/amazon/carbonado/Query.Controller.html" title="interface in com.amazon.carbonado">Query.Controller</a>&nbsp;controller)</code>
+<div class="block">Deletes zero or more matching objects.</div>
+</td>
+</tr>
+<tr class="rowColor">
+<td class="colFirst"><code>void</code></td>
+<td class="colLast"><code><strong><a href="../../../com/amazon/carbonado/Query.html#deleteOne()">deleteOne</a></strong>()</code>
+<div class="block">Deletes one matching object.</div>
+</td>
+</tr>
+<tr class="altColor">
+<td class="colFirst"><code>void</code></td>
+<td class="colLast"><code><strong><a href="../../../com/amazon/carbonado/Query.html#deleteOne(com.amazon.carbonado.Query.Controller)">deleteOne</a></strong>(<a href="../../../com/amazon/carbonado/Query.Controller.html" title="interface in com.amazon.carbonado">Query.Controller</a>&nbsp;controller)</code>
+<div class="block">Deletes one matching object.</div>
+</td>
+</tr>
+<tr class="rowColor">
+<td class="colFirst"><code>boolean</code></td>
+<td class="colLast"><code><strong><a href="../../../com/amazon/carbonado/Query.html#equals(java.lang.Object)">equals</a></strong>(java.lang.Object&nbsp;obj)</code>&nbsp;</td>
+</tr>
+<tr class="altColor">
+<td class="colFirst"><code>boolean</code></td>
+<td class="colLast"><code><strong><a href="../../../com/amazon/carbonado/Query.html#exists()">exists</a></strong>()</code>
+<div class="block">Returns true if any results are matched by this query.</div>
+</td>
+</tr>
+<tr class="rowColor">
+<td class="colFirst"><code>boolean</code></td>
+<td class="colLast"><code><strong><a href="../../../com/amazon/carbonado/Query.html#exists(com.amazon.carbonado.Query.Controller)">exists</a></strong>(<a href="../../../com/amazon/carbonado/Query.Controller.html" title="interface in com.amazon.carbonado">Query.Controller</a>&nbsp;controller)</code>
+<div class="block">Returns true if any results are matched by this query.</div>
+</td>
+</tr>
+<tr class="altColor">
+<td class="colFirst"><code><a href="../../../com/amazon/carbonado/Cursor.html" title="interface in com.amazon.carbonado">Cursor</a>&lt;<a href="../../../com/amazon/carbonado/Query.html" title="type parameter in Query">S</a>&gt;</code></td>
+<td class="colLast"><code><strong><a href="../../../com/amazon/carbonado/Query.html#fetch()">fetch</a></strong>()</code>
+<div class="block">Fetches results for this query.</div>
+</td>
+</tr>
+<tr class="rowColor">
+<td class="colFirst"><code><a href="../../../com/amazon/carbonado/Cursor.html" title="interface in com.amazon.carbonado">Cursor</a>&lt;<a href="../../../com/amazon/carbonado/Query.html" title="type parameter in Query">S</a>&gt;</code></td>
+<td class="colLast"><code><strong><a href="../../../com/amazon/carbonado/Query.html#fetch(com.amazon.carbonado.Query.Controller)">fetch</a></strong>(<a href="../../../com/amazon/carbonado/Query.Controller.html" title="interface in com.amazon.carbonado">Query.Controller</a>&nbsp;controller)</code>
+<div class="block">Fetches results for this query.</div>
+</td>
+</tr>
+<tr class="altColor">
+<td class="colFirst"><code>&lt;T extends <a href="../../../com/amazon/carbonado/Query.html" title="type parameter in Query">S</a>&gt;&nbsp;<br><a href="../../../com/amazon/carbonado/Cursor.html" title="interface in com.amazon.carbonado">Cursor</a>&lt;<a href="../../../com/amazon/carbonado/Query.html" title="type parameter in Query">S</a>&gt;</code></td>
+<td class="colLast"><code><strong><a href="../../../com/amazon/carbonado/Query.html#fetchAfter(T)">fetchAfter</a></strong>(T&nbsp;start)</code>
+<div class="block">Fetches results for this query after a given starting point, which is
+ useful for re-opening a cursor.</div>
+</td>
+</tr>
+<tr class="rowColor">
+<td class="colFirst"><code>&lt;T extends <a href="../../../com/amazon/carbonado/Query.html" title="type parameter in Query">S</a>&gt;&nbsp;<br><a href="../../../com/amazon/carbonado/Cursor.html" title="interface in com.amazon.carbonado">Cursor</a>&lt;<a href="../../../com/amazon/carbonado/Query.html" title="type parameter in Query">S</a>&gt;</code></td>
+<td class="colLast"><code><strong><a href="../../../com/amazon/carbonado/Query.html#fetchAfter(T, com.amazon.carbonado.Query.Controller)">fetchAfter</a></strong>(T&nbsp;start,
+ <a href="../../../com/amazon/carbonado/Query.Controller.html" title="interface in com.amazon.carbonado">Query.Controller</a>&nbsp;controller)</code>
+<div class="block">Fetches results for this query after a given starting point, which is
+ useful for re-opening a cursor.</div>
+</td>
+</tr>
+<tr class="altColor">
+<td class="colFirst"><code><a href="../../../com/amazon/carbonado/Cursor.html" title="interface in com.amazon.carbonado">Cursor</a>&lt;<a href="../../../com/amazon/carbonado/Query.html" title="type parameter in Query">S</a>&gt;</code></td>
+<td class="colLast"><code><strong><a href="../../../com/amazon/carbonado/Query.html#fetchSlice(long, java.lang.Long)">fetchSlice</a></strong>(long&nbsp;from,
+ java.lang.Long&nbsp;to)</code>
+<div class="block">Fetches a slice of results for this query, as defined by a numerical
+ range.</div>
+</td>
+</tr>
+<tr class="rowColor">
+<td class="colFirst"><code><a href="../../../com/amazon/carbonado/Cursor.html" title="interface in com.amazon.carbonado">Cursor</a>&lt;<a href="../../../com/amazon/carbonado/Query.html" title="type parameter in Query">S</a>&gt;</code></td>
+<td class="colLast"><code><strong><a href="../../../com/amazon/carbonado/Query.html#fetchSlice(long, java.lang.Long, com.amazon.carbonado.Query.Controller)">fetchSlice</a></strong>(long&nbsp;from,
+ java.lang.Long&nbsp;to,
+ <a href="../../../com/amazon/carbonado/Query.Controller.html" title="interface in com.amazon.carbonado">Query.Controller</a>&nbsp;controller)</code>
+<div class="block">Fetches a slice of results for this query, as defined by a numerical
+ range.</div>
+</td>
+</tr>
+<tr class="altColor">
+<td class="colFirst"><code>int</code></td>
+<td class="colLast"><code><strong><a href="../../../com/amazon/carbonado/Query.html#getBlankParameterCount()">getBlankParameterCount</a></strong>()</code>
+<div class="block">Returns the amount of blank parameters that need to be filled in.</div>
+</td>
+</tr>
+<tr class="rowColor">
+<td class="colFirst"><code><a href="../../../com/amazon/carbonado/filter/Filter.html" title="class in com.amazon.carbonado.filter">Filter</a>&lt;<a href="../../../com/amazon/carbonado/Query.html" title="type parameter in Query">S</a>&gt;</code></td>
+<td class="colLast"><code><strong><a href="../../../com/amazon/carbonado/Query.html#getFilter()">getFilter</a></strong>()</code>
+<div class="block">Returns the query's filter.</div>
+</td>
+</tr>
+<tr class="altColor">
+<td class="colFirst"><code><a href="../../../com/amazon/carbonado/filter/FilterValues.html" title="class in com.amazon.carbonado.filter">FilterValues</a>&lt;<a href="../../../com/amazon/carbonado/Query.html" title="type parameter in Query">S</a>&gt;</code></td>
+<td class="colLast"><code><strong><a href="../../../com/amazon/carbonado/Query.html#getFilterValues()">getFilterValues</a></strong>()</code>
+<div class="block">Returns the query's filter values, which is null if filter has no
+ parameters.</div>
+</td>
+</tr>
+<tr class="rowColor">
+<td class="colFirst"><code>java.lang.Class&lt;<a href="../../../com/amazon/carbonado/Query.html" title="type parameter in Query">S</a>&gt;</code></td>
+<td class="colLast"><code><strong><a href="../../../com/amazon/carbonado/Query.html#getStorableType()">getStorableType</a></strong>()</code>
+<div class="block">Returns the specific type of Storable managed by this object.</div>
+</td>
+</tr>
+<tr class="altColor">
+<td class="colFirst"><code>int</code></td>
+<td class="colLast"><code><strong><a href="../../../com/amazon/carbonado/Query.html#hashCode()">hashCode</a></strong>()</code>&nbsp;</td>
+</tr>
+<tr class="rowColor">
+<td class="colFirst"><code><a href="../../../com/amazon/carbonado/Query.html" title="type parameter in Query">S</a></code></td>
+<td class="colLast"><code><strong><a href="../../../com/amazon/carbonado/Query.html#loadOne()">loadOne</a></strong>()</code>
+<div class="block">Attempts to load exactly one matching object.</div>
+</td>
+</tr>
+<tr class="altColor">
+<td class="colFirst"><code><a href="../../../com/amazon/carbonado/Query.html" title="type parameter in Query">S</a></code></td>
+<td class="colLast"><code><strong><a href="../../../com/amazon/carbonado/Query.html#loadOne(com.amazon.carbonado.Query.Controller)">loadOne</a></strong>(<a href="../../../com/amazon/carbonado/Query.Controller.html" title="interface in com.amazon.carbonado">Query.Controller</a>&nbsp;controller)</code>
+<div class="block">Attempts to load exactly one matching object.</div>
+</td>
+</tr>
+<tr class="rowColor">
+<td class="colFirst"><code><a href="../../../com/amazon/carbonado/Query.html" title="interface in com.amazon.carbonado">Query</a>&lt;<a href="../../../com/amazon/carbonado/Query.html" title="type parameter in Query">S</a>&gt;</code></td>
+<td class="colLast"><code><strong><a href="../../../com/amazon/carbonado/Query.html#not()">not</a></strong>()</code>
+<div class="block">Returns a new query which produces all the results not supplied in this
+ query.</div>
+</td>
+</tr>
+<tr class="altColor">
+<td class="colFirst"><code><a href="../../../com/amazon/carbonado/Query.html" title="interface in com.amazon.carbonado">Query</a>&lt;<a href="../../../com/amazon/carbonado/Query.html" title="type parameter in Query">S</a>&gt;</code></td>
+<td class="colLast"><code><strong><a href="../../../com/amazon/carbonado/Query.html#or(com.amazon.carbonado.filter.Filter)">or</a></strong>(<a href="../../../com/amazon/carbonado/filter/Filter.html" title="class in com.amazon.carbonado.filter">Filter</a>&lt;<a href="../../../com/amazon/carbonado/Query.html" title="type parameter in Query">S</a>&gt;&nbsp;filter)</code>
+<div class="block">Returns a new query which has another <a href="../../../com/amazon/carbonado/Storage.html#query(java.lang.String)"><code>filter</code></a> logically "or"ed to this, potentially increasing the amount of
+ results.</div>
+</td>
+</tr>
+<tr class="rowColor">
+<td class="colFirst"><code><a href="../../../com/amazon/carbonado/Query.html" title="interface in com.amazon.carbonado">Query</a>&lt;<a href="../../../com/amazon/carbonado/Query.html" title="type parameter in Query">S</a>&gt;</code></td>
+<td class="colLast"><code><strong><a href="../../../com/amazon/carbonado/Query.html#or(java.lang.String)">or</a></strong>(java.lang.String&nbsp;filter)</code>
+<div class="block">Returns a new query which has another <a href="../../../com/amazon/carbonado/Storage.html#query(java.lang.String)"><code>filter</code></a> logically "or"ed to this, potentially increasing the amount of
+ results.</div>
+</td>
+</tr>
+<tr class="altColor">
+<td class="colFirst"><code><a href="../../../com/amazon/carbonado/Query.html" title="interface in com.amazon.carbonado">Query</a>&lt;<a href="../../../com/amazon/carbonado/Query.html" title="type parameter in Query">S</a>&gt;</code></td>
+<td class="colLast"><code><strong><a href="../../../com/amazon/carbonado/Query.html#orderBy(java.lang.String...)">orderBy</a></strong>(java.lang.String...&nbsp;properties)</code>
+<div class="block">Returns a copy of this query ordered by specific property values.</div>
+</td>
+</tr>
+<tr class="rowColor">
+<td class="colFirst"><code><a href="../../../com/amazon/carbonado/Query.html" title="interface in com.amazon.carbonado">Query</a>&lt;<a href="../../../com/amazon/carbonado/Query.html" title="type parameter in Query">S</a>&gt;</code></td>
+<td class="colLast"><code><strong><a href="../../../com/amazon/carbonado/Query.html#orderBy(java.lang.String)">orderBy</a></strong>(java.lang.String&nbsp;property)</code>
+<div class="block">Returns a copy of this query ordered by a specific property value.</div>
+</td>
+</tr>
+<tr class="altColor">
+<td class="colFirst"><code>boolean</code></td>
+<td class="colLast"><code><strong><a href="../../../com/amazon/carbonado/Query.html#printNative()">printNative</a></strong>()</code>
+<div class="block">Print the native query to standard out, which is useful for performance
+ analysis.</div>
+</td>
+</tr>
+<tr class="rowColor">
+<td class="colFirst"><code>boolean</code></td>
+<td class="colLast"><code><strong><a href="../../../com/amazon/carbonado/Query.html#printNative(java.lang.Appendable)">printNative</a></strong>(java.lang.Appendable&nbsp;app)</code>
+<div class="block">Prints the native query to any appendable, which is useful for
+ performance analysis.</div>
+</td>
+</tr>
+<tr class="altColor">
+<td class="colFirst"><code>boolean</code></td>
+<td class="colLast"><code><strong><a href="../../../com/amazon/carbonado/Query.html#printNative(java.lang.Appendable, int)">printNative</a></strong>(java.lang.Appendable&nbsp;app,
+ int&nbsp;indentLevel)</code>
+<div class="block">Prints the native query to any appendable, which is useful for
+ performance analysis.</div>
+</td>
+</tr>
+<tr class="rowColor">
+<td class="colFirst"><code>boolean</code></td>
+<td class="colLast"><code><strong><a href="../../../com/amazon/carbonado/Query.html#printPlan()">printPlan</a></strong>()</code>
+<div class="block">Prints the query excecution plan to standard out, which is useful for
+ performance analysis.</div>
+</td>
+</tr>
+<tr class="altColor">
+<td class="colFirst"><code>boolean</code></td>
+<td class="colLast"><code><strong><a href="../../../com/amazon/carbonado/Query.html#printPlan(java.lang.Appendable)">printPlan</a></strong>(java.lang.Appendable&nbsp;app)</code>
+<div class="block">Prints the query excecution plan to any appendable, which is useful for
+ performance analysis.</div>
+</td>
+</tr>
+<tr class="rowColor">
+<td class="colFirst"><code>boolean</code></td>
+<td class="colLast"><code><strong><a href="../../../com/amazon/carbonado/Query.html#printPlan(java.lang.Appendable, int)">printPlan</a></strong>(java.lang.Appendable&nbsp;app,
+ int&nbsp;indentLevel)</code>
+<div class="block">Prints the query excecution plan to any appendable, which is useful for
+ performance analysis.</div>
+</td>
+</tr>
+<tr class="altColor">
+<td class="colFirst"><code>java.lang.String</code></td>
+<td class="colLast"><code><strong><a href="../../../com/amazon/carbonado/Query.html#toString()">toString</a></strong>()</code>
+<div class="block">Returns a description of the query filter and any other arguments.</div>
+</td>
+</tr>
+<tr class="rowColor">
+<td class="colFirst"><code>boolean</code></td>
+<td class="colLast"><code><strong><a href="../../../com/amazon/carbonado/Query.html#tryDeleteOne()">tryDeleteOne</a></strong>()</code>
+<div class="block">Deletes zero or one matching objects.</div>
+</td>
+</tr>
+<tr class="altColor">
+<td class="colFirst"><code>boolean</code></td>
+<td class="colLast"><code><strong><a href="../../../com/amazon/carbonado/Query.html#tryDeleteOne(com.amazon.carbonado.Query.Controller)">tryDeleteOne</a></strong>(<a href="../../../com/amazon/carbonado/Query.Controller.html" title="interface in com.amazon.carbonado">Query.Controller</a>&nbsp;controller)</code>
+<div class="block">Deletes zero or one matching objects.</div>
+</td>
+</tr>
+<tr class="rowColor">
+<td class="colFirst"><code><a href="../../../com/amazon/carbonado/Query.html" title="type parameter in Query">S</a></code></td>
+<td class="colLast"><code><strong><a href="../../../com/amazon/carbonado/Query.html#tryLoadOne()">tryLoadOne</a></strong>()</code>
+<div class="block">Tries to load one record, but returns null if nothing was found.</div>
+</td>
+</tr>
+<tr class="altColor">
+<td class="colFirst"><code><a href="../../../com/amazon/carbonado/Query.html" title="type parameter in Query">S</a></code></td>
+<td class="colLast"><code><strong><a href="../../../com/amazon/carbonado/Query.html#tryLoadOne(com.amazon.carbonado.Query.Controller)">tryLoadOne</a></strong>(<a href="../../../com/amazon/carbonado/Query.Controller.html" title="interface in com.amazon.carbonado">Query.Controller</a>&nbsp;controller)</code>
+<div class="block">Tries to load one record, but returns null if nothing was found.</div>
+</td>
+</tr>
+<tr class="rowColor">
+<td class="colFirst"><code><a href="../../../com/amazon/carbonado/Query.html" title="interface in com.amazon.carbonado">Query</a>&lt;<a href="../../../com/amazon/carbonado/Query.html" title="type parameter in Query">S</a>&gt;</code></td>
+<td class="colLast"><code><strong><a href="../../../com/amazon/carbonado/Query.html#with(boolean)">with</a></strong>(boolean&nbsp;value)</code>
+<div class="block">Returns a copy of this Query with the next blank parameter filled in.</div>
+</td>
+</tr>
+<tr class="altColor">
+<td class="colFirst"><code><a href="../../../com/amazon/carbonado/Query.html" title="interface in com.amazon.carbonado">Query</a>&lt;<a href="../../../com/amazon/carbonado/Query.html" title="type parameter in Query">S</a>&gt;</code></td>
+<td class="colLast"><code><strong><a href="../../../com/amazon/carbonado/Query.html#with(byte)">with</a></strong>(byte&nbsp;value)</code>
+<div class="block">Returns a copy of this Query with the next blank parameter filled in.</div>
+</td>
+</tr>
+<tr class="rowColor">
+<td class="colFirst"><code><a href="../../../com/amazon/carbonado/Query.html" title="interface in com.amazon.carbonado">Query</a>&lt;<a href="../../../com/amazon/carbonado/Query.html" title="type parameter in Query">S</a>&gt;</code></td>
+<td class="colLast"><code><strong><a href="../../../com/amazon/carbonado/Query.html#with(char)">with</a></strong>(char&nbsp;value)</code>
+<div class="block">Returns a copy of this Query with the next blank parameter filled in.</div>
+</td>
+</tr>
+<tr class="altColor">
+<td class="colFirst"><code><a href="../../../com/amazon/carbonado/Query.html" title="interface in com.amazon.carbonado">Query</a>&lt;<a href="../../../com/amazon/carbonado/Query.html" title="type parameter in Query">S</a>&gt;</code></td>
+<td class="colLast"><code><strong><a href="../../../com/amazon/carbonado/Query.html#with(double)">with</a></strong>(double&nbsp;value)</code>
+<div class="block">Returns a copy of this Query with the next blank parameter filled in.</div>
+</td>
+</tr>
+<tr class="rowColor">
+<td class="colFirst"><code><a href="../../../com/amazon/carbonado/Query.html" title="interface in com.amazon.carbonado">Query</a>&lt;<a href="../../../com/amazon/carbonado/Query.html" title="type parameter in Query">S</a>&gt;</code></td>
+<td class="colLast"><code><strong><a href="../../../com/amazon/carbonado/Query.html#with(float)">with</a></strong>(float&nbsp;value)</code>
+<div class="block">Returns a copy of this Query with the next blank parameter filled in.</div>
+</td>
+</tr>
+<tr class="altColor">
+<td class="colFirst"><code><a href="../../../com/amazon/carbonado/Query.html" title="interface in com.amazon.carbonado">Query</a>&lt;<a href="../../../com/amazon/carbonado/Query.html" title="type parameter in Query">S</a>&gt;</code></td>
+<td class="colLast"><code><strong><a href="../../../com/amazon/carbonado/Query.html#with(int)">with</a></strong>(int&nbsp;value)</code>
+<div class="block">Returns a copy of this Query with the next blank parameter filled in.</div>
+</td>
+</tr>
+<tr class="rowColor">
+<td class="colFirst"><code><a href="../../../com/amazon/carbonado/Query.html" title="interface in com.amazon.carbonado">Query</a>&lt;<a href="../../../com/amazon/carbonado/Query.html" title="type parameter in Query">S</a>&gt;</code></td>
+<td class="colLast"><code><strong><a href="../../../com/amazon/carbonado/Query.html#with(long)">with</a></strong>(long&nbsp;value)</code>
+<div class="block">Returns a copy of this Query with the next blank parameter filled in.</div>
+</td>
+</tr>
+<tr class="altColor">
+<td class="colFirst"><code><a href="../../../com/amazon/carbonado/Query.html" title="interface in com.amazon.carbonado">Query</a>&lt;<a href="../../../com/amazon/carbonado/Query.html" title="type parameter in Query">S</a>&gt;</code></td>
+<td class="colLast"><code><strong><a href="../../../com/amazon/carbonado/Query.html#with(java.lang.Object)">with</a></strong>(java.lang.Object&nbsp;value)</code>
+<div class="block">Returns a copy of this Query with the next blank parameter filled in.</div>
+</td>
+</tr>
+<tr class="rowColor">
+<td class="colFirst"><code><a href="../../../com/amazon/carbonado/Query.html" title="interface in com.amazon.carbonado">Query</a>&lt;<a href="../../../com/amazon/carbonado/Query.html" title="type parameter in Query">S</a>&gt;</code></td>
+<td class="colLast"><code><strong><a href="../../../com/amazon/carbonado/Query.html#with(short)">with</a></strong>(short&nbsp;value)</code>
+<div class="block">Returns a copy of this Query with the next blank parameter filled in.</div>
+</td>
+</tr>
+<tr class="altColor">
+<td class="colFirst"><code><a href="../../../com/amazon/carbonado/Query.html" title="interface in com.amazon.carbonado">Query</a>&lt;<a href="../../../com/amazon/carbonado/Query.html" title="type parameter in Query">S</a>&gt;</code></td>
+<td class="colLast"><code><strong><a href="../../../com/amazon/carbonado/Query.html#withValues(java.lang.Object...)">withValues</a></strong>(java.lang.Object...&nbsp;values)</code>
+<div class="block">Returns a copy of this Query with the next blank parameters filled in.</div>
+</td>
+</tr>
+</table>
+</li>
+</ul>
+</li>
+</ul>
+</div>
+<div class="details">
+<ul class="blockList">
+<li class="blockList">
+<!-- ============ METHOD DETAIL ========== -->
+<ul class="blockList">
+<li class="blockList"><a name="method_detail">
+<!-- -->
+</a>
+<h3>Method Detail</h3>
+<a name="getStorableType()">
+<!-- -->
+</a>
+<ul class="blockList">
+<li class="blockList">
+<h4>getStorableType</h4>
+<pre>java.lang.Class&lt;<a href="../../../com/amazon/carbonado/Query.html" title="type parameter in Query">S</a>&gt;&nbsp;getStorableType()</pre>
+<div class="block">Returns the specific type of Storable managed by this object.</div>
+</li>
+</ul>
+<a name="getFilter()">
+<!-- -->
+</a>
+<ul class="blockList">
+<li class="blockList">
+<h4>getFilter</h4>
+<pre><a href="../../../com/amazon/carbonado/filter/Filter.html" title="class in com.amazon.carbonado.filter">Filter</a>&lt;<a href="../../../com/amazon/carbonado/Query.html" title="type parameter in Query">S</a>&gt;&nbsp;getFilter()</pre>
+<div class="block">Returns the query's filter.</div>
+</li>
+</ul>
+<a name="getFilterValues()">
+<!-- -->
+</a>
+<ul class="blockList">
+<li class="blockList">
+<h4>getFilterValues</h4>
+<pre><a href="../../../com/amazon/carbonado/filter/FilterValues.html" title="class in com.amazon.carbonado.filter">FilterValues</a>&lt;<a href="../../../com/amazon/carbonado/Query.html" title="type parameter in Query">S</a>&gt;&nbsp;getFilterValues()</pre>
+<div class="block">Returns the query's filter values, which is null if filter has no
+ parameters.</div>
+</li>
+</ul>
+<a name="getBlankParameterCount()">
+<!-- -->
+</a>
+<ul class="blockList">
+<li class="blockList">
+<h4>getBlankParameterCount</h4>
+<pre>int&nbsp;getBlankParameterCount()</pre>
+<div class="block">Returns the amount of blank parameters that need to be filled in. If
+ zero, then this query is ready to be used.</div>
+</li>
+</ul>
+<a name="with(int)">
+<!-- -->
+</a>
+<ul class="blockList">
+<li class="blockList">
+<h4>with</h4>
+<pre><a href="../../../com/amazon/carbonado/Query.html" title="interface in com.amazon.carbonado">Query</a>&lt;<a href="../../../com/amazon/carbonado/Query.html" title="type parameter in Query">S</a>&gt;&nbsp;with(int&nbsp;value)</pre>
+<div class="block">Returns a copy of this Query with the next blank parameter filled in.</div>
+<dl><dt><span class="strong">Parameters:</span></dt><dd><code>value</code> - parameter value to fill in</dd>
+<dt><span class="strong">Throws:</span></dt>
+<dd><code>java.lang.IllegalStateException</code> - if no blank parameters</dd>
+<dd><code>java.lang.IllegalArgumentException</code> - if type doesn't match</dd></dl>
+</li>
+</ul>
+<a name="with(long)">
+<!-- -->
+</a>
+<ul class="blockList">
+<li class="blockList">
+<h4>with</h4>
+<pre><a href="../../../com/amazon/carbonado/Query.html" title="interface in com.amazon.carbonado">Query</a>&lt;<a href="../../../com/amazon/carbonado/Query.html" title="type parameter in Query">S</a>&gt;&nbsp;with(long&nbsp;value)</pre>
+<div class="block">Returns a copy of this Query with the next blank parameter filled in.</div>
+<dl><dt><span class="strong">Parameters:</span></dt><dd><code>value</code> - parameter value to fill in</dd>
+<dt><span class="strong">Throws:</span></dt>
+<dd><code>java.lang.IllegalStateException</code> - if no blank parameters</dd>
+<dd><code>java.lang.IllegalArgumentException</code> - if type doesn't match</dd></dl>
+</li>
+</ul>
+<a name="with(float)">
+<!-- -->
+</a>
+<ul class="blockList">
+<li class="blockList">
+<h4>with</h4>
+<pre><a href="../../../com/amazon/carbonado/Query.html" title="interface in com.amazon.carbonado">Query</a>&lt;<a href="../../../com/amazon/carbonado/Query.html" title="type parameter in Query">S</a>&gt;&nbsp;with(float&nbsp;value)</pre>
+<div class="block">Returns a copy of this Query with the next blank parameter filled in.</div>
+<dl><dt><span class="strong">Parameters:</span></dt><dd><code>value</code> - parameter value to fill in</dd>
+<dt><span class="strong">Throws:</span></dt>
+<dd><code>java.lang.IllegalStateException</code> - if no blank parameters</dd>
+<dd><code>java.lang.IllegalArgumentException</code> - if type doesn't match</dd></dl>
+</li>
+</ul>
+<a name="with(double)">
+<!-- -->
+</a>
+<ul class="blockList">
+<li class="blockList">
+<h4>with</h4>
+<pre><a href="../../../com/amazon/carbonado/Query.html" title="interface in com.amazon.carbonado">Query</a>&lt;<a href="../../../com/amazon/carbonado/Query.html" title="type parameter in Query">S</a>&gt;&nbsp;with(double&nbsp;value)</pre>
+<div class="block">Returns a copy of this Query with the next blank parameter filled in.</div>
+<dl><dt><span class="strong">Parameters:</span></dt><dd><code>value</code> - parameter value to fill in</dd>
+<dt><span class="strong">Throws:</span></dt>
+<dd><code>java.lang.IllegalStateException</code> - if no blank parameters</dd>
+<dd><code>java.lang.IllegalArgumentException</code> - if type doesn't match</dd></dl>
+</li>
+</ul>
+<a name="with(boolean)">
+<!-- -->
+</a>
+<ul class="blockList">
+<li class="blockList">
+<h4>with</h4>
+<pre><a href="../../../com/amazon/carbonado/Query.html" title="interface in com.amazon.carbonado">Query</a>&lt;<a href="../../../com/amazon/carbonado/Query.html" title="type parameter in Query">S</a>&gt;&nbsp;with(boolean&nbsp;value)</pre>
+<div class="block">Returns a copy of this Query with the next blank parameter filled in.</div>
+<dl><dt><span class="strong">Parameters:</span></dt><dd><code>value</code> - parameter value to fill in</dd>
+<dt><span class="strong">Throws:</span></dt>
+<dd><code>java.lang.IllegalStateException</code> - if no blank parameters</dd>
+<dd><code>java.lang.IllegalArgumentException</code> - if type doesn't match</dd></dl>
+</li>
+</ul>
+<a name="with(char)">
+<!-- -->
+</a>
+<ul class="blockList">
+<li class="blockList">
+<h4>with</h4>
+<pre><a href="../../../com/amazon/carbonado/Query.html" title="interface in com.amazon.carbonado">Query</a>&lt;<a href="../../../com/amazon/carbonado/Query.html" title="type parameter in Query">S</a>&gt;&nbsp;with(char&nbsp;value)</pre>
+<div class="block">Returns a copy of this Query with the next blank parameter filled in.</div>
+<dl><dt><span class="strong">Parameters:</span></dt><dd><code>value</code> - parameter value to fill in</dd>
+<dt><span class="strong">Throws:</span></dt>
+<dd><code>java.lang.IllegalStateException</code> - if no blank parameters</dd>
+<dd><code>java.lang.IllegalArgumentException</code> - if type doesn't match</dd></dl>
+</li>
+</ul>
+<a name="with(byte)">
+<!-- -->
+</a>
+<ul class="blockList">
+<li class="blockList">
+<h4>with</h4>
+<pre><a href="../../../com/amazon/carbonado/Query.html" title="interface in com.amazon.carbonado">Query</a>&lt;<a href="../../../com/amazon/carbonado/Query.html" title="type parameter in Query">S</a>&gt;&nbsp;with(byte&nbsp;value)</pre>
+<div class="block">Returns a copy of this Query with the next blank parameter filled in.</div>
+<dl><dt><span class="strong">Parameters:</span></dt><dd><code>value</code> - parameter value to fill in</dd>
+<dt><span class="strong">Throws:</span></dt>
+<dd><code>java.lang.IllegalStateException</code> - if no blank parameters</dd>
+<dd><code>java.lang.IllegalArgumentException</code> - if type doesn't match</dd></dl>
+</li>
+</ul>
+<a name="with(short)">
+<!-- -->
+</a>
+<ul class="blockList">
+<li class="blockList">
+<h4>with</h4>
+<pre><a href="../../../com/amazon/carbonado/Query.html" title="interface in com.amazon.carbonado">Query</a>&lt;<a href="../../../com/amazon/carbonado/Query.html" title="type parameter in Query">S</a>&gt;&nbsp;with(short&nbsp;value)</pre>
+<div class="block">Returns a copy of this Query with the next blank parameter filled in.</div>
+<dl><dt><span class="strong">Parameters:</span></dt><dd><code>value</code> - parameter value to fill in</dd>
+<dt><span class="strong">Throws:</span></dt>
+<dd><code>java.lang.IllegalStateException</code> - if no blank parameters</dd>
+<dd><code>java.lang.IllegalArgumentException</code> - if type doesn't match</dd></dl>
+</li>
+</ul>
+<a name="with(java.lang.Object)">
+<!-- -->
+</a>
+<ul class="blockList">
+<li class="blockList">
+<h4>with</h4>
+<pre><a href="../../../com/amazon/carbonado/Query.html" title="interface in com.amazon.carbonado">Query</a>&lt;<a href="../../../com/amazon/carbonado/Query.html" title="type parameter in Query">S</a>&gt;&nbsp;with(java.lang.Object&nbsp;value)</pre>
+<div class="block">Returns a copy of this Query with the next blank parameter filled in.</div>
+<dl><dt><span class="strong">Parameters:</span></dt><dd><code>value</code> - parameter value to fill in</dd>
+<dt><span class="strong">Throws:</span></dt>
+<dd><code>java.lang.IllegalStateException</code> - if no blank parameters</dd>
+<dd><code>java.lang.IllegalArgumentException</code> - if type doesn't match</dd></dl>
+</li>
+</ul>
+<a name="withValues(java.lang.Object...)">
+<!-- -->
+</a>
+<ul class="blockList">
+<li class="blockList">
+<h4>withValues</h4>
+<pre><a href="../../../com/amazon/carbonado/Query.html" title="interface in com.amazon.carbonado">Query</a>&lt;<a href="../../../com/amazon/carbonado/Query.html" title="type parameter in Query">S</a>&gt;&nbsp;withValues(java.lang.Object...&nbsp;values)</pre>
+<div class="block">Returns a copy of this Query with the next blank parameters filled in.</div>
+<dl><dt><span class="strong">Parameters:</span></dt><dd><code>values</code> - parameter values to fill in; if null or empty, this
+ Query instance is returned</dd>
+<dt><span class="strong">Throws:</span></dt>
+<dd><code>java.lang.IllegalStateException</code> - if no blank parameters or if too many
+ parameter values supplied</dd>
+<dd><code>java.lang.IllegalArgumentException</code> - if any type doesn't match</dd></dl>
+</li>
+</ul>
+<a name="and(java.lang.String)">
+<!-- -->
+</a>
+<ul class="blockList">
+<li class="blockList">
+<h4>and</h4>
+<pre><a href="../../../com/amazon/carbonado/Query.html" title="interface in com.amazon.carbonado">Query</a>&lt;<a href="../../../com/amazon/carbonado/Query.html" title="type parameter in Query">S</a>&gt;&nbsp;and(java.lang.String&nbsp;filter)
+ throws <a href="../../../com/amazon/carbonado/FetchException.html" title="class in com.amazon.carbonado">FetchException</a></pre>
+<div class="block">Returns a new query which has another <a href="../../../com/amazon/carbonado/Storage.html#query(java.lang.String)"><code>filter</code></a> logically "and"ed to this, potentially reducing the amount of
+ results.</div>
+<dl><dt><span class="strong">Parameters:</span></dt><dd><code>filter</code> - query filter expression</dd>
+<dt><span class="strong">Throws:</span></dt>
+<dd><code><a href="../../../com/amazon/carbonado/FetchException.html" title="class in com.amazon.carbonado">FetchException</a></code> - if storage layer throws an exception</dd>
+<dd><code>java.lang.IllegalStateException</code> - if any blank parameters in this query, or
+ if this query is already guaranteed to fetch nothing</dd>
+<dd><code>java.lang.IllegalArgumentException</code> - if filter is null</dd>
+<dd><code><a href="../../../com/amazon/carbonado/MalformedFilterException.html" title="class in com.amazon.carbonado">MalformedFilterException</a></code> - if expression is malformed</dd>
+<dd><code>java.lang.UnsupportedOperationException</code> - if given filter is unsupported by repository</dd></dl>
+</li>
+</ul>
+<a name="and(com.amazon.carbonado.filter.Filter)">
+<!-- -->
+</a>
+<ul class="blockList">
+<li class="blockList">
+<h4>and</h4>
+<pre><a href="../../../com/amazon/carbonado/Query.html" title="interface in com.amazon.carbonado">Query</a>&lt;<a href="../../../com/amazon/carbonado/Query.html" title="type parameter in Query">S</a>&gt;&nbsp;and(<a href="../../../com/amazon/carbonado/filter/Filter.html" title="class in com.amazon.carbonado.filter">Filter</a>&lt;<a href="../../../com/amazon/carbonado/Query.html" title="type parameter in Query">S</a>&gt;&nbsp;filter)
+ throws <a href="../../../com/amazon/carbonado/FetchException.html" title="class in com.amazon.carbonado">FetchException</a></pre>
+<div class="block">Returns a new query which has another <a href="../../../com/amazon/carbonado/Storage.html#query(java.lang.String)"><code>filter</code></a> logically "and"ed to this, potentially reducing the amount of
+ results.</div>
+<dl><dt><span class="strong">Parameters:</span></dt><dd><code>filter</code> - query filter</dd>
+<dt><span class="strong">Throws:</span></dt>
+<dd><code><a href="../../../com/amazon/carbonado/FetchException.html" title="class in com.amazon.carbonado">FetchException</a></code> - if storage layer throws an exception</dd>
+<dd><code>java.lang.IllegalStateException</code> - if any blank parameters in this query, or
+ if this query is already guaranteed to fetch nothing</dd>
+<dd><code>java.lang.IllegalArgumentException</code> - if filter is null</dd>
+<dd><code>java.lang.UnsupportedOperationException</code> - if given filter is unsupported by repository</dd></dl>
+</li>
+</ul>
+<a name="or(java.lang.String)">
+<!-- -->
+</a>
+<ul class="blockList">
+<li class="blockList">
+<h4>or</h4>
+<pre><a href="../../../com/amazon/carbonado/Query.html" title="interface in com.amazon.carbonado">Query</a>&lt;<a href="../../../com/amazon/carbonado/Query.html" title="type parameter in Query">S</a>&gt;&nbsp;or(java.lang.String&nbsp;filter)
+ throws <a href="../../../com/amazon/carbonado/FetchException.html" title="class in com.amazon.carbonado">FetchException</a></pre>
+<div class="block">Returns a new query which has another <a href="../../../com/amazon/carbonado/Storage.html#query(java.lang.String)"><code>filter</code></a> logically "or"ed to this, potentially increasing the amount of
+ results.</div>
+<dl><dt><span class="strong">Parameters:</span></dt><dd><code>filter</code> - query filter expression</dd>
+<dt><span class="strong">Throws:</span></dt>
+<dd><code><a href="../../../com/amazon/carbonado/FetchException.html" title="class in com.amazon.carbonado">FetchException</a></code> - if storage layer throws an exception</dd>
+<dd><code>java.lang.IllegalStateException</code> - if any blank parameters in this query, or
+ if this query is already guaranteed to fetch everything</dd>
+<dd><code>java.lang.IllegalArgumentException</code> - if filter is null</dd>
+<dd><code><a href="../../../com/amazon/carbonado/MalformedFilterException.html" title="class in com.amazon.carbonado">MalformedFilterException</a></code> - if expression is malformed</dd>
+<dd><code>java.lang.UnsupportedOperationException</code> - if given filter is unsupported by repository</dd></dl>
+</li>
+</ul>
+<a name="or(com.amazon.carbonado.filter.Filter)">
+<!-- -->
+</a>
+<ul class="blockList">
+<li class="blockList">
+<h4>or</h4>
+<pre><a href="../../../com/amazon/carbonado/Query.html" title="interface in com.amazon.carbonado">Query</a>&lt;<a href="../../../com/amazon/carbonado/Query.html" title="type parameter in Query">S</a>&gt;&nbsp;or(<a href="../../../com/amazon/carbonado/filter/Filter.html" title="class in com.amazon.carbonado.filter">Filter</a>&lt;<a href="../../../com/amazon/carbonado/Query.html" title="type parameter in Query">S</a>&gt;&nbsp;filter)
+ throws <a href="../../../com/amazon/carbonado/FetchException.html" title="class in com.amazon.carbonado">FetchException</a></pre>
+<div class="block">Returns a new query which has another <a href="../../../com/amazon/carbonado/Storage.html#query(java.lang.String)"><code>filter</code></a> logically "or"ed to this, potentially increasing the amount of
+ results.</div>
+<dl><dt><span class="strong">Parameters:</span></dt><dd><code>filter</code> - query filter</dd>
+<dt><span class="strong">Throws:</span></dt>
+<dd><code><a href="../../../com/amazon/carbonado/FetchException.html" title="class in com.amazon.carbonado">FetchException</a></code> - if storage layer throws an exception</dd>
+<dd><code>java.lang.IllegalStateException</code> - if any blank parameters in this query, or
+ if this query is already guaranteed to fetch everything</dd>
+<dd><code>java.lang.IllegalArgumentException</code> - if filter is null</dd>
+<dd><code>java.lang.UnsupportedOperationException</code> - if given filter is unsupported by repository</dd></dl>
+</li>
+</ul>
+<a name="not()">
+<!-- -->
+</a>
+<ul class="blockList">
+<li class="blockList">
+<h4>not</h4>
+<pre><a href="../../../com/amazon/carbonado/Query.html" title="interface in com.amazon.carbonado">Query</a>&lt;<a href="../../../com/amazon/carbonado/Query.html" title="type parameter in Query">S</a>&gt;&nbsp;not()
+ throws <a href="../../../com/amazon/carbonado/FetchException.html" title="class in com.amazon.carbonado">FetchException</a></pre>
+<div class="block">Returns a new query which produces all the results not supplied in this
+ query. Any filled in parameters in this query are copied into the new
+ one.</div>
+<dl><dt><span class="strong">Throws:</span></dt>
+<dd><code><a href="../../../com/amazon/carbonado/FetchException.html" title="class in com.amazon.carbonado">FetchException</a></code> - if storage layer throws an exception</dd>
+<dd><code>java.lang.UnsupportedOperationException</code> - if new query is unsupported by repository</dd></dl>
+</li>
+</ul>
+<a name="orderBy(java.lang.String)">
+<!-- -->
+</a>
+<ul class="blockList">
+<li class="blockList">
+<h4>orderBy</h4>
+<pre><a href="../../../com/amazon/carbonado/Query.html" title="interface in com.amazon.carbonado">Query</a>&lt;<a href="../../../com/amazon/carbonado/Query.html" title="type parameter in Query">S</a>&gt;&nbsp;orderBy(java.lang.String&nbsp;property)
+ throws <a href="../../../com/amazon/carbonado/FetchException.html" title="class in com.amazon.carbonado">FetchException</a></pre>
+<div class="block">Returns a copy of this query ordered by a specific property value. The
+ property name may be prefixed with '+' or '-' to indicate ascending or
+ descending order. If the prefix is omitted, ascending order is assumed.
+
+ <p>Note: Specification of ordering properties is not cumulative. Calling
+ this method will first remove any previous ordering properties.</div>
+<dl><dt><span class="strong">Parameters:</span></dt><dd><code>property</code> - name of property to order by</dd>
+<dt><span class="strong">Throws:</span></dt>
+<dd><code><a href="../../../com/amazon/carbonado/FetchException.html" title="class in com.amazon.carbonado">FetchException</a></code> - if storage layer throws an exception</dd>
+<dd><code>java.lang.IllegalArgumentException</code> - if property is null or is not a member
+ of type S</dd>
+<dd><code>java.lang.UnsupportedOperationException</code> - if given ordering, combined with
+ query filter, is unsupported by repository</dd></dl>
+</li>
+</ul>
+<a name="orderBy(java.lang.String...)">
+<!-- -->
+</a>
+<ul class="blockList">
+<li class="blockList">
+<h4>orderBy</h4>
+<pre><a href="../../../com/amazon/carbonado/Query.html" title="interface in com.amazon.carbonado">Query</a>&lt;<a href="../../../com/amazon/carbonado/Query.html" title="type parameter in Query">S</a>&gt;&nbsp;orderBy(java.lang.String...&nbsp;properties)
+ throws <a href="../../../com/amazon/carbonado/FetchException.html" title="class in com.amazon.carbonado">FetchException</a></pre>
+<div class="block">Returns a copy of this query ordered by specific property values. The
+ property names may be prefixed with '+' or '-' to indicate ascending or
+ descending order. If the prefix is omitted, ascending order is assumed.
+
+ <p>Note: Specification of ordering properties is not cumulative. Calling
+ this method will first remove any previous ordering properties.</div>
+<dl><dt><span class="strong">Parameters:</span></dt><dd><code>properties</code> - names of properties to order by</dd>
+<dt><span class="strong">Throws:</span></dt>
+<dd><code><a href="../../../com/amazon/carbonado/FetchException.html" title="class in com.amazon.carbonado">FetchException</a></code> - if storage layer throws an exception</dd>
+<dd><code>java.lang.IllegalArgumentException</code> - if any property is null or is not a
+ member of type S</dd>
+<dd><code>java.lang.UnsupportedOperationException</code> - if given ordering, combined with
+ query filter, is unsupported by repository</dd></dl>
+</li>
+</ul>
+<a name="after(com.amazon.carbonado.Storable)">
+<!-- -->
+</a><a name="after(T)">
+<!-- -->
+</a>
+<ul class="blockList">
+<li class="blockList">
+<h4>after</h4>
+<pre>&lt;T extends <a href="../../../com/amazon/carbonado/Query.html" title="type parameter in Query">S</a>&gt;&nbsp;<a href="../../../com/amazon/carbonado/Query.html" title="interface in com.amazon.carbonado">Query</a>&lt;<a href="../../../com/amazon/carbonado/Query.html" title="type parameter in Query">S</a>&gt;&nbsp;after(T&nbsp;start)
+ throws <a href="../../../com/amazon/carbonado/FetchException.html" title="class in com.amazon.carbonado">FetchException</a></pre>
+<div class="block">Returns a query which fetches results for this query after a given
+ starting point, which is useful for re-opening a cursor. This is only
+ effective when query has been given an explicit <a href="../../../com/amazon/carbonado/Query.html#orderBy(java.lang.String)"><code>ordering</code></a>. If not a total ordering, then query may start at an earlier
+ position.
+
+ <p>Note: The returned query can be very expensive to fetch from
+ repeatedly, if the query needs to perform a sort operation. Ideally, the
+ query ordering should match the natural ordering of an index or key.</div>
+<dl><dt><span class="strong">Parameters:</span></dt><dd><code>start</code> - storable to attempt to start after; if null, this query is
+ returned</dd>
+<dt><span class="strong">Throws:</span></dt>
+<dd><code>java.lang.IllegalStateException</code> - if any blank parameters in this query</dd>
+<dd><code><a href="../../../com/amazon/carbonado/FetchException.html" title="class in com.amazon.carbonado">FetchException</a></code> - if storage layer throws an exception</dd><dt><span class="strong">Since:</span></dt>
+ <dd>1.2</dd></dl>
+</li>
+</ul>
+<a name="fetch()">
+<!-- -->
+</a>
+<ul class="blockList">
+<li class="blockList">
+<h4>fetch</h4>
+<pre><a href="../../../com/amazon/carbonado/Cursor.html" title="interface in com.amazon.carbonado">Cursor</a>&lt;<a href="../../../com/amazon/carbonado/Query.html" title="type parameter in Query">S</a>&gt;&nbsp;fetch()
+ throws <a href="../../../com/amazon/carbonado/FetchException.html" title="class in com.amazon.carbonado">FetchException</a></pre>
+<div class="block">Fetches results for this query. If any updates or deletes might be
+ performed on the results, consider enclosing the fetch in a
+ transaction. This allows the isolation level and "for update" mode to be
+ adjusted. Some repositories might otherwise deadlock.</div>
+<dl><dt><span class="strong">Returns:</span></dt><dd>fetch results</dd>
+<dt><span class="strong">Throws:</span></dt>
+<dd><code>java.lang.IllegalStateException</code> - if any blank parameters in this query</dd>
+<dd><code><a href="../../../com/amazon/carbonado/FetchException.html" title="class in com.amazon.carbonado">FetchException</a></code> - if storage layer throws an exception</dd><dt><span class="strong">See Also:</span></dt><dd><a href="../../../com/amazon/carbonado/Repository.html#enterTransaction(com.amazon.carbonado.IsolationLevel)"><code>Repository.enterTransaction(IsolationLevel)</code></a></dd></dl>
+</li>
+</ul>
+<a name="fetch(com.amazon.carbonado.Query.Controller)">
+<!-- -->
+</a>
+<ul class="blockList">
+<li class="blockList">
+<h4>fetch</h4>
+<pre><a href="../../../com/amazon/carbonado/Cursor.html" title="interface in com.amazon.carbonado">Cursor</a>&lt;<a href="../../../com/amazon/carbonado/Query.html" title="type parameter in Query">S</a>&gt;&nbsp;fetch(<a href="../../../com/amazon/carbonado/Query.Controller.html" title="interface in com.amazon.carbonado">Query.Controller</a>&nbsp;controller)
+ throws <a href="../../../com/amazon/carbonado/FetchException.html" title="class in com.amazon.carbonado">FetchException</a></pre>
+<div class="block">Fetches results for this query. If any updates or deletes might be
+ performed on the results, consider enclosing the fetch in a
+ transaction. This allows the isolation level and "for update" mode to be
+ adjusted. Some repositories might otherwise deadlock.</div>
+<dl><dt><span class="strong">Parameters:</span></dt><dd><code>controller</code> - optional controller which can abort query operation</dd>
+<dt><span class="strong">Returns:</span></dt><dd>fetch results</dd>
+<dt><span class="strong">Throws:</span></dt>
+<dd><code>java.lang.IllegalStateException</code> - if any blank parameters in this query</dd>
+<dd><code><a href="../../../com/amazon/carbonado/FetchException.html" title="class in com.amazon.carbonado">FetchException</a></code> - if storage layer throws an exception</dd><dt><span class="strong">See Also:</span></dt><dd><a href="../../../com/amazon/carbonado/Repository.html#enterTransaction(com.amazon.carbonado.IsolationLevel)"><code>Repository.enterTransaction(IsolationLevel)</code></a></dd></dl>
+</li>
+</ul>
+<a name="fetchSlice(long, java.lang.Long)">
+<!-- -->
+</a>
+<ul class="blockList">
+<li class="blockList">
+<h4>fetchSlice</h4>
+<pre><a href="../../../com/amazon/carbonado/Cursor.html" title="interface in com.amazon.carbonado">Cursor</a>&lt;<a href="../../../com/amazon/carbonado/Query.html" title="type parameter in Query">S</a>&gt;&nbsp;fetchSlice(long&nbsp;from,
+ java.lang.Long&nbsp;to)
+ throws <a href="../../../com/amazon/carbonado/FetchException.html" title="class in com.amazon.carbonado">FetchException</a></pre>
+<div class="block">Fetches a slice of results for this query, as defined by a numerical
+ range. A slice can be used to limit the number of results from a
+ query. It is strongly recommended that the query be given a total <a href="../../../com/amazon/carbonado/Query.html#orderBy(java.lang.String)"><code>ordering</code></a> in order for the slice results to be deterministic.</div>
+<dl><dt><span class="strong">Parameters:</span></dt><dd><code>from</code> - zero-based <code>from</code> record number, inclusive</dd><dd><code>to</code> - optional zero-based <code>to</code> record number, exclusive</dd>
+<dt><span class="strong">Returns:</span></dt><dd>fetch results</dd>
+<dt><span class="strong">Throws:</span></dt>
+<dd><code>java.lang.IllegalStateException</code> - if any blank parameters in this query</dd>
+<dd><code>java.lang.IllegalArgumentException</code> - if <code>from</code> is negative or if
+ <code>from</code> is more than <code>to</code></dd>
+<dd><code><a href="../../../com/amazon/carbonado/FetchException.html" title="class in com.amazon.carbonado">FetchException</a></code> - if storage layer throws an exception</dd><dt><span class="strong">Since:</span></dt>
+ <dd>1.2</dd></dl>
+</li>
+</ul>
+<a name="fetchSlice(long, java.lang.Long, com.amazon.carbonado.Query.Controller)">
+<!-- -->
+</a>
+<ul class="blockList">
+<li class="blockList">
+<h4>fetchSlice</h4>
+<pre><a href="../../../com/amazon/carbonado/Cursor.html" title="interface in com.amazon.carbonado">Cursor</a>&lt;<a href="../../../com/amazon/carbonado/Query.html" title="type parameter in Query">S</a>&gt;&nbsp;fetchSlice(long&nbsp;from,
+ java.lang.Long&nbsp;to,
+ <a href="../../../com/amazon/carbonado/Query.Controller.html" title="interface in com.amazon.carbonado">Query.Controller</a>&nbsp;controller)
+ throws <a href="../../../com/amazon/carbonado/FetchException.html" title="class in com.amazon.carbonado">FetchException</a></pre>
+<div class="block">Fetches a slice of results for this query, as defined by a numerical
+ range. A slice can be used to limit the number of results from a
+ query. It is strongly recommended that the query be given a total <a href="../../../com/amazon/carbonado/Query.html#orderBy(java.lang.String)"><code>ordering</code></a> in order for the slice results to be deterministic.</div>
+<dl><dt><span class="strong">Parameters:</span></dt><dd><code>from</code> - zero-based <code>from</code> record number, inclusive</dd><dd><code>to</code> - optional zero-based <code>to</code> record number, exclusive</dd><dd><code>controller</code> - optional controller which can abort query operation</dd>
+<dt><span class="strong">Returns:</span></dt><dd>fetch results</dd>
+<dt><span class="strong">Throws:</span></dt>
+<dd><code>java.lang.IllegalStateException</code> - if any blank parameters in this query</dd>
+<dd><code>java.lang.IllegalArgumentException</code> - if <code>from</code> is negative or if
+ <code>from</code> is more than <code>to</code></dd>
+<dd><code><a href="../../../com/amazon/carbonado/FetchException.html" title="class in com.amazon.carbonado">FetchException</a></code> - if storage layer throws an exception</dd><dt><span class="strong">Since:</span></dt>
+ <dd>1.2</dd></dl>
+</li>
+</ul>
+<a name="fetchAfter(com.amazon.carbonado.Storable)">
+<!-- -->
+</a><a name="fetchAfter(T)">
+<!-- -->
+</a>
+<ul class="blockList">
+<li class="blockList">
+<h4>fetchAfter</h4>
+<pre>&lt;T extends <a href="../../../com/amazon/carbonado/Query.html" title="type parameter in Query">S</a>&gt;&nbsp;<a href="../../../com/amazon/carbonado/Cursor.html" title="interface in com.amazon.carbonado">Cursor</a>&lt;<a href="../../../com/amazon/carbonado/Query.html" title="type parameter in Query">S</a>&gt;&nbsp;fetchAfter(T&nbsp;start)
+ throws <a href="../../../com/amazon/carbonado/FetchException.html" title="class in com.amazon.carbonado">FetchException</a></pre>
+<div class="block">Fetches results for this query after a given starting point, which is
+ useful for re-opening a cursor. This is only effective when query has
+ been given an explicit <a href="../../../com/amazon/carbonado/Query.html#orderBy(java.lang.String)"><code>ordering</code></a>. If not a total
+ ordering, then cursor may start at an earlier position.
+
+ <p>Note: This method can be very expensive to call repeatedly, if the
+ query needs to perform a sort operation. Ideally, the query ordering
+ should match the natural ordering of an index or key.
+
+ <p>Calling <code>fetchAfter(s)</code> is equivalent to calling <code>after(s).fetch()</code>.</div>
+<dl><dt><span class="strong">Parameters:</span></dt><dd><code>start</code> - storable to attempt to start after; if null, fetch all results</dd>
+<dt><span class="strong">Returns:</span></dt><dd>fetch results</dd>
+<dt><span class="strong">Throws:</span></dt>
+<dd><code>java.lang.IllegalStateException</code> - if any blank parameters in this query</dd>
+<dd><code><a href="../../../com/amazon/carbonado/FetchException.html" title="class in com.amazon.carbonado">FetchException</a></code> - if storage layer throws an exception</dd><dt><span class="strong">See Also:</span></dt><dd><a href="../../../com/amazon/carbonado/Repository.html#enterTransaction(com.amazon.carbonado.IsolationLevel)"><code>Repository.enterTransaction(IsolationLevel)</code></a>,
+<a href="../../../com/amazon/carbonado/Query.html#after(T)"><code>after(T)</code></a></dd></dl>
+</li>
+</ul>
+<a name="fetchAfter(com.amazon.carbonado.Storable,com.amazon.carbonado.Query.Controller)">
+<!-- -->
+</a><a name="fetchAfter(T, com.amazon.carbonado.Query.Controller)">
+<!-- -->
+</a>
+<ul class="blockList">
+<li class="blockList">
+<h4>fetchAfter</h4>
+<pre>&lt;T extends <a href="../../../com/amazon/carbonado/Query.html" title="type parameter in Query">S</a>&gt;&nbsp;<a href="../../../com/amazon/carbonado/Cursor.html" title="interface in com.amazon.carbonado">Cursor</a>&lt;<a href="../../../com/amazon/carbonado/Query.html" title="type parameter in Query">S</a>&gt;&nbsp;fetchAfter(T&nbsp;start,
+ <a href="../../../com/amazon/carbonado/Query.Controller.html" title="interface in com.amazon.carbonado">Query.Controller</a>&nbsp;controller)
+ throws <a href="../../../com/amazon/carbonado/FetchException.html" title="class in com.amazon.carbonado">FetchException</a></pre>
+<div class="block">Fetches results for this query after a given starting point, which is
+ useful for re-opening a cursor. This is only effective when query has
+ been given an explicit <a href="../../../com/amazon/carbonado/Query.html#orderBy(java.lang.String)"><code>ordering</code></a>. If not a total
+ ordering, then cursor may start at an earlier position.
+
+ <p>Note: This method can be very expensive to call repeatedly, if the
+ query needs to perform a sort operation. Ideally, the query ordering
+ should match the natural ordering of an index or key.
+
+ <p>Calling <code>fetchAfter(s)</code> is equivalent to calling <code>after(s).fetch()</code>.</div>
+<dl><dt><span class="strong">Parameters:</span></dt><dd><code>start</code> - storable to attempt to start after; if null, fetch all results</dd><dd><code>controller</code> - optional controller which can abort query operation</dd>
+<dt><span class="strong">Returns:</span></dt><dd>fetch results</dd>
+<dt><span class="strong">Throws:</span></dt>
+<dd><code>java.lang.IllegalStateException</code> - if any blank parameters in this query</dd>
+<dd><code><a href="../../../com/amazon/carbonado/FetchException.html" title="class in com.amazon.carbonado">FetchException</a></code> - if storage layer throws an exception</dd><dt><span class="strong">See Also:</span></dt><dd><a href="../../../com/amazon/carbonado/Repository.html#enterTransaction(com.amazon.carbonado.IsolationLevel)"><code>Repository.enterTransaction(IsolationLevel)</code></a>,
+<a href="../../../com/amazon/carbonado/Query.html#after(T)"><code>after(T)</code></a></dd></dl>
+</li>
+</ul>
+<a name="loadOne()">
+<!-- -->
+</a>
+<ul class="blockList">
+<li class="blockList">
+<h4>loadOne</h4>
+<pre><a href="../../../com/amazon/carbonado/Query.html" title="type parameter in Query">S</a>&nbsp;loadOne()
+ throws <a href="../../../com/amazon/carbonado/FetchException.html" title="class in com.amazon.carbonado">FetchException</a></pre>
+<div class="block">Attempts to load exactly one matching object. If the number of matching
+ records is zero or exceeds one, then an exception is thrown instead.</div>
+<dl><dt><span class="strong">Returns:</span></dt><dd>a single fetched object</dd>
+<dt><span class="strong">Throws:</span></dt>
+<dd><code>java.lang.IllegalStateException</code> - if any blank parameters in this query</dd>
+<dd><code><a href="../../../com/amazon/carbonado/FetchNoneException.html" title="class in com.amazon.carbonado">FetchNoneException</a></code> - if no matching record found</dd>
+<dd><code><a href="../../../com/amazon/carbonado/FetchMultipleException.html" title="class in com.amazon.carbonado">FetchMultipleException</a></code> - if more than one matching record found</dd>
+<dd><code><a href="../../../com/amazon/carbonado/FetchException.html" title="class in com.amazon.carbonado">FetchException</a></code> - if storage layer throws an exception</dd></dl>
+</li>
+</ul>
+<a name="loadOne(com.amazon.carbonado.Query.Controller)">
+<!-- -->
+</a>
+<ul class="blockList">
+<li class="blockList">
+<h4>loadOne</h4>
+<pre><a href="../../../com/amazon/carbonado/Query.html" title="type parameter in Query">S</a>&nbsp;loadOne(<a href="../../../com/amazon/carbonado/Query.Controller.html" title="interface in com.amazon.carbonado">Query.Controller</a>&nbsp;controller)
+ throws <a href="../../../com/amazon/carbonado/FetchException.html" title="class in com.amazon.carbonado">FetchException</a></pre>
+<div class="block">Attempts to load exactly one matching object. If the number of matching
+ records is zero or exceeds one, then an exception is thrown instead.</div>
+<dl><dt><span class="strong">Parameters:</span></dt><dd><code>controller</code> - optional controller which can abort query operation</dd>
+<dt><span class="strong">Returns:</span></dt><dd>a single fetched object</dd>
+<dt><span class="strong">Throws:</span></dt>
+<dd><code>java.lang.IllegalStateException</code> - if any blank parameters in this query</dd>
+<dd><code><a href="../../../com/amazon/carbonado/FetchNoneException.html" title="class in com.amazon.carbonado">FetchNoneException</a></code> - if no matching record found</dd>
+<dd><code><a href="../../../com/amazon/carbonado/FetchMultipleException.html" title="class in com.amazon.carbonado">FetchMultipleException</a></code> - if more than one matching record found</dd>
+<dd><code><a href="../../../com/amazon/carbonado/FetchException.html" title="class in com.amazon.carbonado">FetchException</a></code> - if storage layer throws an exception</dd></dl>
+</li>
+</ul>
+<a name="tryLoadOne()">
+<!-- -->
+</a>
+<ul class="blockList">
+<li class="blockList">
+<h4>tryLoadOne</h4>
+<pre><a href="../../../com/amazon/carbonado/Query.html" title="type parameter in Query">S</a>&nbsp;tryLoadOne()
+ throws <a href="../../../com/amazon/carbonado/FetchException.html" title="class in com.amazon.carbonado">FetchException</a></pre>
+<div class="block">Tries to load one record, but returns null if nothing was found. Throws
+ exception if record count is more than one.</div>
+<dl><dt><span class="strong">Returns:</span></dt><dd>null or a single fetched object</dd>
+<dt><span class="strong">Throws:</span></dt>
+<dd><code>java.lang.IllegalStateException</code> - if any blank parameters in this query</dd>
+<dd><code><a href="../../../com/amazon/carbonado/FetchMultipleException.html" title="class in com.amazon.carbonado">FetchMultipleException</a></code> - if more than one matching record found</dd>
+<dd><code><a href="../../../com/amazon/carbonado/FetchException.html" title="class in com.amazon.carbonado">FetchException</a></code> - if storage layer throws an exception</dd></dl>
+</li>
+</ul>
+<a name="tryLoadOne(com.amazon.carbonado.Query.Controller)">
+<!-- -->
+</a>
+<ul class="blockList">
+<li class="blockList">
+<h4>tryLoadOne</h4>
+<pre><a href="../../../com/amazon/carbonado/Query.html" title="type parameter in Query">S</a>&nbsp;tryLoadOne(<a href="../../../com/amazon/carbonado/Query.Controller.html" title="interface in com.amazon.carbonado">Query.Controller</a>&nbsp;controller)
+ throws <a href="../../../com/amazon/carbonado/FetchException.html" title="class in com.amazon.carbonado">FetchException</a></pre>
+<div class="block">Tries to load one record, but returns null if nothing was found. Throws
+ exception if record count is more than one.</div>
+<dl><dt><span class="strong">Parameters:</span></dt><dd><code>controller</code> - optional controller which can abort query operation</dd>
+<dt><span class="strong">Returns:</span></dt><dd>null or a single fetched object</dd>
+<dt><span class="strong">Throws:</span></dt>
+<dd><code>java.lang.IllegalStateException</code> - if any blank parameters in this query</dd>
+<dd><code><a href="../../../com/amazon/carbonado/FetchMultipleException.html" title="class in com.amazon.carbonado">FetchMultipleException</a></code> - if more than one matching record found</dd>
+<dd><code><a href="../../../com/amazon/carbonado/FetchException.html" title="class in com.amazon.carbonado">FetchException</a></code> - if storage layer throws an exception</dd></dl>
+</li>
+</ul>
+<a name="deleteOne()">
+<!-- -->
+</a>
+<ul class="blockList">
+<li class="blockList">
+<h4>deleteOne</h4>
+<pre>void&nbsp;deleteOne()
+ throws <a href="../../../com/amazon/carbonado/PersistException.html" title="class in com.amazon.carbonado">PersistException</a></pre>
+<div class="block">Deletes one matching object. If the number of matching records is zero or
+ exceeds one, then no delete occurs, and an exception is thrown instead.</div>
+<dl><dt><span class="strong">Throws:</span></dt>
+<dd><code>java.lang.IllegalStateException</code> - if any blank parameters in this query</dd>
+<dd><code><a href="../../../com/amazon/carbonado/PersistNoneException.html" title="class in com.amazon.carbonado">PersistNoneException</a></code> - if no matching record found</dd>
+<dd><code><a href="../../../com/amazon/carbonado/PersistMultipleException.html" title="class in com.amazon.carbonado">PersistMultipleException</a></code> - if more than one record matches</dd>
+<dd><code><a href="../../../com/amazon/carbonado/PersistException.html" title="class in com.amazon.carbonado">PersistException</a></code> - if storage layer throws an exception</dd></dl>
+</li>
+</ul>
+<a name="deleteOne(com.amazon.carbonado.Query.Controller)">
+<!-- -->
+</a>
+<ul class="blockList">
+<li class="blockList">
+<h4>deleteOne</h4>
+<pre>void&nbsp;deleteOne(<a href="../../../com/amazon/carbonado/Query.Controller.html" title="interface in com.amazon.carbonado">Query.Controller</a>&nbsp;controller)
+ throws <a href="../../../com/amazon/carbonado/PersistException.html" title="class in com.amazon.carbonado">PersistException</a></pre>
+<div class="block">Deletes one matching object. If the number of matching records is zero or
+ exceeds one, then no delete occurs, and an exception is thrown instead.</div>
+<dl><dt><span class="strong">Parameters:</span></dt><dd><code>controller</code> - optional controller which can abort query operation</dd>
+<dt><span class="strong">Throws:</span></dt>
+<dd><code>java.lang.IllegalStateException</code> - if any blank parameters in this query</dd>
+<dd><code><a href="../../../com/amazon/carbonado/PersistNoneException.html" title="class in com.amazon.carbonado">PersistNoneException</a></code> - if no matching record found</dd>
+<dd><code><a href="../../../com/amazon/carbonado/PersistMultipleException.html" title="class in com.amazon.carbonado">PersistMultipleException</a></code> - if more than one record matches</dd>
+<dd><code><a href="../../../com/amazon/carbonado/PersistException.html" title="class in com.amazon.carbonado">PersistException</a></code> - if storage layer throws an exception</dd></dl>
+</li>
+</ul>
+<a name="tryDeleteOne()">
+<!-- -->
+</a>
+<ul class="blockList">
+<li class="blockList">
+<h4>tryDeleteOne</h4>
+<pre>boolean&nbsp;tryDeleteOne()
+ throws <a href="../../../com/amazon/carbonado/PersistException.html" title="class in com.amazon.carbonado">PersistException</a></pre>
+<div class="block">Deletes zero or one matching objects. If the number of matching records
+ exceeds one, then no delete occurs, and an exception is thrown instead.</div>
+<dl><dt><span class="strong">Returns:</span></dt><dd>true if record existed and was deleted, or false if no match</dd>
+<dt><span class="strong">Throws:</span></dt>
+<dd><code>java.lang.IllegalStateException</code> - if any blank parameters in this query</dd>
+<dd><code><a href="../../../com/amazon/carbonado/PersistMultipleException.html" title="class in com.amazon.carbonado">PersistMultipleException</a></code> - if more than one record matches</dd>
+<dd><code><a href="../../../com/amazon/carbonado/PersistException.html" title="class in com.amazon.carbonado">PersistException</a></code> - if storage layer throws an exception</dd></dl>
+</li>
+</ul>
+<a name="tryDeleteOne(com.amazon.carbonado.Query.Controller)">
+<!-- -->
+</a>
+<ul class="blockList">
+<li class="blockList">
+<h4>tryDeleteOne</h4>
+<pre>boolean&nbsp;tryDeleteOne(<a href="../../../com/amazon/carbonado/Query.Controller.html" title="interface in com.amazon.carbonado">Query.Controller</a>&nbsp;controller)
+ throws <a href="../../../com/amazon/carbonado/PersistException.html" title="class in com.amazon.carbonado">PersistException</a></pre>
+<div class="block">Deletes zero or one matching objects. If the number of matching records
+ exceeds one, then no delete occurs, and an exception is thrown instead.</div>
+<dl><dt><span class="strong">Parameters:</span></dt><dd><code>controller</code> - optional controller which can abort query operation</dd>
+<dt><span class="strong">Returns:</span></dt><dd>true if record existed and was deleted, or false if no match</dd>
+<dt><span class="strong">Throws:</span></dt>
+<dd><code>java.lang.IllegalStateException</code> - if any blank parameters in this query</dd>
+<dd><code><a href="../../../com/amazon/carbonado/PersistMultipleException.html" title="class in com.amazon.carbonado">PersistMultipleException</a></code> - if more than one record matches</dd>
+<dd><code><a href="../../../com/amazon/carbonado/PersistException.html" title="class in com.amazon.carbonado">PersistException</a></code> - if storage layer throws an exception</dd></dl>
+</li>
+</ul>
+<a name="deleteAll()">
+<!-- -->
+</a>
+<ul class="blockList">
+<li class="blockList">
+<h4>deleteAll</h4>
+<pre>void&nbsp;deleteAll()
+ throws <a href="../../../com/amazon/carbonado/PersistException.html" title="class in com.amazon.carbonado">PersistException</a></pre>
+<div class="block">Deletes zero or more matching objects. There is no guarantee that
+ deleteAll is an atomic operation. If atomic behavior is desired, wrap
+ the call in a transaction scope.</div>
+<dl><dt><span class="strong">Throws:</span></dt>
+<dd><code>java.lang.IllegalStateException</code> - if any blank parameters in this query</dd>
+<dd><code><a href="../../../com/amazon/carbonado/PersistException.html" title="class in com.amazon.carbonado">PersistException</a></code> - if storage layer throws an exception</dd></dl>
+</li>
+</ul>
+<a name="deleteAll(com.amazon.carbonado.Query.Controller)">
+<!-- -->
+</a>
+<ul class="blockList">
+<li class="blockList">
+<h4>deleteAll</h4>
+<pre>void&nbsp;deleteAll(<a href="../../../com/amazon/carbonado/Query.Controller.html" title="interface in com.amazon.carbonado">Query.Controller</a>&nbsp;controller)
+ throws <a href="../../../com/amazon/carbonado/PersistException.html" title="class in com.amazon.carbonado">PersistException</a></pre>
+<div class="block">Deletes zero or more matching objects. There is no guarantee that
+ deleteAll is an atomic operation. If atomic behavior is desired, wrap
+ the call in a transaction scope.</div>
+<dl><dt><span class="strong">Parameters:</span></dt><dd><code>controller</code> - optional controller which can abort query operation</dd>
+<dt><span class="strong">Throws:</span></dt>
+<dd><code>java.lang.IllegalStateException</code> - if any blank parameters in this query</dd>
+<dd><code><a href="../../../com/amazon/carbonado/PersistException.html" title="class in com.amazon.carbonado">PersistException</a></code> - if storage layer throws an exception</dd></dl>
+</li>
+</ul>
+<a name="count()">
+<!-- -->
+</a>
+<ul class="blockList">
+<li class="blockList">
+<h4>count</h4>
+<pre>long&nbsp;count()
+ throws <a href="../../../com/amazon/carbonado/FetchException.html" title="class in com.amazon.carbonado">FetchException</a></pre>
+<div class="block">Returns a count of all results matched by this query. Even though no
+ results are explicitly fetched, this method may still be expensive to
+ call. The actual performance will vary by repository and available indexes.</div>
+<dl><dt><span class="strong">Returns:</span></dt><dd>count of matches</dd>
+<dt><span class="strong">Throws:</span></dt>
+<dd><code>java.lang.IllegalStateException</code> - if any blank parameters in this query</dd>
+<dd><code><a href="../../../com/amazon/carbonado/FetchException.html" title="class in com.amazon.carbonado">FetchException</a></code> - if storage layer throws an exception</dd></dl>
+</li>
+</ul>
+<a name="count(com.amazon.carbonado.Query.Controller)">
+<!-- -->
+</a>
+<ul class="blockList">
+<li class="blockList">
+<h4>count</h4>
+<pre>long&nbsp;count(<a href="../../../com/amazon/carbonado/Query.Controller.html" title="interface in com.amazon.carbonado">Query.Controller</a>&nbsp;controller)
+ throws <a href="../../../com/amazon/carbonado/FetchException.html" title="class in com.amazon.carbonado">FetchException</a></pre>
+<div class="block">Returns a count of all results matched by this query. Even though no
+ results are explicitly fetched, this method may still be expensive to
+ call. The actual performance will vary by repository and available indexes.</div>
+<dl><dt><span class="strong">Parameters:</span></dt><dd><code>controller</code> - optional controller which can abort query operation</dd>
+<dt><span class="strong">Returns:</span></dt><dd>count of matches</dd>
+<dt><span class="strong">Throws:</span></dt>
+<dd><code>java.lang.IllegalStateException</code> - if any blank parameters in this query</dd>
+<dd><code><a href="../../../com/amazon/carbonado/FetchException.html" title="class in com.amazon.carbonado">FetchException</a></code> - if storage layer throws an exception</dd></dl>
+</li>
+</ul>
+<a name="exists()">
+<!-- -->
+</a>
+<ul class="blockList">
+<li class="blockList">
+<h4>exists</h4>
+<pre>boolean&nbsp;exists()
+ throws <a href="../../../com/amazon/carbonado/FetchException.html" title="class in com.amazon.carbonado">FetchException</a></pre>
+<div class="block">Returns true if any results are matched by this query.</div>
+<dl><dt><span class="strong">Returns:</span></dt><dd>true if any matches</dd>
+<dt><span class="strong">Throws:</span></dt>
+<dd><code>java.lang.IllegalStateException</code> - if any blank parameters in this query</dd>
+<dd><code><a href="../../../com/amazon/carbonado/FetchException.html" title="class in com.amazon.carbonado">FetchException</a></code> - if storage layer throws an exception</dd><dt><span class="strong">Since:</span></dt>
+ <dd>1.2</dd></dl>
+</li>
+</ul>
+<a name="exists(com.amazon.carbonado.Query.Controller)">
+<!-- -->
+</a>
+<ul class="blockList">
+<li class="blockList">
+<h4>exists</h4>
+<pre>boolean&nbsp;exists(<a href="../../../com/amazon/carbonado/Query.Controller.html" title="interface in com.amazon.carbonado">Query.Controller</a>&nbsp;controller)
+ throws <a href="../../../com/amazon/carbonado/FetchException.html" title="class in com.amazon.carbonado">FetchException</a></pre>
+<div class="block">Returns true if any results are matched by this query.</div>
+<dl><dt><span class="strong">Parameters:</span></dt><dd><code>controller</code> - optional controller which can abort query operation</dd>
+<dt><span class="strong">Returns:</span></dt><dd>true if any matches</dd>
+<dt><span class="strong">Throws:</span></dt>
+<dd><code>java.lang.IllegalStateException</code> - if any blank parameters in this query</dd>
+<dd><code><a href="../../../com/amazon/carbonado/FetchException.html" title="class in com.amazon.carbonado">FetchException</a></code> - if storage layer throws an exception</dd><dt><span class="strong">Since:</span></dt>
+ <dd>1.2</dd></dl>
+</li>
+</ul>
+<a name="printNative()">
+<!-- -->
+</a>
+<ul class="blockList">
+<li class="blockList">
+<h4>printNative</h4>
+<pre>boolean&nbsp;printNative()</pre>
+<div class="block">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.</div>
+<dl><dt><span class="strong">Returns:</span></dt><dd>false if not implemented</dd></dl>
+</li>
+</ul>
+<a name="printNative(java.lang.Appendable)">
+<!-- -->
+</a>
+<ul class="blockList">
+<li class="blockList">
+<h4>printNative</h4>
+<pre>boolean&nbsp;printNative(java.lang.Appendable&nbsp;app)
+ throws java.io.IOException</pre>
+<div class="block">Prints the native query to any appendable, which is useful for
+ performance analysis. Not all repositories have a native query
+ format. An example native format is SQL.</div>
+<dl><dt><span class="strong">Parameters:</span></dt><dd><code>app</code> - append results here</dd>
+<dt><span class="strong">Returns:</span></dt><dd>false if not implemented</dd>
+<dt><span class="strong">Throws:</span></dt>
+<dd><code>java.io.IOException</code></dd></dl>
+</li>
+</ul>
+<a name="printNative(java.lang.Appendable, int)">
+<!-- -->
+</a>
+<ul class="blockList">
+<li class="blockList">
+<h4>printNative</h4>
+<pre>boolean&nbsp;printNative(java.lang.Appendable&nbsp;app,
+ int&nbsp;indentLevel)
+ throws java.io.IOException</pre>
+<div class="block">Prints the native query to any appendable, which is useful for
+ performance analysis. Not all repositories have a native query
+ format. An example native format is SQL.</div>
+<dl><dt><span class="strong">Parameters:</span></dt><dd><code>app</code> - append results here</dd><dd><code>indentLevel</code> - amount to indent text, zero for none</dd>
+<dt><span class="strong">Returns:</span></dt><dd>false if not implemented</dd>
+<dt><span class="strong">Throws:</span></dt>
+<dd><code>java.io.IOException</code></dd></dl>
+</li>
+</ul>
+<a name="printPlan()">
+<!-- -->
+</a>
+<ul class="blockList">
+<li class="blockList">
+<h4>printPlan</h4>
+<pre>boolean&nbsp;printPlan()</pre>
+<div class="block">Prints the query excecution plan to standard out, which is useful for
+ performance analysis. There is no standard format for query plans, nor
+ is it a requirement that this method be implemented.</div>
+<dl><dt><span class="strong">Returns:</span></dt><dd>false if not implemented</dd></dl>
+</li>
+</ul>
+<a name="printPlan(java.lang.Appendable)">
+<!-- -->
+</a>
+<ul class="blockList">
+<li class="blockList">
+<h4>printPlan</h4>
+<pre>boolean&nbsp;printPlan(java.lang.Appendable&nbsp;app)
+ throws java.io.IOException</pre>
+<div class="block">Prints the query excecution plan to any appendable, which is useful for
+ performance analysis. There is no standard format for query plans, nor
+ is it a requirement that this method be implemented.</div>
+<dl><dt><span class="strong">Parameters:</span></dt><dd><code>app</code> - append results here</dd>
+<dt><span class="strong">Returns:</span></dt><dd>false if not implemented</dd>
+<dt><span class="strong">Throws:</span></dt>
+<dd><code>java.io.IOException</code></dd></dl>
+</li>
+</ul>
+<a name="printPlan(java.lang.Appendable, int)">
+<!-- -->
+</a>
+<ul class="blockList">
+<li class="blockList">
+<h4>printPlan</h4>
+<pre>boolean&nbsp;printPlan(java.lang.Appendable&nbsp;app,
+ int&nbsp;indentLevel)
+ throws java.io.IOException</pre>
+<div class="block">Prints the query excecution plan to any appendable, which is useful for
+ performance analysis. There is no standard format for query plans, nor
+ is it a requirement that this method be implemented.</div>
+<dl><dt><span class="strong">Parameters:</span></dt><dd><code>app</code> - append results here</dd><dd><code>indentLevel</code> - amount to indent text, zero for none</dd>
+<dt><span class="strong">Returns:</span></dt><dd>false if not implemented</dd>
+<dt><span class="strong">Throws:</span></dt>
+<dd><code>java.io.IOException</code></dd></dl>
+</li>
+</ul>
+<a name="hashCode()">
+<!-- -->
+</a>
+<ul class="blockList">
+<li class="blockList">
+<h4>hashCode</h4>
+<pre>int&nbsp;hashCode()</pre>
+<dl>
+<dt><strong>Overrides:</strong></dt>
+<dd><code>hashCode</code>&nbsp;in class&nbsp;<code>java.lang.Object</code></dd>
+</dl>
+</li>
+</ul>
+<a name="equals(java.lang.Object)">
+<!-- -->
+</a>
+<ul class="blockList">
+<li class="blockList">
+<h4>equals</h4>
+<pre>boolean&nbsp;equals(java.lang.Object&nbsp;obj)</pre>
+<dl>
+<dt><strong>Overrides:</strong></dt>
+<dd><code>equals</code>&nbsp;in class&nbsp;<code>java.lang.Object</code></dd>
+</dl>
+</li>
+</ul>
+<a name="toString()">
+<!-- -->
+</a>
+<ul class="blockListLast">
+<li class="blockList">
+<h4>toString</h4>
+<pre>java.lang.String&nbsp;toString()</pre>
+<div class="block">Returns a description of the query filter and any other arguments.</div>
+<dl>
+<dt><strong>Overrides:</strong></dt>
+<dd><code>toString</code>&nbsp;in class&nbsp;<code>java.lang.Object</code></dd>
+</dl>
+</li>
+</ul>
+</li>
+</ul>
+</li>
+</ul>
+</div>
+</div>
+<!-- ========= END OF CLASS DATA ========= -->
+<!-- ======= START OF BOTTOM NAVBAR ====== -->
+<div class="bottomNav"><a name="navbar_bottom">
+<!-- -->
+</a><a href="#skip-navbar_bottom" title="Skip navigation links"></a><a name="navbar_bottom_firstrow">
+<!-- -->
+</a>
+<ul class="navList" title="Navigation">
+<li><a href="../../../overview-summary.html">Overview</a></li>
+<li><a href="package-summary.html">Package</a></li>
+<li class="navBarCell1Rev">Class</li>
+<li><a href="class-use/Query.html">Use</a></li>
+<li><a href="package-tree.html">Tree</a></li>
+<li><a href="../../../deprecated-list.html">Deprecated</a></li>
+<li><a href="../../../index-files/index-1.html">Index</a></li>
+<li><a href="../../../help-doc.html">Help</a></li>
+</ul>
+</div>
+<div class="subNav">
+<ul class="navList">
+<li><a href="../../../com/amazon/carbonado/PrimaryKey.html" title="annotation in com.amazon.carbonado"><span class="strong">Prev Class</span></a></li>
+<li><a href="../../../com/amazon/carbonado/Query.Controller.html" title="interface in com.amazon.carbonado"><span class="strong">Next Class</span></a></li>
+</ul>
+<ul class="navList">
+<li><a href="../../../index.html?com/amazon/carbonado/Query.html" target="_top">Frames</a></li>
+<li><a href="Query.html" target="_top">No Frames</a></li>
+</ul>
+<ul class="navList" id="allclasses_navbar_bottom">
+<li><a href="../../../allclasses-noframe.html">All Classes</a></li>
+</ul>
+<div>
+<script type="text/javascript"><!--
+ allClassesLink = document.getElementById("allclasses_navbar_bottom");
+ if(window==top) {
+ allClassesLink.style.display = "block";
+ }
+ else {
+ allClassesLink.style.display = "none";
+ }
+ //-->
+</script>
+</div>
+<div>
+<ul class="subNavList">
+<li>Summary:&nbsp;</li>
+<li><a href="#nested_class_summary">Nested</a>&nbsp;|&nbsp;</li>
+<li>Field&nbsp;|&nbsp;</li>
+<li>Constr&nbsp;|&nbsp;</li>
+<li><a href="#method_summary">Method</a></li>
+</ul>
+<ul class="subNavList">
+<li>Detail:&nbsp;</li>
+<li>Field&nbsp;|&nbsp;</li>
+<li>Constr&nbsp;|&nbsp;</li>
+<li><a href="#method_detail">Method</a></li>
+</ul>
+</div>
+<a name="skip-navbar_bottom">
+<!-- -->
+</a></div>
+<!-- ======== END OF BOTTOM NAVBAR ======= -->
+<p class="legalCopy"><small>Copyright &#169; 2006-2013 <a href="https://github.com/Carbonado/Carbonado">Amazon Technologies, Inc.</a>. All Rights Reserved.</small></p>
+</body>
+</html>