uk.co.strangeskies.reflection.token

Class TypedObject<T>

java.lang.Object

uk.co.strangeskies.reflection.token.TypedObject<T>

Type Parameters:

T - The type of the object instance to track.

All Implemented Interfaces:

Reified, ReifiedType<TypedObject<T>>, Self<TypedObject<T>>

public class TypedObject<T>
extends java.lang.Object
implements ReifiedType<TypedObject<T>>

Method Summary

Modifier and Type	Method and Description
<U> TypedObject<U>	assign(TypeToken<U> type) Cast a typed object into a differently typed object, succeeding only if the types are assignment compatible.
<U> TypedObject<U>	cast(TypeToken<U> type) Cast a typed object into a differently typed object.
static <T> TypedObject<T>	castUnsafe(java.lang.Object object, TypeToken<T> type) Cast an untyped object into a typed object without consideration for generic type safety.
<U> TypedObject<U>	castUnsafe(TypeToken<U> type) Cast a typed object into a differently typed object without consideration for generic type safety.
boolean	equals(java.lang.Object obj)
T	getObject()
TypeToken<TypedObject<T>>	getThisTypeToken()
java.lang.reflect.Type	getType()
TypeToken<T>	getTypeToken()
int	hashCode()
java.lang.String	toString()
<U> java.util.Optional<TypedObject<U>>	tryAssign(TypeToken<U> type) Cast a typed object into a differently typed object, succeeding only if the types are assignment compatible.
<U> java.util.Optional<TypedObject<U>>	tryCast(TypeToken<U> type) Cast a typed object into a differently typed object.
static <T> TypedObject<T>	typedObject(java.lang.Class<T> type, T object) Convenience method to return a TypedObject wrapper around an object instance of this type.
static <T> TypedObject<T>	typedObject(TypeToken<T> type, T object) Convenience method to return a TypedObject wrapper around an object instance of this type.

Methods inherited from class java.lang.Object

clone, finalize, getClass, notify, notifyAll, wait, wait, wait

Methods inherited from interface uk.co.strangeskies.reflection.token.ReifiedType

asTypedObject, getThisType

Methods inherited from interface uk.co.strangeskies.utility.Self

getThis

Method Detail

typedObject

public static <T> TypedObject<T> typedObject(TypeToken<T> type,
                                             T object)

Convenience method to return a TypedObject wrapper around an object instance of this type.

Parameters:

object - The object to wrap with a typed container

Returns:

A typed container for the given object

typedObject

public static <T> TypedObject<T> typedObject(java.lang.Class<T> type,
                                             T object)

Convenience method to return a TypedObject wrapper around an object instance of this type.

Parameters:

object - The object to wrap with a typed container

Returns:

A typed container for the given object

castUnsafe

public static <T> TypedObject<T> castUnsafe(java.lang.Object object,
                                            TypeToken<T> type)

Cast an untyped object into a typed object without consideration for generic type safety.

Type Parameters:

T - The target type of the cast

Parameters:

type - A type token over the type of the cast

object - The object to cast

Returns:

A typed object over the given type and object

castUnsafe

public <U> TypedObject<U> castUnsafe(TypeToken<U> type)

Cast a typed object into a differently typed object without consideration for generic type safety.

Type Parameters:

U - The target type of the cast

Parameters:

type - A type token over the type of the cast

Returns:

A typed object over the given type and object

tryCast

public <U> java.util.Optional<TypedObject<U>> tryCast(TypeToken<U> type)

Cast a typed object into a differently typed object.

Type Parameters:

U - The target type of the cast

Parameters:

type - A type token over the type of the cast

Returns:

If the cast succeeds, an optional containing the typed object over the given type and object is returned, otherwise an empty optional is returned.

cast

public <U> TypedObject<U> cast(TypeToken<U> type)

Cast a typed object into a differently typed object.

Type Parameters:

U - The target type of the cast

Parameters:

type - A type token over the type of the cast

Returns:

A typed object over the given type and object

tryAssign

public <U> java.util.Optional<TypedObject<U>> tryAssign(TypeToken<U> type)

Cast a typed object into a differently typed object, succeeding only if the types are assignment compatible.

Type Parameters:

U - The target type of the cast

Parameters:

type - A type token over the type of the cast

Returns:

If the cast succeeds, an optional containing the typed object over the given type and object is returned, otherwise an empty optional is returned.

assign

public <U> TypedObject<U> assign(TypeToken<U> type)

Cast a typed object into a differently typed object, succeeding only if the types are assignment compatible.

Type Parameters:

U - The target type of the cast

Parameters:

type - A type token over the type of the cast

Returns:

A typed object over the given type and object

getTypeToken

public TypeToken<T> getTypeToken()

Returns:

The type of the reference.

getType

public java.lang.reflect.Type getType()

Returns:

The type of the reference.

getObject

public T getObject()

Returns:

An object reference guaranteed to be of the given type.

toString

public java.lang.String toString()

Overrides:

toString in class java.lang.Object

getThisTypeToken

public TypeToken<TypedObject<T>> getThisTypeToken()

Specified by:

getThisTypeToken in interface ReifiedType<TypedObject<T>>

Returns:

a TypeToken over the value of ReifiedType.getThisType()

equals

public boolean equals(java.lang.Object obj)

Overrides:

equals in class java.lang.Object

hashCode

public int hashCode()

Overrides:

hashCode in class java.lang.Object