xref: /aosp_15_r20/external/jspecify/samples/WildcardBoundWithAnnotations.java (revision 2167191df2fa07300797f1ac5b707370b5f38c48)
1 /*
2  * Copyright 2022 The JSpecify Authors.
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 import org.jspecify.annotations.NullMarked;
17 import org.jspecify.annotations.Nullable;
18 import org.jspecify.annotations.NullnessUnspecified;
19 
20 @NullMarked
21 interface WildcardBoundWithAnnotations {
use(Supplier<? extends T> s, Lib<T> l)22   <T> void use(Supplier<? extends T> s, Lib<T> l);
23 
useUnspec(Supplier<? extends @NullnessUnspecified T> s, Lib<T> l)24   <T> void useUnspec(Supplier<? extends @NullnessUnspecified T> s, Lib<T> l);
25 
useUnionNull(Supplier<? extends @Nullable T> s, Lib<T> l)26   <T> void useUnionNull(Supplier<? extends @Nullable T> s, Lib<T> l);
27 
x0(Supplier<? extends T> s, Lib<T> l)28   default <T> void x0(Supplier<? extends T> s, Lib<T> l) {
29     use(s, l);
30     useUnspec(s, l);
31     useUnionNull(s, l);
32   }
33 
x1(Supplier<? extends @NullnessUnspecified T> s, Lib<T> l)34   default <T> void x1(Supplier<? extends @NullnessUnspecified T> s, Lib<T> l) {
35     // jspecify_nullness_not_enough_information
36     use(s, l);
37     // jspecify_nullness_not_enough_information
38     useUnspec(s, l);
39     useUnionNull(s, l);
40   }
41 
x2(Supplier<? extends @Nullable T> s, Lib<T> l)42   default <T> void x2(Supplier<? extends @Nullable T> s, Lib<T> l) {
43     // jspecify_nullness_mismatch
44     use(s, l);
45     // jspecify_nullness_not_enough_information
46     useUnspec(s, l);
47     useUnionNull(s, l);
48   }
49 
50   interface Supplier<T extends @Nullable Object> {}
51 
52   interface Lib<T> {}
53 }
54