|
|||||||||
| PREV CLASS NEXT CLASS | FRAMES NO FRAMES | ||||||||
| SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD | ||||||||
java.lang.Objectcom.google.appengine.api.search.Cursor
public final class Cursor
Represents a cursor on the set of results found for executing a Query
during a search on the Index.
For example, the following code shows how to use a cursor to get the next page of results
Index index = ...
Cursor cursor = Cursor.newBuilder().build();
Query query = Query.newBuilder().setOptions(
QueryOptions.newBuilder().setCursor(cursor).build("some query"));
// Get the first page of results
Results<ScoredDocument> results = index.search(query);
// process results
...
// Get the next set of results from the returned cursor
query = Query.newBuilder().setOptions(
QueryOptions.newBuilder().setCursor(
results.getCursor()).build("some query"));
results = index.search(query);
Alternatively, you can get a cursor to continue from each of the returned results.
Cursor cursor =
Cursor.newBuilder().setPerResult(true).build();
Query query = Query.newBuilder().setOptions(
QueryOptions.newBuilder().setCursor(cursor).build("some query"));
// Get the first page of results
Results<ScoredDocument> results = index.search(query);
// process results
for (ScoredDocument result : results) {
// choose a cursor from one of the results
cursor = result.getCursor();
}
// Get the next set of results from the result's cursor
query = Query.newBuilder().setOptions(
QueryOptions.newBuilder().setCursor(cursor).build("some query"));
results = index.search(query);
| Nested Class Summary | |
|---|---|
static class |
Cursor.Builder
A builder which constructs Cursor objects. |
| Method Summary | |
|---|---|
boolean |
isPerResult()
|
static Cursor.Builder |
newBuilder()
Creates and returns a Cursor builder. |
static Cursor.Builder |
newBuilder(Cursor request)
Creates a builder from the given request. |
java.lang.String |
toString()
|
java.lang.String |
toWebSafeString()
A web safe string representing a cursor returned from a previous set of search results to use as a starting point to retrieve the next set of results. |
| Methods inherited from class java.lang.Object |
|---|
equals, getClass, hashCode, notify, notifyAll, wait, wait, wait |
| Method Detail |
|---|
public java.lang.String toWebSafeString()
public boolean isPerResult()
public static Cursor.Builder newBuilder()
Cursor builder. Set the search request
parameters and use the Cursor.Builder.build() method to create a concrete
instance of Cursor.
Cursor.Builder which can construct a search requestpublic static Cursor.Builder newBuilder(Cursor request)
request - the search request for the builder to use
to build another requestpublic java.lang.String toString()
toString in class java.lang.Object
|
|||||||||
| PREV CLASS NEXT CLASS | FRAMES NO FRAMES | ||||||||
| SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD | ||||||||