AVQuery (AVOS Cloud Android SDK)

java.lang.Object
- com.avos.avoscloud.AVQuery<T>

直接已知子类:

AVStatusQuery
```
public class AVQuery<T extends AVObject>
extends java.lang.Object
```
The AVQuery class defines a query that is used to fetch AVObjects. The most common use case is finding all objects that match a query through the findInBackground method, using a FindCallback. For example, this sample code fetches all objects of class "MyClass". It calls a different function depending on whether the fetch succeeded or not.
```
    AVQuery query = AVQuery.getQuery("MyClass");
    query.findInBackground(new FindCallback() {
        public void done(List objects, AVException e) {
            if (e == null) {
                objectsWereRetrievedSuccessfully(objects);
            } else {
                objectRetrievalFailed();
            }
        }
    }
 
```
A AVQuery can also be used to retrieve a single object whose id is known, through the getInBackground method, using a GetCallback. For example, this sample code fetches an object of class "MyClass" and id myId. It calls a different function depending on whether the fetch succeeded or not.
```
    AVQuery query = AVQuery.getQuery("MyClass");
    query.getInBackground(myId, new GetCallback() {
        public void done(AVObject object, AVException e) {
            if (e == null) {
                objectWasRetrievedSuccessfully(object);
            } else {
                objectRetrievalFailed();
            }
        }
    }
 
```
A AVQuery can also be used to count the number of objects that match the query without retrieving all of those objects. For example, this sample code counts the number of objects of the class "MyClass".
```
    AVQuery query = AVQuery.getQuery("MyClass");
    query.countInBackground(new CountCallback() {
        public void done(int count, AVException e) {
            if (e == null) {
                objectsWereCounted(count);
            } else {
                objectCountFailed();
            }
        }
    }
 
```
Using the callback methods is usually preferred because the network operation will not block the calling thread. However, in some cases it may be easier to use the find, get or count calls, which do block the calling thread. For example, if your application has already spawned a background task to perform work, that background task could use the blocking calls and avoid the code complexity of callbacks.

嵌套类概要

嵌套类
限定符和类型类和说明

static class AVQuery.CachePolicy

嵌套类
限定符和类型	类和说明
`static class`	`AVQuery.CachePolicy`

构造器概要

构造器
构造器和说明

AVQuery(java.lang.String theClassName)
Constructs a query.

构造器
构造器和说明
`AVQuery(java.lang.String theClassName)` Constructs a query.

方法概要

所有方法静态方法实例方法具体方法已过时的方法
限定符和类型	方法和说明
`AVQuery<T>`	`addAscendingOrder(java.lang.String key)` Also sorts the results in ascending order by the given key.
`AVQuery<T>`	`addDescendingOrder(java.lang.String key)` Also sorts the results in descending order by the given key.
`static <T extends AVObject> AVQuery<T>`	`and(java.util.List<AVQuery<T>> queries)`
`void`	`cancel()` 已过时。
`static void`	`clearAllCachedResults()` Clears the cached result for all queries.
`void`	`clearCachedResult()` Removes the previously cached result for this query, forcing the next find() to hit the network.
`AVQuery`	`clone()` clone a new query object, which fully same to this.
`int`	`count()` Counts the number of objects that match this query.
`void`	`countInBackground(CountCallback callback)` Counts the number of objects that match this query in a background thread.
`void`	`deleteAll()` Delete all objects that are retrieved by this query.
`void`	`deleteAllInBackground(DeleteCallback cb)` Delete all objects that are retrieved by this query in background.
`static AVCloudQueryResult`	`doCloudQuery(java.lang.String cql)` 通过cql查询对象请在异步线程中调用此方法，在UI线程中，请调用doCloudQueryInBackground方法
`static AVCloudQueryResult`	`doCloudQuery(java.lang.String cql, java.lang.Class<? extends AVObject> clazz)` 通过cql查询对象请在异步线程中调用此方法，在UI线程中，请调用doCloudQueryInBackground方法
`static AVCloudQueryResult`	`doCloudQuery(java.lang.String cql, java.lang.Class<? extends AVObject> clazz, java.lang.Object... params)` 通过cql查询对象
`static AVCloudQueryResult`	`doCloudQuery(java.lang.String cql, java.lang.Object... params)` 通过cql查询对象
`static void`	`doCloudQueryInBackground(java.lang.String cql, CloudQueryCallback<AVCloudQueryResult> callback)` 通过cql查询对象
`static void`	`doCloudQueryInBackground(java.lang.String cql, CloudQueryCallback<AVCloudQueryResult> callback, java.lang.Class<? extends AVObject> clazz)` 通过cql查询对象
`static void`	`doCloudQueryInBackground(java.lang.String cql, CloudQueryCallback<AVCloudQueryResult> callback, java.lang.Class<? extends AVObject> clazz, java.lang.Object... params)` 通过cql查询对象
`static void`	`doCloudQueryInBackground(java.lang.String cql, CloudQueryCallback<AVCloudQueryResult> callback, java.lang.Object... params)` 通过cql查询对象
`java.util.List<T>`	`find()` Retrieves a list of AVObjects that satisfy this query.
`void`	`findInBackground(FindCallback<T> callback)` Retrieves a list of AVObjects that satisfy this query from the server in a background thread.
`T`	`get(java.lang.String theObjectId)` Constructs a AVObject whose id is already known by fetching data from the server.
`AVQuery.CachePolicy`	`getCachePolicy()` Accessor for the caching policy.
`java.lang.String`	`getClassName()` Accessor for the class name.
`T`	`getFirst()` Retrieves at most one AVObject that satisfies this query.
`void`	`getFirstInBackground(GetCallback<T> callback)` Retrieves at most one AVObject that satisfies this query from the server in a background thread.
`void`	`getInBackground(java.lang.String objectId, GetCallback<T> callback)` Constructs a AVObject whose id is already known by fetching data from the server in a background thread.
`int`	`getLimit()` Accessor for the limit.
`long`	`getMaxCacheAge()` Gets the maximum age of cached data that will be considered in this query.
`java.lang.String`	`getOrder()`
`AVQuery.CachePolicy`	`getPolicy()`
`static <T extends AVObject> AVQuery<T>`	`getQuery(java.lang.Class<T> clazz)` Create a AVQuery with special sub-class.
`static <T extends AVObject> AVQuery<T>`	`getQuery(java.lang.String theClassName)` Constructs a query.
`int`	`getSkip()` Accessor for the skip value.
`static AVQuery<AVUser>`	`getUserQuery()` 已过时。
`boolean`	`hasCachedResult()` Returns whether or not this query has a cached result.
`AVQuery<T>`	`include(java.lang.String key)` Include nested AVObjects for the provided key.
`AVQuery<T>`	`includeACL(boolean includeACL)` Include ACL attribute.
`boolean`	`isTrace()`
`AVQuery<T>`	`limit(int limit)`
`static <T extends AVObject> AVQuery<T>`	`or(java.util.List<AVQuery<T>> queries)` Constructs a query that is the or of the given queries.
`AVQuery<T>`	`order(java.lang.String order)`
`AVQuery<T>`	`orderByAscending(java.lang.String key)` Sorts the results in ascending order by the given key.
`AVQuery<T>`	`orderByDescending(java.lang.String key)` Sorts the results in descending order by the given key.
`AVQuery<T>`	`selectKeys(java.util.Collection<java.lang.String> keys)` Restrict the fields of returned AVObjects to only include the provided keys.
`AVQuery<T>`	`setCachePolicy(AVQuery.CachePolicy cachePolicy)` Change the caching policy of this query.
`AVQuery<T>`	`setClassName(java.lang.String className)`
`AVQuery<T>`	`setLimit(int limit)` Controls the maximum number of results that are returned.
`AVQuery<T>`	`setMaxCacheAge(long maxCacheAge)` Sets the maximum age of cached data that will be considered in this query.
`AVQuery<T>`	`setOrder(java.lang.String order)` Set query order fields.
`AVQuery<T>`	`setPolicy(AVQuery.CachePolicy policy)` Change the caching policy of this query.
`AVQuery<T>`	`setSkip(int skip)` Controls the number of results to skip before returning any results.
`AVQuery<T>`	`setTrace(boolean trace)` Turn on performance tracing of finds.
`AVQuery<T>`	`skip(int skip)`
`AVQuery<T>`	`whereContainedIn(java.lang.String key, java.util.Collection<? extends java.lang.Object> values)` Add a constraint to the query that requires a particular key's value to be contained in the provided list of values.
`AVQuery<T>`	`whereContains(java.lang.String key, java.lang.String substring)` Add a constraint for finding string values that contain a provided string.
`AVQuery<T>`	`whereContainsAll(java.lang.String key, java.util.Collection<?> values)` Add a constraint to the query that requires a particular key's value match another AVQuery.
`AVQuery<T>`	`whereDoesNotExist(java.lang.String key)` Add a constraint for finding objects that do not contain a given key.
`AVQuery<T>`	`whereDoesNotMatchKeyInQuery(java.lang.String key, java.lang.String keyInQuery, AVQuery<?> query)` Add a constraint to the query that requires a particular key's value does not match any value for a key in the results of another AVQuery.
`AVQuery<T>`	`whereDoesNotMatchQuery(java.lang.String key, AVQuery<?> query)` Add a constraint to the query that requires a particular key's value does not match another AVQuery.
`AVQuery<T>`	`whereEndsWith(java.lang.String key, java.lang.String suffix)` Add a constraint for finding string values that end with a provided string.
`AVQuery<T>`	`whereEqualTo(java.lang.String key, java.lang.Object value)` Add a constraint to the query that requires a particular key's value to be equal to the provided value.
`AVQuery<T>`	`whereExists(java.lang.String key)` Add a constraint for finding objects that contain the given key.
`AVQuery<T>`	`whereGreaterThan(java.lang.String key, java.lang.Object value)` Add a constraint to the query that requires a particular key's value to be greater than the provided value. w
`AVQuery<T>`	`whereGreaterThanOrEqualTo(java.lang.String key, java.lang.Object value)` Add a constraint to the query that requires a particular key's value to be greater or equal to than the provided value.
`AVQuery<T>`	`whereLessThan(java.lang.String key, java.lang.Object value)` Add a constraint to the query that requires a particular key's value to be less than the provided value.
`AVQuery<T>`	`whereLessThanOrEqualTo(java.lang.String key, java.lang.Object value)` Add a constraint to the query that requires a particular key's value to be less or equal to than the provided value.
`AVQuery<T>`	`whereMatches(java.lang.String key, java.lang.String regex)` Add a regular expression constraint for finding string values that match the provided regular expression.
`AVQuery<T>`	`whereMatches(java.lang.String key, java.lang.String regex, java.lang.String modifiers)` Add a regular expression constraint for finding string values that match the provided regular expression.
`AVQuery<T>`	`whereMatchesKeyInQuery(java.lang.String key, java.lang.String keyInQuery, AVQuery<?> query)` Add a constraint to the query that requires a particular key's value matches a value for a key in the results of another AVQuery
`AVQuery<T>`	`whereMatchesQuery(java.lang.String key, AVQuery<?> query)` Add a constraint to the query that requires a particular key's value match another AVQuery.
`AVQuery<T>`	`whereNear(java.lang.String key, AVGeoPoint point)` Add a proximity based constraint for finding objects with key point values near the point given.
`AVQuery<T>`	`whereNotContainedIn(java.lang.String key, java.util.Collection<? extends java.lang.Object> values)` Add a constraint to the query that requires a particular key's value not be contained in the provided list of values.
`AVQuery<T>`	`whereNotEqualTo(java.lang.String key, java.lang.Object value)` Add a constraint to the query that requires a particular key's value to be not equal to the provided value.
`AVQuery<T>`	`whereSizeEqual(java.lang.String key, int size)` 添加查询约束条件，查找key类型是数组，该数组的长度匹配提供的数值。
`AVQuery<T>`	`whereStartsWith(java.lang.String key, java.lang.String prefix)` Add a constraint for finding string values that start with a provided string.
`AVQuery<T>`	`whereWithinGeoBox(java.lang.String key, AVGeoPoint southwest, AVGeoPoint northeast)` Add a constraint to the query that requires a particular key's coordinates be contained within a given rectangular geographic bounding box.
`AVQuery<T>`	`whereWithinKilometers(java.lang.String key, AVGeoPoint point, double maxDistance)` Add a proximity based constraint for finding objects with key point values near the point given and within the maximum distance given.
`AVQuery<T>`	`whereWithinKilometers(java.lang.String key, AVGeoPoint point, double maxDistance, double minDistance)` Add a proximity based constraint for finding objects with key point values near the point given and within the given ring area Radius of earth used is 6371.0 kilometers.
`AVQuery<T>`	`whereWithinMiles(java.lang.String key, AVGeoPoint point, double maxDistance)` Add a proximity based constraint for finding objects with key point values near the point given and within the maximum distance given.
`AVQuery<T>`	`whereWithinMiles(java.lang.String key, AVGeoPoint point, double maxDistance, double minDistance)` Add a proximity based constraint for finding objects with key point values near the point given and within the given ring.
`AVQuery<T>`	`whereWithinRadians(java.lang.String key, AVGeoPoint point, double maxDistance)` Add a proximity based constraint for finding objects with key point values near the point given and within the maximum distance given.
`AVQuery<T>`	`whereWithinRadians(java.lang.String key, AVGeoPoint point, double maxDistance, double minDistance)` Add a proximity based constraint for finding objects with key point values near the point given and within the maximum distance given.

从类继承的方法 java.lang.Object
equals, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

- 构造器详细资料
  - AVQuery
```
public AVQuery(java.lang.String theClassName)
```
    Constructs a query. A default query with no further parameters will retrieve all AVObjects of the provided class.
    
    参数:
    
    theClassName - The name of the class to retrieve AVObjects for.
- 方法详细资料
  - getClassName
```
public java.lang.String getClassName()
```
    Accessor for the class name.
  - setClassName
```
public AVQuery<T> setClassName(java.lang.String className)
```
  - getCachePolicy
```
public AVQuery.CachePolicy getCachePolicy()
```
    Accessor for the caching policy.
  - setCachePolicy
```
public AVQuery<T> setCachePolicy(AVQuery.CachePolicy cachePolicy)
```
    Change the caching policy of this query.
    
    返回:
    
    this query.
  - getPolicy
```
public AVQuery.CachePolicy getPolicy()
```
  - setPolicy
```
public AVQuery<T> setPolicy(AVQuery.CachePolicy policy)
```
    Change the caching policy of this query.
    
    返回:
    
    this query.
  - getMaxCacheAge
```
public long getMaxCacheAge()
```
    Gets the maximum age of cached data that will be considered in this query. The returned value is in milliseconds
  - setMaxCacheAge
```
public AVQuery<T> setMaxCacheAge(long maxCacheAge)
```
    Sets the maximum age of cached data that will be considered in this query.
    
    返回:
    
    this query.
  - isTrace
```
public boolean isTrace()
```
  - setTrace
```
public AVQuery<T> setTrace(boolean trace)
```
    Turn on performance tracing of finds. If performance tracing is already turned on this does nothing. In general you don't need to call trace.
    
    返回:
    
    this query.
  - clone
```
public AVQuery clone()
```
    clone a new query object, which fully same to this.
    
    覆盖:
    
    clone 在类中 java.lang.Object
    
    返回:
    
    a new AVQuery object.
  - getQuery
```
public static <T extends AVObject> AVQuery<T> getQuery(java.lang.String theClassName)
```
    Constructs a query. A default query with no further parameters will retrieve all AVObjects of the provided class.
    
    参数:
    
    theClassName - The name of the class to retrieve AVObjects for.
    
    返回:
    
    the query object.
  - getQuery
```
public static <T extends AVObject> AVQuery<T> getQuery(java.lang.Class<T> clazz)
```
    Create a AVQuery with special sub-class.
    
    参数:
    
    clazz - The AVObject subclass
    
    返回:
    
    The AVQuery
  - cancel
```
@Deprecated
public void cancel()
```
    已过时。
    
    Cancels the current network request (if one is running).
  - clearAllCachedResults
```
public static void clearAllCachedResults()
```
    Clears the cached result for all queries.
  - clearCachedResult
```
public void clearCachedResult()
```
    Removes the previously cached result for this query, forcing the next find() to hit the network. If there is no cached result for this query, then this is a no-op.
  - getUserQuery
```
@Deprecated
public static AVQuery<AVUser> getUserQuery()
```
    已过时。
    
    Deprecated. Please use AVUser.getQuery() instead. Constructs a query for AVUsers
    
    另请参阅:
    
    AVUser.getQuery()
  - hasCachedResult
```
public boolean hasCachedResult()
```
    Returns whether or not this query has a cached result.
  - getLimit
```
public int getLimit()
```
    Accessor for the limit.
  - setLimit
```
public AVQuery<T> setLimit(int limit)
```
    Controls the maximum number of results that are returned. Setting a negative limit denotes retrieval without a limit. The default limit is 100, with a maximum of 1000 results being returned at a time.
    
    返回:
    
    this query.
  - limit
```
public AVQuery<T> limit(int limit)
```
    参数:
    
    limit -
    
    返回:
    
    this query.
    
    另请参阅:
    
    setLimit(int)
  - skip
```
public AVQuery<T> skip(int skip)
```
    参数:
    
    skip -
    
    返回:
    
    this query.
    
    另请参阅:
    
    setSkip(int)
  - getSkip
```
public int getSkip()
```
    Accessor for the skip value.
  - setSkip
```
public AVQuery<T> setSkip(int skip)
```
    Controls the number of results to skip before returning any results. This is useful for pagination. Default is to skip zero results.
    
    返回:
    
    this query
  - getOrder
```
public java.lang.String getOrder()
```
  - setOrder
```
public AVQuery<T> setOrder(java.lang.String order)
```
    Set query order fields.
    
    参数:
    
    order -
    
    返回:
    
    this query.
  - order
```
public AVQuery<T> order(java.lang.String order)
```
    参数:
    
    order -
    
    返回:
    
    另请参阅:
    
    setOrder(String)
  - addAscendingOrder
```
public AVQuery<T> addAscendingOrder(java.lang.String key)
```
    Also sorts the results in ascending order by the given key. The previous sort keys have precedence over this key.
    
    参数:
    
    key - The key to order by
    
    返回:
    
    Returns the query so you can chain this call.
  - addDescendingOrder
```
public AVQuery<T> addDescendingOrder(java.lang.String key)
```
    Also sorts the results in descending order by the given key. The previous sort keys have precedence over this key.
    
    参数:
    
    key - The key to order by
    
    返回:
    
    Returns the query so you can chain this call.
  - includeACL
```
public AVQuery<T> includeACL(boolean includeACL)
```
    Include ACL attribute.
    
    参数:
    
    includeACL - need ACL attribute returned or not.
  - include
```
public AVQuery<T> include(java.lang.String key)
```
    Include nested AVObjects for the provided key. You can use dot notation to specify which fields in the included object that are also fetched.
    
    参数:
    
    key - The key that should be included.
  - selectKeys
```
public AVQuery<T> selectKeys(java.util.Collection<java.lang.String> keys)
```
    Restrict the fields of returned AVObjects to only include the provided keys. If this is called multiple times, then all of the keys specified in each of the calls will be included.
    
    参数:
    
    keys - The set of keys to include in the result.
  - orderByAscending
```
public AVQuery<T> orderByAscending(java.lang.String key)
```
    Sorts the results in ascending order by the given key.
    
    参数:
    
    key - The key to order by.
    
    返回:
    
    Returns the query, so you can chain this call.
  - orderByDescending
```
public AVQuery<T> orderByDescending(java.lang.String key)
```
    Sorts the results in descending order by the given key.
    
    参数:
    
    key - The key to order by.
    
    返回:
    
    Returns the query, so you can chain this call.
  - whereContainedIn
```
public AVQuery<T> whereContainedIn(java.lang.String key,
                                   java.util.Collection<? extends java.lang.Object> values)
```
    Add a constraint to the query that requires a particular key's value to be contained in the provided list of values.
    
    参数:
    
    key - The key to check.
    
    values - The values that will match.
    
    返回:
    
    Returns the query, so you can chain this call.
  - whereContains
```
public AVQuery<T> whereContains(java.lang.String key,
                                java.lang.String substring)
```
    Add a constraint for finding string values that contain a provided string. This will be slow for large datasets.
    
    参数:
    
    key - The key that the string to match is stored in.
    
    substring - The substring that the value must contain.
    
    返回:
    
    Returns the query, so you can chain this call.
  - whereSizeEqual
```
public AVQuery<T> whereSizeEqual(java.lang.String key,
                                 int size)
```
    添加查询约束条件，查找key类型是数组，该数组的长度匹配提供的数值。
    
    参数:
    
    key - 查询的key
    
    size - 数组的长度
    
    返回:
    
    从以下版本开始:
    
    2.0.2
  - whereContainsAll
```
public AVQuery<T> whereContainsAll(java.lang.String key,
                                   java.util.Collection<?> values)
```
    Add a constraint to the query that requires a particular key's value match another AVQuery. This only works on keys whose values are AVObjects or lists of AVObjects. Add a constraint to the query that requires a particular key's value to contain every one of the provided list of values.
    
    参数:
    
    key - The key to check. This key's value must be an array.
    
    values - The values that will match.
    
    返回:
    
    Returns the query, so you can chain this call.
  - whereDoesNotExist
```
public AVQuery<T> whereDoesNotExist(java.lang.String key)
```
    Add a constraint for finding objects that do not contain a given key.
    
    参数:
    
    key - The key that should not exist
  - whereEndsWith
```
public AVQuery<T> whereEndsWith(java.lang.String key,
                                java.lang.String suffix)
```
    Add a constraint for finding string values that end with a provided string. This will be slow for large datasets.
    
    参数:
    
    key - The key that the string to match is stored in.
    
    suffix - The substring that the value must end with.
    
    返回:
    
    Returns the query, so you can chain this call.
  - whereEqualTo
```
public AVQuery<T> whereEqualTo(java.lang.String key,
                               java.lang.Object value)
```
    Add a constraint to the query that requires a particular key's value to be equal to the provided value.
    
    参数:
    
    key - The key to check.
    
    value - The value that the AVObject must contain.
    
    返回:
    
    Returns the query, so you can chain this call.
  - whereExists
```
public AVQuery<T> whereExists(java.lang.String key)
```
    Add a constraint for finding objects that contain the given key.
    
    参数:
    
    key - The key that should exist.
  - whereGreaterThan
```
public AVQuery<T> whereGreaterThan(java.lang.String key,
                                   java.lang.Object value)
```
    Add a constraint to the query that requires a particular key's value to be greater than the provided value. w
    
    参数:
    
    key - The key to check.
    
    value - The value that provides an lower bound.
    
    返回:
    
    Returns the query, so you can chain this call.
  - whereGreaterThanOrEqualTo
```
public AVQuery<T> whereGreaterThanOrEqualTo(java.lang.String key,
                                            java.lang.Object value)
```
    Add a constraint to the query that requires a particular key's value to be greater or equal to than the provided value.
    
    参数:
    
    key - The key to check.
    
    value - The value that provides an lower bound.
    
    返回:
    
    Returns the query, so you can chain this call.
  - whereLessThan
```
public AVQuery<T> whereLessThan(java.lang.String key,
                                java.lang.Object value)
```
    Add a constraint to the query that requires a particular key's value to be less than the provided value.
    
    参数:
    
    key - The key to check.
    
    value - The value that provides an upper bound.
    
    返回:
    
    Returns the query, so you can chain this call.
  - whereLessThanOrEqualTo
```
public AVQuery<T> whereLessThanOrEqualTo(java.lang.String key,
                                         java.lang.Object value)
```
    Add a constraint to the query that requires a particular key's value to be less or equal to than the provided value.
    
    参数:
    
    key - The key to check.
    
    value - The value that provides an lower bound.
    
    返回:
    
    Returns the query, so you can chain this call.
  - whereMatches
```
public AVQuery<T> whereMatches(java.lang.String key,
                               java.lang.String regex)
```
    Add a regular expression constraint for finding string values that match the provided regular expression. This may be slow for large datasets.
    
    参数:
    
    key - The key that the string to match is stored in.
    
    regex - The regular expression pattern to match.
    
    返回:
    
    Returns the query, so you can chain this call.
  - whereMatches
```
public AVQuery<T> whereMatches(java.lang.String key,
                               java.lang.String regex,
                               java.lang.String modifiers)
```
    Add a regular expression constraint for finding string values that match the provided regular expression. This may be slow for large datasets.
    
    参数:
    
    key - The key that the string to match is stored in.
    
    regex - The regular expression pattern to match.
    
    modifiers - Any of the following supported PCRE modifiers: i - Case insensitive search m - Search across multiple lines of input
    
    返回:
  - whereNear
```
public AVQuery<T> whereNear(java.lang.String key,
                            AVGeoPoint point)
```
    Add a proximity based constraint for finding objects with key point values near the point given.
    
    参数:
    
    key - The key that the AVGeoPoint is stored in.
    
    point - The reference AVGeoPoint that is used.
    
    返回:
    
    Returns the query, so you can chain this call.
  - whereNotContainedIn
```
public AVQuery<T> whereNotContainedIn(java.lang.String key,
                                      java.util.Collection<? extends java.lang.Object> values)
```
    Add a constraint to the query that requires a particular key's value not be contained in the provided list of values.
    
    参数:
    
    key - The key to check.
    
    values - The values that will not match.
    
    返回:
    
    Returns the query, so you can chain this call.
  - whereNotEqualTo
```
public AVQuery<T> whereNotEqualTo(java.lang.String key,
                                  java.lang.Object value)
```
    Add a constraint to the query that requires a particular key's value to be not equal to the provided value.
    
    参数:
    
    key - The key to check.
    
    value - The value that must not be equalled.
    
    返回:
    
    Returns the query, so you can chain this call.
  - whereStartsWith
```
public AVQuery<T> whereStartsWith(java.lang.String key,
                                  java.lang.String prefix)
```
    Add a constraint for finding string values that start with a provided string. This query will use the backend index, so it will be fast even for large datasets.
    
    参数:
    
    key - The key that the string to match is stored in.
    
    prefix - The substring that the value must start with.
    
    返回:
    
    Returns the query, so you can chain this call.
  - whereWithinGeoBox
```
public AVQuery<T> whereWithinGeoBox(java.lang.String key,
                                    AVGeoPoint southwest,
                                    AVGeoPoint northeast)
```
    Add a constraint to the query that requires a particular key's coordinates be contained within a given rectangular geographic bounding box.
    
    参数:
    
    key - The key to be constrained.
    
    southwest - The lower-left inclusive corner of the box.
    
    northeast - The upper-right inclusive corner of the box.
    
    返回:
    
    Returns the query, so you can chain this call.
  - whereWithinKilometers
```
public AVQuery<T> whereWithinKilometers(java.lang.String key,
                                        AVGeoPoint point,
                                        double maxDistance)
```
    Add a proximity based constraint for finding objects with key point values near the point given and within the maximum distance given. Radius of earth used is 6371.0 kilometers.
    
    参数:
    
    key - The key that the AVGeoPoint is stored in.
    
    point - The reference AVGeoPoint that is used.
    
    maxDistance - Maximum distance (in kilometers) of results to return.
    
    返回:
  - whereWithinKilometers
```
public AVQuery<T> whereWithinKilometers(java.lang.String key,
                                        AVGeoPoint point,
                                        double maxDistance,
                                        double minDistance)
```
    Add a proximity based constraint for finding objects with key point values near the point given and within the given ring area Radius of earth used is 6371.0 kilometers.
    
    参数:
    
    key - The key that the AVGeoPoint is stored in.
    
    point - The reference AVGeoPoint that is used.
    
    maxDistance - outer radius of the given ring in kilometers
    
    minDistance - inner radius of the given ring in kilometers
    
    返回:
  - whereWithinMiles
```
public AVQuery<T> whereWithinMiles(java.lang.String key,
                                   AVGeoPoint point,
                                   double maxDistance)
```
    Add a proximity based constraint for finding objects with key point values near the point given and within the maximum distance given. Radius of earth used is 3958.8 miles.
  - whereWithinMiles
```
public AVQuery<T> whereWithinMiles(java.lang.String key,
                                   AVGeoPoint point,
                                   double maxDistance,
                                   double minDistance)
```
    Add a proximity based constraint for finding objects with key point values near the point given and within the given ring. Radius of earth used is 3958.8 miles.
    
    参数:
    
    key -
    
    point -
    
    maxDistance -
    
    minDistance -
    
    返回:
  - whereWithinRadians
```
public AVQuery<T> whereWithinRadians(java.lang.String key,
                                     AVGeoPoint point,
                                     double maxDistance)
```
    Add a proximity based constraint for finding objects with key point values near the point given and within the maximum distance given.
    
    参数:
    
    key - The key that the AVGeoPoint is stored in.
    
    point - The reference AVGeoPoint that is used.
    
    maxDistance - Maximum distance (in radians) of results to return.
    
    返回:
    
    Returns the query, so you can chain this call.
  - whereWithinRadians
```
public AVQuery<T> whereWithinRadians(java.lang.String key,
                                     AVGeoPoint point,
                                     double maxDistance,
                                     double minDistance)
```
    Add a proximity based constraint for finding objects with key point values near the point given and within the maximum distance given.
    
    参数:
    
    key -
    
    point -
    
    maxDistance -
    
    minDistance -
    
    返回:
  - or
```
public static <T extends AVObject> AVQuery<T> or(java.util.List<AVQuery<T>> queries)
```
    Constructs a query that is the or of the given queries.
    
    参数:
    
    queries - The list of AVQueries to 'or' together
    
    返回:
    
    A AVQuery that is the 'or' of the passed in queries
  - and
```
public static <T extends AVObject> AVQuery<T> and(java.util.List<AVQuery<T>> queries)
```
  - whereMatchesKeyInQuery
```
public AVQuery<T> whereMatchesKeyInQuery(java.lang.String key,
                                         java.lang.String keyInQuery,
                                         AVQuery<?> query)
```
    Add a constraint to the query that requires a particular key's value matches a value for a key in the results of another AVQuery
    
    参数:
    
    key - The key whose value is being checked
    
    keyInQuery - The key in the objects from the sub query to look in
    
    query - The sub query to run
    
    返回:
    
    Returns the query so you can chain this call.
  - whereMatchesQuery
```
public AVQuery<T> whereMatchesQuery(java.lang.String key,
                                    AVQuery<?> query)
```
    Add a constraint to the query that requires a particular key's value match another AVQuery. This only works on keys whose values are AVObjects or lists of AVObjects.
    
    参数:
    
    key - The key to check.
    
    query - The query that the value should match
    
    返回:
    
    Returns the query so you can chain this call.
  - whereDoesNotMatchKeyInQuery
```
public AVQuery<T> whereDoesNotMatchKeyInQuery(java.lang.String key,
                                              java.lang.String keyInQuery,
                                              AVQuery<?> query)
```
    Add a constraint to the query that requires a particular key's value does not match any value for a key in the results of another AVQuery.
    
    参数:
    
    key - The key whose value is being checked and excluded
    
    keyInQuery - The key in the objects from the sub query to look in
    
    query - The sub query to run
    
    返回:
    
    Returns the query so you can chain this call.
  - whereDoesNotMatchQuery
```
public AVQuery<T> whereDoesNotMatchQuery(java.lang.String key,
                                         AVQuery<?> query)
```
    Add a constraint to the query that requires a particular key's value does not match another AVQuery. This only works on keys whose values are AVObjects or lists of AVObjects.
    
    参数:
    
    key - The key to check.
    
    query - The query that the value should not match
    
    返回:
    
    Returns the query so you can chain this call.
  - doCloudQuery
```
public static AVCloudQueryResult doCloudQuery(java.lang.String cql,
                                              java.lang.Object... params)
                                       throws java.lang.Exception
```
    通过cql查询对象
    
    参数:
    
    cql - cql语句
    
    params - 查询参数列表
    
    返回:
    
    抛出:
    
    java.lang.Exception
  - doCloudQuery
```
public static AVCloudQueryResult doCloudQuery(java.lang.String cql,
                                              java.lang.Class<? extends AVObject> clazz,
                                              java.lang.Object... params)
                                       throws java.lang.Exception
```
    通过cql查询对象
    
    参数:
    
    cql -
    
    clazz -
    
    params - 查询参数列表
    
    返回:
    
    抛出:
    
    java.lang.Exception
  - doCloudQueryInBackground
```
public static void doCloudQueryInBackground(java.lang.String cql,
                                            CloudQueryCallback<AVCloudQueryResult> callback,
                                            java.lang.Object... params)
```
    通过cql查询对象
    
    参数:
    
    cql -
    
    callback -
    
    params - 查询参数列表
  - doCloudQueryInBackground
```
public static void doCloudQueryInBackground(java.lang.String cql,
                                            CloudQueryCallback<AVCloudQueryResult> callback,
                                            java.lang.Class<? extends AVObject> clazz,
                                            java.lang.Object... params)
```
    通过cql查询对象
    
    参数:
    
    cql -
    
    callback -
    
    clazz -
    
    params -
  - doCloudQuery
```
public static AVCloudQueryResult doCloudQuery(java.lang.String cql)
                                       throws java.lang.Exception
```
    通过cql查询对象请在异步线程中调用此方法，在UI线程中，请调用doCloudQueryInBackground方法
    
    参数:
    
    cql -
    
    返回:
    
    抛出:
    
    java.lang.Exception
  - doCloudQuery
```
public static AVCloudQueryResult doCloudQuery(java.lang.String cql,
                                              java.lang.Class<? extends AVObject> clazz)
                                       throws java.lang.Exception
```
    通过cql查询对象请在异步线程中调用此方法，在UI线程中，请调用doCloudQueryInBackground方法
    
    参数:
    
    cql -
    
    clazz -
    
    返回:
    
    抛出:
    
    java.lang.Exception
  - doCloudQueryInBackground
```
public static void doCloudQueryInBackground(java.lang.String cql,
                                            CloudQueryCallback<AVCloudQueryResult> callback)
```
    通过cql查询对象
    
    参数:
    
    cql -
    
    callback -
  - doCloudQueryInBackground
```
public static void doCloudQueryInBackground(java.lang.String cql,
                                            CloudQueryCallback<AVCloudQueryResult> callback,
                                            java.lang.Class<? extends AVObject> clazz)
```
    通过cql查询对象
    
    参数:
    
    cql -
    
    callback -
    
    clazz -
  - findInBackground
```
public void findInBackground(FindCallback<T> callback)
```
    Retrieves a list of AVObjects that satisfy this query from the server in a background thread. This is preferable to using find(), unless your code is already running in a background thread.
    
    参数:
    
    callback - callback.done(objectList, e) is called when the find completes.
  - get
```
public T get(java.lang.String theObjectId)
      throws AVException
```
    Constructs a AVObject whose id is already known by fetching data from the server. This mutates the AVQuery.
    
    参数:
    
    theObjectId - Object id of the AVObject to fetch.
    
    抛出:
    
    AVException
  - getFirst
```
public T getFirst()
           throws AVException
```
    Retrieves at most one AVObject that satisfies this query. Uses the network and/or the cache, depending on the cache policy. This mutates the AVQuery.
    
    返回:
    
    A AVObject obeying the conditions set in this query, or null if none found.
    
    抛出:
    
    AVException
  - getFirstInBackground
```
public void getFirstInBackground(GetCallback<T> callback)
```
    Retrieves at most one AVObject that satisfies this query from the server in a background thread. This is preferable to using getFirst(), unless your code is already running in a background thread. This mutates the AVQuery.
    
    参数:
    
    callback - callback.done(object, e) is called when the find completes.
  - getInBackground
```
public void getInBackground(java.lang.String objectId,
                            GetCallback<T> callback)
```
    Constructs a AVObject whose id is already known by fetching data from the server in a background thread. This does not use caching. This is preferable to using the AVObject(className, objectId) constructor, unless your code is already running in a background thread.
    
    参数:
    
    objectId - Object id of the AVObject to fetch
    
    callback - callback.done(object, e) will be called when the fetch completes.
  - count
```
public int count()
          throws AVException
```
    Counts the number of objects that match this query. This does not use caching.
    
    抛出:
    
    AVException
  - countInBackground
```
public void countInBackground(CountCallback callback)
```
    Counts the number of objects that match this query in a background thread. This does not use caching.
    
    参数:
    
    callback - callback.done(count, e) will be called when the count completes.
  - find
```
public java.util.List<T> find()
                       throws AVException
```
    Retrieves a list of AVObjects that satisfy this query. Uses the network and/or the cache, depending on the cache policy.
    
    返回:
    
    A list of all AVObjects obeying the conditions set in this query.
    
    抛出:
    
    AVException
  - deleteAll
```
public void deleteAll()
               throws AVException
```
    Delete all objects that are retrieved by this query.
    
    抛出:
    
    AVException
    
    从以下版本开始:
    
    1.4.0
  - deleteAllInBackground
```
public void deleteAllInBackground(DeleteCallback cb)
```
    Delete all objects that are retrieved by this query in background.
    
    参数:
    
    cb - The delete callback.
    
    从以下版本开始:
    
    1.4.0

类 AVQuery<T extends AVObject>

嵌套类概要

构造器概要

方法概要

从类继承的方法 java.lang.Object

构造器详细资料

AVQuery

方法详细资料

getClassName

setClassName

getCachePolicy

setCachePolicy

getPolicy

setPolicy

getMaxCacheAge

setMaxCacheAge

isTrace

setTrace

clone

getQuery

getQuery

cancel

clearAllCachedResults

clearCachedResult

getUserQuery

hasCachedResult

getLimit

setLimit

limit

skip

getSkip

setSkip

getOrder

setOrder

order

addAscendingOrder

addDescendingOrder

includeACL

include

selectKeys

orderByAscending

orderByDescending

whereContainedIn

whereContains

whereSizeEqual

whereContainsAll

whereDoesNotExist

whereEndsWith

whereEqualTo

whereExists

whereGreaterThan

whereGreaterThanOrEqualTo

whereLessThan

whereLessThanOrEqualTo

whereMatches

whereMatches

whereNear

whereNotContainedIn

whereNotEqualTo

whereStartsWith

whereWithinGeoBox

whereWithinKilometers

whereWithinKilometers

whereWithinMiles

whereWithinMiles

whereWithinRadians

whereWithinRadians

or

and

whereMatchesKeyInQuery

whereMatchesQuery

whereDoesNotMatchKeyInQuery

whereDoesNotMatchQuery

doCloudQuery

doCloudQuery

doCloudQueryInBackground

doCloudQueryInBackground

doCloudQuery

doCloudQuery

doCloudQueryInBackground