uk.co.strangeskies.reflection.codegen

Class TypeVariableSignature

java.lang.Object

uk.co.strangeskies.reflection.codegen.TypeVariableSignature

All Implemented Interfaces:

AnnotatedSignature<TypeVariableSignature>, Signature<TypeVariableSignature>

public class TypeVariableSignature
extends java.lang.Object
implements AnnotatedSignature<TypeVariableSignature>

This type is a placeholder for a TypeVariable on a GenericDeclaration produced from a ParameterizedSignature.

Constructor Summary

Constructors

Modifier	Constructor and Description
protected	TypeVariableSignature(java.lang.String name)
protected	TypeVariableSignature(java.lang.String name, java.util.Set<java.lang.reflect.AnnotatedType> bounds, java.util.Set<java.lang.annotation.Annotation> annotations)

Method Summary

Modifier and Type	Method and Description
TypeVariableSignature	annotated(java.util.Collection<? extends java.lang.annotation.Annotation> annotations) Derive a version of this declaration with the given annotations.
java.util.stream.Stream<java.lang.annotation.Annotation>	getAnnotations()
java.util.stream.Stream<java.lang.reflect.AnnotatedType>	getBounds()
java.lang.String	getName()
java.lang.reflect.Type	reference()
static java.lang.reflect.Type	referenceTypeVariable(java.lang.String name) Type variable declarations intended to have bounds on other type variable declarations within the same parameterized declaration may specify those bounds by reference to the name of the other type variable.
java.lang.String	toString()
static TypeVariableSignature	typeVariableSignature(java.lang.String ofName)
static TypeVariableSignature	typeVariableSignature(java.lang.reflect.TypeVariable<?> of)
TypeVariableSignature	withBounds(java.lang.reflect.AnnotatedType... bounds)
TypeVariableSignature	withBounds(java.util.Collection<? extends java.lang.reflect.AnnotatedType> bounds)
TypeVariableSignature	withBounds(java.lang.reflect.Type... bounds)
TypeVariableSignature	withBounds(TypeToken<?>... bounds)

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait

Methods inherited from interface uk.co.strangeskies.reflection.codegen.AnnotatedSignature

annotated

Constructor Detail

TypeVariableSignature

protected TypeVariableSignature(java.lang.String name)

Parameters:

name - the name of the declared type parameter

TypeVariableSignature

protected TypeVariableSignature(java.lang.String name,
                                java.util.Set<java.lang.reflect.AnnotatedType> bounds,
                                java.util.Set<java.lang.annotation.Annotation> annotations)

Method Detail

referenceTypeVariable

public static java.lang.reflect.Type referenceTypeVariable(java.lang.String name)

Type variable declarations intended to have bounds on other type variable declarations within the same parameterized declaration may specify those bounds by reference to the name of the other type variable. This method creates a placeholder type for this purpose, which will be substituted with the appropriate TypeVariable when the parameterized declaration is actualized into its definition. This is also useful as type variable declarations sometimes need to be self-referential in their bounds, whether directly or indirectly. Recursive data structures are difficult to capture naturally through immutable APIs, but referencing type variable declarations by name rather than by identity makes this a little simpler.

Parameters:

name - the name of the type variable declaration to create a placeholder for

Returns:

a placeholder for a type variable of the given name

typeVariableSignature

public static TypeVariableSignature typeVariableSignature(java.lang.String ofName)

typeVariableSignature

public static TypeVariableSignature typeVariableSignature(java.lang.reflect.TypeVariable<?> of)

getAnnotations

public java.util.stream.Stream<java.lang.annotation.Annotation> getAnnotations()

Specified by:

getAnnotations in interface AnnotatedSignature<TypeVariableSignature>

Returns:

the annotations on this declaration

annotated

public TypeVariableSignature annotated(java.util.Collection<? extends java.lang.annotation.Annotation> annotations)

Description copied from interface: AnnotatedSignature

Derive a version of this declaration with the given annotations. Users should take care not to specify annotations which could not be applied to the declaration due to their Target, as there is no validation of applicability.

Annotations already present on the receiving declaration will be replaced rather than appended.

Specified by:

annotated in interface AnnotatedSignature<TypeVariableSignature>

Parameters:

annotations - the annotations with which to annotate this declaration

Returns:

a new declaration of the same type, and with the same content, but with the given annotations

getName

public java.lang.String getName()

reference

public java.lang.reflect.Type reference()

getBounds

public java.util.stream.Stream<java.lang.reflect.AnnotatedType> getBounds()

withBounds

public TypeVariableSignature withBounds(java.lang.reflect.AnnotatedType... bounds)

withBounds

public TypeVariableSignature withBounds(java.lang.reflect.Type... bounds)

withBounds

public TypeVariableSignature withBounds(TypeToken<?>... bounds)

withBounds

public TypeVariableSignature withBounds(java.util.Collection<? extends java.lang.reflect.AnnotatedType> bounds)

toString

public java.lang.String toString()

Specified by:

toString in interface Signature<TypeVariableSignature>

Overrides:

toString in class java.lang.Object

Returns:

A single-line, canonical string representation of the signature in the format of a Java language source element.