OpenJDK 27 · sun.reflect.generics.reflectiveObjects.TypeVariableImpl

Modifier and Type	Field and Description
private volatile Object[]	bounds The upper bounds.
private final D	genericDeclaration
private final String	name

Access	Constructor and Description
private	TypeVariableImpl(D decl, String n, FieldTypeSignature[] bs, GenericsFactory f)

Method Summary

Modifier and Type	Method and Description
public boolean	equals(Object o) Overrides java.lang.Object.equals. Indicates whether some other object is "equal to" this one.
public AnnotatedType[]	getAnnotatedBounds() Implements java.lang.reflect.TypeVariable.getAnnotatedBounds. Returns an array of AnnotatedType objects that represent the use of types to denote the upper bounds of the type parameter represented by this TypeVariable.
public <T extends Annotation> T	getAnnotation(Class<T> annotationClass) Implements java.lang.reflect.AnnotatedElement.getAnnotation. Returns this element's annotation for the specified type if such an annotation is present, else null.
public Annotation[]	getAnnotations() Implements java.lang.reflect.AnnotatedElement.getAnnotations. Returns annotations that are present on this element.
public <T extends Annotation> T[]	getAnnotationsByType(Class<T> annotationClass) Overrides default java.lang.reflect.AnnotatedElement.getAnnotationsByType. Returns annotations that are associated with this element.
public Type[]	Returns: an array of Types representing the upper bound(s) of this type variable getBounds() Implements java.lang.reflect.TypeVariable.getBounds. Returns an array of `Type` objects representing the upper bound(s) of this type variable.
public <T extends Annotation> T	getDeclaredAnnotation(Class<T> annotationClass) Overrides default java.lang.reflect.AnnotatedElement.getDeclaredAnnotation. Returns this element's annotation for the specified type if such an annotation is directly present, else null.
public Annotation[]	getDeclaredAnnotations() Implements java.lang.reflect.AnnotatedElement.getDeclaredAnnotations. Returns annotations that are directly present on this element.
public <T extends Annotation> T[]	getDeclaredAnnotationsByType(Class<T> annotationClass) Overrides default java.lang.reflect.AnnotatedElement.getDeclaredAnnotationsByType. Returns this element's annotation(s) for the specified type if such annotations are either directly present or indirectly present.
public D	Returns: a generic declaration that declared this type variable. getGenericDeclaration() Implements java.lang.reflect.TypeVariable.getGenericDeclaration. Returns a `GenericDeclaration` object representing the generic declaration that declared this type variable.
public String	Returns: the name of this type variable, as it appears in the source code getName() Implements java.lang.reflect.TypeVariable.getName. Returns the name of this type variable, as it occurs in the source code.
public int	hashCode() Overrides java.lang.Object.hashCode. Returns a hash code value for this object.
public static <T extends GenericDeclaration> TypeVariableImpl<T>	Returns: A type variable with name, bounds, declaration and factory specified make(T - the reflective object that declared the type variable that this method should create decl, String - the name of the type variable to be returned name, FieldTypeSignature[] - an array of ASTs representing the bounds for the type variable to be created bs, GenericsFactory - a factory that can be used to manufacture reflective objects that represent the bounds of this type variable f) Factory method.
private static Map<Class<? extends Annotation>, Annotation>	mapAnnotations(Annotation[] annos)
public String	toString() Overrides java.lang.Object.toString. Returns a string representation of the object.
private int	typeVarIndex()

Inherited from sun.reflect.generics.reflectiveObjects.LazyReflectiveObjectGenerator:: getReifier reifyBounds

bounds	back to summary
private volatile Object[] bounds The upper bounds. Lazily converted from FieldTypeSignature[] to Type[]. We are required to evaluate the bounds lazily, so we store them as ASTs until we are first asked for them. This also neatly solves the problem with F-bounds - you can't reify them before the formal is defined.

genericDeclaration	back to summary
private final D genericDeclaration

name	back to summary
private final String name

TypeVariableImpl	back to summary
private TypeVariableImpl(D decl, String n, FieldTypeSignature[] bs, GenericsFactory f)

Method Detail

equals back to summary

equals	back to summary
public boolean equals(Object o) Overrides java.lang.Object.equals. Doc from java.lang.Object.equals. Indicates whether some other object is "equal to" this one. The `equals` method implements an equivalence relation on non-null object references: It is reflexive: for any non-null reference value `x`, `x.equals(x)` should return `true`. It is symmetric: for any non-null reference values `x` and `y`, `x.equals(y)` should return `true` if and only if `y.equals(x)` returns `true`. It is transitive: for any non-null reference values `x`, `y`, and `z`, if `x.equals(y)` returns `true` and `y.equals(z)` returns `true`, then `x.equals(z)` should return `true`. It is consistent: for any non-null reference values `x` and `y`, multiple invocations of `x.equals(y)` consistently return `true` or consistently return `false`, provided no information used in `equals` comparisons on the objects is modified. For any non-null reference value `x`, `x.equals(null)` should return `false`. An equivalence relation partitions the elements it operates on into equivalence classes; all the members of an equivalence class are equal to each other. Members of an equivalence class are substitutable for each other, at least for some purposes. Annotations @Override

public boolean equals(Object o)

Overrides java.lang.Object.equals.

Doc from java.lang.Object.equals.

Indicates whether some other object is "equal to" this one.

The equals method implements an equivalence relation on non-null object references:

It is reflexive: for any non-null reference value x, x.equals(x) should return true.
It is symmetric: for any non-null reference values x and y, x.equals(y) should return true if and only if y.equals(x) returns true.
It is transitive: for any non-null reference values x, y, and z, if x.equals(y) returns true and y.equals(z) returns true, then x.equals(z) should return true.
It is consistent: for any non-null reference values x and y, multiple invocations of x.equals(y) consistently return true or consistently return false, provided no information used in equals comparisons on the objects is modified.
For any non-null reference value x, x.equals(null) should return false.

An equivalence relation partitions the elements it operates on into equivalence classes; all the members of an equivalence class are equal to each other. Members of an equivalence class are substitutable for each other, at least for some purposes.

Annotations

@Override

getAnnotatedBounds back to summary

getAnnotatedBounds	back to summary
public AnnotatedType[] getAnnotatedBounds() Implements java.lang.reflect.TypeVariable.getAnnotatedBounds. Doc from java.lang.reflect.TypeVariable.getAnnotatedBounds. Returns an array of AnnotatedType objects that represent the use of types to denote the upper bounds of the type parameter represented by this TypeVariable. The order of the objects in the array corresponds to the order of the bounds in the declaration of the type parameter. Note that if no upper bound is explicitly declared, the upper bound is unannotated `Object`.

public AnnotatedType[] getAnnotatedBounds()

Implements java.lang.reflect.TypeVariable.getAnnotatedBounds.

Doc from java.lang.reflect.TypeVariable.getAnnotatedBounds.

Returns an array of AnnotatedType objects that represent the use of types to denote the upper bounds of the type parameter represented by this TypeVariable. The order of the objects in the array corresponds to the order of the bounds in the declaration of the type parameter. Note that if no upper bound is explicitly declared, the upper bound is unannotated Object.

getAnnotation	back to summary
public <T extends Annotation> T getAnnotation(Class<T> annotationClass) Implements java.lang.reflect.AnnotatedElement.getAnnotation. Doc from java.lang.reflect.AnnotatedElement.getAnnotation. Returns this element's annotation for the specified type if such an annotation is present, else null. Annotations @SuppressWarnings:unchecked

getAnnotation

back to summary

public <T extends Annotation> T getAnnotation(Class<T> annotationClass)

Implements java.lang.reflect.AnnotatedElement.getAnnotation.

Doc from java.lang.reflect.AnnotatedElement.getAnnotation.

Returns this element's annotation for the specified type if such an annotation is present, else null.

Annotations

@SuppressWarnings:unchecked

getAnnotations	back to summary
public Annotation[] getAnnotations() Implements java.lang.reflect.AnnotatedElement.getAnnotations. Doc from java.lang.reflect.AnnotatedElement.getAnnotations. Returns annotations that are present on this element. If there are no annotations present on this element, the return value is an array of length 0. The caller of this method is free to modify the returned array; it will have no effect on the arrays returned to other callers.

getAnnotations

back to summary

public Annotation[] getAnnotations()

Implements java.lang.reflect.AnnotatedElement.getAnnotations.

Doc from java.lang.reflect.AnnotatedElement.getAnnotations.

Returns annotations that are present on this element. If there are no annotations present on this element, the return value is an array of length 0. The caller of this method is free to modify the returned array; it will have no effect on the arrays returned to other callers.

getAnnotationsByType back to summary

getAnnotationsByType	back to summary
public <T extends Annotation> T[] getAnnotationsByType(Class<T> annotationClass) Overrides default java.lang.reflect.AnnotatedElement.getAnnotationsByType. Doc from java.lang.reflect.AnnotatedElement.getAnnotationsByType. Returns annotations that are associated with this element. If there are no annotations associated with this element, the return value is an array of length 0. The difference between this method and `getAnnotation(Class)` is that this method detects if its argument is a repeatable annotation type (JLS 9.6), and if so, attempts to find one or more annotations of that type by "looking through" a container annotation. The caller of this method is free to modify the returned array; it will have no effect on the arrays returned to other callers. Annotations @Override

public <T extends Annotation> T[] getAnnotationsByType(Class<T> annotationClass)

Overrides default java.lang.reflect.AnnotatedElement.getAnnotationsByType.

Doc from java.lang.reflect.AnnotatedElement.getAnnotationsByType.

Returns annotations that are associated with this element. If there are no annotations associated with this element, the return value is an array of length 0. The difference between this method and getAnnotation(Class) is that this method detects if its argument is a repeatable annotation type (JLS 9.6), and if so, attempts to find one or more annotations of that type by "looking through" a container annotation. The caller of this method is free to modify the returned array; it will have no effect on the arrays returned to other callers.

Annotations

@Override

getBounds back to summary

getBounds	back to summary
public Type[] getBounds() Implements java.lang.reflect.TypeVariable.getBounds. Returns an array of `Type` objects representing the upper bound(s) of this type variable. Note that if no upper bound is explicitly declared, the upper bound is `Object`. For each upper bound B: if B is a parameterized type or a type variable, it is created, (see `ParameterizedType` for the details of the creation process for parameterized types). Otherwise, B is resolved. Returns:Type[] an array of Types representing the upper bound(s) of this type variable Exceptions TypeNotPresentException: if any of the bounds refers to a non-existent type declaration MalformedParameterizedTypeException: if any of the bounds refer to a parameterized type that cannot be instantiated for any reason

public Type[] getBounds()

Implements java.lang.reflect.TypeVariable.getBounds.

Returns an array of Type objects representing the upper bound(s) of this type variable. Note that if no upper bound is explicitly declared, the upper bound is Object.

For each upper bound B:

if B is a parameterized type or a type variable, it is created, (see ParameterizedType for the details of the creation process for parameterized types).
Otherwise, B is resolved.

Returns:Type[]

an array of Types representing the upper bound(s) of this type variable

Exceptions

TypeNotPresentException:: if any of the bounds refers to a non-existent type declaration
MalformedParameterizedTypeException:: if any of the bounds refer to a parameterized type that cannot be instantiated for any reason

getDeclaredAnnotation	back to summary
public <T extends Annotation> T getDeclaredAnnotation(Class<T> annotationClass) Overrides default java.lang.reflect.AnnotatedElement.getDeclaredAnnotation. Doc from java.lang.reflect.AnnotatedElement.getDeclaredAnnotation. Returns this element's annotation for the specified type if such an annotation is directly present, else null. This method ignores inherited annotations. (Returns null if no annotations are directly present on this element.)

getDeclaredAnnotation

back to summary

public <T extends Annotation> T getDeclaredAnnotation(Class<T> annotationClass)

Overrides default java.lang.reflect.AnnotatedElement.getDeclaredAnnotation.

Doc from java.lang.reflect.AnnotatedElement.getDeclaredAnnotation.

Returns this element's annotation for the specified type if such an annotation is directly present, else null. This method ignores inherited annotations. (Returns null if no annotations are directly present on this element.)

getDeclaredAnnotations	back to summary
public Annotation[] getDeclaredAnnotations() Implements java.lang.reflect.AnnotatedElement.getDeclaredAnnotations. Doc from java.lang.reflect.AnnotatedElement.getDeclaredAnnotations. Returns annotations that are directly present on this element. This method ignores inherited annotations. If there are no annotations directly present on this element, the return value is an array of length 0. The caller of this method is free to modify the returned array; it will have no effect on the arrays returned to other callers.

getDeclaredAnnotations

back to summary

public Annotation[] getDeclaredAnnotations()

Implements java.lang.reflect.AnnotatedElement.getDeclaredAnnotations.

Doc from java.lang.reflect.AnnotatedElement.getDeclaredAnnotations.

Returns annotations that are directly present on this element. This method ignores inherited annotations. If there are no annotations directly present on this element, the return value is an array of length 0. The caller of this method is free to modify the returned array; it will have no effect on the arrays returned to other callers.

getDeclaredAnnotationsByType back to summary

getDeclaredAnnotationsByType	back to summary
public <T extends Annotation> T[] getDeclaredAnnotationsByType(Class<T> annotationClass) Overrides default java.lang.reflect.AnnotatedElement.getDeclaredAnnotationsByType. Doc from java.lang.reflect.AnnotatedElement.getDeclaredAnnotationsByType. Returns this element's annotation(s) for the specified type if such annotations are either directly present or indirectly present. This method ignores inherited annotations. If there are no specified annotations directly or indirectly present on this element, the return value is an array of length 0. The difference between this method and `getDeclaredAnnotation(Class)` is that this method detects if its argument is a repeatable annotation type (JLS 9.6), and if so, attempts to find one or more annotations of that type by "looking through" a container annotation if one is present. The caller of this method is free to modify the returned array; it will have no effect on the arrays returned to other callers. Annotations @Override

public <T extends Annotation> T[] getDeclaredAnnotationsByType(Class<T> annotationClass)

Overrides default java.lang.reflect.AnnotatedElement.getDeclaredAnnotationsByType.

Doc from java.lang.reflect.AnnotatedElement.getDeclaredAnnotationsByType.

Returns this element's annotation(s) for the specified type if such annotations are either directly present or indirectly present. This method ignores inherited annotations. If there are no specified annotations directly or indirectly present on this element, the return value is an array of length 0. The difference between this method and getDeclaredAnnotation(Class) is that this method detects if its argument is a repeatable annotation type (JLS 9.6), and if so, attempts to find one or more annotations of that type by "looking through" a container annotation if one is present. The caller of this method is free to modify the returned array; it will have no effect on the arrays returned to other callers.

Annotations

@Override

getGenericDeclaration back to summary

getGenericDeclaration	back to summary
public D getGenericDeclaration() Implements java.lang.reflect.TypeVariable.getGenericDeclaration. Returns a `GenericDeclaration` object representing the generic declaration that declared this type variable. Returns:D a generic declaration that declared this type variable. Annotations @SuppressWarnings:unchecked Since 1.5

public D getGenericDeclaration()

Implements java.lang.reflect.TypeVariable.getGenericDeclaration.

Returns a GenericDeclaration object representing the generic declaration that declared this type variable.

Returns:D

a generic declaration that declared this type variable.

Annotations

@SuppressWarnings:unchecked

Since

1.5

getName	back to summary
public String getName() Implements java.lang.reflect.TypeVariable.getName. Returns the name of this type variable, as it occurs in the source code. Returns:String the name of this type variable, as it appears in the source code

getName

back to summary

public String getName()

Implements java.lang.reflect.TypeVariable.getName.

Returns the name of this type variable, as it occurs in the source code.

Returns:String: the name of this type variable, as it appears in the source code

hashCode back to summary

hashCode	back to summary
public int hashCode() Overrides java.lang.Object.hashCode. Doc from java.lang.Object.hashCode. Returns a hash code value for this object. This method is supported for the benefit of hash tables such as those provided by `java.util.HashMap`. The general contract of `hashCode` is: Whenever it is invoked on the same object more than once during an execution of a Java application, the `hashCode` method must consistently return the same integer, provided no information used in `equals` comparisons on the object is modified. This integer need not remain consistent from one execution of an application to another execution of the same application. If two objects are equal according to the `equals` method, then calling the `hashCode` method on each of the two objects must produce the same integer result. It is not required that if two objects are unequal according to the `equals` method, then calling the `hashCode` method on each of the two objects must produce distinct integer results. However, the programmer should be aware that producing distinct integer results for unequal objects may improve the performance of hash tables. Annotations @Override

public int hashCode()

Overrides java.lang.Object.hashCode.

Doc from java.lang.Object.hashCode.

Returns a hash code value for this object. This method is supported for the benefit of hash tables such as those provided by java.util.HashMap.

The general contract of hashCode is:

Whenever it is invoked on the same object more than once during an execution of a Java application, the hashCode method must consistently return the same integer, provided no information used in equals comparisons on the object is modified. This integer need not remain consistent from one execution of an application to another execution of the same application.
If two objects are equal according to the equals method, then calling the hashCode method on each of the two objects must produce the same integer result.
It is not required that if two objects are unequal according to the equals method, then calling the hashCode method on each of the two objects must produce distinct integer results. However, the programmer should be aware that producing distinct integer results for unequal objects may improve the performance of hash tables.

Annotations

@Override

make	back to summary
public static <T extends GenericDeclaration> TypeVariableImpl<T> make(T decl, String name, FieldTypeSignature[] bs, GenericsFactory f) Factory method. Parameters decl:T - the reflective object that declared the type variable that this method should create name:String - the name of the type variable to be returned bs:FieldTypeSignature[] - an array of ASTs representing the bounds for the type variable to be created f:GenericsFactory - a factory that can be used to manufacture reflective objects that represent the bounds of this type variable Returns:TypeVariableImpl<T> A type variable with name, bounds, declaration and factory specified

make

back to summary

public static <T extends GenericDeclaration> TypeVariableImpl<T> make(T decl, String name, FieldTypeSignature[] bs, GenericsFactory f)

Factory method.

Parameters

decl:T: - the reflective object that declared the type variable that this method should create
name:String: - the name of the type variable to be returned
bs:FieldTypeSignature[]: - an array of ASTs representing the bounds for the type variable to be created
f:GenericsFactory: - a factory that can be used to manufacture reflective objects that represent the bounds of this type variable

Returns:TypeVariableImpl<T>

A type variable with name, bounds, declaration and factory specified

mapAnnotations	back to summary
private static Map<Class<? extends Annotation>, Annotation> mapAnnotations(Annotation[] annos)

toString back to summary

toString	back to summary
public String toString() Overrides java.lang.Object.toString. Doc from java.lang.Object.toString. Returns a string representation of the object. Satisfying this method's contract implies a non-`null` result must be returned.

public String toString()

Overrides java.lang.Object.toString.

Doc from java.lang.Object.toString.

Returns a string representation of the object. Satisfying this method's contract implies a non-null result must be returned.

typeVarIndex	back to summary
private int typeVarIndex()

public Class TypeVariableImpl<D extends GenericDeclaration>

Field Summary

Constructor Summary

Method Summary

Field Detail

Constructor Detail

Method Detail