Add command to bounce dock icon on OSX

Change-Id: I4f0ae98d92e106e72388b81e1c7747f9a7ed68a6
Reviewed-on: http://gerrit.dmdirc.com/2569
Reviewed-by: Chris Smith <chris@dmdirc.com>
Automatic-Compile: DMDirc Build Manager

.gitignore

@@ -1,2 +1,3 @@
 /build
 /dist
+*.iml

src/com/dmdirc/addons/osx_integration/DockBounceCommand.java

@@ -0,0 +1,68 @@
+/*
+ * Copyright (c) 2006-2012 DMDirc Developers
+ *
+ * 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.addons.osx_integration;
+
+import com.dmdirc.FrameContainer;
+import com.dmdirc.addons.ui_swing.Apple;
+import com.dmdirc.commandparser.BaseCommandInfo;
+import com.dmdirc.commandparser.CommandArguments;
+import com.dmdirc.commandparser.CommandType;
+import com.dmdirc.commandparser.commands.Command;
+import com.dmdirc.commandparser.commands.context.CommandContext;
+
+/**
+ * A command to bounce the icon in the OSX dock.
+ */
+public class DockBounceCommand extends Command {
+
+    /**
+     * Information about this command.
+     */
+    public static final BaseCommandInfo INFO = new BaseCommandInfo(
+            "dockbounce",
+            "dockbounce - bounce the dock icon on OS X",
+            CommandType.TYPE_GLOBAL
+    );
+
+    /**
+     * The current UI's Apple-specific library.
+     */
+    private final Apple apple;
+
+    /**
+     * Creates an instance of {@link DockBounceCommand}.
+     *
+     * @param apple The UI wrapper for Apple-specific things
+     */
+    public DockBounceCommand(final Apple apple) {
+        this.apple = apple;
+    }
+
+    /** {@inheritDoc} */
+    @Override
+    public void execute(final FrameContainer origin,
+                        final CommandArguments args,
+                        final CommandContext context) {
+        apple.requestUserAttention(false);
+    }
+}

src/com/dmdirc/addons/osx_integration/OsxIntegrationPlugin.java

@@ -0,0 +1,43 @@
+/*
+ * Copyright (c) 2006-2012 DMDirc Developers
+ *
+ * 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.addons.osx_integration;
+
+import com.dmdirc.addons.ui_swing.SwingController;
+import com.dmdirc.plugins.BasePlugin;
+
+/**
+ * A plugin which provides extra commands that integrate with the OS X
+ * environment.
+ */
+public class OsxIntegrationPlugin extends BasePlugin {
+
+    /**
+     * Creates an instance of {@link OsxIntegrationPlugin}.
+     *
+     * @param controller The Swing UI which runs on the OS X environment
+     */
+    public OsxIntegrationPlugin(final SwingController controller) {
+        registerCommand(new DockBounceCommand(controller.getApple()),
+                DockBounceCommand.INFO);
+    }
+}

src/com/dmdirc/addons/osx_integration/plugin.config

@@ -0,0 +1,27 @@
+keysections:
+  metadata
+  requires
+  version
+  updates
+
+metadata:
+  author=Chris Northwood <chrisn@dmdirc.com>
+  mainclass=com.dmdirc.addons.osx_integration.OsxIntegrationPlugin
+  description=Provides commands that integrate with OSX
+  name=osx_integration
+  nicename=OSX Integration Plugin
+
+requires:
+  parent=ui_swing
+
+required-services:
+  swing ui
+
+updates:
+  id=72
+
+version:
+  friendly=1.0
+
+provides:
+  dockbounce command