Initial Android support

src/android/BackgroundMode.java

@@ -0,0 +1,180 @@
+/*
+    Copyright 2013-2014 appPlant UG
+
+    Licensed to the Apache Software Foundation (ASF) under one
+    or more contributor license agreements.  See the NOTICE file
+    distributed with this work for additional information
+    regarding copyright ownership.  The ASF licenses this file
+    to you under the Apache License, Version 2.0 (the
+    "License"); you may not use this file except in compliance
+    with the License.  You may obtain a copy of the License at
+
+     http://www.apache.org/licenses/LICENSE-2.0
+
+    Unless required by applicable law or agreed to in writing,
+    software distributed under the License is distributed on an
+    "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+    KIND, either express or implied.  See the License for the
+    specific language governing permissions and limitations
+    under the License.
+*/
+
+package de.appplant.cordova.plugin.background;
+
+import android.app.Activity;
+import android.content.ComponentName;
+import android.content.Context;
+import android.content.Intent;
+import android.content.ServiceConnection;
+import android.os.IBinder;
+import android.util.Log;
+
+import org.apache.cordova.CallbackContext;
+import org.apache.cordova.CordovaPlugin;
+import org.json.JSONArray;
+import org.json.JSONException;
+
+public class BackgroundMode extends CordovaPlugin {
+
+    // Flag indicates if the app is in background or foreground
+    private boolean inBackground = false;
+
+    // Flag indicates if the plugin is enabled or disabled
+    private boolean isDisabled = false;
+
+    // Used to (un)bind the service to with the activity
+    private ServiceConnection connection = new ServiceConnection() {
+
+        @Override
+        public void onServiceConnected(ComponentName name, IBinder binder) {
+            // Nothing to do here
+            Log.d("BackgroundMode", "Service connected");
+        }
+
+        @Override
+        public void onServiceDisconnected(ComponentName name) {
+            Log.w("BackgroundMode", "Service disrupted");
+            //stopService();
+        }
+    };
+
+    /**
+     * Executes the request.
+     *
+     * @param action   The action to execute.
+     * @param args     The exec() arguments.
+     * @param callback The callback context used when
+     *                 calling back into JavaScript.
+     *
+     * @return
+     *      Returning false results in a "MethodNotFound" error.
+     *
+     * @throws JSONException
+     */
+    @Override
+    public boolean execute (String action, JSONArray args,
+                            CallbackContext callback) throws JSONException {
+
+        if (action.equalsIgnoreCase("observeLifeCycle")) {
+            // Nothing to do here
+            return true;
+        }
+
+        if (action.equalsIgnoreCase("enable")) {
+            enableMode();
+            return true;
+        }
+
+        if (action.equalsIgnoreCase("disable")) {
+            disableMode();
+            return true;
+        }
+
+        return false;
+    }
+
+    /**
+     * Called when the system is about to start resuming a previous activity.
+     *
+     * @param multitasking
+     *      Flag indicating if multitasking is turned on for app
+     */
+    @Override
+    public void onPause(boolean multitasking) {
+        super.onPause(multitasking);
+        inBackground = true;
+        startService();
+    }
+
+
+    /**
+     * Called when the activity will start interacting with the user.
+     *
+     * @param multitasking
+     *      Flag indicating if multitasking is turned on for app
+     */
+    @Override
+    public void onResume(boolean multitasking) {
+        super.onResume(multitasking);
+        inBackground = false;
+        stopService();
+    }
+
+    @Override
+    public void onDestroy() {
+        super.onDestroy();
+        stopService();
+    }
+
+    /**
+     * Enable the background mode.
+     */
+    private void enableMode() {
+        isDisabled = false;
+
+        if (inBackground) {
+            startService();
+        }
+    }
+
+    /**
+     * Disable the background mode.
+     */
+    private void disableMode() {
+        stopService();
+        isDisabled = true;
+    }
+
+    /**
+     * Bind the activity to a background service and put them into foreground
+     * state.
+     */
+    private void startService() {
+        Activity context = cordova.getActivity();
+
+        Intent intent = new Intent(
+                context, ForegroundService.class);
+
+        if (isDisabled)
+            return;
+
+        context.bindService(
+                intent, connection, Context.BIND_AUTO_CREATE);
+
+        context.startService(intent);
+    }
+
+    /**
+     * Bind the activity to a background service and put them into foreground
+     * state.
+     */
+    private void stopService() {
+        Activity context = cordova.getActivity();
+
+        Intent intent = new Intent(
+                context, ForegroundService.class);
+
+        context.unbindService(connection);
+        context.stopService(intent);
+    }
+}