com.google.inject
Class TypeLiteral<T>

java.lang.Object
  extended by com.google.inject.TypeLiteral<T>

public class TypeLiteral<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:

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

Assumes that type T implements Object.equals(java.lang.Object) and Object.hashCode() as value (as opposed to identity) comparison.


Constructor Summary
protected TypeLiteral()
          Constructs a new type literal.
 
Method Summary
 boolean equals(Object o)
           
static
<T> TypeLiteral<T>
get(Class<T> type)
          Gets type literal for the given Class instance.
static TypeLiteral<?> get(Type type)
          Gets type literal for the given Type instance.
 List<Type> getExceptionTypes(Member methodOrConstructor)
          Returns the resolved generic exception types thrown by constructor.
 Type getFieldType(Field field)
          Returns the resolved generic type of field.
 List<Type> getParameterTypes(Member methodOrConstructor)
          Returns the resolved generic parameter types of methodOrConstructor.
 Type getReturnType(Method method)
          Returns the resolved generic return type of method.
 Type getSupertype(Class<?> supertype)
          Returns the generic form of supertype.
 Type getType()
          Gets underlying Type instance.
 int hashCode()
           
 String toString()
           
 
Methods inherited from class java.lang.Object
clone, finalize, getClass, notify, notifyAll, wait, wait, wait
 

Constructor Detail

TypeLiteral

protected TypeLiteral()
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

getType

public final Type getType()
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

public static TypeLiteral<?> get(Type type)
Gets type literal for the given Type instance.


get

public static <T> TypeLiteral<T> get(Class<T> type)
Gets type literal for the given Class instance.


getSupertype

public Type getSupertype(Class<?> supertype)
Returns the generic form of supertype. For example, if this is ArrayList<String>, this returns Iterable<String> given the input Iterable.class.

Parameters:
supertype - a superclass of, or interface implemented by, this.
Since:
2.0

getFieldType

public Type getFieldType(Field field)
Returns the resolved generic type of field.

Parameters:
field - a field defined by this or any superclass.
Since:
2.0

getParameterTypes

public List<Type> getParameterTypes(Member methodOrConstructor)
Returns the resolved generic parameter types of methodOrConstructor.

Parameters:
methodOrConstructor - a method or constructor defined by this or any supertype.
Since:
2.0

getExceptionTypes

public List<Type> getExceptionTypes(Member methodOrConstructor)
Returns the resolved generic exception types thrown by constructor.

Parameters:
methodOrConstructor - a method or constructor defined by this or any supertype.
Since:
2.0

getReturnType

public Type getReturnType(Method method)
Returns the resolved generic return type of method.

Parameters:
method - a method defined by this or any supertype.
Since:
2.0


Copyright 2008 Google Inc. All Rights Reserved.