io.jooby

Class Reified<T>

java.lang.Object

io.jooby.Reified<T>

Type Parameters:

T - Target type.

public class Reified<T>
extends Object

Represents a generic type T. Java doesn't yet provide a way to represent generic types, so this class does. Forces clients to create a subclass of this class which enables retrieval the type information even at runtime.

For example, to create a type literal for List<String>, you can create an empty anonymous inner class:

Reified<List<String>> list = new Reified<List<String>>() {};

This syntax cannot be used to create type literals that have wildcard parameters, such as Class<?> or List<? extends CharSequence>.

Author:

Bob Lee, Sven Mawson, Jesse Wilson

Constructor Summary

Constructors

Constructor and Description
Reified() Constructs a new type literal.

Method Summary

Modifier and Type	Method and Description
static <T> Reified<CompletableFuture<T>>	completableFuture(Type type) Creates a CompletableFuture type literal.
boolean	equals(Object o)
static <T> Reified<T>	get(Class<T> type) Gets type literal for the given Class instance.
static Reified<?>	get(Type type) Gets type literal for the given Type instance.
static Reified<?>	getParameterized(Type rawType, Type... typeArguments) Gets type literal for the parameterized type represented by applying typeArguments to rawType.
Class<? super T>	getRawType() Returns the raw (non-generic) type for this type.
Type	getType() Gets underlying Type instance.
int	hashCode()
static <T> Reified<List<T>>	list(Type type) Creates a List type literal.
static <K,V> Reified<Map<K,V>>	map(Type key, Type value) Creates an Map type literal.
static <T> Reified<Optional<T>>	optional(Type type) Creates an Optional type literal.
static Class<?>	rawType(Type type) Get raw type (class) from given type.
static <T> Reified<Set<T>>	set(Type type) Creates a Set type literal.
String	toString()

Methods inherited from class java.lang.Object

getClass, notify, notifyAll, wait, wait, wait

Constructor Detail

Reified

public Reified()

Constructs a new type literal. Derives represented class from type parameter.

Clients create an empty anonymous subclass. Doing so embeds the type parameter in the anonymous class's type hierarchy so we can reconstitute it at runtime despite erasure.

Method Detail

getRawType

@Nonnull
public final Class<? super T> getRawType()

Returns the raw (non-generic) type for this type.

Returns:

Returns the raw (non-generic) type for this type.

getType

@Nonnull
public final Type getType()

Gets underlying Type instance.

Returns:

Gets underlying Type instance.

hashCode

public final int hashCode()

Overrides:

hashCode in class Object

equals

public final boolean equals(Object o)

Overrides:

equals in class Object

toString

public final String toString()

Overrides:

toString in class Object

get

@Nonnull
public static Reified<?> get(@Nonnull
                                      Type type)

Gets type literal for the given Type instance.

Parameters:

type - Source type.

Returns:

Gets type literal for the given Type instance.

rawType

@Nonnull
public static Class<?> rawType(@Nonnull
                                        Type type)

Get raw type (class) from given type.

Parameters:

type - Type.

Returns:

Raw type.

get

@Nonnull
public static <T> Reified<T> get(@Nonnull
                                          Class<T> type)

Gets type literal for the given Class instance.

Type Parameters:

T - Generic type.

Parameters:

type - Java type.

Returns:

Gets type literal for the given Class instance.

list

@Nonnull
public static <T> Reified<List<T>> list(@Nonnull
                                                 Type type)

Creates a List type literal.

Type Parameters:

T - Item type.

Parameters:

type - Item type.

Returns:

A List type literal.

set

@Nonnull
public static <T> Reified<Set<T>> set(@Nonnull
                                               Type type)

Creates a Set type literal.

Type Parameters:

T - Item type.

Parameters:

type - Item type.

Returns:

A Set type literal.

optional

@Nonnull
public static <T> Reified<Optional<T>> optional(@Nonnull
                                                         Type type)

Creates an Optional type literal.

Type Parameters:

T - Item type.

Parameters:

type - Item type.

Returns:

A Optional type literal.

map

@Nonnull
public static <K,V> Reified<Map<K,V>> map(@Nonnull
                                                   Type key,
                                                   @Nonnull
                                                   Type value)

Creates an Map type literal.

Type Parameters:

K - Key type.

V - Key type.

Parameters:

key - Key type.

value - Value type.

Returns:

A Map type literal.

completableFuture

@Nonnull
public static <T> Reified<CompletableFuture<T>> completableFuture(@Nonnull
                                                                           Type type)

Creates a CompletableFuture type literal.

Type Parameters:

T - Item type.

Parameters:

type - Item type.

Returns:

A CompletableFuture type literal.

getParameterized

@Nonnull
public static Reified<?> getParameterized(@Nonnull
                                                   Type rawType,
                                                   @Nonnull
                                                   Type... typeArguments)

Gets type literal for the parameterized type represented by applying typeArguments to rawType.

Parameters:

rawType - Raw type.

typeArguments - Parameter types.

Returns:

Gets type literal for the parameterized type represented by applying typeArguments to rawType.