/*
* Copyright (c) 2003, 2006, Oracle and/or its affiliates. All rights reserved.
* DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
*
* This code is free software; you can redistribute it and/or modify it
* under the terms of the GNU General Public License version 2 only, as
* published by the Free Software Foundation. Oracle designates this
* particular file as subject to the "Classpath" exception as provided
* by Oracle in the LICENSE file that accompanied this code.
*
* This code is distributed in the hope that it will be useful, but WITHOUT
* ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
* FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License
* version 2 for more details (a copy is included in the LICENSE file that
* accompanied this code).
*
* You should have received a copy of the GNU General Public License version
* 2 along with this work; if not, write to the Free Software Foundation,
* Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA.
*
* Please contact Oracle, 500 Oracle Parkway, Redwood Shores, CA 94065 USA
* or visit www.oracle.com if you need additional information or have any
* questions.
*/
package com.sun.beans;
import java.lang.reflect.Type;
import java.lang.reflect.WildcardType;
import java.util.Arrays;
/**
* This class implements {@link WildcardType WildcardType} compatibly with the JDK's
* {@link sun.reflect.generics.reflectiveObjects.WildcardTypeImpl WildcardTypeImpl}.
* Unfortunately we can't use the JDK's
* {@link sun.reflect.generics.reflectiveObjects.WildcardTypeImpl WildcardTypeImpl} here as we do for
* {@link sun.reflect.generics.reflectiveObjects.ParameterizedTypeImpl ParameterizedTypeImpl} and
* {@link sun.reflect.generics.reflectiveObjects.GenericArrayTypeImpl GenericArrayTypeImpl},
* because {@link sun.reflect.generics.reflectiveObjects.WildcardTypeImpl WildcardTypeImpl}'s
* constructor takes parameters representing intermediate structures obtained during class-file parsing.
* We could reconstruct versions of those structures but it would be more trouble than it's worth.
*
* @since 1.7
*
* @author Eamonn McManus
* @author Sergey Malenkov
*/
final class WildcardTypeImpl implements WildcardType {
private final Type[] upperBounds;
private final Type[] lowerBounds;
/**
* Creates a wildcard type with the requested bounds.
* Note that the array arguments are not cloned
* because instances of this class are never constructed
* from outside the containing package.
*
* @param upperBounds the array of types representing
* the upper bound(s) of this type variable
* @param lowerBounds the array of types representing
* the lower bound(s) of this type variable
*/
WildcardTypeImpl(Type[] upperBounds, Type[] lowerBounds) {
this.upperBounds = upperBounds;
this.lowerBounds = lowerBounds;
}
/**
* Returns an array of {@link Type Type} objects
* representing the upper bound(s) of this type variable.
* Note that if no upper bound is explicitly declared,
* the upper bound is {@link Object Object}.
*
* @return an array of types representing
* the upper bound(s) of this type variable
*/
public Type[] getUpperBounds() {
return this.upperBounds.clone();
}
/**
* Returns an array of {@link Type Type} objects
* representing the lower bound(s) of this type variable.
* Note that if no lower bound is explicitly declared,
* the lower bound is the type of {@code null}.
* In this case, a zero length array is returned.
*
* @return an array of types representing
* the lower bound(s) of this type variable
*/
public Type[] getLowerBounds() {
return this.lowerBounds.clone();
}
/**
* Indicates whether some other object is "equal to" this one.
* It is implemented compatibly with the JDK's
* {@link sun.reflect.generics.reflectiveObjects.WildcardTypeImpl WildcardTypeImpl}.
*
* @param object the reference object with which to compare
* @return {@code true} if this object is the same as the object argument;
* {@code false} otherwise
* @see sun.reflect.generics.reflectiveObjects.WildcardTypeImpl#equals
*/
@Override
public boolean equals(Object object) {
if (object instanceof WildcardType) {
WildcardType type = (WildcardType) object;
return Arrays.equals(this.upperBounds, type.getUpperBounds())
&& Arrays.equals(this.lowerBounds, type.getLowerBounds());
}
return false;
}
/**
* Returns a hash code value for the object.
* It is implemented compatibly with the JDK's
* {@link sun.reflect.generics.reflectiveObjects.WildcardTypeImpl WildcardTypeImpl}.
*
* @return a hash code value for this object
* @see sun.reflect.generics.reflectiveObjects.WildcardTypeImpl#hashCode
*/
@Override
public int hashCode() {
return Arrays.hashCode(this.upperBounds)
^ Arrays.hashCode(this.lowerBounds);
}
/**
* Returns a string representation of the object.
* It is implemented compatibly with the JDK's
* {@link sun.reflect.generics.reflectiveObjects.WildcardTypeImpl WildcardTypeImpl}.
*
* @return a string representation of the object
* @see sun.reflect.generics.reflectiveObjects.WildcardTypeImpl#toString
*/
@Override
public String toString() {
StringBuilder sb;
Type[] bounds;
if (this.lowerBounds.length == 0) {
if (this.upperBounds.length == 0 || Object.class == this.upperBounds[0]) {
return "?";
}
bounds = this.upperBounds;
sb = new StringBuilder("? extends ");
}
else {
bounds = this.lowerBounds;
sb = new StringBuilder("? super ");
}
for (int i = 0; i < bounds.length; i++) {
if (i > 0) {
sb.append(" & ");
}
sb.append((bounds[i] instanceof Class)
? ((Class) bounds[i]).getName()
: bounds[i].toString());
}
return sb.toString();
}
}