com.extjs.gxt.ui.client.data.BaseListLoader Maven / Gradle / Ivy

Go to download
/*
 * Sencha GXT 2.3.1a - Sencha for GWT
 * Copyright(c) 2007-2013, Sencha, Inc.
 * [email protected]
 * 
 * http://www.sencha.com/products/gxt/license/
 */
 package com.extjs.gxt.ui.client.data;

import com.extjs.gxt.ui.client.Style.SortDir;
import com.extjs.gxt.ui.client.event.BaseEvent;

/**
 * Default implementation of the ListLoader interface.
 * 
 * 
 * Events:
 * 
 * BeforeLoad : LoadEvent(loader, config)

 * Fires before a load operation. Listeners can cancel the action by
 * calling {@link BaseEvent#setCancelled(boolean)}.
 * 
 * loader : this
 * config : the load config
 * 
 * 
 * 
 * Load : LoadEvent(loader, config, result)

 * Fires after the button is selected.
 * 
 * loader : this
 * config : the load config
 * result : the load result
 * 
 * 
 * 
 * LoadException : LoadEvent(loader, config, result)

 * Fires after the button is selected.
 * 
 * loader : this
 * config : the load config
 * result : the load result
 * 
 * 
 * 
 * 
 * @param  the list load result type
 */
public class BaseListLoader> extends BaseLoader implements
    ListLoader {

  private boolean remoteSort;
  private String sortField;
  private SortDir sortDir = SortDir.NONE;

  /**
   * Creates a new loader instance with the given proxy. A reader is not
   * specified and will not be passed to the proxy at load time.
   * 
   * @param proxy the data proxy
   */
  @SuppressWarnings({"unchecked", "rawtypes"})
  public BaseListLoader(DataProxy proxy) {
    super(proxy);
  }

  /**
   * Creates a new loader instance.
   * 
   * @param proxy the data proxy
   * @param reader the data reader
   */
  @SuppressWarnings({"unchecked", "rawtypes"})
  public BaseListLoader(DataProxy proxy, DataReader reader) {
    super(proxy, reader);
  }

  public SortDir getSortDir() {
    return sortDir;
  }

  public String getSortField() {
    return sortField;
  }

  public boolean isRemoteSort() {
    return remoteSort;
  }

  public void setRemoteSort(boolean remoteSort) {
    this.remoteSort = remoteSort;
  }

  public void setSortDir(SortDir sortDir) {
    this.sortDir = sortDir == null ? SortDir.NONE : sortDir;
  }

  public void setSortField(String sortField) {
    this.sortField = sortField;
  }

  /**
   * Use the specified LoadConfig for all load calls. The {@link #reuseConfig}
   * will be set to true.
   */
  public void useLoadConfig(Object loadConfig) {
    setReuseLoadConfig(true);
    lastConfig = loadConfig;
    ListLoadConfig listConfig = (ListLoadConfig) loadConfig;
    sortDir = listConfig.getSortInfo().getSortDir();
    sortField = listConfig.getSortInfo().getSortField();
  }

  /**
   * Template method to allow custom BaseLoader subclasses to provide their own
   * implementation of LoadConfig
   */
  protected Object newLoadConfig() {
    return new BaseListLoadConfig();
  }

  /**
   * Template method to allow custom subclasses to prepare the load config prior
   * to loading data
   */
  protected Object prepareLoadConfig(Object config) {
    super.prepareLoadConfig(config);
    ListLoadConfig listConfig = (ListLoadConfig) config;
    listConfig.setSortField(sortField);
    listConfig.setSortDir(sortDir);
    return config;
  }

}