Package com.googlecode.objectify.cmd

Interface QueryExecute<T>

All Superinterfaces:
Iterable<T>, QueryResultIterable<T>
All Known Subinterfaces:
Loader, LoadType<T>, Query<T>, QueryKeys<T>, SimpleQuery<T>
All Known Implementing Classes:
QueryImpl, SimpleQueryImpl
public interface QueryExecute<T> extends QueryResultIterable<T>
Most of the various methods that can end the definition of a query and start execution. The first() method is excluded because it returns a Ref which encapsulates both the regular and keys-only result. It makes no sense to have a Ref<Key>, but when you do keys() you get a QueryExecute<Key>.
Author:
Jeff Schnitzer <[email protected]>

  • Method Details

    • iterable

      QueryResultIterable<T> iterable()

      Starts an asynchronous query which will return entities.

      Note that since the Query itself is QueryResultIterable, you can iterate on the query object itself. However, if you want to start an async query and iterate on it later, you can use this method.

    • list

      List<T> list()

      Execute the query and get the results as a List. The list will be equivalent to a simple ArrayList; you can iterate through it multiple times without incurring additional datastore cost.

      Note that you must be careful about limit()ing the size of the list returned; you can easily exceed the practical memory limits of Appengine by querying for a very large dataset.

    • stream

      default Stream<T> stream()

      Execute the query and get the results as a Stream.

    • first

      LoadResult<T> first()
      Gets the first entity in the result set. Obeys the offset value.
      Returns:
      an asynchronous result containing the first result. The result will hold null if the result set is empty.

    • toString

      String toString()

      Generates a string that consistently and uniquely specifies this query. There is no way to convert this string back into a query and there is no guarantee that the string will be consistent across versions of Objectify.

      In particular, this value is useful as a key for a simple memcache query cache.

      Overrides:
      toString in class Object