Home | History | Annotate | Download | only in test
      1 /*
      2  * Copyright (C) 2012 The Android Open Source Project
      3  *
      4  * Licensed under the Apache License, Version 2.0 (the "License");
      5  * you may not use this file except in compliance with the License.
      6  * You may obtain a copy of the License at
      7  *
      8  *      http://www.apache.org/licenses/LICENSE-2.0
      9  *
     10  * Unless required by applicable law or agreed to in writing, software
     11  * distributed under the License is distributed on an "AS IS" BASIS,
     12  * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
     13  * See the License for the specific language governing permissions and
     14  * limitations under the License.
     15  */
     16 package com.android.test;
     17 
     18 import android.app.Instrumentation;
     19 import android.content.Context;
     20 import android.test.AndroidTestCase;
     21 
     22 import junit.framework.Test;
     23 
     24 import org.junit.Before;
     25 
     26 import java.lang.annotation.ElementType;
     27 import java.lang.annotation.Retention;
     28 import java.lang.annotation.RetentionPolicy;
     29 import java.lang.annotation.Target;
     30 
     31 /**
     32  * Use this to inject a {@link Context} representing {@link Instrumentation#getTargetContext()}
     33  * into your JUnit4-style test.
     34  * <p/>
     35  * To use, just add the correct annotation to an {@link Context} field like this:
     36  * <pre>
     37  *     &#64;InjectContext public Context mMyContext;
     38  * </pre>
     39  * The test runner will set the value of this field with the {@link Instrumentation} after
     40  * object construction but before any {@link Before} methods are called.
     41  * <p/>
     42  * Declaring this in a JUnit3 test (ie a class that is a {@link Test}) will have no effect.
     43  * Use {@link AndroidTestCase} instead for JUnit3 style tests.
     44  */
     45 @Retention(RetentionPolicy.RUNTIME)
     46 @Target(ElementType.FIELD)
     47 public @interface InjectContext {
     48 
     49 }
     50