cn.leancloud.LCCloudQuery Maven / Gradle / Ivy

Go to download
package cn.leancloud;

import cn.leancloud.core.PaasClient;
import cn.leancloud.query.LCCloudQueryResult;
import cn.leancloud.query.LCQueryResult;
import cn.leancloud.utils.LCUtils;
import cn.leancloud.utils.StringUtil;
import io.reactivex.Observable;
import io.reactivex.functions.Function;

import java.util.*;

public class LCCloudQuery {
  private LCCloudQuery() {
  }

  /**
   * execute cql query in background.
   * @param cql cql statement.
   * @return observable instance.
   */
  public static Observable executeInBackground(String cql) {
    return executeInBackground(null, cql);
  }

  /**
   * execute cql query in background.
   * @param asAuthenticatedUser explicit user for request authentication.
   * @param cql cql statement.
   * @return observable instance.
   *
   * in general, this method should be invoked in lean engine.
   */
  public static Observable executeInBackground(LCUser asAuthenticatedUser, String cql) {
    return executeInBackground(asAuthenticatedUser, cql, LCObject.class);
  }

  /**
   * execute cql query in background.
   * @param cql cql statement.
   * @param params query parameters.
   * @return observable instance.
   */
  public static Observable executeInBackground(String cql, Object... params) {
    return executeInBackground(null, cql, params);
  }

  /**
   * execute cql query in background.
   * @param asAuthenticatedUser explicit user for request authentication.
   * @param cql cql statement.
   * @param params query parameters.
   * @return observable instance.
   *
   * in general, this method should be invoked in lean engine.
   */
  public static Observable executeInBackground(LCUser asAuthenticatedUser,
                                                                   String cql, Object... params) {
    return executeInBackground(asAuthenticatedUser, cql, LCObject.class, params);
  }

  /**
   * execute cql query in background.
   * @param cql cql statement.
   * @param clazz result class.
   * @return observable instance.
   */
  public static Observable executeInBackground(String cql, Class clazz) {
    return executeInBackground(null, cql, clazz);
  }

  /**
   * execute cql query in background.
   * @param asAuthenticatedUser explicit user for request authentication.
   * @param cql cql statement.
   * @param clazz result class.
   * @return observable instance.
   *
   * in general, this method should be invoked in lean engine.
   */
  public static Observable executeInBackground(LCUser asAuthenticatedUser,
                                                                   String cql, Class clazz) {
    return executeInBackground(asAuthenticatedUser, cql, clazz, null);
  }

  /**
   * execute cql query in background.
   * @param cql cql statement.
   * @param clazz result class.
   * @param params query parameters.
   * @param  template type.
   * @return observable instance.
   */
  public static  Observable executeInBackground(String cql, final Class clazz, Object... params) {
    return executeInBackground(null, cql, clazz, params);
  }

  /**
   * execute cql query in background.
   * @param asAuthenticatedUser explicit user for request authentication.
   * @param cql cql statement.
   * @param clazz result class.
   * @param params query parameters.
   * @param  template type.
   * @return observable instance.
   *
   * in general, this method should be invoked in lean engine.
   */
  public static  Observable executeInBackground(LCUser asAuthenticatedUser,
                                                                                        String cql, final Class clazz,
                                                                                        Object... params) {
    if (StringUtil.isEmpty(cql)) {
      throw new IllegalArgumentException("cql is empty");
    }
    if (null == clazz) {
      throw new IllegalArgumentException("target class is null");
    }
    List