libs.net: complete network functionality

[WeStealzYourDataz.git] / src / uk / ac / ntu / n0521366 / wsyd / libs / net / NetworkMessageEventListenerManager.java

diff --git a/src/uk/ac/ntu/n0521366/wsyd/libs/net/NetworkMessageEventListenerManager.java b/src/uk/ac/ntu/n0521366/wsyd/libs/net/NetworkMessageEventListenerManager.java
new file mode 100644 (file)
index 0000000..7c18a2c
--- /dev/null
+++ b/src/uk/ac/ntu/n0521366/wsyd/libs/net/NetworkMessageEventListenerManager.java
@@ -0,0 +1,106 @@
+/*
+ * The MIT License
+ *
+ * Copyright 2015 eddie.
+ *
+ * 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 uk.ac.ntu.n0521366.wsyd.libs.net;
+
+import java.util.ArrayList;
+
+/**
+ *
+ * @author eddie
+ */
+public class NetworkMessageEventListenerManager implements NetworkMessageEventGenerator {
+    /**
+     * Wrapper allowing filtering of NetworkMessageEvents based on message intent.
+     */
+    public class NetworkMessageEventListenerWithIntent {
+        String _intent;
+        NetworkMessageEventListener _listener;
+        
+        public NetworkMessageEventListenerWithIntent(NetworkMessageEventListener listener, String intent) {
+            _intent = intent;
+            _listener = listener;
+        }
+    }
+    protected ArrayList<NetworkMessageEventListenerWithIntent> _NetworkMessageEventListeners;
+    
+    /**
+     * Construct an empty list of Event Listeners.
+     */
+    NetworkMessageEventListenerManager() {
+        _NetworkMessageEventListeners = new ArrayList<>();
+    }
+    
+    /**
+     * Add a NetworkMessageEvent listener.
+     * 
+     * Listens to all intents.
+     * 
+     * @param listener 
+     */
+    @Override
+    public synchronized void addNetworkMessageEventListener(NetworkMessageEventListener listener) {
+        _NetworkMessageEventListeners.add(new NetworkMessageEventListenerWithIntent(listener, null));
+    }
+
+    /**
+     * Add a filtered NetworkMessageEvent listener.
+     * 
+     * Filters on the intent of the NetworkMessage.
+     * 
+     * @param listener
+     * @param intent null to listen to all intents, otherwise the intent to listen for
+     */
+    @Override
+    public synchronized void addNetworkMessageEventListener(NetworkMessageEventListener listener, String intent) {
+        _NetworkMessageEventListeners.add(new NetworkMessageEventListenerWithIntent(listener, intent));        
+    }
+
+    /**
+     * Remove a NetworkMessageEvent listener.
+     * 
+     * @param listener 
+     */
+    @Override
+    public synchronized void removeNetworkMessageEventListener(NetworkMessageEventListener listener) {
+        for (NetworkMessageEventListenerWithIntent intentListener : _NetworkMessageEventListeners)
+            if (intentListener._listener == listener)
+                _NetworkMessageEventListeners.remove(intentListener);
+    }
+    
+    /**
+     * Send a NetworkMessageEvent to all listeners.
+     * 
+     * Only sends the message to listeners registered for the same intent, or for all messages.
+     * 
+     * @param message the NetworkMessage to send
+     */
+    @Override
+    public synchronized void fireNetworkMessageEvent(NetworkMessage message) {
+        NetworkMessageEvent event = new NetworkMessageEvent(this, message);
+        for (NetworkMessageEventListenerWithIntent intentListener : _NetworkMessageEventListeners) {
+            if (intentListener._intent.equals(message._intent) || intentListener._intent == null)
+                intentListener._listener.NetworkMessageReceived(event);
+        }
+    }
+}