Add frame changed events, deprecate listener.

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

src/com/dmdirc/FrameContainer.java

@@ -24,6 +24,9 @@ package com.dmdirc;
 
 import com.dmdirc.commandparser.parsers.CommandParser;
 import com.dmdirc.events.ClientLineAddedEvent;
+import com.dmdirc.events.FrameIconChangedEvent;
+import com.dmdirc.events.FrameNameChangedEvent;
+import com.dmdirc.events.FrameTitleChangedEvent;
 import com.dmdirc.interfaces.Connection;
 import com.dmdirc.interfaces.FrameCloseListener;
 import com.dmdirc.interfaces.FrameComponentChangeListener;
@@ -310,6 +313,7 @@ public abstract class FrameContainer {
     protected void setName(final String name) {
         this.name = name;
 
+        eventBus.post(new FrameNameChangedEvent(this, name));
         listeners.getCallable(FrameInfoListener.class).nameChanged(this, name);
     }
 
@@ -322,6 +326,7 @@ public abstract class FrameContainer {
     public void setTitle(final String title) {
         this.title = title;
 
+        eventBus.post(new FrameTitleChangedEvent(this, title));
         listeners.getCallable(FrameInfoListener.class).titleChanged(this, title);
     }
 
@@ -404,6 +409,7 @@ public abstract class FrameContainer {
      * Called when this container's icon is updated.
      */
     private void iconUpdated() {
+        eventBus.post(new FrameIconChangedEvent(this, icon));
         listeners.getCallable(FrameInfoListener.class).iconChanged(this, icon);
     }
 
@@ -597,7 +603,10 @@ public abstract class FrameContainer {
      * Adds a frame info listener to this container.
      *
      * @param listener The listener to be informed of frame information changes.
+     *
+     * @deprecated Use @{link FrameChangedEvent} instead
      */
+    @Deprecated
     public void addFrameInfoListener(final FrameInfoListener listener) {
         listeners.add(FrameInfoListener.class, listener);
     }
@@ -606,7 +615,10 @@ public abstract class FrameContainer {
      * Removes a frame info listener from this container.
      *
      * @param listener The listener to be removed.
+     *
+     * @deprecated Use @{link FrameChangedEvent} instead
      */
+    @Deprecated
     public void removeFrameInfoListener(final FrameInfoListener listener) {
         listeners.remove(FrameInfoListener.class, listener);
     }

src/com/dmdirc/events/FrameChangedEvent.java

@@ -0,0 +1,41 @@
+/*
+ * Copyright (c) 2006-2014 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.events;
+
+import com.dmdirc.FrameContainer;
+
+/**
+ * Base class for all frame info events.
+ */
+public class FrameChangedEvent extends DMDircEvent {
+
+    private final FrameContainer container;
+
+    public FrameChangedEvent(final FrameContainer container) {
+        this.container = container;
+    }
+
+    public FrameContainer getContainer() {
+        return container;
+    }
+}

src/com/dmdirc/events/FrameIconChangedEvent.java

@@ -0,0 +1,42 @@
+/*
+ * Copyright (c) 2006-2014 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.events;
+
+import com.dmdirc.FrameContainer;
+
+/**
+ * Fired when a frame icon changes.
+ */
+public class FrameIconChangedEvent extends FrameChangedEvent {
+
+    private final String icon;
+
+    public FrameIconChangedEvent(final FrameContainer container, final String icon) {
+        super(container);
+        this.icon = icon;
+    }
+
+    public String getIcon() {
+        return icon;
+    }
+}

src/com/dmdirc/events/FrameNameChangedEvent.java

@@ -0,0 +1,42 @@
+/*
+ * Copyright (c) 2006-2014 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.events;
+
+import com.dmdirc.FrameContainer;
+
+/**
+ * Fired when a frame's name changes.
+ */
+public class FrameNameChangedEvent extends FrameChangedEvent {
+
+    private final String name;
+
+    public FrameNameChangedEvent(final FrameContainer container, final String name) {
+        super(container);
+        this.name = name;
+    }
+
+    public String getName() {
+        return name;
+    }
+}

src/com/dmdirc/events/FrameTitleChangedEvent.java

@@ -0,0 +1,42 @@
+/*
+ * Copyright (c) 2006-2014 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.events;
+
+import com.dmdirc.FrameContainer;
+
+/**
+ * Fired when a frame title changes.
+ */
+public class FrameTitleChangedEvent extends FrameChangedEvent {
+
+    private final String title;
+
+    public FrameTitleChangedEvent(final FrameContainer container, final String title) {
+        super(container);
+        this.title = title;
+    }
+
+    public String getTitle() {
+        return title;
+    }
+}

src/com/dmdirc/interfaces/FrameInfoListener.java

@@ -31,7 +31,9 @@ import java.util.EventListener;
  * frame icon or title changes.
  *
  * @since 0.6.3m2
+ * @deprecated Use @{link com.dmdirc.events.FrameChangedEvent} or its children.
  */
+@Deprecated
 public interface FrameInfoListener extends EventListener {
 
     /**