/**
A threaded file search accessory for JFileChooser.
<P>
Presents JFileChooser users with a tabbed panel interface for
specifying file search criteria including (1) search by name,
(2) search by date of modification, and (3) search by file content.
Finded are performed "in the background" with found files displayed
dynamically as they are found. Only one search can be active at
a time. FindResults are displayed in a scrolling list within a results
tab panel.
<P>
Findes are performed asynchronously so the user can continue
browsing the file system. The user may stop the search at any time.
Accepting or cancelling the file chooser or closing the dialog window
will automatically stop a search in progress.
<P>
The starting folder of the search (the search base) is displayed
at the top of the accessory panel. The search base display will
not change while a search is running. The search base display
will change to reflect the current directory of JFileChooser
when a search is not running.
<P>
Changing the search options does not affect a search in progress.

@version	1.0, 2000/01/19
@author		Ken Klinner, kklinner@opiom.com
 */

import java.io.*;
import java.util.*;
import java.text.*;
import java.awt.*;
import java.awt.event.*;
import javax.swing.*;
import javax.swing.filechooser.*;
import javax.swing.border.*;
import java.beans.*;

public class FindAccessory	extends	JPanel
			 			 implements Runnable, PropertyChangeListener, ActionListener,
							                          									FindProgressCallback {
  /**
	 * Label for this accessory.
	 */
	static public final String	ACCESSORY_NAME = " Find ";

	/**
	 * Default max number of found items. Prevents overloading results list.
	 */
	static public final int		DEFAULT_MAX_SEARCH_HITS = 500;

  /**
   * Find start action name
	 */
	static public final String	ACTION_START = "Start";

	/**
	 * Find stop action name
	 */
	static public final String	ACTION_STOP = "Stop";

	/**
	 * Parent JFileChooser component
	 */
	protected JFileChooser		chooser = null;

	protected FindAction		actionStart = null;
	protected FindAction		actionStop = null;

	/**
	 * This version of FindAccesory supports only one active search thread
	 */
	protected Thread			searchThread = null;

	/**
	 * Set to true to stop current search
	 */
	protected boolean			killFind = false;

	/**
	 * Displays full path of search base
	 */
	protected FindFolder		pathPanel = null;

	/**
	 * Find options with results list
	 */
	protected FindTabs		searchTabs = null;

	/**
	 * Find controls with progress display
	 */
	protected FindControls	controlPanel = null;

	/**
	 * Number of items inspected by current/last search
	 */
	protected int				total = 0;

	/**
	 * Number of items found by current/last search
	 */
	protected int				matches = 0;

	/**
	 * Max number of found items to prevent overloading
	 * the results list.
	 */
	protected int				maxMatches = DEFAULT_MAX_SEARCH_HITS;

  /**
   * Construct a search panel with start and stop actions, option panes and a
	 * results list pane that can display up to DEFAULT_MAX_SEARCH_HITS items.
   */
	public FindAccessory () {
		super();

		setBorder(new TitledBorder(ACCESSORY_NAME));
		setLayout(new BorderLayout());

		actionStart = new FindAction(ACTION_START,null);
		actionStop = new FindAction(ACTION_STOP,null);

		add(pathPanel = new FindFolder(),BorderLayout.NORTH);
		add(searchTabs = new FindTabs(), BorderLayout.CENTER);
		add(controlPanel = new FindControls(actionStart,actionStop,true),
						                         BorderLayout.SOUTH);
		updateFindDirectory();
	}

  /**
	 * Construct a search panel with start and stop actions and "attach" it to
	 * the specified JFileChooser component. Calls register() to establish
	 * FindAccessory as a PropertyChangeListener of JFileChooser.
   *
	 * @param parent JFileChooser containing this accessory
   */
	public FindAccessory (JFileChooser parent) {
		this();
		chooser = parent;
		register(chooser);
	}

  /**
	 * Construct a search panel with start and stop actions and "attach" it to
	 * the specified JFileChooser component. Calls register() to establish
	 * FindAccessory as a PropertyChangeListener of JFileChooser. Sets maximum
	 * number of found items to limit the load in the results list.
   *
   * @param parent JFileChooser containing this accessory
	 * @param max Max number of items for results list. Find stops when max
	 * number of items found.
   */
	public FindAccessory (JFileChooser c, int max) {
		this(c);
		setMaxFindHits(max);
	}

  /**
 	 * Sets maximum capacity of the results list.
	 * Find stops when max number of items found.
   *
	 * @param max Max capacity of results list.
   */
	public void setMaxFindHits (int max) {
		maxMatches = max;
	}

  /**
	 * Returns maximum capacity of results list.
   *
	 * @return Max capacity of results list.
   */
	public int getMaxFindHits () {
		return maxMatches;
	}

  /**
  	Called by JFileChooser when a property changes. FindAccessory listens
  	for DIRECTORY_CHANGED_PROPERTY and updates the path component to display
  	the full path of the current JFileChooser directory. When a search is
  	in progress the path component is <b>not</b> updated - the path component
  	will display the starting point of the current search.

  	@param e PropertyChangeEvent from parent JFileChooser.
   */
  public void propertyChange (PropertyChangeEvent e)
  {
  	String prop = e.getPropertyName();
  	if (prop.equals(JFileChooser.DIRECTORY_CHANGED_PROPERTY))
  	{
  		updateFindDirectory();
  	}
  }

  /**
  	Called by JFileChooser when the user provokes an action like "cancel"
  	or "open". Listens for APPROVE_SELECTION and CANCEL_SELECTION action
  	and stops the current search, if there is one.

  	@param e ActionEvent from parent JFileChooser.
   */
  public void actionPerformed (ActionEvent e)
  {
  	String command = e.getActionCommand();
  	if (command == null) return; // Can this happen? Probably not. Call me paranoid.
  	if (command.equals(JFileChooser.APPROVE_SELECTION))
  		quit();
  	else if (command.equals(JFileChooser.CANCEL_SELECTION))
  		quit();
  }


  /**
  	Displays the absolute path to the parent's current directory if and only
  	if there is no active search.
   */
  public void updateFindDirectory ()
  {
  	if (isRunning()) return;
  	if (chooser == null) return;
  	if (pathPanel == null) return;
  	File f = chooser.getCurrentDirectory();
  	pathPanel.setFindDirectory(f);
  }

  /**
  	Set parent's current directory to the parent folder of the specified
  	file and select the specified file. This method is invoked when the
  	user double clicks on an item in the results list.

  	@param f File to select in parent JFileChooser
   */
  public void goTo ( File f ) {
  	if (f == null) return;
  	if (!f.exists()) return;
  	if (chooser == null) return;

  	// Make sure that files and directories can be displayed
  	chooser.setFileSelectionMode(JFileChooser.FILES_AND_DIRECTORIES);

  	// Make sure that parent file chooser will show the type of file
  	// specified
  	javax.swing.filechooser.FileFilter filter = chooser.getFileFilter();
  	if (filter != null)
  	{
  		if (!filter.accept(f))
  		{
  			// The current filter will not display the specified file.
  			// Set the file filter to the built-in accept-all filter (*.*)
  			javax.swing.filechooser.FileFilter all =
  				chooser.getAcceptAllFileFilter();
  			chooser.setFileFilter(all);
  		}
  	}

  	// Tell parent file chooser to display contents of parentFolder.
  	// Prior to Java 1.2.2 setSelectedFile() did not set the current
  	// directory the folder containing the file to be selected.
  	File parentFolder = f.getParentFile();
  	if (parentFolder != null) chooser.setCurrentDirectory(parentFolder);

  	// Nullify the current selection, if any.
  	// Why is this necessary?
  	// Emperical evidence suggests that JFileChooser gets "sticky" (i.e. it
  	// does not always relinquish the current selection). Nullifying the
  	// current selection seems to yield better results.
  	chooser.setSelectedFile(null);

  	// Select the file
  	chooser.setSelectedFile(f);

  	// Refresh file chooser display.
  	// Is this really necessary? Testing on a variety of systems with
  	// Java 1.2.2 suggests that this helps. Sometimes it doesn't work,
  	// but it doesn't do any harm.
  	chooser.invalidate();
  	chooser.repaint();
  }

  /**
  	Start a search. The path display will show the starting folder of the
  	search.
  	Finds are recursive and will span the entire folder hierarchy below the
  	base folder. The user may continue to browse with JFileChooser.
   */
  public synchronized void start () {
  	if (searchTabs != null) searchTabs.showFindResults();
  	updateFindDirectory();
  	killFind = false;
  	if (searchThread == null)	{
  		searchThread = new Thread(this);
  	}
  	if (searchThread != null) searchThread.start();
  }

  /**
  	Stop the active search.
   */
  public synchronized void stop ()  {
  	killFind = true;
  }

  /**
	 * @return true if a search is currently running
   */
  public boolean isRunning ()
  {
  	if (searchThread == null) return false;
  	return searchThread.isAlive();
  }

  /**
   * Find thread
   */
  public void run ()  {
  	if (searchThread == null) return;
  	if (Thread.currentThread() != searchThread) return;
  	try	{
  		actionStart.setEnabled(false);
  		actionStop.setEnabled(true);
  		runFind(chooser.getCurrentDirectory(),newFind());
  	}
  	catch (InterruptedException e) {
  	}
  	finally
  	{
  		actionStart.setEnabled(true);
  		actionStop.setEnabled(false);
  		searchThread = null;
  	}
  }

  /**
  	Recursive search beginning at folder <b>base</b> for files and folders
  	matching each filter in the <b>filters</b> array. To interrupt set
  	<b>killFind</b> to true. Also stops when number of search hits (matches)
  	equals <b>maxMatches</b>.
  	<P>
  	<b>Note:</b> Convert this to a nonrecursive search algorithm on systems
  	where stack space might be limited and/or the search hierarchy might be
  	very deep.

  	@param base starting folder of search
  	@param filters matches must pass each filters in array
  	@exception InterruptedException if thread is interrupted
   */
  protected void runFind (File base, FindFilter[] filters)
  				                                        throws InterruptedException
  {
  	if (base == null) return;
  	if (!base.exists()) return; // Not likely to happen
  	if (filters == null) return;

  	if (killFind) return;
  	File folder = null;
  	if (base.isDirectory()) folder = base;
  	else folder = base.getParentFile();

  	File[] files = folder.listFiles();
  	for (int i=0; i<files.length; i++)
  	{
  		total++;
  		if (accept(files[i],filters))
  		{
  			matches++;
  			searchTabs.addFoundFile(files[i]);
  		}
  		updateProgress();
  		if (killFind) return;
  		Thread.currentThread().sleep(0);

  		if (files[i].isDirectory()) runFind(files[i],filters);
  		if ((maxMatches > 0) && (matches >= maxMatches))
  		{
  			return;// stopgap measure so that we don't overload
  		}
  	}
  }

  /**
	@param file file to pass to each filter's accept method
	@param filters array of selection criteria

	@return true if specified file matches each filter's selection criteria
   */
  protected boolean accept (File file, FindFilter[] filters)
  {
  	if (file == null) return false;
  	if (filters == null) return false;

  	for (int i=0; i<filters.length; i++)
  	{
  		if (!filters[i].accept(file,this)) return false;
  	}
  	return true;
  }

  /**
	Called by FindFilter to report progress of a search. Purely
	a voluntary report. This really should be implemented as a
	property change listener.
	Percentage completion = (current/total)*100.

	@param filter FindFilter reporting progress
	@param file file being searched
	@param current current "location" of search
	@param total expected maximum value of current

	@return true to continue search, false to abort
   */
  public boolean reportProgress (FindFilter filter, File file,
  								long current, long total)
  {
  	return !killFind;
  }

  /**
	Begins a new search by resetting the <b>total</b> and <b>matches</b>
	progress variables and retrieves the search filter array from the
	options panel.
	Each tab in the options panel is responsible for generating a
	FindFilter based on its current settings.

	@return Array of search filters from the options panel.
   */
  protected FindFilter[] newFind ()
  {
  	total = matches = 0;
  	updateProgress();

  	if (searchTabs != null) return searchTabs.newFind();
  	return null;
  }

  /**
	Display progress of running search.
   */
  protected void updateProgress ()  {
  	controlPanel.showProgress(matches,total);
  }

  /**
	Add this component to the specified JFileChooser's list of property
	change listeners and action listeners.

	@param c parent JFileChooser
   */
  protected void register (JFileChooser c)
  {
  	if (c == null) return;
  	c.addPropertyChangeListener(this);
  	c.addActionListener(this);
  }

  /**
	Remove this component from the specified JFileChooser's list of property
	change listeners and action listeners.

	@param c parent JFileChooser
   */
  protected void unregister (JFileChooser c)
  {
  	if (c == null) return;
  	c.removeActionListener(this);
  	c.removePropertyChangeListener(this);
  }

  /**
	Stop the current search and unregister in preparation for parent
	shutdown.
   */
  public void quit ()  {
  	stop();
  	unregister(chooser);
  }


  /**
	Invoked by FindAction objects to start and stop searches.
   */
  public void action (String command)
  {
  	if (command == null) return;
  	if (command.equals(ACTION_START))
  		start();
  	else if (command.equals(ACTION_STOP))
  		stop();
  }

  /**
   * Convenience class for adding action objects to the control panel.
   */
  class FindAction extends AbstractAction {
  	/**
  		Construct a search control action currently implements
  		FindAccesory.ACTION_START and FindAccessory.ACTION_STOP.

  		@param text command
  		@param icon button icon
  	 */
  	FindAction (String text, Icon icon)	{
  		super(text,icon);
  	}

  	/**
  		Invoke FindAction's action() method.

  		@param e action event
  	 */
  	public void actionPerformed (ActionEvent e)
  	{
  		action(e.getActionCommand());
  	}
  }

  /**
   * Displays the full path of the search starting folder.
   */
  class FindFolder extends JPanel {
  	protected JLabel	searchDirectory = null;

  	FindFolder ()  	{
  		super();
  		setLayout(new BorderLayout());

  		// Directory
  		searchDirectory = new JLabel();
  		searchDirectory.setForeground(Color.black);
  		searchDirectory.setFont(new Font("Helvetica",Font.PLAIN,9));
  		add(searchDirectory);
  	}

  	/**
  		Display the full path of the specified folder.
  	*/
  	public void setFindDirectory (File f)	{
  		if (searchDirectory == null) return;
  		if (f != null) searchDirectory.setText(f.getAbsolutePath());
  		else searchDirectory.setText(null);
  	}
  }


  /**
  	Find controls panel displays default action components for starting
  	and stopping a search. Also displays the search progress in the form of
  	a text display indicating the number of items found and the total number
  	of items encountered in the search.
  */
  class FindControls extends JPanel  {
  	protected JLabel		searchDirectory = null;
  	protected JLabel		progress = null;

  	/**
  		Construct a simple search control panel with buttons for
  		starting and stopping a search and a simple display for
  		search progress.
  	*/
  	FindControls (FindAction find, FindAction stop, boolean recurse) {
  		super();
  		setLayout(new BorderLayout());

  		JToolBar tools = new JToolBar();
  		tools.setFloatable(false);
  		tools.add(actionStart = new FindAction(ACTION_START,null));
  		tools.add(actionStop = new FindAction(ACTION_STOP,null));
  		add(tools,BorderLayout.WEST);

  		progress = new JLabel("",SwingConstants.RIGHT);

  		// So that frequent updates will appear smooth
  		progress.setDoubleBuffered(true);

  		progress.setForeground(Color.black);
  		progress.setFont(new Font("Helvetica",Font.PLAIN,9));
  		add(progress,BorderLayout.EAST);
  	}

  	/**
  		Display search progress as a text field
  		"no. of matches / total searched".
  		@param matches number of items found
  		@param total number of items investigated
  	*/
  	public void showProgress (int matches, int total)
  	{
  		if (progress == null) return;
  		progress.setText(String.valueOf(matches)+"/"+String.valueOf(total));
  	}
  }

  /**
  	Contains a collecton of search options displayed as tabbed panes and
  	at least one pane for displaying the search results. Each options tab
  	pane is a user interface for sprecifying the search criteria and a
  	factory for a FindFilter to implement the acceptance function. By making
  	the search option pane responsible for generating a FindFilter object,
  	the programmer can easily extend the search capabilities without
  	modifying the controlling search engine.
  */
  class FindTabs extends JTabbedPane
  {
  	protected String			TAB_NAME = "Name";
  	protected String			TAB_DATE = "Date";
  	protected String			TAB_CONTENT = "Content";
  	protected String			TAB_RESULTS = "Found";

  	protected FindResults	resultsPanel = null;
  	protected JScrollPane	resultsScroller = null;

  	/**
  		Construct a search tabbed pane with tab panels for seach by
  		filename, search by date, search by content and search results.
  	*/
  	FindTabs ()
  	{
  		super();

  		setForeground(Color.black);
  		setFont(new Font("Helvetica",Font.BOLD,10));

  		// Add search-by-name panel
  		addTab(TAB_NAME,new FindByName());

  		// Add search-by-date panel
  		addTab(TAB_DATE,new FindByDate());

  		// Add search-by-content panel
  		addTab(TAB_CONTENT,new FindByContent());

  		// Add results panel
  		resultsScroller = new JScrollPane(resultsPanel = new FindResults());

  		// so that updates will be smooth
  		resultsPanel.setDoubleBuffered(true);
  		resultsScroller.setDoubleBuffered(true);

  		addTab(TAB_RESULTS,resultsScroller);
  	}

  	/**
  		Adds the specified file to the results list.

  		@param f file to add to results list
  	*/
  	public void addFoundFile (File f)	{
  		if (resultsPanel != null) resultsPanel.append(f);
  	}

  	/**
  		Bring the search results tab panel to the front.
  	*/
  	public void showFindResults ()
  	{
  		if (resultsScroller != null) setSelectedComponent(resultsScroller);
  	}

  	/**
  		Prepares the panel for a new search by clearing the results list,
  		bringing the results tab panel to the front and generating an
  		array of search filters for each search options pane that
  		implements the FindFilterFactory interface.

  		@return array of FindFilters to be used by the controlling
  		search engine
  	*/
  	public FindFilter[] newFind ()
  	{
  		// Clear the results display
  		if (resultsPanel != null) resultsPanel.clear();

  		// Fix the width of the scrolling results panel so the layout
  		// managers don't try to make it too wide for JFileChooser
  		Dimension dim = resultsScroller.getSize();
  		resultsScroller.setMaximumSize(dim);
  		resultsScroller.setPreferredSize(dim);

  		// Return an array of FindFilters
  		Vector filters = new Vector();
  		for (int i=0; i<getTabCount(); i++)
  		{
  			try
  			{
  				FindFilterFactory fac = (FindFilterFactory)getComponentAt(i);
  				FindFilter f = fac.createFindFilter();
  				if (f != null) filters.addElement(f);
  			}
  			catch (Throwable e)
  			{
  				// The FindResults pane does not implement FindFilterFactory
  			}
  		}
  		if (filters.size() == 0) return null;
  		FindFilter[] filterArray = new FindFilter[filters.size()];
  		for (int i=0; i<filterArray.length; i++)
  		{
  			filterArray[i] = (FindFilter)filters.elementAt(i);
  		}
  		return filterArray;
  	}
  }

  /**
  	Appears as a special pane within the FindOptions tabbed panel.
  	The only one that does not generate a FindFilter.
  */
  class FindResults extends JPanel
  {
  	protected DefaultListModel	model = null;
  	protected JList				fileList = null;


  	/**
  		Construct a search results pane with a scrollable list of files.
  		When an item is double-clicked the FindAccessory controller will
  		be instructed to select the file in the parent JFileChooser's item
  		display.
  	*/
  	FindResults ()
  	{
  		super();
  		setLayout(new BorderLayout());

  		model = new DefaultListModel();
  		fileList = new JList(model);
  		fileList.setSelectionMode(ListSelectionModel.SINGLE_SELECTION);
  		fileList.setCellRenderer(new FindResultsCellRenderer());
  		add(fileList,BorderLayout.CENTER);

  		// Double click listener
  		MouseListener mouseListener = new MouseAdapter()
  		{
  			public void mouseClicked (MouseEvent e)
  			{
  				if (e.getClickCount() == 2)
  				{
  					try
  					{
  						int index = fileList.locationToIndex(e.getPoint());
  						File f = (File)model.elementAt(index);
  						goTo(f);
  					}
  					catch (Throwable err)
  					{
  					}
  				}
  			}
  		};
  		fileList.addMouseListener(mouseListener);
  	}

  	/**
  		Add a file to the results list.

  		@param f file found
  	*/
  	public void append (File f)
  	{
  		if (f == null) return;
  		model.addElement(f);
  	}

  	/**
  		Clear all items from the results list.
  	*/
  	public void clear ()
  	{
  		if (model != null)
  		{
  			model.removeAllElements();
  			invalidate();
  			repaint();
  		}
  	}

  	/**
  		Convenience class for rendering cells in the results list.
  	*/
  	class FindResultsCellRenderer extends JLabel implements ListCellRenderer
  	{

  		FindResultsCellRenderer()
  		{
  			setOpaque(true);
  		}

  		public Component getListCellRendererComponent (
  							JList list,
  							Object value,
  							int index,
  							boolean isSelected,
  							boolean cellHasFocus)
  		{
  			if (index == -1)
  			{
  				// This shouldn't happen since we won't be using this
  				// renderer in a combo box
  				int selected = list.getSelectedIndex();
  				if (selected == -1) return this;
  				else index = selected;
  			}

  			setBorder(new EmptyBorder(1,2,1,2));
  			setFont(new Font("Helvetica",Font.PLAIN,10));

  			// show absolute path of file
  			File file = (File)model.elementAt(index);
  			setText(file.getAbsolutePath());

  			// selection characteristics
  			if(isSelected)
  			{
  				setBackground(list.getSelectionBackground());
  				setForeground(list.getSelectionForeground());
  			}
  			else
  			{
  				setBackground(Color.white);
  				setForeground(Color.black);
  			}
  			return this;
  		}

  	}
  }

}


/**
Each search option tab that implements FindFilterFactory defines an
inner class that implements FindFilter. When a search is started
the search panel invokes createFindFilter() on each panel that
implements FindFilterFactory, thus causing the panel to create
a FindFilter object that implements its search settings.
*/
interface FindFilter {
  //public boolean accept (File f);
  public boolean accept (File f, FindProgressCallback monitor);
}

interface FindProgressCallback {
  /**
  	Should be called by all time-consuming search filters at a reasonable
  	interval. Allows the search controller to report progress and to
  	abort the search in a clean and timely way.
  	@param filter FindFilter reporting the progress
  	@param file the file being searched
  	@param current current "location" of search
  	@param total maximum value
  	@return true if search should continue, false to abort
  */
  public boolean reportProgress (FindFilter filter, File file,
  								long current, long total);
}

/**
Implemented by each search option panel. Each panel is responsible for
creating a FindFilter object that implements the search criteria
specified by its user interface.
*/
interface FindFilterFactory {
  public FindFilter createFindFilter ();
}



/**
Implements a user interface and generates FindFilter for selecting
files by date.
*/
class FindByDate extends JPanel implements FindFilterFactory {

  public static String	THE_BIG_BANG = "The Big Bang";
  public static String	THE_BIG_CRUNCH = "The Big Crunch";
  public static String	YESTERDAY = "Yesterday";
  public static String	TODAY = "Today";
  public static String	NOW = "Now";

  public static String	MODIFIED_LABEL = "Modified";
  public static String	FORMAT_LABEL = "mm/dd/yyyy";
  public static String	FROM_DATE_LABEL = "between start of";
  public static String	TO_DATE_LABEL = "and end of";

  protected JComboBox		fromDateField = null;
  protected JComboBox		toDateField = null;

  protected String[]		fromDateItems = {THE_BIG_BANG,YESTERDAY,TODAY};
  protected String[]		toDateItems = {THE_BIG_CRUNCH,TODAY,NOW,YESTERDAY};

  FindByDate ()  {
  	super();
  	setLayout(new BorderLayout());

  	Font font = new Font("Helvetica",Font.PLAIN,10);

  	// Grid Layout
  	JPanel p = new JPanel();
  	p.setLayout(new GridLayout(0,2,2,2));

  	// Date selection criteria
  	JLabel modified = new JLabel(MODIFIED_LABEL,SwingConstants.LEFT);
  	modified.setFont(font);
  	modified.setForeground(Color.black);
  	p.add(modified);

  	// format note
  	JLabel format = new JLabel(FORMAT_LABEL,SwingConstants.LEFT);
  	format.setFont(font);
  	format.setForeground(Color.black);
  	p.add(format);

  	// between
  	JLabel betweenLabel = new JLabel(FROM_DATE_LABEL,SwingConstants.RIGHT);
  	betweenLabel.setFont(font);
  	betweenLabel.setForeground(Color.black);
  	p.add(betweenLabel);

  	// from date
  	//fromDateField = new JTextField(8);
  	fromDateField = new JComboBox(fromDateItems);
  	fromDateField.setFont(font);
  	fromDateField.setEditable(true);
  	p.add(fromDateField);

  	// and
  	JLabel andLabel = new JLabel(TO_DATE_LABEL,SwingConstants.RIGHT);
  	andLabel.setFont(font);
  	andLabel.setForeground(Color.black);
  	p.add(andLabel);

  	//toDateField = new JTextField(8);
  	toDateField = new JComboBox(toDateItems);
  	toDateField.setFont(font);
  	toDateField.setEditable(true);
  	p.add(toDateField);

  	add(p,BorderLayout.NORTH);
  }

  /**
  	Generate a search filter object based on the setting of this UI
  	component.

  	@return a FindFilter object that implements the selection criteria
  */
  public FindFilter createFindFilter() {
  	long from = -1;
  	long to = -1;

  	from = startDateToTime((String)fromDateField.getSelectedItem());
  	to = endDateToTime((String)toDateField.getSelectedItem());

  	return new DateFilter(from,to);
  }

  /**
  	Convenience method for converting the start date text to milliseconds
  	since January 1, 1970.

  	@return milliseconds since January 1, 1970
  */
  protected long startDateToTime (String s)  {
  	if (s == null) return -1;
  	SimpleDateFormat formatter = new SimpleDateFormat("MM/dd/yyyy");
  	Date d = formatter.parse(s,new ParsePosition(0));
  	if (d == null)
  	{
  		if (s.equalsIgnoreCase(TODAY))
  		{
  			String today = formatter.format(new Date());
  			d = formatter.parse(today,new ParsePosition(0));
  		}
  		else if (s.equalsIgnoreCase(YESTERDAY))
  		{
  			String yesterday = formatter.format(
  					new Date(new Date().getTime() - 24*60*60*1000));
  			d = formatter.parse(yesterday,new ParsePosition(0));
  		}
  		else if (s.equalsIgnoreCase(THE_BIG_BANG))
  		{
  			return 0;	// Not exactly the beginning of time, but
  						//close enough for computer work
  		}
  	}
  	if (d != null) return d.getTime();
  	return -1;
  }

  /**
  	Convenience method for converting the end date text to milliseconds
  	since January 1, 1970. The end time is the end of the specified day.

  	@return milliseconds since January 1, 1970
  */
  protected long endDateToTime (String s)
  {
  	if (s == null) return -1;
  	SimpleDateFormat dateFormatter = new SimpleDateFormat("MM/dd/yyyy");

  	long time = -1;
  	Date d = dateFormatter.parse(s,new ParsePosition(0));
  	if (d == null)
  	{
  		if (s.equalsIgnoreCase(TODAY))
  		{
  			String today = dateFormatter.format(new Date());
  			d = dateFormatter.parse(today,new ParsePosition(0));
  			if (d != null) time = d.getTime() + (24L*3600L*1000L);
  		}
  		else if (s.equalsIgnoreCase(YESTERDAY))
  		{
  			String yesterday = dateFormatter.format(
  				new Date(new Date().getTime() - 24*60*60*1000));
  			d = dateFormatter.parse(yesterday,new ParsePosition(0));
  			if (d != null) time = d.getTime() + (24L*3600L*1000L);
  		}
  		else if (s.equalsIgnoreCase(NOW))
  		{
  			d = new Date();
  			if (d != null) time = d.getTime();
  		}
  		else if (s.equalsIgnoreCase(THE_BIG_CRUNCH))
  		{
  			time = Long.MAX_VALUE;
  		}
  	}
  	else
  	{
  		// Valid date. Now add 24 hours to make sure that the
  		// date is inclusive
  		time = d.getTime() + (24L*3600L*1000L);
  	}

  	return time;
  }

  /**
  	Filter object for selecting files by the date range specified by the UI.
  */
  class DateFilter implements FindFilter
  {
  	protected long	startTime = -1;
  	protected long	endTime = -1;


  	DateFilter (long from, long to)
  	{
  		startTime = from;
  		endTime = to;
  	}

  	public boolean accept (File f, FindProgressCallback callback)
  	{
  		if (f == null) return false;

  		long t = f.lastModified();

  		if (startTime >= 0)
  		{
  			if (t < startTime) return false;
  		}
  		if (endTime >= 0)
  		{
  			if (t > endTime) return false;
  		}

  		return true;
  	}
  }
}


/**
Implements user interface and generates FindFilter for selecting
files by name.
*/
class FindByName extends JPanel implements FindFilterFactory
{
  protected String		NAME_CONTAINS = "contains";
  protected String		NAME_IS = "is";
  protected String		NAME_STARTS_WITH = "starts with";
  protected String		NAME_ENDS_WITH = "ends with";
  protected int			NAME_CONTAINS_INDEX = 0;
  protected int			NAME_IS_INDEX = 1;
  protected int			NAME_STARTS_WITH_INDEX = 2;
  protected int			NAME_ENDS_WITH_INDEX = 3;
  protected String[]		criteria = {NAME_CONTAINS,
  									NAME_IS,
  									NAME_STARTS_WITH,
  									NAME_ENDS_WITH};

  protected JTextField	nameField = null;
  protected JComboBox		combo = null;
  protected JCheckBox		ignoreCaseCheck = null;

  FindByName ()
  {
  	super();
  	setLayout(new BorderLayout());

  	// Grid Layout
  	JPanel p = new JPanel();
  	p.setLayout(new GridLayout(0,2,2,2));

  	// Name
  	combo = new JComboBox(criteria);
  	combo.setFont(new Font("Helvetica",Font.PLAIN,10));
  	combo.setPreferredSize(combo.getPreferredSize());
  	p.add(combo);

  	nameField = new JTextField(12);
  	nameField.setFont(new Font("Helvetica",Font.PLAIN,10));
  	p.add(nameField);

  	// ignore case
  	p.add(new JLabel("",SwingConstants.RIGHT));

  	ignoreCaseCheck = new JCheckBox("ignore case",true);
  	ignoreCaseCheck.setForeground(Color.black);
  	ignoreCaseCheck.setFont(new Font("Helvetica",Font.PLAIN,10));
  	p.add(ignoreCaseCheck);

  	add(p,BorderLayout.NORTH);
  }

  public FindFilter createFindFilter ()
  {
  	return new NameFilter(nameField.getText(),combo.getSelectedIndex(),
  							ignoreCaseCheck.isSelected());
  }

  /**
  	Filter object for selecting files by name.
  */
  class NameFilter implements FindFilter
  {
  	protected String	match = null;
  	protected int		howToMatch = -1;
  	protected boolean	ignoreCase = true;

  	NameFilter (String name, int how, boolean ignore)
  	{
  		match = name;
  		howToMatch = how;
  		ignoreCase = ignore;
  	}

  	public boolean accept (File f, FindProgressCallback callback)
  	{
  		if (f == null) return false;

  		if ((match == null) || (match.length() == 0)) return true;
  		if (howToMatch < 0) return true;

  		String filename = f.getName();


  		if (howToMatch == NAME_CONTAINS_INDEX)
  		{
  			if (ignoreCase)
  			{
  				if (filename.toLowerCase().indexOf(match.toLowerCase()) >= 0)
  					return true;
  				else return false;
  			}
  			else
  			{
  				if (filename.indexOf(match) >= 0) return true;
  				else return false;
  			}
  		}
  		else if (howToMatch == NAME_IS_INDEX)
  		{
  			if (ignoreCase)
  			{
  				if (filename.equalsIgnoreCase(match)) return true;
  				else return false;
  			}
  			else
  			{
  				if (filename.equals(match)) return true;
  				else return false;
  			}
  		}
  		else if (howToMatch == NAME_STARTS_WITH_INDEX)
  		{
  			if (ignoreCase)
  			{
  				if (filename.toLowerCase().startsWith(match.toLowerCase()))
  					return true;
  				else return false;
  			}
  			else
  			{
  				if (filename.startsWith(match)) return true;
  				else return false;
  			}
  		}
  		else if (howToMatch == NAME_ENDS_WITH_INDEX)
  		{
  			if (ignoreCase)
  			{
  				if (filename.toLowerCase().endsWith(match.toLowerCase()))
  					return true;
  				else return false;
  			}
  			else
  			{
  				if (filename.endsWith(match)) return true;
  				else return false;
  			}
  		}

  		return true;
  	}
  }

}


/**
Implements user interface and generates FindFilter for selecting
files by content.
<P>
<b>WARNING:</B> The FindFilter inner class for this object does
not implement an efficient strng search algorithm. Efficiency was
traded for code simplicity.
*/
class FindByContent extends JPanel implements FindFilterFactory
{
  /**
  	Find for the first occurrence of the text in this field.
  */
  protected JTextField	contentField = null;

  protected JCheckBox		ignoreCaseCheck = null;


  /**
  	Constructs a user interface and a FindFilterFactory for searching
  	files containing specified text.
  */
  FindByContent ()
  {
  	super();
  	setLayout(new BorderLayout());

  	JPanel p = new JPanel();
  	p.setLayout(new BoxLayout(p,BoxLayout.Y_AXIS));

  	// Name
  	JLabel l = new JLabel("File contains...",SwingConstants.LEFT);
  	l.setForeground(Color.black);
  	l.setFont(new Font("Helvetica",Font.PLAIN,10));
  	p.add(l);

  	contentField = new JTextField();
  	contentField.setForeground(Color.black);
  	contentField.setFont(new Font("Helvetica",Font.PLAIN,10));
  	p.add(contentField);

  	// ignore case
  	ignoreCaseCheck = new JCheckBox("ignore case",true);
  	ignoreCaseCheck.setForeground(Color.black);
  	ignoreCaseCheck.setFont(new Font("Helvetica",Font.PLAIN,9));
  	p.add(ignoreCaseCheck);

  	add(p,BorderLayout.NORTH);
  }

  public FindFilter createFindFilter ()
  {
  	return new ContentFilter(contentField.getText(),
  								ignoreCaseCheck.isSelected());
  }

  /**
  	Implements a simple content filter.
  */
  class ContentFilter implements FindFilter
  {
  	protected String	content = null;
  	protected boolean	ignoreCase = true;

  	ContentFilter (String s, boolean ignore)
  	{
  		content = s;
  		ignoreCase = ignore;
  	}

  	public boolean accept (File f, FindProgressCallback callback)
  	{
  		if (f == null) return false;
  		if (f.isDirectory()) return false;
  		if ((content == null) || (content.length() == 0)) return true;

  		boolean result = false;
  		BufferedInputStream in = null;
  		try
  		{
  			long fileLength = f.length();
  			in = new BufferedInputStream(new FileInputStream(f));
  			byte[] contentBytes = null;
  			if (ignoreCase)
  				contentBytes = content.toLowerCase().getBytes();
  			else
  				contentBytes = content.getBytes();
  			LocatorStream locator = new LocatorStream(contentBytes);
  			long counter = 0;
  			int callbackCounter = 20; // Only call back every 20 bytes
  			int c = -1;
  			while((c = in.read()) != -1)
  			{
  				counter++;
  				int matchChar = c;
  				if (ignoreCase) matchChar =
  					(int)Character.toLowerCase((char)c);
  				locator.write(matchChar);

  				// This search could be time consuming, especially since
  				// this algorithm is not exactly the most efficient.
  				// Report progress to search monitor and abort
  				// if method returns false.
  				if (callback != null)
  				{
  					if (--callbackCounter <= 0)
  					{
  						if (!callback.reportProgress(this,
  											f,counter,fileLength))
  							return false;
  						callbackCounter = 20;
  					}
  				}
  			}
  		}
  		catch (LocatedException e)
  		{
  			result = true;
  		}
  		catch (Throwable e)
  		{
  		}
  		finally
  		{
  			try
  			{
  				if (in != null) in.close();
  			}
  			catch (IOException e)
  			{
  			}
  			return result;
  		}
  	}


  	/**
  		Thrown when a LocatorStream object finds a byte array.
  	*/
  	class LocatedException extends IOException
  	{
  		public LocatedException (String msg)
  		{
  			super(msg);
  		}

  		public LocatedException (long location)
  		{
  			super(String.valueOf(location));
  		}
  	}

  	/**
  		Locate an array of bytes on the output stream. Throws
  		a LocatedStream exception for every occurrence of the byte
  		array.
  	*/
  	class LocatorStream extends OutputStream
  	{
  		protected byte[]	locate = null;
  		protected Vector	matchMakers = new Vector();
  		protected long		mark = 0;

  		LocatorStream (byte[] b)
  		{
  			locate = b;
  		}

  		public void write (int b) throws IOException
  		{
  			if (locate == null)
  				throw new IOException("NULL locator array");
  			if (locate.length == 0)
  				throw new IOException("Empty locator array");

  			long foundAt = -1;

  			for (int i=matchMakers.size()-1; i>=0; i--)
  			{
  				MatchStream m = (MatchStream)matchMakers.elementAt(i);
  				try
  				{
  					m.write(b);
  				}
  				catch (MatchMadeException e)
  				{
  					foundAt = m.getMark();
  					matchMakers.removeElementAt(i);
  				}
  				catch (IOException e)
  				{
  					// Match not made. Remove current matchMaker stream.
  					matchMakers.removeElementAt(i);
  				}
  			}

  			if (b == locate[0])
  			{
  				MatchStream m = new MatchStream(locate,mark);
  				m.write(b); // This will be accepted
  				matchMakers.addElement(m);
  			}
  			mark++;

  			if (foundAt >= 0)
  			{
  				throw new LocatedException(foundAt);
  			}
  		}

  		/**
  			Thrown when the bytes written match the byte pattern.
  		*/
  		class MatchMadeException extends IOException
  		{
  			public MatchMadeException (String msg)
  			{
  				super(msg);
  			}

  			public MatchMadeException (long mark)
  			{
  				super(String.valueOf(mark));
  			}
  		}

  		/**
  			Accept "output" as long as it matches a specified array of
  			bytes.
  			Throw a MatchMadeException when the bytes written equals
  			the match array.
  			Throw an IOException when a byte does not match. Ignore
  			everything after a match is made.
  		*/
  		class MatchStream extends OutputStream
  		{
  			protected long		mark = -1;
  			protected int		pos = 0;
  			protected byte[]	match = null;
  			protected boolean	matchMade = false;

  			MatchStream (byte[] b, long m)
  			{
  				mark = m;
  				match = b;
  			}

  			public void write (int b) throws IOException
  			{
  				if (matchMade) return;
  				if (match == null)
  					throw new IOException("NULL match array");

  				if (match.length == 0)
  					throw new IOException("Empty match array");

  				if (pos >= match.length)
  					throw new IOException("No match");

  				if (b != (byte)match[pos])
  					throw new IOException("No match");

  				pos++;
  				if (pos >= match.length)
  				{
  					matchMade = true;
  					throw new MatchMadeException(mark);
  				}
  			}

  			public long getMark ()
  			{
  				return mark;
  			}
  		}
  	}
  }
}