Notice: Over the next few months, we're reorganizing the App Engine documentation site to make it easier to find content and better align with the rest of Google Cloud products. The same content will be available, but the navigation will now match the rest of the Cloud products.

Cursor (Google App Engine API for Java)

Class Cursor

  • java.lang.Object
  • All Implemented Interfaces:

    public final class Cursor
    extends java.lang.Object
    A cursor that represents a position in a query.

    To resume a Query at the position defined by a Cursor, the Cursor must be present in the FetchOptions passed to a PreparedQuery identical to the one it was created from.

    Cursors can be retrieved from PreparedQuery.asQueryResult* functions. A typical use case would be:

     Cursor originalCursor = preparedQuery.asQueryResultList(withLimit(20)).getCursor();
     String encodedCursor = original.toWebSafeString();
    The encoded cursor can then be passed safely in a get or post arg of a web request and on another request the next batch of results can be retrieved with:
     Cursor decodedCursor = Cursor.fromWebSafeString(encodedCursor);
     List<Entity> nextBatch = preparedQuery.asQueryResultList(withLimit(20).cursor(decoded));

    See Also:
    Serialized Form
    • Method Detail

      • reverse

        public Cursor reverse()
        Deprecated. It is no longer necessary to call reverse() on cursors.

        A cursor returned by a query may also be used in the query returned by Query.reverse().

        a cursor identical to this
      • toWebSafeString

        public java.lang.String toWebSafeString()
        Encodes the current cursor as a web safe string that can later be decoded by fromWebSafeString(String)
      • fromWebSafeString

        public static Cursor fromWebSafeString(java.lang.String encodedCursor)
        Decodes the given encoded cursor
        encodedCursor -
        the decoded cursor
        java.lang.IllegalArgumentException - if the provided string is not a valid encoded cursor
      • equals

        public boolean equals(java.lang.Object obj)
        equals in class java.lang.Object
      • hashCode

        public int hashCode()
        hashCode in class java.lang.Object
      • toString

        public java.lang.String toString()
        toString in class java.lang.Object