core/java/android/app/Application.java - platform/frameworks/base - Git at Google

 /*
  * Copyright (C) 2006 The Android Open Source Project
  *
  * Licensed 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 android.app;

 import java.util.ArrayList;

 import android.annotation.CallSuper;
 import android.content.ComponentCallbacks;
 import android.content.ComponentCallbacks2;
 import android.content.Context;
 import android.content.ContextWrapper;
 import android.content.Intent;
 import android.content.res.Configuration;
 import android.os.Bundle;

 /**
  * Base class for maintaining global application state. You can provide your own
  * implementation by creating a subclass and specifying the fully-qualified name
  * of this subclass as the <code>"android:name"</code> attribute in your
  * AndroidManifest.xml's <code>&lt;application&gt;</code> tag. The Application
  * class, or your subclass of the Application class, is instantiated before any
  * other class when the process for your application/package is created.
  *
  * <p class="note"><strong>Note: </strong>There is normally no need to subclass
  * Application.  In most situations, static singletons can provide the same
  * functionality in a more modular way.  If your singleton needs a global
  * context (for example to register broadcast receivers), include
  * {@link android.content.Context#getApplicationContext() Context.getApplicationContext()}
  * as a {@link android.content.Context} argument when invoking your singleton's
  * <code>getInstance()</code> method.
  * </p>
  */
 public class Application extends ContextWrapper implements ComponentCallbacks2 {
     private ArrayList<ComponentCallbacks> mComponentCallbacks =
             new ArrayList<ComponentCallbacks>();
     private ArrayList<ActivityLifecycleCallbacks> mActivityLifecycleCallbacks =
             new ArrayList<ActivityLifecycleCallbacks>();
     private ArrayList<OnProvideAssistDataListener> mAssistCallbacks = null;

     /** @hide */
     public LoadedApk mLoadedApk;

     public interface ActivityLifecycleCallbacks {
         void onActivityCreated(Activity activity, Bundle savedInstanceState);
         void onActivityStarted(Activity activity);
         void onActivityResumed(Activity activity);
         void onActivityPaused(Activity activity);
         void onActivityStopped(Activity activity);
         void onActivitySaveInstanceState(Activity activity, Bundle outState);
         void onActivityDestroyed(Activity activity);
     }

     /**
      * Callback interface for use with {@link Application#registerOnProvideAssistDataListener}
      * and {@link Application#unregisterOnProvideAssistDataListener}.
      */
     public interface OnProvideAssistDataListener {
         /**
          * This is called when the user is requesting an assist, to build a full
          * {@link Intent#ACTION_ASSIST} Intent with all of the context of the current
          * application.  You can override this method to place into the bundle anything
          * you would like to appear in the {@link Intent#EXTRA_ASSIST_CONTEXT} part
          * of the assist Intent.
          */
         public void onProvideAssistData(Activity activity, Bundle data);
     }

     public Application() {
         super(null);
     }

     /**
      * Called when the application is starting, before any activity, service,
      * or receiver objects (excluding content providers) have been created.
      * Implementations should be as quick as possible (for example using
      * lazy initialization of state) since the time spent in this function
      * directly impacts the performance of starting the first activity,
      * service, or receiver in a process.
      * If you override this method, be sure to call super.onCreate().
      */
     @CallSuper
     public void onCreate() {
     }

     /**
      * This method is for use in emulated process environments.  It will
      * never be called on a production Android device, where processes are
      * removed by simply killing them; no user code (including this callback)
      * is executed when doing so.
      */
     @CallSuper
     public void onTerminate() {
     }

     @CallSuper
     public void onConfigurationChanged(Configuration newConfig) {
         Object[] callbacks = collectComponentCallbacks();
         if (callbacks != null) {
             for (int i=0; i<callbacks.length; i++) {
                 ((ComponentCallbacks)callbacks[i]).onConfigurationChanged(newConfig);
             }
         }
     }

     @CallSuper
     public void onLowMemory() {
         Object[] callbacks = collectComponentCallbacks();
         if (callbacks != null) {
             for (int i=0; i<callbacks.length; i++) {
                 ((ComponentCallbacks)callbacks[i]).onLowMemory();
             }
         }
     }

     @CallSuper
     public void onTrimMemory(int level) {
         Object[] callbacks = collectComponentCallbacks();
         if (callbacks != null) {
             for (int i=0; i<callbacks.length; i++) {
                 Object c = callbacks[i];
                 if (c instanceof ComponentCallbacks2) {
                     ((ComponentCallbacks2)c).onTrimMemory(level);
                 }
             }
         }
     }

     public void registerComponentCallbacks(ComponentCallbacks callback) {
         synchronized (mComponentCallbacks) {
             mComponentCallbacks.add(callback);
         }
     }

     public void unregisterComponentCallbacks(ComponentCallbacks callback) {
         synchronized (mComponentCallbacks) {
             mComponentCallbacks.remove(callback);
         }
     }

     public void registerActivityLifecycleCallbacks(ActivityLifecycleCallbacks callback) {
         synchronized (mActivityLifecycleCallbacks) {
             mActivityLifecycleCallbacks.add(callback);
         }
     }

     public void unregisterActivityLifecycleCallbacks(ActivityLifecycleCallbacks callback) {
         synchronized (mActivityLifecycleCallbacks) {
             mActivityLifecycleCallbacks.remove(callback);
         }
     }

     public void registerOnProvideAssistDataListener(OnProvideAssistDataListener callback) {
         synchronized (this) {
             if (mAssistCallbacks == null) {
                 mAssistCallbacks = new ArrayList<OnProvideAssistDataListener>();
             }
             mAssistCallbacks.add(callback);
         }
     }

     public void unregisterOnProvideAssistDataListener(OnProvideAssistDataListener callback) {
         synchronized (this) {
             if (mAssistCallbacks != null) {
                 mAssistCallbacks.remove(callback);
             }
         }
     }

     // ------------------ Internal API ------------------

     /**
      * @hide
      */
     /* package */ final void attach(Context context) {
         attachBaseContext(context);
         mLoadedApk = ContextImpl.getImpl(context).mPackageInfo;
     }

     /* package */ void dispatchActivityCreated(Activity activity, Bundle savedInstanceState) {
         Object[] callbacks = collectActivityLifecycleCallbacks();
         if (callbacks != null) {
             for (int i=0; i<callbacks.length; i++) {
                 ((ActivityLifecycleCallbacks)callbacks[i]).onActivityCreated(activity,
                         savedInstanceState);
             }
         }
     }

     /* package */ void dispatchActivityStarted(Activity activity) {
         Object[] callbacks = collectActivityLifecycleCallbacks();
         if (callbacks != null) {
             for (int i=0; i<callbacks.length; i++) {
                 ((ActivityLifecycleCallbacks)callbacks[i]).onActivityStarted(activity);
             }
         }
     }

     /* package */ void dispatchActivityResumed(Activity activity) {
         Object[] callbacks = collectActivityLifecycleCallbacks();
         if (callbacks != null) {
             for (int i=0; i<callbacks.length; i++) {
                 ((ActivityLifecycleCallbacks)callbacks[i]).onActivityResumed(activity);
             }
         }
     }

     /* package */ void dispatchActivityPaused(Activity activity) {
         Object[] callbacks = collectActivityLifecycleCallbacks();
         if (callbacks != null) {
             for (int i=0; i<callbacks.length; i++) {
                 ((ActivityLifecycleCallbacks)callbacks[i]).onActivityPaused(activity);
             }
         }
     }

     /* package */ void dispatchActivityStopped(Activity activity) {
         Object[] callbacks = collectActivityLifecycleCallbacks();
         if (callbacks != null) {
             for (int i=0; i<callbacks.length; i++) {
                 ((ActivityLifecycleCallbacks)callbacks[i]).onActivityStopped(activity);
             }
         }
     }

     /* package */ void dispatchActivitySaveInstanceState(Activity activity, Bundle outState) {
         Object[] callbacks = collectActivityLifecycleCallbacks();
         if (callbacks != null) {
             for (int i=0; i<callbacks.length; i++) {
                 ((ActivityLifecycleCallbacks)callbacks[i]).onActivitySaveInstanceState(activity,
                         outState);
             }
         }
     }

     /* package */ void dispatchActivityDestroyed(Activity activity) {
         Object[] callbacks = collectActivityLifecycleCallbacks();
         if (callbacks != null) {
             for (int i=0; i<callbacks.length; i++) {
                 ((ActivityLifecycleCallbacks)callbacks[i]).onActivityDestroyed(activity);
             }
         }
     }

     private Object[] collectComponentCallbacks() {
         Object[] callbacks = null;
         synchronized (mComponentCallbacks) {
             if (mComponentCallbacks.size() > 0) {
                 callbacks = mComponentCallbacks.toArray();
             }
         }
         return callbacks;
     }

     private Object[] collectActivityLifecycleCallbacks() {
         Object[] callbacks = null;
         synchronized (mActivityLifecycleCallbacks) {
             if (mActivityLifecycleCallbacks.size() > 0) {
                 callbacks = mActivityLifecycleCallbacks.toArray();
             }
         }
         return callbacks;
     }

     /* package */ void dispatchOnProvideAssistData(Activity activity, Bundle data) {
         Object[] callbacks;
         synchronized (this) {
             if (mAssistCallbacks == null) {
                 return;
             }
             callbacks = mAssistCallbacks.toArray();
         }
         if (callbacks != null) {
             for (int i=0; i<callbacks.length; i++) {
                 ((OnProvideAssistDataListener)callbacks[i]).onProvideAssistData(activity, data);
             }
         }
     }
 }
	/*
	* Copyright (C) 2006 The Android Open Source Project
	*
	* Licensed 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 android.app;

	import java.util.ArrayList;

	import android.annotation.CallSuper;
	import android.content.ComponentCallbacks;
	import android.content.ComponentCallbacks2;
	import android.content.Context;
	import android.content.ContextWrapper;
	import android.content.Intent;
	import android.content.res.Configuration;
	import android.os.Bundle;

	/**
	* Base class for maintaining global application state. You can provide your own
	* implementation by creating a subclass and specifying the fully-qualified name
	* of this subclass as the <code>"android:name"</code> attribute in your
	* AndroidManifest.xml's <code><application></code> tag. The Application
	* class, or your subclass of the Application class, is instantiated before any
	* other class when the process for your application/package is created.
	*
	* <p class="note"><strong>Note: </strong>There is normally no need to subclass
	* Application. In most situations, static singletons can provide the same
	* functionality in a more modular way. If your singleton needs a global
	* context (for example to register broadcast receivers), include
	* {@link android.content.Context#getApplicationContext() Context.getApplicationContext()}
	* as a {@link android.content.Context} argument when invoking your singleton's
	* <code>getInstance()</code> method.
	* </p>
	*/
	public class Application extends ContextWrapper implements ComponentCallbacks2 {
	private ArrayList<ComponentCallbacks> mComponentCallbacks =
	new ArrayList<ComponentCallbacks>();
	private ArrayList<ActivityLifecycleCallbacks> mActivityLifecycleCallbacks =
	new ArrayList<ActivityLifecycleCallbacks>();
	private ArrayList<OnProvideAssistDataListener> mAssistCallbacks = null;

	/** @hide */
	public LoadedApk mLoadedApk;

	public interface ActivityLifecycleCallbacks {
	void onActivityCreated(Activity activity, Bundle savedInstanceState);
	void onActivityStarted(Activity activity);
	void onActivityResumed(Activity activity);
	void onActivityPaused(Activity activity);
	void onActivityStopped(Activity activity);
	void onActivitySaveInstanceState(Activity activity, Bundle outState);
	void onActivityDestroyed(Activity activity);
	}

	/**
	* Callback interface for use with {@link Application#registerOnProvideAssistDataListener}
	* and {@link Application#unregisterOnProvideAssistDataListener}.
	*/
	public interface OnProvideAssistDataListener {
	/**
	* This is called when the user is requesting an assist, to build a full
	* {@link Intent#ACTION_ASSIST} Intent with all of the context of the current
	* application. You can override this method to place into the bundle anything
	* you would like to appear in the {@link Intent#EXTRA_ASSIST_CONTEXT} part
	* of the assist Intent.
	*/
	public void onProvideAssistData(Activity activity, Bundle data);
	}

	public Application() {
	super(null);
	}

	/**
	* Called when the application is starting, before any activity, service,
	* or receiver objects (excluding content providers) have been created.
	* Implementations should be as quick as possible (for example using
	* lazy initialization of state) since the time spent in this function
	* directly impacts the performance of starting the first activity,
	* service, or receiver in a process.
	* If you override this method, be sure to call super.onCreate().
	*/
	@CallSuper
	public void onCreate() {
	}

	/**
	* This method is for use in emulated process environments. It will
	* never be called on a production Android device, where processes are
	* removed by simply killing them; no user code (including this callback)
	* is executed when doing so.
	*/
	@CallSuper
	public void onTerminate() {
	}

	@CallSuper
	public void onConfigurationChanged(Configuration newConfig) {
	Object[] callbacks = collectComponentCallbacks();
	if (callbacks != null) {
	for (int i=0; i<callbacks.length; i++) {
	((ComponentCallbacks)callbacks[i]).onConfigurationChanged(newConfig);
	}
	}
	}

	@CallSuper
	public void onLowMemory() {
	Object[] callbacks = collectComponentCallbacks();
	if (callbacks != null) {
	for (int i=0; i<callbacks.length; i++) {
	((ComponentCallbacks)callbacks[i]).onLowMemory();
	}
	}
	}

	@CallSuper
	public void onTrimMemory(int level) {
	Object[] callbacks = collectComponentCallbacks();
	if (callbacks != null) {
	for (int i=0; i<callbacks.length; i++) {
	Object c = callbacks[i];
	if (c instanceof ComponentCallbacks2) {
	((ComponentCallbacks2)c).onTrimMemory(level);
	}
	}
	}
	}

	public void registerComponentCallbacks(ComponentCallbacks callback) {
	synchronized (mComponentCallbacks) {
	mComponentCallbacks.add(callback);
	}
	}

	public void unregisterComponentCallbacks(ComponentCallbacks callback) {
	synchronized (mComponentCallbacks) {
	mComponentCallbacks.remove(callback);
	}
	}

	public void registerActivityLifecycleCallbacks(ActivityLifecycleCallbacks callback) {
	synchronized (mActivityLifecycleCallbacks) {
	mActivityLifecycleCallbacks.add(callback);
	}
	}

	public void unregisterActivityLifecycleCallbacks(ActivityLifecycleCallbacks callback) {
	synchronized (mActivityLifecycleCallbacks) {
	mActivityLifecycleCallbacks.remove(callback);
	}
	}

	public void registerOnProvideAssistDataListener(OnProvideAssistDataListener callback) {
	synchronized (this) {
	if (mAssistCallbacks == null) {
	mAssistCallbacks = new ArrayList<OnProvideAssistDataListener>();
	}
	mAssistCallbacks.add(callback);
	}
	}

	public void unregisterOnProvideAssistDataListener(OnProvideAssistDataListener callback) {
	synchronized (this) {
	if (mAssistCallbacks != null) {
	mAssistCallbacks.remove(callback);
	}
	}
	}

	// ------------------ Internal API ------------------

	/**
	* @hide
	*/
	/* package */ final void attach(Context context) {
	attachBaseContext(context);
	mLoadedApk = ContextImpl.getImpl(context).mPackageInfo;
	}

	/* package */ void dispatchActivityCreated(Activity activity, Bundle savedInstanceState) {
	Object[] callbacks = collectActivityLifecycleCallbacks();
	if (callbacks != null) {
	for (int i=0; i<callbacks.length; i++) {
	((ActivityLifecycleCallbacks)callbacks[i]).onActivityCreated(activity,
	savedInstanceState);
	}
	}
	}

	/* package */ void dispatchActivityStarted(Activity activity) {
	Object[] callbacks = collectActivityLifecycleCallbacks();
	if (callbacks != null) {
	for (int i=0; i<callbacks.length; i++) {
	((ActivityLifecycleCallbacks)callbacks[i]).onActivityStarted(activity);
	}
	}
	}

	/* package */ void dispatchActivityResumed(Activity activity) {
	Object[] callbacks = collectActivityLifecycleCallbacks();
	if (callbacks != null) {
	for (int i=0; i<callbacks.length; i++) {
	((ActivityLifecycleCallbacks)callbacks[i]).onActivityResumed(activity);
	}
	}
	}

	/* package */ void dispatchActivityPaused(Activity activity) {
	Object[] callbacks = collectActivityLifecycleCallbacks();
	if (callbacks != null) {
	for (int i=0; i<callbacks.length; i++) {
	((ActivityLifecycleCallbacks)callbacks[i]).onActivityPaused(activity);
	}
	}
	}

	/* package */ void dispatchActivityStopped(Activity activity) {
	Object[] callbacks = collectActivityLifecycleCallbacks();
	if (callbacks != null) {
	for (int i=0; i<callbacks.length; i++) {
	((ActivityLifecycleCallbacks)callbacks[i]).onActivityStopped(activity);
	}
	}
	}

	/* package */ void dispatchActivitySaveInstanceState(Activity activity, Bundle outState) {
	Object[] callbacks = collectActivityLifecycleCallbacks();
	if (callbacks != null) {
	for (int i=0; i<callbacks.length; i++) {
	((ActivityLifecycleCallbacks)callbacks[i]).onActivitySaveInstanceState(activity,
	outState);
	}
	}
	}

	/* package */ void dispatchActivityDestroyed(Activity activity) {
	Object[] callbacks = collectActivityLifecycleCallbacks();
	if (callbacks != null) {
	for (int i=0; i<callbacks.length; i++) {
	((ActivityLifecycleCallbacks)callbacks[i]).onActivityDestroyed(activity);
	}
	}
	}

	private Object[] collectComponentCallbacks() {
	Object[] callbacks = null;
	synchronized (mComponentCallbacks) {
	if (mComponentCallbacks.size() > 0) {
	callbacks = mComponentCallbacks.toArray();
	}
	}
	return callbacks;
	}

	private Object[] collectActivityLifecycleCallbacks() {
	Object[] callbacks = null;
	synchronized (mActivityLifecycleCallbacks) {
	if (mActivityLifecycleCallbacks.size() > 0) {
	callbacks = mActivityLifecycleCallbacks.toArray();
	}
	}
	return callbacks;
	}

	/* package */ void dispatchOnProvideAssistData(Activity activity, Bundle data) {
	Object[] callbacks;
	synchronized (this) {
	if (mAssistCallbacks == null) {
	return;
	}
	callbacks = mAssistCallbacks.toArray();
	}
	if (callbacks != null) {
	for (int i=0; i<callbacks.length; i++) {
	((OnProvideAssistDataListener)callbacks[i]).onProvideAssistData(activity, data);
	}
	}
	}
	}