AVObject (leancloud-common 0.1.13 API)

java.lang.Object
- com.avos.avoscloud.AVObject

All Implemented Interfaces:

android.os.Parcelable

Direct Known Subclasses:

AVRole, AVStatus, AVUser
```
public class AVObject
extends Object
implements android.os.Parcelable
```
The AVObject is a local representation of data that can be saved and retrieved from the AVOSCloud cloud.

The basic workflow for creating new data is to construct a new AVObject, use put() to fill it with data, and then use save() to persist to the database.

The basic workflow for accessing existing data is to use a AVQuery to specify which existing data to retrieve.

Nested Class Summary

Nested Classes
Modifier and Type Class and Description

static class AVObject.AVObjectCreator

static class AVObject.Hook
- Nested classes/interfaces inherited from interface android.os.Parcelable
  android.os.Parcelable.ClassLoaderCreator<T>, android.os.Parcelable.Creator<T>

Nested Classes
Modifier and Type	Class and Description
`static class`	`AVObject.AVObjectCreator`
`static class`	`AVObject.Hook`

Field Summary

Fields
Modifier and Type	Field and Description
`protected AVACL`	`acl`
`static String`	`CREATED_AT`
`protected String`	`createdAt`
`static android.os.Parcelable.Creator`	`CREATOR`
`static Set<String>`	`INVALID_KEYS`
`static String`	`OBJECT_ID`
`protected String`	`objectId`
`protected boolean`	`requestStatistic`
`static String`	`UPDATED_AT`
`protected String`	`updatedAt`

Fields inherited from interface android.os.Parcelable
CONTENTS_FILE_DESCRIPTOR, PARCELABLE_WRITE_RETURN_VALUE

Constructor Summary

Constructors
Constructor and Description

AVObject()

AVObject(android.os.Parcel in)

AVObject(String theClassName)
Constructs a new AVObject with no data in it.

Constructors
Constructor and Description
`AVObject()`
`AVObject(android.os.Parcel in)`
`AVObject(String theClassName)` Constructs a new AVObject with no data in it.

Method Summary

All Methods Static Methods Instance Methods Concrete Methods
Modifier and Type	Method and Description
`void`	`add(String key, Object value)` Atomically adds an object to the end of the array associated with a given key.
`void`	`addAll(String key, Collection<?> values)` Atomically adds the objects contained in a Collection to the end of the array associated with a given key.
`void`	`addAllUnique(String key, Collection<?> values)` Atomically adds the objects contained in a Collection to the array associated with a given key, only adding elements which are not already present in the array.
`void`	`addUnique(String key, Object value)` Atomically adds an object to the array associated with a given key, only if it is not already present in the array.
`protected boolean`	`alwaysSaveAllKeyValues()`
`protected boolean`	`alwaysUsePost()`
`protected void`	`buildBatchParameterForNonSavedObject(List<AVObject> unSavedChildren, List requestQueue)`
`protected static <T extends AVObject> T`	`cast(AVObject object, Class<T> clazz)`
`boolean`	`containsKey(String key)` Whether this object has a particular key.
`protected void`	`copyFromJson(String jsonStr)`
`protected void`	`copyFromMap(Map map)`
`static AVObject`	`create(String className)` Creates a new AVObject based upon a class name.
`static <T extends AVObject> T`	`createWithoutData(Class<T> clazz, String objectId)` Creates a reference to an existing AVObject subclass instance for use in creating associations between AVObjects.
`static AVObject`	`createWithoutData(String className, String objectId)` Creates a reference to an existing AVObject for use in creating associations between AVObjects.
`void`	`delete()` Deletes this object on the server.
`void`	`delete(AVDeleteOption option)` Deletes this object on the server.
`static void`	`deleteAll(Collection<? extends AVObject> objects)` Delete AVObject in batch.The objects class name must be the same.
`static void`	`deleteAllInBackground(Collection<? extends AVObject> objects, DeleteCallback deleteCallback)` Delete AVObject in batch with callback in background.The objects class name must be the same.
`void`	`deleteEventually()` Deletes this object from the server at some unspecified time in the future, even if AVOSCloud is currently inaccessible.
`void`	`deleteEventually(DeleteCallback callback)` Deletes this object from the server at some unspecified time in the future, even if AVOSCloud is currently inaccessible.
`void`	`deleteInBackground()` Deletes this object on the server in a background thread.
`void`	`deleteInBackground(AVDeleteOption option)` Deletes this object on the server in a background thread.
`void`	`deleteInBackground(AVDeleteOption option, DeleteCallback callback)` Deletes this object on the server in a background thread.
`void`	`deleteInBackground(DeleteCallback callback)` Deletes this object on the server in a background thread.
`int`	`describeContents()`
`void`	`disableAfterHook()`
`void`	`disableBeforeHook()`
`boolean`	`equals(Object obj)`
`AVObject`	`fetch()`
`AVObject`	`fetch(String includeKeys)`
`static List<AVObject>`	`fetchAll(List<AVObject> objects)` Fetches all the objects in the provided list.
`static List<AVObject>`	`fetchAllIfNeeded(List<AVObject> objects)` Fetches all the objects that don't have data in the provided list.
`static void`	`fetchAllIfNeededInBackground(List<AVObject> objects, FindCallback<AVObject> callback)` Fetches all the objects that don't have data in the provided list in the background
`static void`	`fetchAllInBackground(List<AVObject> objects, FindCallback<AVObject> callback)` Fetches all the objects in the provided list in the background
`AVObject`	`fetchIfNeeded()`
`AVObject`	`fetchIfNeeded(String includeKeys)`
`void`	`fetchIfNeededInBackground(GetCallback<AVObject> callback)` If this AVObject has not been fetched (i.e.
`void`	`fetchIfNeededInBackground(String includeKeys, GetCallback<AVObject> callback)` If this AVObject has not been fetched (i.e.
`void`	`fetchInBackground(GetCallback<AVObject> callback)` Fetches this object with the data from the server in a background thread.
`void`	`fetchInBackground(String includeKeys, GetCallback<AVObject> callback)` Fetches this object with the data from the server in a background thread.
`Object`	`get(String key)` Access a value.
`AVACL`	`getACL()` Access the AVACL governing this object.
`<T extends AVFile> T`	`getAVFile(String key)` Access a AVFile value.
`AVGeoPoint`	`getAVGeoPoint(String key)` Access a AVGeoPoint value.
`<T extends AVObject> T`	`getAVObject(String key)` Access a AVObject value.
`<T extends AVObject> T`	`getAVObject(String key, Class<T> clazz)`
`<T extends AVUser> T`	`getAVUser(String key)` Access a AVUser value.
`<T extends AVUser> T`	`getAVUser(String key, Class<T> clazz)` Access a AVUser subclass value.
`boolean`	`getBoolean(String key)` Access a boolean value.
`byte[]`	`getBytes(String key)` Access a byte array value.
`String`	`getClassName()` Accessor to the class name.
`Date`	`getCreatedAt()` This reports time as the server sees it, so that if you create a AVObject, then wait a while, and then call save(), the creation time will be the time of the first save() call rather than the time the object was created locally.
`Date`	`getDate(String key)` Access a Date value.
`double`	`getDouble(String key)` Access a double value.
`int`	`getInt(String key)` Access an int value.
`org.json.JSONArray`	`getJSONArray(String key)` Access a JSONArray value.
`org.json.JSONObject`	`getJSONObject(String key)` Access a JSONObject value.
`List`	`getList(String key)` Access a List value
`<T extends AVObject> List<T>`	`getList(String key, Class<T> clazz)` 获得一个指定类型的List值
`long`	`getLong(String key)` Access a long value.
`<V> Map<String,V>`	`getMap(String key)` Access a Map value
`Number`	`getNumber(String key)` Access a numerical value.
`String`	`getObjectId()` Accessor to the object id.
`static <T extends AVObject> AVQuery<T>`	`getQuery(Class<T> clazz)` Create a AVQuery with special sub-class.
`<T extends AVObject> AVRelation<T>`	`getRelation(String key)` Access or create a Relation value for a key
`String`	`getString(String key)` Access a string value.
`Date`	`getUpdatedAt()` This reports time as the server sees it, so that if you make changes to a AVObject, then wait a while, and then call save(), the updated time will be the time of the save() call rather than the time the object was changed locally.
`String`	`getUuid()`
`boolean`	`has(String key)` Whether this object has a particular key.
`int`	`hashCode()`
`boolean`	`hasSameId(AVObject other)`
`protected Map<String,String>`	`headerMap()`
`void`	`ignoreHook(AVObject.Hook hook)`
`void`	`increment(String key)` Atomically increments the given key by 1.
`void`	`increment(String key, Number amount)` Atomically increments the given key by the given number.
`protected String`	`internalClassName()`
`protected String`	`internalId()`
`boolean`	`isDataAvailable()` Gets whether the AVObject has been fetched.
`boolean`	`isFetchWhenSave()`
`Set<String>`	`keySet()` Returns a set view of the keys contained in this object.
`protected void`	`onDataSynchronized()`
`protected void`	`onSaveFailure()`
`protected void`	`onSaveSuccess()`
`static AVObject`	`parseAVObject(String avObjectString)` 通过解析AVObject.toString得到的String对象来获取AVObject对象
`void`	`put(String key, Object value)` Add a key-value pair to this object.
`protected void`	`put(String key, Object value, boolean pending)`
`protected void`	`rebuildInstanceData()`
`void`	`refresh()` Refreshes this object with the data from the server.
`void`	`refresh(String includeKeys)` Refreshes this object with the data from the server.
`void`	`refreshInBackground(RefreshCallback<AVObject> callback)` Refreshes this object with the data from the server in a background thread.
`void`	`refreshInBackground(String includeKeys, RefreshCallback<AVObject> callback)` Refreshes this object with the data from the server in a background thread.
`static <T extends AVObject> void`	`registerSubclass(Class<T> clazz)` Register subclass to AVOSCloud SDK.It must be invocated before AVOSCloud.initialize.
`void`	`remove(String key)` Removes a key from this object's data if it exists.
`void`	`removeAll(String key, Collection<?> values)` Atomically removes all instances of the objects contained in a Collection from the array associated with a given key.
`void`	`save()` Saves this object to the server.
`void`	`save(AVSaveOption option)` Saves this object to the server.
`static void`	`saveAll(List<? extends AVObject> objects)` Saves each object in the provided list.
`static void`	`saveAllInBackground(List<? extends AVObject> objects)` Saves each object in the provided list to the server in a background thread.
`static void`	`saveAllInBackground(List<? extends AVObject> objects, SaveCallback callback)` Saves each object in the provided list to the server in a background thread.
`void`	`saveEventually()` 适用于用户并不关心具体保存到服务器的具体时间，或者数据并不需要时常与服务器发生交互时，可以使用本方法在网络请求遇到异常时，AVOS Cloud会将此类请求保存到本地，等到网络回复正常或者排除故障以后再发送请求被保存下来的请求会按照初始的发送顺序进行发送
`void`	`saveEventually(SaveCallback callback)` 适用于用户并不关心具体保存到服务器的具体时间，或者数据并不需要时常与服务器发生交互时，可以使用本方法在网络请求遇到异常时，AVOS Cloud会将此类请求保存到本地，等到网络回复正常或者排除故障以后再发送请求被保存下来的请求会按照初始的发送顺序进行发送
`static void`	`saveFileBeforeSave(List<AVFile> files, boolean sync, SaveCallback callback)`
`void`	`saveInBackground()` Saves this object to the server in a background thread.
`void`	`saveInBackground(AVSaveOption option)` Saves this object to the server in a background thread.Use this when you do not have code to run on completion of the push.
`void`	`saveInBackground(AVSaveOption option, SaveCallback callback)` Saves this object to the server in a background thread.
`void`	`saveInBackground(SaveCallback callback)` Saves this object to the server in a background thread.
`void`	`setACL(AVACL acl)` Set the AVACL governing this object
`void`	`setFetchWhenSave(boolean fetchWhenSave)`
`void`	`setObjectId(String newObjectId)` Setter for the object id.
`protected boolean`	`shouldThrowException(Throwable error, String content)`
`org.json.JSONObject`	`toJSONObject()` 将本对象转化为一个jsonObject
`String`	`toString()`
`void`	`writeToParcel(android.os.Parcel out, int i)`

Methods inherited from class java.lang.Object
clone, finalize, getClass, notify, notifyAll, wait, wait, wait

- Field Detail
  - CREATED_AT
```
public static final String CREATED_AT
```
    See Also:
    
    Constant Field Values
  - UPDATED_AT
```
public static final String UPDATED_AT
```
    See Also:
    
    Constant Field Values
  - OBJECT_ID
```
public static final String OBJECT_ID
```
    See Also:
    
    Constant Field Values
  - requestStatistic
```
protected boolean requestStatistic
```
  - objectId
```
protected String objectId
```
  - updatedAt
```
protected String updatedAt
```
  - createdAt
```
protected String createdAt
```
  - acl
```
protected transient AVACL acl
```
  - INVALID_KEYS
```
public static final Set<String> INVALID_KEYS
```
  - CREATOR
```
public static final transient android.os.Parcelable.Creator CREATOR
```
- Constructor Detail
  - AVObject
```
public AVObject()
```
  - AVObject
```
public AVObject(String theClassName)
```
    Constructs a new AVObject with no data in it. A AVObject constructed in this way will not have an objectId and will not persist to the database until save() is called.
    
    Class names must be alphanumerical plus underscore, and start with a letter. It is recommended to name classes in CamelCaseLikeThis.
    
    Parameters:
    
    theClassName - The className for this AVObject.
  - AVObject
```
public AVObject(android.os.Parcel in)
```
- Method Detail
  - toString
```
public String toString()
```
    Overrides:
    
    toString in class Object
  - toJSONObject
```
public org.json.JSONObject toJSONObject()
```
    将本对象转化为一个jsonObject
    
    Returns:
    
    jsonObject
  - isFetchWhenSave
```
public boolean isFetchWhenSave()
```
  - setFetchWhenSave
```
public void setFetchWhenSave(boolean fetchWhenSave)
```
  - getUuid
```
public String getUuid()
```
  - registerSubclass
```
public static <T extends AVObject> void registerSubclass(Class<T> clazz)
```
    Register subclass to AVOSCloud SDK.It must be invocated before AVOSCloud.initialize.
    
    Type Parameters:
    
    T - AVObject subclass
    
    Parameters:
    
    clazz - The subclass.
    
    Since:
    
    1.3.6
  - add
```
public void add(String key,
                Object value)
```
    Atomically adds an object to the end of the array associated with a given key.
    
    Parameters:
    
    key - The key.
    
    value - The object to add.
  - addAll
```
public void addAll(String key,
                   Collection<?> values)
```
    Atomically adds the objects contained in a Collection to the end of the array associated with a given key.
    
    Parameters:
    
    key - The key.
    
    values - The objects to add.
  - getQuery
```
public static <T extends AVObject> AVQuery<T> getQuery(Class<T> clazz)
```
    Create a AVQuery with special sub-class.
    
    Type Parameters:
    
    T - AVObject subclass
    
    Parameters:
    
    clazz - The AVObject subclass
    
    Returns:
    
    The AVQuery
  - addAllUnique
```
public void addAllUnique(String key,
                         Collection<?> values)
```
    Atomically adds the objects contained in a Collection to the array associated with a given key, only adding elements which are not already present in the array. The position of the insert is not guaranteed.
    
    Parameters:
    
    key - The key.
    
    values - The objects to add.
  - addUnique
```
public void addUnique(String key,
                      Object value)
```
    Atomically adds an object to the array associated with a given key, only if it is not already present in the array. The position of the insert is not guaranteed.
    
    Parameters:
    
    key - The key.
    
    value - The object to add.
  - containsKey
```
public boolean containsKey(String key)
```
    Whether this object has a particular key. Same as 'has'.
    
    Parameters:
    
    key - The key to check for
    
    Returns:
    
    Returns whether this object contains the key
  - create
```
public static AVObject create(String className)
```
    Creates a new AVObject based upon a class name. If the class name is a special type (e.g. for AVUser), then the appropriate type of AVObject is returned.
    
    Parameters:
    
    className - The class of object to create.
    
    Returns:
    
    A new AVObject for the given class name.
  - parseAVObject
```
public static AVObject parseAVObject(String avObjectString)
                              throws Exception
```
    通过解析AVObject.toString得到的String对象来获取AVObject对象
    
    Parameters:
    
    avObjectString - string got from AVObject.toString
    
    Returns:
    
    parsed AVObject
    
    Throws:
    
    Exception - exception during AVObject parse497
  - createWithoutData
```
public static AVObject createWithoutData(String className,
                                         String objectId)
```
    Creates a reference to an existing AVObject for use in creating associations between AVObjects. Calling AVObject.isDataAvailable() on this object will return false until AVObject.fetchIfNeeded() or AVObject.refresh() has been called. No network request will be made.
    
    Parameters:
    
    className - The object's class.
    
    objectId - The object id for the referenced object.
    
    Returns:
    
    A AVObject without data.
  - createWithoutData
```
public static <T extends AVObject> T createWithoutData(Class<T> clazz,
                                                       String objectId)
                                                throws AVException
```
    Creates a reference to an existing AVObject subclass instance for use in creating associations between AVObjects. Calling AVObject.isDataAvailable() on this object will return false until AVObject.fetchIfNeeded() or AVObject.refresh() has been called. No network request will be made.
    
    Type Parameters:
    
    T - AVObject subclass
    
    Parameters:
    
    clazz - The object's class.
    
    objectId - The object id for the referenced object.
    
    Returns:
    
    A AVObject without data.
    
    Throws:
    
    AVException - exception if clazz instance creation failure
  - delete
```
public void delete()
            throws AVException
```
    Deletes this object on the server. This does not delete or destroy the object locally.
    
    Throws:
    
    AVException - Throws an error if the object does not exist or if the internet fails.
  - delete
```
public void delete(AVDeleteOption option)
            throws AVException
```
    Deletes this object on the server. This does not delete or destroy the object locally.
    
    Parameters:
    
    option - options for server to
    
    Throws:
    
    AVException - Throws an error if the object does not exist or if the internet fails.
  - deleteAll
```
public static void deleteAll(Collection<? extends AVObject> objects)
                      throws AVException
```
    Delete AVObject in batch.The objects class name must be the same.
    
    Parameters:
    
    objects - the AVObject list to be deleted.
    
    Throws:
    
    AVException - Throws an error if any object does not exist or if the internet fails.
    
    Since:
    
    1.4.0
  - deleteAllInBackground
```
public static void deleteAllInBackground(Collection<? extends AVObject> objects,
                                         DeleteCallback deleteCallback)
```
    Delete AVObject in batch with callback in background.The objects class name must be the same.
    
    Parameters:
    
    objects - objects the AVObject list to be deleted.
    
    deleteCallback - deleteCallback.done will be called when api done
    
    Since:
    
    1.4.0
  - deleteEventually
```
public void deleteEventually()
```
    Deletes this object from the server at some unspecified time in the future, even if AVOSCloud is currently inaccessible. Use this when you may not have a solid network connection, and don't need to know when the delete completes. If there is some problem with the object such that it can't be deleted, the request will be silently discarded. Delete requests made with this method will be stored locally in an on-disk cache until they can be transmitted to AVOSCloud. They will be sent immediately if possible. Otherwise, they will be sent the next time a network connection is available. Delete instructions saved this way will persist even after the app is closed, in which case they will be sent the next time the app is opened. If more than 10MB of commands are waiting to be sent, subsequent calls to deleteEventually or saveEventually will cause old instructions to be silently discarded until the connection can be re-established, and the queued objects can be saved.
  - deleteEventually
```
public void deleteEventually(DeleteCallback callback)
```
    Deletes this object from the server at some unspecified time in the future, even if AVOSCloud is currently inaccessible. Use this when you may not have a solid network connection, and don't need to know when the delete completes. If there is some problem with the object such that it can't be deleted, the request will be silently discarded. Delete requests made with this method will be stored locally in an on-disk cache until they can be transmitted to AVOSCloud. They will be sent immediately if possible. Otherwise, they will be sent the next time a network connection is available. Delete instructions saved this way will persist even after the app is closed, in which case they will be sent the next time the app is opened. If more than 10MB of commands are waiting to be sent, subsequent calls to deleteEventually or saveEventually will cause old instructions to be silently discarded until the connection can be re-established, and the queued objects can be saved.
    
    Parameters:
    
    callback - callback which will be called if the delete completes before the app exits.
  - deleteInBackground
```
public void deleteInBackground()
```
    Deletes this object on the server in a background thread. Does nothing in particular when the save completes. Use this when you don't care if the delete works.
  - deleteInBackground
```
public void deleteInBackground(AVDeleteOption option)
```
    Deletes this object on the server in a background thread. Does nothing in particular when the delete completes. Use this when you don't care if the delete works.
    
    Parameters:
    
    option - option or conditions for delete operation
  - deleteInBackground
```
public void deleteInBackground(AVDeleteOption option,
                               DeleteCallback callback)
```
    Deletes this object on the server in a background thread.
    
    Parameters:
    
    option - option or conditions for delete operation
    
    callback - callback.done will be called when the delete completes
  - deleteInBackground
```
public void deleteInBackground(DeleteCallback callback)
```
    Deletes this object on the server in a background thread. This is preferable to using delete(), unless your code is already running from a background thread.
    
    Parameters:
    
    callback - callback.done(e) is called when the delete completes.
  - fetch
```
public AVObject fetch()
               throws AVException
```
    Throws:
    
    AVException
  - fetch
```
public AVObject fetch(String includeKeys)
               throws AVException
```
    Throws:
    
    AVException
  - fetchAll
```
public static List<AVObject> fetchAll(List<AVObject> objects)
                               throws AVException
```
    Fetches all the objects in the provided list.
    
    Parameters:
    
    objects - The list of objects to fetch.
    
    Returns:
    
    The list passed in.
    
    Throws:
    
    AVException - Throws an exception if the server returns an error or is inaccessible.
  - fetchAllIfNeeded
```
public static List<AVObject> fetchAllIfNeeded(List<AVObject> objects)
                                       throws AVException
```
    Fetches all the objects that don't have data in the provided list.
    
    Parameters:
    
    objects - The list of objects to fetch.
    
    Returns:
    
    The list of objects fetched
    
    Throws:
    
    AVException - Throws an exception if the server returns an error or is inaccessible.
  - fetchAllIfNeededInBackground
```
public static void fetchAllIfNeededInBackground(List<AVObject> objects,
                                                FindCallback<AVObject> callback)
```
    Fetches all the objects that don't have data in the provided list in the background
    
    Parameters:
    
    objects - The list of objects to fetch.
    
    callback - callback.done(result, e) is called when the fetch completes.
  - fetchAllInBackground
```
public static void fetchAllInBackground(List<AVObject> objects,
                                        FindCallback<AVObject> callback)
```
    Fetches all the objects in the provided list in the background
    
    Parameters:
    
    objects - The list of objects to fetch.
    
    callback - callback.done(result, e) is called when the fetch completes.
  - fetchIfNeeded
```
public AVObject fetchIfNeeded()
                       throws AVException
```
    Throws:
    
    AVException
  - fetchIfNeeded
```
public AVObject fetchIfNeeded(String includeKeys)
                       throws AVException
```
    Throws:
    
    AVException
  - fetchIfNeededInBackground
```
public void fetchIfNeededInBackground(GetCallback<AVObject> callback)
```
    If this AVObject has not been fetched (i.e. AVObject.isDataAvailable() returns false), fetches this object with the data from the server in a background thread. This is preferable to using AVObject.fetchIfNeeded(), unless your code is already running from a background thread.
    
    Parameters:
    
    callback - callback.done(object, e) is called when the fetch completes.
  - fetchIfNeededInBackground
```
public void fetchIfNeededInBackground(String includeKeys,
                                      GetCallback<AVObject> callback)
```
    If this AVObject has not been fetched (i.e. AVObject.isDataAvailable() returns false), fetches this object with the data from the server in a background thread. This is preferable to using AVObject.fetchIfNeeded(), unless your code is already running from a background thread.
    
    Parameters:
    
    includeKeys - 以逗号隔开的include字段列表组成的字符串，形如'author,comment'
    
    callback - callback.done(object, e) is called when the fetch completes.
    
    Since:
    
    2.0.2
  - fetchInBackground
```
public void fetchInBackground(GetCallback<AVObject> callback)
```
    Fetches this object with the data from the server in a background thread. This is preferable to using fetch(), unless your code is already running from a background thread.
    
    Parameters:
    
    callback - callback.done(object, e) is called when the fetch completes.
  - fetchInBackground
```
public void fetchInBackground(String includeKeys,
                              GetCallback<AVObject> callback)
```
    Fetches this object with the data from the server in a background thread. This is preferable to using fetch(), unless your code is already running from a background thread.
    
    Parameters:
    
    includeKeys - 以逗号隔开的include字段列表组成的字符串，例如'author,comment'
    
    callback - callback.done(object, e) is called when the fetch completes.
  - get
```
public Object get(String key)
```
    Access a value. In most cases it is more convenient to use a helper function such as getString or getInt.
    
    Parameters:
    
    key - The key to access the value for.
    
    Returns:
    
    null if there is no such key.
  - getACL
```
public AVACL getACL()
```
    Access the AVACL governing this object.
    
    Returns:
    
    AVACL of AVObject
  - getBoolean
```
public boolean getBoolean(String key)
```
    Access a boolean value.
    
    Parameters:
    
    key - The key to access the value for.
    
    Returns:
    
    Returns false if there is no such key or if it is not a boolean.
  - getBytes
```
public byte[] getBytes(String key)
```
    Access a byte array value.
    
    Parameters:
    
    key - The key to access the value for.
    
    Returns:
    
    Returns null if there is no such key or if it is not a byte array.
  - getClassName
```
public String getClassName()
```
    Accessor to the class name.
    
    Returns:
    
    object class name
  - getCreatedAt
```
public Date getCreatedAt()
```
    This reports time as the server sees it, so that if you create a AVObject, then wait a while, and then call save(), the creation time will be the time of the first save() call rather than the time the object was created locally.
    
    Returns:
    
    The first time this object was saved on the server.
  - getDate
```
public Date getDate(String key)
```
    Access a Date value.
    
    Parameters:
    
    key - The key to access the value for.
    
    Returns:
    
    Returns null if there is no such key or if it is not a Date.
  - getDouble
```
public double getDouble(String key)
```
    Access a double value.
    
    Parameters:
    
    key - The key to access the value for.
    
    Returns:
    
    Returns 0 if there is no such key or if it is not a double.
  - getInt
```
public int getInt(String key)
```
    Access an int value.
    
    Parameters:
    
    key - The key to access the value for.
    
    Returns:
    
    Returns 0 if there is no such key or if it is not a JSONObject.
  - getJSONArray
```
public org.json.JSONArray getJSONArray(String key)
```
    Access a JSONArray value.
    
    Parameters:
    
    key - The key to access the value for.
    
    Returns:
    
    Returns null if there is no such key or if it is not a JSONArray.
  - getJSONObject
```
public org.json.JSONObject getJSONObject(String key)
```
    Access a JSONObject value.
    
    Parameters:
    
    key - The key to access the value for.
    
    Returns:
    
    Returns null if there is no such key or if it is not a JSONObject.
  - getList
```
public List getList(String key)
```
    Access a List value
    
    Parameters:
    
    key - The key to access the value for
    
    Returns:
    
    Returns null if there is no such key or if the value can't be converted to a List.
  - getList
```
public <T extends AVObject> List<T> getList(String key,
                                            Class<T> clazz)
```
    获得一个指定类型的List值
    
    Type Parameters:
    
    T - AVObject subclass
    
    Parameters:
    
    key - The key to access the value for
    
    clazz - specified class type for return list
    
    Returns:
    
    Returns null if there is no such key or if the value can't be converted to a List.
  - getLong
```
public long getLong(String key)
```
    Access a long value.
    
    Parameters:
    
    key - The key to access the value for.
    
    Returns:
    
    Returns 0 if there is no such key or if it is not a long.
  - getMap
```
public <V> Map<String,V> getMap(String key)
```
    Access a Map value
    
    Type Parameters:
    
    V - generic type for map value
    
    Parameters:
    
    key - The key to access the value for
    
    Returns:
    
    Returns null if there is no such key or if the value can't be converted to a Map.
  - getNumber
```
public Number getNumber(String key)
```
    Access a numerical value.
    
    Parameters:
    
    key - The key to access the value for.
    
    Returns:
    
    Returns null if there is no such key or if it is not a Number.
  - getObjectId
```
public String getObjectId()
```
    Accessor to the object id. An object id is assigned as soon as an object is saved to the server. The combination of a className and an objectId uniquely identifies an object in your application.
    
    Returns:
    
    The object id.
  - getAVFile
```
public <T extends AVFile> T getAVFile(String key)
```
    Access a AVFile value. This function will not perform a network request. Unless the AVFile has been downloaded (e.g. by calling AVFile.getData()), AVFile.isDataAvailable() will return false.
    
    Type Parameters:
    
    T - AVFile subclass
    
    Parameters:
    
    key - The key to access the value for.
    
    Returns:
    
    Returns null if there is no such key or if it is not a AVFile.
  - getAVGeoPoint
```
public AVGeoPoint getAVGeoPoint(String key)
```
    Access a AVGeoPoint value.
    
    Parameters:
    
    key - The key to access the value for
    
    Returns:
    
    Returns null if there is no such key or if it is not a AVGeoPoint.
  - getAVObject
```
public <T extends AVObject> T getAVObject(String key)
```
    Access a AVObject value. This function will not perform a network request. Unless the AVObject has been downloaded (e.g. by a AVQuery.include(String) or by calling AVObject.fetchIfNeeded() or AVObject.refresh()), AVObject.isDataAvailable() will return false.
    
    Type Parameters:
    
    T - AVObject subclass
    
    Parameters:
    
    key - The key to access the value for.
    
    Returns:
    
    Returns null if there is no such key or if it is not a AVObject.
  - getAVObject
```
public <T extends AVObject> T getAVObject(String key,
                                          Class<T> clazz)
                                   throws Exception
```
    Throws:
    
    Exception
  - getAVUser
```
public <T extends AVUser> T getAVUser(String key)
```
    Access a AVUser value. This function will not perform a network request. Unless the AVObject has been downloaded (e.g. by a AVQuery.include(String) or by calling AVObject.fetchIfNeeded() or AVObject.refresh()), AVObject.isDataAvailable() will return false.
    
    Type Parameters:
    
    T - AVObject subclass
    
    Parameters:
    
    key - The key to access the value for.
    
    Returns:
    
    Returns null if there is no such key or if it is not a AVUser.
  - getAVUser
```
public <T extends AVUser> T getAVUser(String key,
                                      Class<T> clazz)
```
    Access a AVUser subclass value. This function will not perform a network request. Unless the AVObject has been downloaded (e.g. by a AVQuery.include(String) or by calling AVObject.fetchIfNeeded() or AVObject.refresh()), AVObject.isDataAvailable() will return false.
    
    Type Parameters:
    
    T - subclass of AVObject
    
    Parameters:
    
    key - The key to access the value for.
    
    clazz - subclass of AVUser as the class of return value
    
    Returns:
    
    Returns null if there is no such key or if it is not a AVUser.
  - getRelation
```
public <T extends AVObject> AVRelation<T> getRelation(String key)
```
    Access or create a Relation value for a key
    
    Parameters:
    
    key - The key to access the relation for.
    
    subclass - of AVObject
    
    Returns:
    
    the AVRelation object if the relation already exists for the key or can be created for this key.
  - getString
```
public String getString(String key)
```
    Access a string value.
    
    Parameters:
    
    key - The key to access the value for.
    
    Returns:
    
    Returns null if there is no such key or if it is not a String.
  - getUpdatedAt
```
public Date getUpdatedAt()
```
    This reports time as the server sees it, so that if you make changes to a AVObject, then wait a while, and then call save(), the updated time will be the time of the save() call rather than the time the object was changed locally.
    
    Returns:
    
    The last time this object was updated on the server.
  - has
```
public boolean has(String key)
```
    Whether this object has a particular key. Same as containsKey.
    
    Parameters:
    
    key - The key to check for
    
    Returns:
    
    Returns whether this object contains the key
  - hasSameId
```
public boolean hasSameId(AVObject other)
```
  - increment
```
public void increment(String key)
```
    Atomically increments the given key by 1.
    
    Parameters:
    
    key - The key to increment.
  - increment
```
public void increment(String key,
                      Number amount)
```
    Atomically increments the given key by the given number.
    
    Parameters:
    
    key - The key to increment.
    
    amount - The amount to increment by.
  - isDataAvailable
```
public boolean isDataAvailable()
```
    Gets whether the AVObject has been fetched.
    
    Returns:
    
    true if the AVObject is new or has been fetched or refreshed. false otherwise.
  - keySet
```
public Set<String> keySet()
```
    Returns a set view of the keys contained in this object. This does not include createdAt, updatedAt, authData, or objectId. It does include things like username and ACL.
    
    Returns:
    
    keyset of AVObject attributes
  - put
```
public void put(String key,
                Object value)
```
    Add a key-value pair to this object. It is recommended to name keys in partialCamelCaseLikeThis.
    
    Parameters:
    
    key - Keys must be alphanumerical plus underscore, and start with a letter.
    
    value - Values may be numerical, String, JSONObject, JSONArray, JSONObject.NULL, or other AVObjects. value may not be null.
  - put
```
protected void put(String key,
                   Object value,
                   boolean pending)
```
  - refresh
```
public void refresh()
             throws AVException
```
    Refreshes this object with the data from the server. Call this whenever you want the state of the object to reflect exactly what is on the server.
    
    Throws:
    
    AVException - Throws an exception if the server is inaccessible.
  - refresh
```
public void refresh(String includeKeys)
             throws AVException
```
    Refreshes this object with the data from the server. Call this whenever you want the state of the object to reflect exactly what is on the server.
    
    Parameters:
    
    includeKeys - 以逗号隔开的include字段列表字符串，例如'author,comment'
    
    Throws:
    
    AVException - Throws an exception if the server is inaccessible.
    
    Since:
    
    2.0.2
  - refreshInBackground
```
public void refreshInBackground(RefreshCallback<AVObject> callback)
```
    Refreshes this object with the data from the server in a background thread. This is preferable to using refresh(), unless your code is already running from a background thread.
    
    Parameters:
    
    callback - callback.done(object, e) is called when the refresh completes.
  - refreshInBackground
```
public void refreshInBackground(String includeKeys,
                                RefreshCallback<AVObject> callback)
```
    Refreshes this object with the data from the server in a background thread. This is preferable to using refresh(), unless your code is already running from a background thread.
    
    Parameters:
    
    includeKeys - 以逗号隔开的include字段列表字符串，例如'author,comment'
    
    callback - callback.done(object, e) is called when the refresh completes.
    
    Since:
    
    2.0.2
  - remove
```
public void remove(String key)
```
    Removes a key from this object's data if it exists.
    
    Parameters:
    
    key - The key to remove.
  - removeAll
```
public void removeAll(String key,
                      Collection<?> values)
```
    Atomically removes all instances of the objects contained in a Collection from the array associated with a given key. To maintain consistency with the Java Collection API, there is no method removing all instances of a single object. Instead, you can call avObject.removeAll(key, Arrays.asList(value)).
    
    Parameters:
    
    key - The key.
    
    values - The objects to remove.
  - save
```
public void save()
          throws AVException
```
    Saves this object to the server. Typically, you should use AVObject.saveInBackground(com.parse.SaveCallback) instead of this, unless you are managing your own threading.
    
    Throws:
    
    AVException - exception during save operation
  - save
```
public void save(AVSaveOption option)
          throws AVException
```
    Saves this object to the server.
    
    Parameters:
    
    option - save options
    
    Throws:
    
    AVException - exception during save operation
  - saveAll
```
public static void saveAll(List<? extends AVObject> objects)
                    throws AVException
```
    Saves each object in the provided list. This is faster than saving each object individually because it batches the requests.
    
    Parameters:
    
    objects - The objects to save.
    
    Throws:
    
    AVException - Throws an exception if the server returns an error or is inaccessible.
  - saveAllInBackground
```
public static void saveAllInBackground(List<? extends AVObject> objects)
```
    Saves each object in the provided list to the server in a background thread. This is preferable to using saveAll, unless your code is already running from a background thread.
    
    Parameters:
    
    objects - The objects to save.
  - saveAllInBackground
```
public static void saveAllInBackground(List<? extends AVObject> objects,
                                       SaveCallback callback)
```
    Saves each object in the provided list to the server in a background thread. This is preferable to using saveAll, unless your code is already running from a background thread.
    
    Parameters:
    
    objects - The objects to save.
    
    callback - callback.done(e) is called when the save completes.
  - saveEventually
```
public void saveEventually()
```
    适用于用户并不关心具体保存到服务器的具体时间，或者数据并不需要时常与服务器发生交互时，可以使用本方法在网络请求遇到异常时，AVOS Cloud会将此类请求保存到本地，等到网络回复正常或者排除故障以后再发送请求被保存下来的请求会按照初始的发送顺序进行发送
  - saveEventually
```
public void saveEventually(SaveCallback callback)
```
    适用于用户并不关心具体保存到服务器的具体时间，或者数据并不需要时常与服务器发生交互时，可以使用本方法在网络请求遇到异常时，AVOS Cloud会将此类请求保存到本地，等到网络回复正常或者排除故障以后再发送请求被保存下来的请求会按照初始的发送顺序进行发送
    由于保存的时间无法确定，回调发生时可能已经超出了原来的运行环境，即便发生也没有意义，所以不鼓励用户saveEventually中传入callback
    
    Parameters:
    
    callback - A callback which will be called if the save completes before the app exits.
  - onSaveSuccess
```
protected void onSaveSuccess()
```
  - onDataSynchronized
```
protected void onDataSynchronized()
```
  - onSaveFailure
```
protected void onSaveFailure()
```
  - headerMap
```
protected Map<String,String> headerMap()
```
  - copyFromJson
```
protected void copyFromJson(String jsonStr)
```
  - copyFromMap
```
protected void copyFromMap(Map map)
```
  - alwaysUsePost
```
protected boolean alwaysUsePost()
```
  - internalId
```
protected String internalId()
```
  - alwaysSaveAllKeyValues
```
protected boolean alwaysSaveAllKeyValues()
```
  - buildBatchParameterForNonSavedObject
```
protected void buildBatchParameterForNonSavedObject(List<AVObject> unSavedChildren,
                                                    List requestQueue)
```
  - saveInBackground
```
public void saveInBackground()
```
    Saves this object to the server in a background thread. Use this when you do not have code to run on completion of the push.
  - saveInBackground
```
public void saveInBackground(AVSaveOption option)
```
    Saves this object to the server in a background thread.Use this when you do not have code to run on completion of the push.
    
    Parameters:
    
    option - save options
  - saveInBackground
```
public void saveInBackground(SaveCallback callback)
```
    Saves this object to the server in a background thread. This is preferable to using save(), unless your code is already running from a background thread.
    
    Parameters:
    
    callback - callback.done(e) is called when the save completes.
  - saveInBackground
```
public void saveInBackground(AVSaveOption option,
                             SaveCallback callback)
```
    Saves this object to the server in a background thread.
    
    Parameters:
    
    option - save options
    
    callback - callback.done(e) is called when the save completes.
  - setACL
```
public void setACL(AVACL acl)
```
    Set the AVACL governing this object
    
    Parameters:
    
    acl - access control level
  - setObjectId
```
public void setObjectId(String newObjectId)
```
    Setter for the object id. In general you do not need to use this. However, in some cases this can be convenient. For example, if you are serializing a AVObject yourself and wish to recreate it, you can use this to recreate the AVObject exactly.
    
    Parameters:
    
    newObjectId - id for AVObject
  - internalClassName
```
protected String internalClassName()
```
  - shouldThrowException
```
protected boolean shouldThrowException(Throwable error,
                                       String content)
```
  - saveFileBeforeSave
```
public static void saveFileBeforeSave(List<AVFile> files,
                                      boolean sync,
                                      SaveCallback callback)
                               throws AVException
```
    Throws:
    
    AVException
  - hashCode
```
public int hashCode()
```
    Overrides:
    
    hashCode in class Object
  - equals
```
public boolean equals(Object obj)
```
    Overrides:
    
    equals in class Object
  - rebuildInstanceData
```
protected void rebuildInstanceData()
```
  - cast
```
protected static <T extends AVObject> T cast(AVObject object,
                                             Class<T> clazz)
                                      throws Exception
```
    Throws:
    
    Exception
  - describeContents
```
public int describeContents()
```
    Specified by:
    
    describeContents in interface android.os.Parcelable
  - writeToParcel
```
public void writeToParcel(android.os.Parcel out,
                          int i)
```
    Specified by:
    
    writeToParcel in interface android.os.Parcelable
  - disableBeforeHook
```
public void disableBeforeHook()
```
  - disableAfterHook
```
public void disableAfterHook()
```
  - ignoreHook
```
public void ignoreHook(AVObject.Hook hook)
```

Class AVObject

Nested Class Summary

Nested classes/interfaces inherited from interface android.os.Parcelable

Field Summary

Fields inherited from interface android.os.Parcelable

Constructor Summary

Method Summary

Methods inherited from class java.lang.Object

Field Detail

CREATED_AT

UPDATED_AT

OBJECT_ID

requestStatistic

objectId

updatedAt

createdAt

acl

INVALID_KEYS

CREATOR

Constructor Detail

AVObject

AVObject

AVObject

Method Detail

toString

toJSONObject

isFetchWhenSave

setFetchWhenSave

getUuid

registerSubclass

add

addAll

getQuery

addAllUnique

addUnique

containsKey

create

parseAVObject

createWithoutData

createWithoutData

delete

delete

deleteAll

deleteAllInBackground

deleteEventually

deleteEventually

deleteInBackground

deleteInBackground

deleteInBackground

deleteInBackground

fetch

fetch

fetchAll

fetchAllIfNeeded

fetchAllIfNeededInBackground

fetchAllInBackground

fetchIfNeeded

fetchIfNeeded

fetchIfNeededInBackground

fetchIfNeededInBackground

fetchInBackground

fetchInBackground

get

getACL

getBoolean

getBytes

getClassName

getCreatedAt

getDate

getDouble

getInt

getJSONArray

getJSONObject

getList

getList

getLong

getMap

getNumber

getObjectId

getAVFile