1 /* 2 * Copyright (c) 2012, 2020, Oracle and/or its affiliates. All rights reserved. 3 * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. 4 * 5 * This code is free software; you can redistribute it and/or modify it 6 * under the terms of the GNU General Public License version 2 only, as 7 * published by the Free Software Foundation. Oracle designates this 8 * particular file as subject to the "Classpath" exception as provided 9 * by Oracle in the LICENSE file that accompanied this code. 10 * 11 * This code is distributed in the hope that it will be useful, but WITHOUT 12 * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or 13 * FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License 14 * version 2 for more details (a copy is included in the LICENSE file that 15 * accompanied this code). 16 * 17 * You should have received a copy of the GNU General Public License version 18 * 2 along with this work; if not, write to the Free Software Foundation, 19 * Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA. 20 * 21 * Please contact Oracle, 500 Oracle Parkway, Redwood Shores, CA 94065 USA 22 * or visit www.oracle.com if you need additional information or have any 23 * questions. 24 */ 25 26 package java.lang.reflect; 27 28 /** 29 * {@code AnnotatedWildcardType} represents the potentially annotated use of a 30 * wildcard type argument, whose upper or lower bounds may themselves represent 31 * annotated uses of types. 32 * 33 * @jls 4.5.1 Type Arguments of Parameterized Types 34 * @since 1.8 35 */ 36 public interface AnnotatedWildcardType extends AnnotatedType { 37 38 /** 39 * Returns the potentially annotated lower bounds of this wildcard type. 40 * If no lower bound is explicitly declared, the lower bound is the 41 * type of null. In this case, a zero length array is returned. 42 * 43 * @return the potentially annotated lower bounds of this wildcard type or 44 * an empty array if no lower bound is explicitly declared. 45 * @see WildcardType#getLowerBounds() 46 */ 47 AnnotatedType[] getAnnotatedLowerBounds(); 48 49 /** 50 * Returns the potentially annotated upper bounds of this wildcard type. 51 * If no upper bound is explicitly declared, the upper bound is 52 * unannotated {@code Object} 53 * 54 * @return the potentially annotated upper bounds of this wildcard type 55 * @see WildcardType#getUpperBounds() 56 */ 57 AnnotatedType[] getAnnotatedUpperBounds(); 58 59 /** 60 * Returns the potentially annotated type that this type is a member of, if 61 * this type represents a nested type. For example, if this type is 62 * {@code @TA O<T>.I<S>}, return a representation of {@code @TA O<T>}. 63 * 64 * <p>Returns {@code null} for an {@code AnnotatedType} that is an instance 65 * of {@code AnnotatedWildcardType}. 66 * 67 * @return {@code null} 68 * 69 * @since 9 70 */ 71 @Override 72 AnnotatedType getAnnotatedOwnerType(); 73 }