com.parse.RefreshCallback Maven / Gradle / Ivy

Go to download

Show more of this group Show more artifacts with this name
Show all versions of parse-android Show documentation

A library that gives you access to the powerful Parse cloud platform from your Android app.

There is a newer version: 1.17.3

/*
 * Copyright (c) 2015-present, Parse, LLC.
 * All rights reserved.
 *
 * This source code is licensed under the BSD-style license found in the
 * LICENSE file in the root directory of this source tree. An additional grant
 * of patent rights can be found in the PATENTS file in the same directory.
 */
package com.parse;

/**
 * A {@code RefreshCallback} is used to run code after refresh is used to update a {@link ParseObject} in a
 * background thread.
 * 
 * The easiest way to use a {@code RefreshCallback} is through an anonymous inner class. Override
 * the {@code done} function to specify what the callback should do after the refresh is complete.
 * The {@code done} function will be run in the UI thread, while the refresh happens in a
 * background thread. This ensures that the UI does not freeze while the refresh happens.
 * 

 * For example, this sample code refreshes an object of class {@code "MyClass"} and id
 * {@code myId}. It calls a different function depending on whether the refresh succeeded or
 * not.
 * 

 * 
 * object.refreshInBackground(new RefreshCallback() {
 *   public void done(ParseObject object, ParseException e) {
 *     if (e == null) {
 *       objectWasRefreshedSuccessfully(object);
 *     } else {
 *       objectRefreshFailed();
 *     }
 *   }
 * });
 * 
 */
public interface RefreshCallback extends ParseCallback2 {
  /**
   * Override this function with the code you want to run after the save is complete.
   *
   * @param object
   *          The object that was refreshed, or {@code null} if it did not succeed.
   * @param e
   *          The exception raised by the login, or {@code null} if it succeeded.
   */
  @Override
  public void done(ParseObject object, ParseException e);
}