123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278 |
- /*
- * Copyright (c) 2006-2010 Chris Smith, Shane Mc Cormack, Gregory Holmes
- *
- * Permission is hereby granted, free of charge, to any person obtaining a copy
- * of this software and associated documentation files (the "Software"), to deal
- * in the Software without restriction, including without limitation the rights
- * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
- * copies of the Software, and to permit persons to whom the Software is
- * furnished to do so, subject to the following conditions:
- *
- * The above copyright notice and this permission notice shall be included in
- * all copies or substantial portions of the Software.
- *
- * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
- * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
- * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
- * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
- * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
- * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
- * SOFTWARE.
- */
-
- package com.dmdirc.ui.input;
-
- import com.dmdirc.commandparser.CommandArguments;
- import com.dmdirc.commandparser.CommandInfo;
- import com.dmdirc.commandparser.CommandManager;
- import com.dmdirc.commandparser.commands.ChannelCommand;
- import com.dmdirc.commandparser.commands.Command;
- import com.dmdirc.commandparser.commands.IntelligentCommand;
- import com.dmdirc.config.IdentityManager;
- import com.dmdirc.util.MapList;
-
- import java.io.Serializable;
- import java.util.Arrays;
- import java.util.List;
- import java.util.Locale;
- import java.util.Map;
-
- /**
- * The tab completer handles a user's request to tab complete some word.
- *
- * @author chris
- */
- public final class TabCompleter implements Serializable {
-
- /**
- * A version number for this class. It should be changed whenever the class
- * structure is changed (or anything else that would prevent serialized
- * objects being unserialized with the new class).
- */
- private static final long serialVersionUID = 1;
-
- /**
- * The parent TabCompleter. Results from parents are merged with results
- * from this completer.
- */
- private TabCompleter parent;
-
- /**
- * The entries in this completer.
- */
- private final MapList<TabCompletionType, String> entries
- = new MapList<TabCompletionType, String>();
-
- /** Creates a new instance of TabCompleter. */
- public TabCompleter() {
- //Do nothing.
- }
-
- /**
- * Creates a new instance of TabCompleter, with a designated parent.
- * @param newParent The parent TabCompleter, which is checked for matches if
- * local ones fail
- */
- public TabCompleter(final TabCompleter newParent) {
- this.parent = newParent;
- }
-
- /**
- * Attempts to complete the partial string.
- *
- * @param partial The string to tab complete
- * @param additionals A list of additional strings to use
- * @return A TabCompleterResult containing any matches found
- */
- public TabCompleterResult complete(final String partial,
- final AdditionalTabTargets additionals) {
- final TabCompleterResult result = new TabCompleterResult();
-
- final MapList<TabCompletionType, String> targets
- = new MapList<TabCompletionType, String>(entries);
-
- final boolean caseSensitive = IdentityManager.getGlobalConfig()
- .getOptionBool("tabcompletion", "casesensitive");
- final boolean allowEmpty = IdentityManager.getGlobalConfig()
- .getOptionBool("tabcompletion", "allowempty");
-
- if (partial.isEmpty() && !allowEmpty) {
- return result;
- }
-
- if (additionals != null) {
- targets.safeGet(TabCompletionType.ADDITIONAL).addAll(additionals);
- }
-
- for (Map.Entry<TabCompletionType, List<String>> typeEntry : targets.entrySet()) {
- if (additionals != null && !additionals.shouldInclude(typeEntry.getKey())) {
- // If we're not including this type, skip to the next.
- continue;
- }
-
- for (String entry : typeEntry.getValue()) {
- // Skip over duplicates
- if (result.hasResult(entry)) {
- continue;
- }
-
- if (caseSensitive && entry.startsWith(partial)) {
- result.addResult(entry);
- } else if (!caseSensitive && entry.toLowerCase(Locale.getDefault())
- .startsWith(partial.toLowerCase(Locale.getDefault()))) {
- result.addResult(entry);
- }
- }
- }
-
- if (parent != null) {
- if (additionals != null) {
- additionals.clear();
- }
-
- result.merge(parent.complete(partial, additionals));
- }
-
- return result;
- }
-
- /**
- * Adds a new entry to this tab completer's list.
- *
- * @param type The type of the entry that's being added
- * @param entry The new entry to be added
- */
- public void addEntry(final TabCompletionType type, final String entry) {
- entries.add(type, entry);
-
- if (type == TabCompletionType.COMMAND
- && entry.startsWith(String.valueOf(CommandManager.getCommandChar()))
- && !entry.startsWith(String.valueOf(CommandManager.getCommandChar())
- + CommandManager.getSilenceChar())) {
- // If we're adding a command name that doesn't include the silence
- // character, also add a version with the silence char
- addEntry(type, entry.substring(0, 1) + CommandManager.getSilenceChar()
- + entry.substring(1));
- }
- }
-
- /**
- * Adds multiple new entries to this tab completer's list.
- *
- * @param type The type of the entries that're being added
- * @param newEntries Entries to be added
- */
- public void addEntries(final TabCompletionType type, final List<String> newEntries) {
- if (newEntries == null) {
- return;
- }
-
- for (String entry : newEntries) {
- addEntry(type, entry);
- }
- }
-
- /**
- * Removes a specified entry from this tab completer's list.
- *
- * @param type The type of the entry that should be removed
- * @param entry The entry to be removed
- */
- public void removeEntry(final TabCompletionType type, final String entry) {
- entries.remove(type, entry);
- }
-
- /**
- * Replaces the current entries with the new list.
- *
- * @param type The type of entry which should be replaced
- * @param newEntries the new entries to use
- */
- public void replaceEntries(final TabCompletionType type, final List<String> newEntries) {
- entries.clear(type);
- entries.add(type, newEntries);
- }
-
- /**
- * Clears all entries in this tab completer.
- */
- public void clear() {
- entries.clear();
- }
-
- /**
- * Clears all entries of the specified type in this tab completer.
- *
- * @param type The type of entry to clear
- */
- public void clear(final TabCompletionType type) {
- entries.clear(type);
- }
-
- /**
- * Retrieves intelligent results for a deferred command.
- *
- * @param arg The argument number that is being requested
- * @param previousArgs The full list of previous arguments
- * @param offset The number of arguments our command used before deferring
- * to this method
- * @return Additional tab targets for the text, or null if none are available
- */
- public static AdditionalTabTargets getIntelligentResults(final int arg,
- final List<String> previousArgs, final int offset) {
- if (arg == offset) {
- final AdditionalTabTargets targets = new AdditionalTabTargets().excludeAll();
- targets.include(TabCompletionType.COMMAND);
- return targets;
- } else {
- return getIntelligentResults(
- new CommandArguments(previousArgs.subList(offset, previousArgs.size())));
- }
- }
-
- /**
- * Retrieves the intelligent results for the command and its arguments
- * formed from args.
- *
- * @param args The input arguments
- * @return Additional tab targets for the text, or null if none are available
- */
- private static AdditionalTabTargets getIntelligentResults(final CommandArguments args) {
- if (!args.isCommand()) {
- return null;
- }
-
- final Map.Entry<CommandInfo, Command> command
- = CommandManager.getCommand(args.getCommandName());
-
- AdditionalTabTargets targets = null;
-
- if (command != null) {
- if (command.getValue() instanceof IntelligentCommand) {
- targets = ((IntelligentCommand) command.getValue())
- .getSuggestions(args.getArguments().length,
- Arrays.asList(args.getArgumentsAsString()));
- }
-
- if (command.getValue() instanceof ChannelCommand) {
- if (targets == null) {
- targets = new AdditionalTabTargets();
- }
-
- targets.include(TabCompletionType.CHANNEL);
- }
- }
-
- return targets;
- }
-
- /**
- * Handles potentially intelligent tab completion.
- *
- * @param text The text that is being completed
- * @return Additional tab targets for the text, or null if none are available
- */
- public static AdditionalTabTargets getIntelligentResults(final String text) {
- return getIntelligentResults(new CommandArguments(text));
- }
- }
|