com.belladati.sdk.util.CachedCollection Maven / Gradle / Ivy

Go to download
package com.belladati.sdk.util;

import java.util.Collection;

/**
 * A collection that is cached by the client. Call {@link #load()} to initially
 * load its contents from the server or to clear the cache and reload at a later
 * time.
 * 
 * @author Chris Hennigfeld
 */
public interface CachedCollection> {

	/**
	 * Returns the immutable content of this cached collection.
	 * 
	 * @return the immutable content of this cached collection
	 */
	C get();

	/**
	 * Clears and loads the content of this collection from the server.
	 * 
	 * @return this collection (for chaining)
	 */
	CachedCollection load();

	/**
	 * Returns true if this cached collection has been loaded from the
	 * server.
	 * 
	 * @return true if this cached collection has been loaded from the
	 *         server
	 */
	boolean isLoaded();
}