/* * Copyright (C) 2015 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.support.annotation; import java.lang.annotation.Retention; import static java.lang.annotation.RetentionPolicy.CLASS; /** * Denotes that the class, method or field has its visibility relaxed, so that it is more widely * visible than otherwise necessary to make code testable. *

* You can optionally specify what the visibility should have been if not for * testing; this allows tools to catch unintended access from within production * code. *

* Example: *


 *  @VisibleForTesting(otherwise = VisibleForTesting.PROTECTED)
 *  public String printDiagnostics() { ... }
 * 
* * If not specified, the intended visibility is assumed to be private. */ @Retention(CLASS) public @interface VisibleForTesting { /** * The visibility the annotated element would have if it did not need to be made visible for * testing. */ @ProductionVisibility int otherwise() default PRIVATE; /** * The annotated element would have "private" visibility */ int PRIVATE = 2; // Happens to be the same as Modifier.PRIVATE /** * The annotated element would have "package private" visibility */ int PACKAGE_PRIVATE = 3; /** * The annotated element would have "protected" visibility */ int PROTECTED = 4; // Happens to be the same as Modifier.PROTECTED /** * The annotated element should never be called from production code, only from tests. *

* This is equivalent to {@code @RestrictTo.Scope.TESTS}. */ int NONE = 5; }