co.easimart.EasimartSession Maven / Gradle / Ivy

Go to download
package co.easimart;

import java.util.Arrays;
import java.util.Collections;
import java.util.List;

import bolts.Continuation;
import bolts.Task;

/**
 * The {@code EasimartSession} is a local representation of session data that can be saved
 * and retrieved from the Easimart cloud.
 */
@EasimartClassName("_Session")
public class EasimartSession extends EasimartObject {

  private static final String KEY_SESSION_TOKEN = "sessionToken";
  private static final String KEY_CREATED_WITH = "createdWith";
  private static final String KEY_RESTRICTED = "restricted";
  private static final String KEY_USER = "user";
  private static final String KEY_EXPIRES_AT = "expiresAt";
  private static final String KEY_INSTALLATION_ID = "installationId";

  private static final List READ_ONLY_KEYS = Collections.unmodifiableList(
      Arrays.asList(KEY_SESSION_TOKEN, KEY_CREATED_WITH, KEY_RESTRICTED, KEY_USER, KEY_EXPIRES_AT,
          KEY_INSTALLATION_ID));

  private static EasimartSessionController getSessionController() {
    return EasimartCorePlugins.getInstance().getSessionController();
  }

  /**
   * Get the current {@code EasimartSession} object related to the current user.
   *
   * @return A task that resolves a {@code EasimartSession} object or {@code null} if not valid or
   *         logged in.
   */
  public static Task getCurrentSessionInBackground() {
    return EasimartUser.getCurrentSessionTokenAsync().onSuccessTask(new Continuation>() {
      @Override
      public Task then(Task task) throws Exception {
        String sessionToken = task.getResult();
        if (sessionToken == null) {
          return Task.forResult(null);
        }
        return getSessionController().getSessionAsync(sessionToken).onSuccess(new Continuation() {
          @Override
          public EasimartSession then(Task task) throws Exception {
            EasimartObject.State result = task.getResult();
            return EasimartObject.from(result);
          }
        });
      }
    });
  }

  /**
   * Get the current {@code EasimartSession} object related to the current user.
   *
   * @param callback A callback that returns a {@code EasimartSession} object or {@code null} if not
   *                 valid or logged in.
   */
  public static void getCurrentSessionInBackground(GetCallback callback) {
    EasimartTaskUtils.callbackOnMainThreadAsync(getCurrentSessionInBackground(), callback);
  }

  /* package */ static Task revokeAsync(String sessionToken) {
    if (sessionToken == null || !isRevocableSessionToken(sessionToken)) {
      return Task.forResult(null);
    }
    return getSessionController().revokeAsync(sessionToken);
  }

  /* package */ static Task upgradeToRevocableSessionAsync(String sessionToken) {
    if (sessionToken == null || isRevocableSessionToken(sessionToken)) {
      return Task.forResult(sessionToken);
    }

    return getSessionController().upgradeToRevocable(sessionToken).onSuccess(new Continuation() {
      @Override
      public String then(Task task) throws Exception {
        EasimartObject.State result = task.getResult();
        return EasimartObject.from(result).getSessionToken();
      }
    });
  }

  /* package */ static boolean isRevocableSessionToken(String sessionToken) {
    return sessionToken.contains("r:");
  }

  /**
   * Constructs a query for {@code EasimartSession}.
   *
   * @see EasimartQuery#getQuery(Class)
   */
  public static EasimartQuery getQuery() {
    return EasimartQuery.getQuery(EasimartSession.class);
  }

  @Override
  /* package */ boolean needsDefaultACL() {
    return false;
  }

  @Override
  /* package */ boolean isKeyMutable(String key) {
    return !READ_ONLY_KEYS.contains(key);
  }

  /**
   * @return the session token for a user, if they are logged in.
   */
  public String getSessionToken() {
    return getString(KEY_SESSION_TOKEN);
  }
}