001: /*
002: * Copyright 2003-2006 Sun Microsystems, Inc. All Rights Reserved.
003: * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
004: *
005: * This code is free software; you can redistribute it and/or modify it
006: * under the terms of the GNU General Public License version 2 only, as
007: * published by the Free Software Foundation. Sun designates this
008: * particular file as subject to the "Classpath" exception as provided
009: * by Sun in the LICENSE file that accompanied this code.
010: *
011: * This code is distributed in the hope that it will be useful, but WITHOUT
012: * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
013: * FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License
014: * version 2 for more details (a copy is included in the LICENSE file that
015: * accompanied this code).
016: *
017: * You should have received a copy of the GNU General Public License version
018: * 2 along with this work; if not, write to the Free Software Foundation,
019: * Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA.
020: *
021: * Please contact Sun Microsystems, Inc., 4150 Network Circle, Santa Clara,
022: * CA 95054 USA or visit www.sun.com if you need additional information or
023: * have any questions.
024: */
025: package com.sun.beans;
026:
027: import java.lang.reflect.Type;
028: import java.lang.reflect.WildcardType;
029: import java.util.Arrays;
030:
031: /**
032: * This class implements {@link WildcardType WildcardType} compatibly with the JDK's
033: * {@link sun.reflect.generics.reflectiveObjects.WildcardTypeImpl WildcardTypeImpl}.
034: * Unfortunately we can't use the JDK's
035: * {@link sun.reflect.generics.reflectiveObjects.WildcardTypeImpl WildcardTypeImpl} here as we do for
036: * {@link sun.reflect.generics.reflectiveObjects.ParameterizedTypeImpl ParameterizedTypeImpl} and
037: * {@link sun.reflect.generics.reflectiveObjects.GenericArrayTypeImpl GenericArrayTypeImpl},
038: * because {@link sun.reflect.generics.reflectiveObjects.WildcardTypeImpl WildcardTypeImpl}'s
039: * constructor takes parameters representing intermediate structures obtained during class-file parsing.
040: * We could reconstruct versions of those structures but it would be more trouble than it's worth.
041: *
042: * @since 1.7
043: *
044: * @version 1.1 06/06/07
045: * @author Eamonn McManus
046: * @author Sergey Malenkov
047: */
048: final class WildcardTypeImpl implements WildcardType {
049: private final Type[] upperBounds;
050: private final Type[] lowerBounds;
051:
052: /**
053: * Creates a wildcard type with the requested bounds.
054: * Note that the array arguments are not cloned
055: * because instances of this class are never constructed
056: * from outside the containing package.
057: *
058: * @param upperBounds the array of types representing
059: * the upper bound(s) of this type variable
060: * @param lowerBounds the array of types representing
061: * the lower bound(s) of this type variable
062: */
063: WildcardTypeImpl(Type[] upperBounds, Type[] lowerBounds) {
064: this .upperBounds = upperBounds;
065: this .lowerBounds = lowerBounds;
066: }
067:
068: /**
069: * Returns an array of {@link Type Type} objects
070: * representing the upper bound(s) of this type variable.
071: * Note that if no upper bound is explicitly declared,
072: * the upper bound is {@link Object Object}.
073: *
074: * @return an array of types representing
075: * the upper bound(s) of this type variable
076: */
077: public Type[] getUpperBounds() {
078: return this .upperBounds.clone();
079: }
080:
081: /**
082: * Returns an array of {@link Type Type} objects
083: * representing the lower bound(s) of this type variable.
084: * Note that if no lower bound is explicitly declared,
085: * the lower bound is the type of {@code null}.
086: * In this case, a zero length array is returned.
087: *
088: * @return an array of types representing
089: * the lower bound(s) of this type variable
090: */
091: public Type[] getLowerBounds() {
092: return this .lowerBounds.clone();
093: }
094:
095: /**
096: * Indicates whether some other object is "equal to" this one.
097: * It is implemented compatibly with the JDK's
098: * {@link sun.reflect.generics.reflectiveObjects.WildcardTypeImpl WildcardTypeImpl}.
099: *
100: * @param object the reference object with which to compare
101: * @return {@code true} if this object is the same as the object argument;
102: * {@code false} otherwise
103: * @see sun.reflect.generics.reflectiveObjects.WildcardTypeImpl#equals
104: */
105: @Override
106: public boolean equals(Object object) {
107: if (object instanceof WildcardType) {
108: WildcardType type = (WildcardType) object;
109: return Arrays.equals(this .upperBounds, type
110: .getUpperBounds())
111: && Arrays.equals(this .lowerBounds, type
112: .getLowerBounds());
113: }
114: return false;
115: }
116:
117: /**
118: * Returns a hash code value for the object.
119: * It is implemented compatibly with the JDK's
120: * {@link sun.reflect.generics.reflectiveObjects.WildcardTypeImpl WildcardTypeImpl}.
121: *
122: * @return a hash code value for this object
123: * @see sun.reflect.generics.reflectiveObjects.WildcardTypeImpl#hashCode
124: */
125: @Override
126: public int hashCode() {
127: return Arrays.hashCode(this .upperBounds)
128: ^ Arrays.hashCode(this .lowerBounds);
129: }
130:
131: /**
132: * Returns a string representation of the object.
133: * It is implemented compatibly with the JDK's
134: * {@link sun.reflect.generics.reflectiveObjects.WildcardTypeImpl WildcardTypeImpl}.
135: *
136: * @return a string representation of the object
137: * @see sun.reflect.generics.reflectiveObjects.WildcardTypeImpl#toString
138: */
139: @Override
140: public String toString() {
141: StringBuilder sb;
142: Type[] bounds;
143: if (this .lowerBounds.length == 0) {
144: if (this .upperBounds.length == 0
145: || Object.class == this .upperBounds[0]) {
146: return "?";
147: }
148: bounds = this .upperBounds;
149: sb = new StringBuilder("? extends ");
150: } else {
151: bounds = this .lowerBounds;
152: sb = new StringBuilder("? super ");
153: }
154: for (int i = 0; i < bounds.length; i++) {
155: if (i > 0) {
156: sb.append(" & ");
157: }
158: sb
159: .append((bounds[i] instanceof Class) ? ((Class) bounds[i])
160: .getName()
161: : bounds[i].toString());
162: }
163: return sb.toString();
164: }
165: }
|