1 /*
2  * Copyright (C) 2018 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 
17 package annotations;
18 
19 import java.lang.annotation.ElementType;
20 import java.lang.annotation.Retention;
21 import java.lang.annotation.RetentionPolicy;
22 import java.lang.annotation.Target;
23 
24 /**
25  * This annotation can be set on method to specify that if this method
26  * is statically invoked then the invocation is replaced by a
27  * load-constant bytecode with the MethodHandle constant described by
28  * the annotation.
29  */
30 @Retention(RetentionPolicy.RUNTIME)
31 @Target(ElementType.METHOD)
32 public @interface ConstantMethodHandle {
33     /* Method handle kinds */
34     public static final int STATIC_PUT = 0;
35     public static final int STATIC_GET = 1;
36     public static final int INSTANCE_PUT = 2;
37     public static final int INSTANCE_GET = 3;
38     public static final int INVOKE_STATIC = 4;
39     public static final int INVOKE_VIRTUAL = 5;
40     public static final int INVOKE_SPECIAL = 6;
41     public static final int NEW_INVOKE_SPECIAL = 7;
42     public static final int INVOKE_INTERFACE = 8;
43 
44     /** Kind of method handle. */
kind()45     int kind();
46 
47     /** Class name owning the field or method. */
owner()48     String owner();
49 
50     /** The field or method name addressed by the MethodHandle. */
fieldOrMethodName()51     String fieldOrMethodName();
52 
53     /** Descriptor for the field (type) or method (method-type) */
descriptor()54     String descriptor();
55 
56     /** Whether the owner is an interface. */
ownerIsInterface()57     boolean ownerIsInterface() default false;
58 }
59