1 /*
2  * Copyright (C) 2023 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 android.hosttest.annotation;
17 
18 import static java.lang.annotation.ElementType.METHOD;
19 
20 import java.lang.annotation.Retention;
21 import java.lang.annotation.RetentionPolicy;
22 import java.lang.annotation.Target;
23 
24 /**
25  * THIS ANNOTATION IS EXPERIMENTAL. REACH OUT TO g/ravenwood BEFORE USING IT, OR YOU HAVE ANY
26  * QUESTIONS ABOUT IT.
27  *
28  * If a method has this annotation, we'll replace it with another method on the host side.
29  *
30  * See {@link android.util.LruCache#getEldest()} and its substitution.
31  *
32  * @hide
33  */
34 @Target({METHOD})
35 @Retention(RetentionPolicy.CLASS)
36 public @interface HostSideTestSubstitute {
37     // TODO We should add "_host" as default. We're not doing it yet, because extractign the default
38     // value with ASM doesn't seem trivial. (? not sure.)
suffix()39     String suffix();
40 }
41