1 /*
2  * Copyright 2024 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 sample.optin;
18 
19 import androidx.annotation.OptIn;
20 
21 /**
22  * Tests for calls made to members on an experimental (with message) class.
23  */
24 @SuppressWarnings({"unused", "WeakerAccess"})
25 public class UseJavaExperimentalWithMessageFromJava {
26 
unsafeExperimentalClassField()27     int unsafeExperimentalClassField() {
28         AnnotatedJavaClassWithMessage experimentalObject = new AnnotatedJavaClassWithMessage();
29         return experimentalObject.field;
30     }
31 
32     /**
33      * Unsafe call into a method on an experimental class.
34      */
unsafeExperimentalClassMethod()35     int unsafeExperimentalClassMethod() {
36         AnnotatedJavaClassWithMessage experimentalObject = new AnnotatedJavaClassWithMessage();
37         return experimentalObject.method();
38     }
39 
40     /**
41      * Unsafe call into a static field on an experimental class.
42      */
unsafeExperimentalClassStaticField()43     int unsafeExperimentalClassStaticField() {
44         return AnnotatedJavaClassWithMessage.FIELD_STATIC;
45     }
46 
47     /**
48      * Unsafe call into a static method on an experimental class.
49      */
unsafeExperimentalClassStaticMethod()50     int unsafeExperimentalClassStaticMethod() {
51         return AnnotatedJavaClassWithMessage.methodStatic();
52     }
53 
54     /**
55      * Safe call due to propagation of experimental annotation with message.
56      */
57     @ExperimentalJavaAnnotationWithMessage
safePropagateMarker()58     int safePropagateMarker() {
59         AnnotatedJavaClassWithMessage experimentalObject = new AnnotatedJavaClassWithMessage();
60         return experimentalObject.method();
61     }
62 
63     /**
64      * Safe call due to opting in to experimental annotation with message.
65      */
66     @OptIn(markerClass = ExperimentalJavaAnnotationWithMessage.class)
safeOptInMarker()67     int safeOptInMarker() {
68         AnnotatedJavaClassWithMessage experimentalObject = new AnnotatedJavaClassWithMessage();
69         return experimentalObject.method();
70     }
71 
72 }
73