Add CommandOptions class and make all server commands that can't be used

offline use it. Fixes issue 2317.

src/com/dmdirc/commandparser/commands/CommandOptions.java

+/*
+ * Copyright (c) 2006-2009 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.commandparser.commands;
+
+import java.lang.annotation.ElementType;
+import java.lang.annotation.Retention;
+import java.lang.annotation.RetentionPolicy;
+import java.lang.annotation.Target;
+
+/**
+ * Allows commands to define options that affect their behaviour.
+ *
+ * @since 0.6.3
+ * @author chris
+ */
+@Retention(RetentionPolicy.RUNTIME)
+@Target(ElementType.TYPE)
+public @interface CommandOptions {
+
+    /**
+     * Whether or not to allow use of the command while not connected.
+     *
+     * @return True if the command may be used offline, false otherwise
+     */
+    boolean allowOffline() default true;
+
+}

src/com/dmdirc/commandparser/commands/server/Away.java

 package com.dmdirc.commandparser.commands.server;
 
 import com.dmdirc.Server;
-import com.dmdirc.ServerState;
 import com.dmdirc.commandparser.CommandArguments;
 import com.dmdirc.commandparser.CommandManager;
+import com.dmdirc.commandparser.commands.CommandOptions;
 import com.dmdirc.commandparser.commands.ServerCommand;
 import com.dmdirc.ui.interfaces.InputWindow;
 
  * The away command allows the user to set their away message.
  * @author chris
  */
+@CommandOptions(allowOffline=false)
 public final class Away extends ServerCommand {
     
     /**
     @Override
     public void execute(final InputWindow origin, final Server server,
             final boolean isSilent, final CommandArguments args) {
-        if (server.getState() == ServerState.CONNECTED) {
-            final String line = args.getArgumentsAsString();
+        final String line = args.getArgumentsAsString();
 
-            server.getParser().sendLine("AWAY :" + line);
-        } else {
-            sendLine(origin, isSilent, FORMAT_ERROR, "Not connected");
-        }
+        server.getParser().sendLine("AWAY :" + line);
     }
     
     

src/com/dmdirc/commandparser/commands/server/Back.java

 package com.dmdirc.commandparser.commands.server;
 
 import com.dmdirc.Server;
-import com.dmdirc.ServerState;
 import com.dmdirc.commandparser.CommandArguments;
 import com.dmdirc.commandparser.CommandManager;
+import com.dmdirc.commandparser.commands.CommandOptions;
 import com.dmdirc.commandparser.commands.IntelligentCommand;
 import com.dmdirc.commandparser.commands.ServerCommand;
 import com.dmdirc.ui.input.AdditionalTabTargets;
  * The back command allows the user to unset their away status.
  * @author chris
  */
+@CommandOptions(allowOffline=false)
 public final class Back extends ServerCommand implements IntelligentCommand {
     
     /**
      */
     @Override
     public void execute(final InputWindow origin, final Server server,
-            final boolean isSilent, final CommandArguments args) {
-        if (server.getState() != ServerState.CONNECTED) {
-            sendLine(origin, isSilent, FORMAT_ERROR, "Not connected");
-            return;
-        }
-        
+            final boolean isSilent, final CommandArguments args) {        
         server.getParser().sendLine("AWAY");
     }
     

src/com/dmdirc/commandparser/commands/server/Ctcp.java

 package com.dmdirc.commandparser.commands.server;
 
 import com.dmdirc.Server;
-import com.dmdirc.ServerState;
 import com.dmdirc.commandparser.CommandArguments;
 import com.dmdirc.commandparser.CommandManager;
+import com.dmdirc.commandparser.commands.CommandOptions;
 import com.dmdirc.commandparser.commands.IntelligentCommand;
 import com.dmdirc.commandparser.commands.ServerCommand;
 import com.dmdirc.ui.input.AdditionalTabTargets;
  * Allows the user to send CTCP messages.
  * @author chris
  */
+@CommandOptions(allowOffline=false)
 public final class Ctcp extends ServerCommand implements IntelligentCommand {
     
     /**
     @Override
     public void execute(final InputWindow origin, final Server server,
             final boolean isSilent, final CommandArguments args) {
-        if (server.getState() != ServerState.CONNECTED) {
-            sendLine(origin, isSilent, FORMAT_ERROR, "Not connected");
-            return;
-        }
-
         if (args.getArguments().length < 2) {
             showUsage(origin, isSilent, "ctcp", "<target> <type> [arguments]");
         } else {

src/com/dmdirc/commandparser/commands/server/Disconnect.java

      * @param isSilent Whether this command is silenced or not
      * @param args The user supplied arguments
      */
+    @Override
     public void execute(final InputWindow origin, final Server server,
             final boolean isSilent, final CommandArguments args) {
         String line;
     }
     
     
-    /** {@inheritDoc}. */
+    /** {@inheritDoc} */
+    @Override
     public String getName() {
         return "disconnect";
     }
     
-    /** {@inheritDoc}. */
+    /** {@inheritDoc} */
+    @Override
     public boolean showInHelp() {
         return true;
     }
     
-    /** {@inheritDoc}. */
+    /** {@inheritDoc} */
+    @Override
     public String getHelp() {
         return "disconnect [reason] - disconnect from this server";
     }

src/com/dmdirc/commandparser/commands/server/Message.java

 package com.dmdirc.commandparser.commands.server;
 
 import com.dmdirc.Server;
-import com.dmdirc.ServerState;
 import com.dmdirc.commandparser.CommandArguments;
 import com.dmdirc.commandparser.CommandManager;
+import com.dmdirc.commandparser.commands.CommandOptions;
 import com.dmdirc.commandparser.commands.IntelligentCommand;
 import com.dmdirc.commandparser.commands.ServerCommand;
 import com.dmdirc.commandparser.commands.WrappableCommand;
  * Allows the user to send privmsgs.
  * @author chris
  */
+@CommandOptions(allowOffline=false)
 public final class Message extends ServerCommand implements IntelligentCommand,
         WrappableCommand {
     
     @Override
     public void execute(final InputWindow origin, final Server server,
             final boolean isSilent, final CommandArguments args) {
-        if (server.getState() != ServerState.CONNECTED) {
-            sendLine(origin, isSilent, FORMAT_ERROR, "Not connected");
-            return;
-        }
-        
         if (args.getArguments().length < 2) {
             showUsage(origin, isSilent, "msg", "<target> <message>");
         } else {

src/com/dmdirc/commandparser/commands/server/Nick.java

 import com.dmdirc.Server;
 import com.dmdirc.commandparser.CommandArguments;
 import com.dmdirc.commandparser.CommandManager;
+import com.dmdirc.commandparser.commands.CommandOptions;
 import com.dmdirc.commandparser.commands.IntelligentCommand;
 import com.dmdirc.commandparser.commands.ServerCommand;
 import com.dmdirc.ui.input.AdditionalTabTargets;
  * Allows the user to change nickname.
  * @author chris
  */
+@CommandOptions(allowOffline=false)
 public final class Nick extends ServerCommand implements IntelligentCommand {
     
     /**

src/com/dmdirc/commandparser/commands/server/Notice.java

 import com.dmdirc.ServerState;
 import com.dmdirc.commandparser.CommandArguments;
 import com.dmdirc.commandparser.CommandManager;
+import com.dmdirc.commandparser.commands.CommandOptions;
 import com.dmdirc.commandparser.commands.IntelligentCommand;
 import com.dmdirc.commandparser.commands.ServerCommand;
 import com.dmdirc.ui.input.AdditionalTabTargets;
  * Allows the user to send notices.
  * @author chris
  */
+@CommandOptions(allowOffline=false)
 public final class Notice extends ServerCommand implements IntelligentCommand {
     
     /**
     @Override
     public void execute(final InputWindow origin, final Server server,
             final boolean isSilent, final CommandArguments args) {
-        if (server.getState() != ServerState.CONNECTED) {
-            sendLine(origin, isSilent, FORMAT_ERROR, "Not connected");
-            return;
-        }
-        
         if (args.getArguments().length < 2) {
             showUsage(origin, isSilent, "notice", "<target> <message>");
         } else {

src/com/dmdirc/commandparser/commands/server/Raw.java

 import com.dmdirc.Server;
 import com.dmdirc.commandparser.CommandArguments;
 import com.dmdirc.commandparser.CommandManager;
+import com.dmdirc.commandparser.commands.CommandOptions;
 import com.dmdirc.commandparser.commands.ServerCommand;
 import com.dmdirc.ui.interfaces.InputWindow;
 
  * irc server.
  * @author chris
  */
+@CommandOptions(allowOffline=false)
 public final class Raw extends ServerCommand {
     
     /**

src/com/dmdirc/commandparser/commands/server/RawServerCommand.java

 import com.dmdirc.Server;
 import com.dmdirc.commandparser.CommandArguments;
 import com.dmdirc.commandparser.CommandManager;
+import com.dmdirc.commandparser.commands.CommandOptions;
 import com.dmdirc.commandparser.commands.ServerCommand;
 import com.dmdirc.ui.interfaces.InputWindow;
 
  * 
  * @author chris
  */
+@CommandOptions(allowOffline=false)
 public final class RawServerCommand extends ServerCommand {
     
     /** The name of this raw command. */

src/com/dmdirc/commandparser/commands/server/Umode.java

 import com.dmdirc.ServerState;
 import com.dmdirc.commandparser.CommandArguments;
 import com.dmdirc.commandparser.CommandManager;
+import com.dmdirc.commandparser.commands.CommandOptions;
 import com.dmdirc.commandparser.commands.ServerCommand;
 import com.dmdirc.ui.interfaces.InputWindow;
 
  * 
  * @author chris
  */
+@CommandOptions(allowOffline=false)
 public class Umode extends ServerCommand {
     
     /**

src/com/dmdirc/commandparser/parsers/CommandParser.java

 import com.dmdirc.commandparser.CommandManager;
 import com.dmdirc.commandparser.CommandType;
 import com.dmdirc.commandparser.commands.Command;
+import com.dmdirc.commandparser.commands.CommandOptions;
 import com.dmdirc.commandparser.commands.ExternalCommand;
 import com.dmdirc.commandparser.commands.PreviousCommand;
 import com.dmdirc.config.IdentityManager;
      */
     protected abstract void handleNonCommand(final InputWindow origin,
             final String line);
+
+    /**
+     * Determines if the specified command has defined any command options.
+     *
+     * @param command The command to investigate
+     * @return True if the command defines options, false otherwise
+     */
+    protected boolean hasCommandOptions(final Command command) {
+        return command.getClass().isAnnotationPresent(CommandOptions.class);
+    }
+
+    /**
+     * Retrieves the command options for the specified command. If the command
+     * does not define options, this method will return null.
+     *
+     * @param command The command whose options should be retrieved
+     * @return The command's options, or null if not available
+     */
+    protected CommandOptions getCommandOptions(final Command command) {
+        return command.getClass().getAnnotation(CommandOptions.class);
+    }
 }

src/com/dmdirc/commandparser/parsers/ServerCommandParser.java

 package com.dmdirc.commandparser.parsers;
 
 import com.dmdirc.Server;
+import com.dmdirc.ServerState;
 import com.dmdirc.commandparser.CommandArguments;
 import com.dmdirc.commandparser.CommandManager;
 import com.dmdirc.commandparser.CommandType;
     protected void executeCommand(final InputWindow origin,
             final boolean isSilent, final Command command, final CommandArguments args) {
         if (command instanceof ServerCommand) {
-            ((ServerCommand) command).execute(origin, server, isSilent, args);
+            if (hasCommandOptions(command) && !getCommandOptions(command).allowOffline()
+                    && ((server.getState() != ServerState.CONNECTED
+                    && server.getState() != ServerState.CONNECTING)
+                    || server.getParser() == null)) {
+                if (!isSilent) {
+                    origin.addLine("commandError", "You must be connected to use this command");
+                }
+            } else {
+                ((ServerCommand) command).execute(origin, server, isSilent, args);
+            }
         } else {
             ((GlobalCommand) command).execute(origin, isSilent, args);
         }