com.darwinsys.util.RecentItems Maven / Gradle / Ivy

Go to download

Show more of this group Show more artifacts with this name
Show all versions of darwinsys-api Show documentation

Ian Darwin's assorted Java stuff, assembled as an API.

There is a newer version: 1.8.0

package com.darwinsys.util;

import java.util.ArrayList;
import java.util.Collections;
import java.util.List;
import java.util.prefs.Preferences;

/**
 * A list of recent items, such as a Recent File Menu, a Recent Choices dropdown, etc.
 */
public class RecentItems {
	
	public interface Callback {
		public void reload(List items);
	}
	
	/** The List of recent files */
	private List recentNames = new ArrayList();
	public final static int DEFAULT_MAX_RECENT_FILES = 5;
	private final int maxRecentFiles;
	private String RECENT_ITEMS_KEY = "recent_items";
	private final Preferences prefsNode;
	private Callback callback;
	
	public RecentItems(Preferences prefs, Callback cb, int max) {
		this.prefsNode = prefs;
		this.callback = cb;
		maxRecentFiles = max;
	}
	
	public RecentItems(Preferences prefs, Callback cb) {
		this(prefs, cb, DEFAULT_MAX_RECENT_FILES);
	}
	
	/**
	 * Add the given filename to the top of the recent list in Prefs and in menu.
	 * It is generally not necessary for user code to call this method!
	 */
	public void putRecent(String f) {
		// Trim from back end if too long
		while (recentNames.size() > maxRecentFiles - 1) {
			recentNames.remove(recentNames.size()-1);
		}
		// Move filename to front: Remove if present, add at front.
		if (recentNames.contains(f)) {
			recentNames.remove(f);
		}
		recentNames.add(0, f);

		// Now save from List into Prefs
		for (int i = 0; i < recentNames.size(); i++) {
			String t = recentNames.get(i);
			prefsNode.put(makeName(i), t);
		}

		// Finally, load menu again.
		callCallBack();
	}

	private void callCallBack() {
		if (callback != null) {
			callback.reload(getList());
		}
	}
	
	String makeName(int i) {
		return RECENT_ITEMS_KEY + "." + i;
	}

	public List getList() {
		return Collections.unmodifiableList(recentNames);
	}
	
	/**
	 * Clear all saved Recent Items from Preferences, from memory, and from the Menu.
	 * There is NO UNDO for this so call with care. DOES invoke your callback.
	 */
	public void clear() {
		for (int i = 0; i < maxRecentFiles; i++) {
			prefsNode.remove(makeName(i));
		}
		callCallBack();
	}

	/**
	 * Remove the given name from the list; does NOT invoke your callback
	 * since it might have been invoked in your callback...
	 */
	public void remove(String f) {
		recentNames.remove(f);
	}
}