1/* 2 * Copyright (C) 2008 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 17package dalvik.annotation; 18 19import java.lang.annotation.ElementType; 20import java.lang.annotation.Retention; 21import java.lang.annotation.RetentionPolicy; 22import java.lang.annotation.Target; 23 24/** 25 * Defines an annotation for test methods that allow, among other things, to 26 * link the test to the method that is being tested. 27 * 28 * {@hide} 29 */ 30@Retention(RetentionPolicy.RUNTIME) 31@Target({ ElementType.METHOD }) 32public @interface TestInfo { 33 34 /** 35 * Specifies the current status of the test, as determined by a reviewer. 36 */ 37 TestStatus status() default TestStatus.TBR; 38 39 /** 40 * Specifies noteworthy plain-text information about the test, like whether 41 * it is testing a specific parameter combination or something. 42 */ 43 String notes() default ""; 44 45 /** 46 * Specifies the current level of coverage the test has. 47 */ 48 TestLevel level() default TestLevel.PARTIAL; 49 50 /** 51 * Specifies the purpose (either if it is noteworth to mention such as if 52 * it is testing a specific parameter combination) or the covered test 53 * aspects (exceptions, normal cases, border edge cases, etc.) in 54 * case the level is Level.PARTIAL 55 */ 56 String purpose() default ""; 57 58 /** 59 * Specifies an array of target methods. 60 */ 61 TestTarget[] targets(); 62 63} 64