Add onMessage(id, data) to plugin API.

A solution was needed to notify the audio player to pause when a phone call comes in. The option was to add a specific onPhone() method or generalize it. Since there are other "events" that are useful to plugins, a generalized solution was used. It is also extensible without changing the plugin API again.

Any plugin can call DroidGap.onMessage() to send a message/event to all other plugins. NetworkManager was updated to send changes in connection status to plugins, so they can intelligently handle lost connections.

framework/src/com/phonegap/api/IPlugin.java

@@ -87,6 +87,14 @@ public interface IPlugin {
      */
     void onDestroy();
 	
+    /**
+     * Called when a message is sent to plugin. 
+     * 
+     * @param id            The message id
+     * @param data          The message data
+     */
+    public void onMessage(String id, Object data);
+
     /**
      * Called when an activity you launched exits, giving you the requestCode you started it with,
      * the resultCode it returned, and any additional data from it. 

framework/src/com/phonegap/api/PhonegapActivity.java

@@ -65,4 +65,12 @@ public abstract class PhonegapActivity extends Activity {
      * @param url				The URL to load.
      */
     abstract public void loadUrl(String url);
+    
+    /**
+     * Send a message to all plugins. 
+     * 
+     * @param id            The message id
+     * @param data          The message data
+     */
+    abstract public void onMessage(String id, Object data);
 }

framework/src/com/phonegap/api/Plugin.java

@@ -103,6 +103,15 @@ public abstract class Plugin implements IPlugin {
     public void onDestroy() {
     }
 	
+    /**
+     * Called when a message is sent to plugin. 
+     * 
+     * @param id            The message id
+     * @param data          The message data
+     */
+    public void onMessage(String id, Object data) {
+    }
+
     /**
      * Called when an activity you launched exits, giving you the requestCode you started it with,
      * the resultCode it returned, and any additional data from it. 

framework/src/com/phonegap/api/PluginManager.java

@@ -318,7 +318,23 @@ public final class PluginManager {
     		plugin.onDestroy();
     	}
     }
-    
+
+    /**
+     * Send a message to all plugins. 
+     * 
+     * @param id            The message id
+     * @param data          The message data
+     */
+    public void onMessage(String id, Object data) {
+        java.util.Set<Entry<String,IPlugin>> s = this.plugins.entrySet();
+        java.util.Iterator<Entry<String,IPlugin>> it = s.iterator();
+        while(it.hasNext()) {
+            Entry<String,IPlugin> entry = it.next();
+            IPlugin plugin = entry.getValue();
+            plugin.onMessage(id, data);
+        }
+    }
+
     /**
      * Called when the activity receives a new intent. 
      */