2010-03-09 13:46:02 -05:00
|
|
|
/*
|
2010-03-12 14:35:25 -05:00
|
|
|
Yaaic - Yet Another Android IRC Client
|
2010-03-09 13:46:02 -05:00
|
|
|
|
2011-02-05 07:00:12 -05:00
|
|
|
Copyright 2009-2011 Sebastian Kaspari
|
2010-03-09 13:46:02 -05:00
|
|
|
|
|
|
|
This file is part of Yaaic.
|
|
|
|
|
|
|
|
Yaaic 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 3 of the License, or
|
|
|
|
(at your option) any later version.
|
|
|
|
|
|
|
|
Yaaic 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 Yaaic. If not, see <http://www.gnu.org/licenses/>.
|
2011-01-25 15:02:27 -05:00
|
|
|
*/
|
2010-03-09 13:46:02 -05:00
|
|
|
package org.yaaic.command;
|
|
|
|
|
2010-03-14 08:35:16 -04:00
|
|
|
import org.yaaic.exception.CommandException;
|
2010-03-09 13:46:02 -05:00
|
|
|
import org.yaaic.irc.IRCService;
|
2010-03-10 14:58:11 -05:00
|
|
|
import org.yaaic.model.Conversation;
|
2010-03-09 13:46:02 -05:00
|
|
|
import org.yaaic.model.Server;
|
|
|
|
|
2010-09-05 10:05:51 -04:00
|
|
|
import android.content.Context;
|
|
|
|
|
2010-03-09 13:46:02 -05:00
|
|
|
/**
|
|
|
|
* Base class for commands
|
|
|
|
*
|
|
|
|
* @author Sebastian Kaspari <sebastian@yaaic.org>
|
|
|
|
*/
|
2010-03-10 03:01:49 -05:00
|
|
|
public abstract class BaseHandler
|
2010-03-09 13:46:02 -05:00
|
|
|
{
|
2010-11-18 12:52:19 -05:00
|
|
|
/**
|
|
|
|
* Execute the command
|
|
|
|
*
|
|
|
|
* @param params The params given (0 is the command itself)
|
|
|
|
* @param server The server object
|
|
|
|
* @param channel The channel object or null if no channel is selected
|
|
|
|
* @param service The service with all server connections
|
|
|
|
* @throws CommandException if command couldn't be executed
|
|
|
|
*/
|
|
|
|
public abstract void execute(String[] params, Server server, Conversation conversation, IRCService service) throws CommandException;
|
2011-01-25 15:02:27 -05:00
|
|
|
|
2010-11-18 12:52:19 -05:00
|
|
|
/**
|
|
|
|
* Get the usage description for this command
|
|
|
|
*
|
|
|
|
* @return The usage description
|
|
|
|
*/
|
|
|
|
public abstract String getUsage();
|
2011-01-25 15:02:27 -05:00
|
|
|
|
2010-11-18 12:52:19 -05:00
|
|
|
/**
|
|
|
|
* Get the description for this command
|
|
|
|
*
|
|
|
|
* @param context The current context. Needed for getting string resources
|
|
|
|
* @return
|
|
|
|
*/
|
|
|
|
public abstract String getDescription(Context context);
|
2011-01-25 15:02:27 -05:00
|
|
|
|
2010-11-18 12:52:19 -05:00
|
|
|
/**
|
|
|
|
* Merge params to a string
|
|
|
|
*
|
|
|
|
* @params params The params to merge
|
|
|
|
*/
|
|
|
|
public static String mergeParams(String[] params)
|
|
|
|
{
|
|
|
|
return mergeParams(params, 1);
|
|
|
|
}
|
2011-01-25 15:02:27 -05:00
|
|
|
|
2010-11-18 12:52:19 -05:00
|
|
|
/**
|
|
|
|
* Merge params to a string
|
|
|
|
*
|
|
|
|
* @param params The params to merge
|
|
|
|
* @param position Start at given param
|
|
|
|
*/
|
|
|
|
public static String mergeParams(String[] params, int position)
|
|
|
|
{
|
|
|
|
StringBuffer buffer = new StringBuffer();
|
2011-01-25 15:02:27 -05:00
|
|
|
|
2010-11-18 12:52:19 -05:00
|
|
|
for (; position < params.length; position++) {
|
|
|
|
buffer.append(params[position]);
|
|
|
|
buffer.append(" ");
|
|
|
|
}
|
2011-01-25 15:02:27 -05:00
|
|
|
|
2010-11-18 12:52:19 -05:00
|
|
|
return buffer.toString().trim();
|
|
|
|
}
|
2010-03-09 13:46:02 -05:00
|
|
|
}
|