diff options
Diffstat (limited to 'test-runner/src/android/test/ApplicationTestCase.java')
-rw-r--r-- | test-runner/src/android/test/ApplicationTestCase.java | 177 |
1 files changed, 0 insertions, 177 deletions
diff --git a/test-runner/src/android/test/ApplicationTestCase.java b/test-runner/src/android/test/ApplicationTestCase.java deleted file mode 100644 index ae5fa4d..0000000 --- a/test-runner/src/android/test/ApplicationTestCase.java +++ /dev/null @@ -1,177 +0,0 @@ -/* - * Copyright (C) 2008 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.test; - -import java.lang.reflect.Field; - -import android.app.Application; -import android.app.Instrumentation; -import android.content.Context; - -/** - * This test case provides a framework in which you can test Application classes in - * a controlled environment. It provides basic support for the lifecycle of a - * Application, and hooks by which you can inject various dependencies and control - * the environment in which your Application is tested. - * - * <p><b>Lifecycle Support.</b> - * Every Application is designed to be accessed within a specific sequence of - * method calls (see {@link android.app.Application} for more details). - * In order to support the lifecycle of a Application, this test case will make the - * following calls at the following times. - * - * <ul><li>The test case will not call onCreate() until your test calls - * {@link #createApplication()}. This gives you a chance - * to set up or adjust any additional framework or test logic before - * onCreate().</li> - * <li>After your test completes, the test case {@link #tearDown} method is - * automatically called, and it will stop & destroy your application by calling its - * onDestroy() method.</li> - * </ul> - * - * <p><b>Dependency Injection.</b> - * Every Application has one inherent dependency, the {@link android.content.Context Context} in - * which it runs. - * This framework allows you to inject a modified, mock, or isolated replacement for this - * dependencies, and thus perform a true unit test. - * - * <p>If simply run your tests as-is, your Application will be injected with a fully-functional - * Context. - * You can create and inject alternative types of Contexts by calling - * {@link AndroidTestCase#setContext(Context) setContext()}. You must do this <i>before</i> calling - * {@link #createApplication()}. The test framework provides a - * number of alternatives for Context, including {@link android.test.mock.MockContext MockContext}, - * {@link android.test.RenamingDelegatingContext RenamingDelegatingContext}, and - * {@link android.content.ContextWrapper ContextWrapper}. - */ -public abstract class ApplicationTestCase<T extends Application> extends AndroidTestCase { - - Class<T> mApplicationClass; - - private Context mSystemContext; - - public ApplicationTestCase(Class<T> applicationClass) { - mApplicationClass = applicationClass; - } - - private T mApplication; - private boolean mAttached = false; - private boolean mCreated = false; - - /** - * @return Returns the actual Application under test. - */ - public T getApplication() { - return mApplication; - } - - /** - * This will do the work to instantiate the Application under test. After this, your test - * code must also start and stop the Application. - */ - @Override - protected void setUp() throws Exception { - super.setUp(); - - // get the real context, before the individual tests have a chance to muck with it - mSystemContext = getContext(); - } - - /** - * Load and attach the application under test. - */ - private void setupApplication() { - mApplication = null; - try { - mApplication = (T) Instrumentation.newApplication(mApplicationClass, getContext()); - } catch (Exception e) { - assertNotNull(mApplication); - } - mAttached = true; - } - - /** - * Start the Application under test, in the same way as if it was started by the system. - * If you use this method to start the Application, it will automatically - * be stopped by {@link #tearDown}. If you wish to inject a specialized Context for your - * test, by calling {@link AndroidTestCase#setContext(Context) setContext()}, - * you must do so before calling this method. - */ - final protected void createApplication() { - assertFalse(mCreated); - - if (!mAttached) { - setupApplication(); - } - assertNotNull(mApplication); - - mApplication.onCreate(); - mCreated = true; - } - - /** - * This will make the necessary calls to terminate the Application under test (it will - * call onTerminate(). Ordinarily this will be called automatically (by {@link #tearDown}, but - * you can call it directly from your test in order to check for proper shutdown behaviors. - */ - final protected void terminateApplication() { - if (mCreated) { - mApplication.onTerminate(); - } - } - - /** - * Shuts down the Application under test. Also makes sure all resources are cleaned up and - * garbage collected before moving on to the next - * test. Subclasses that override this method should make sure they call super.tearDown() - * at the end of the overriding method. - * - * @throws Exception - */ - @Override - protected void tearDown() throws Exception { - terminateApplication(); - mApplication = null; - - // Scrub out members - protects against memory leaks in the case where someone - // creates a non-static inner class (thus referencing the test case) and gives it to - // someone else to hold onto - scrubClass(ApplicationTestCase.class); - - super.tearDown(); - } - - /** - * Return a real (not mocked or instrumented) system Context that can be used when generating - * Mock or other Context objects for your Application under test. - * - * @return Returns a reference to a normal Context. - */ - public Context getSystemContext() { - return mSystemContext; - } - - /** - * This test simply confirms that the Application class can be instantiated properly. - * - * @throws Exception - */ - final public void testApplicationTestCaseSetUpProperly() throws Exception { - setupApplication(); - assertNotNull("Application class could not be instantiated successfully", mApplication); - } -} |