autocompletelist.java

google公司的用Java写的一个聊天软件的原代码

/***************************************************************************
 *   Copyright 2006-2008 by Christian Ihle                                 *
 *   [e-mail]                                                  *
 *                                                                         *
 *   This program is free software; you can redistribute it and/or modify  *
 *   it under the terms of the GNU General Public License as published by  *
 *   the Free Software Foundation; either version 2 of the License, or     *
 *   (at your option) any later version.                                   *
 *                                                                         *
 *   This program is distributed in the hope that it will be useful,       *
 *   but WITHOUT ANY WARRANTY; without even the implied warranty of        *
 *   MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the         *
 *   GNU General Public License for more details.                          *
 *                                                                         *
 *   You should have received a copy of the GNU General Public License     *
 *   along with this program; if not, write to the                         *
 *   Free Software Foundation, Inc.,                                       *
 *   59 Temple Place - Suite 330, Boston, MA  02111-1307, USA.             *
 ***************************************************************************/

package net.usikkert.kouchat.autocomplete;

/**
 * This interface is used by {@link AutoCompleter} to check for suggestions
 * for autocompleting a word.
 * <br><br>
 * Implement this to add support for more types of words.
 *
 * @author Christian Ihle
 */
public interface AutoCompleteList
{
	/**
	 * Gets the list of words this autocompleter currently contains.
	 *
	 * @return The list of words for this autocompleter.
	 */
	String[] getWordList();

	/**
	 * Checks if this autocompleter supports that type of word.
	 * <br><br>
	 * This should <strong>not</strong> check if the list of words contains
	 * a match, only if the word matches a pattern of words this list can
	 * have.
	 * <br><br>
	 * The use of a regex match, or a {@link String#startsWith(String)}
	 * is a good start.
	 *
	 * @param word The word to check.
	 * @return True if this autocompleter can give suggestions for that
	 * type of word.
	 */
	boolean acceptsWord( String word );
}