com.comphenix.protocol.reflect.instances

Class DefaultInstances

java.lang.Object

com.comphenix.protocol.reflect.instances.DefaultInstances

All Implemented Interfaces:

InstanceProvider

public class DefaultInstances
extends java.lang.Object
implements InstanceProvider

Used to construct default instances of any type.

Author:

Kristian

Field Summary

Fields

Modifier and Type	Field and Description
static DefaultInstances	DEFAULT Standard default instance provider.

Constructor Summary

Constructors

Constructor and Description
DefaultInstances(DefaultInstances other) Copy a given instance provider.
DefaultInstances(com.google.common.collect.ImmutableList<InstanceProvider> registered) Construct a default instance generator using the given instance providers.
DefaultInstances(InstanceProvider... instaceProviders) Construct a default instance generator using the given instance providers.

Method Summary

Methods

Modifier and Type	Method and Description
protected <T> boolean	contains(T[] elements, T elementToFind)
java.lang.Object	create(java.lang.Class<?> type) Create an instance given a type, if possible.
protected <T> T	createInstance(java.lang.Class<T> type, java.lang.reflect.Constructor<T> constructor, java.lang.Class<?>[] types, java.lang.Object[] params) Used by the default instance provider to create a class from a given constructor.
DefaultInstances	forEnhancer(net.sf.cglib.proxy.Enhancer enhancer) Construct default instances using the CGLIB enhancer object instead.
static DefaultInstances	fromArray(InstanceProvider... instanceProviders) Construct a default instance generator using the given instance providers.
static DefaultInstances	fromCollection(java.util.Collection<InstanceProvider> instanceProviders) Construct a default instance generator using the given instance providers.
<T> T	getDefault(java.lang.Class<T> type) Retrieves a default instance or value that is assignable to this type.
<T> T	getDefault(java.lang.Class<T> type, java.util.List<InstanceProvider> providers) Retrieves a default instance or value that is assignable to this type.
int	getMaximumRecursion() Retrieve the the maximum height of the hierachy of creates types.
<T> java.lang.reflect.Constructor<T>	getMinimumConstructor(java.lang.Class<T> type) Retrieve the constructor with the fewest number of parameters.
com.google.common.collect.ImmutableList<InstanceProvider>	getRegistered() Retrieves a immutable list of every default object providers that generates instances.
boolean	isNonNull() Retrieve whether or not the constructor's parameters must be non-null.
void	setMaximumRecursion(int maximumRecursion) Set the maximum height of the hierachy of creates types.
void	setNonNull(boolean nonNull) Set whether or not the constructor's parameters must be non-null.

Methods inherited from class java.lang.Object

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

Field Detail

DEFAULT

public static final DefaultInstances DEFAULT

Standard default instance provider.

Constructor Detail

DefaultInstances

public DefaultInstances(com.google.common.collect.ImmutableList<InstanceProvider> registered)

Construct a default instance generator using the given instance providers.

Parameters:

registered - - list of instance providers.

DefaultInstances

public DefaultInstances(DefaultInstances other)

Copy a given instance provider.

Parameters:

other - - instance provider to copy.

DefaultInstances

public DefaultInstances(InstanceProvider... instaceProviders)

Construct a default instance generator using the given instance providers.

Parameters:

instaceProviders - - array of instance providers.

Method Detail

fromArray

public static DefaultInstances fromArray(InstanceProvider... instanceProviders)

Construct a default instance generator using the given instance providers.

Parameters:

instanceProviders - - array of instance providers.

Returns:

An default instance generator.

fromCollection

public static DefaultInstances fromCollection(java.util.Collection<InstanceProvider> instanceProviders)

Construct a default instance generator using the given instance providers.

Parameters:

instanceProviders - - collection of instance providers.

Returns:

An default instance generator.

getRegistered

public com.google.common.collect.ImmutableList<InstanceProvider> getRegistered()

Retrieves a immutable list of every default object providers that generates instances.

Returns:

Table of instance providers.

isNonNull

public boolean isNonNull()

Retrieve whether or not the constructor's parameters must be non-null.

Returns:

TRUE if they must be non-null, FALSE otherwise.

setNonNull

public void setNonNull(boolean nonNull)

Set whether or not the constructor's parameters must be non-null.

Parameters:

nonNull - - TRUE if they must be non-null, FALSE otherwise.

getMaximumRecursion

public int getMaximumRecursion()

Retrieve the the maximum height of the hierachy of creates types.

Returns:

Maximum height.

setMaximumRecursion

public void setMaximumRecursion(int maximumRecursion)

Set the maximum height of the hierachy of creates types. Used to prevent cycles.

Parameters:

maximumRecursion - - maximum recursion height.

getDefault

public <T> T getDefault(java.lang.Class<T> type)

Retrieves a default instance or value that is assignable to this type.

This includes, but isn't limited too:

• Primitive types. Returns either zero or null.
• Primitive wrappers.
• String types. Returns an empty string.
• Arrays. Returns a zero-length array of the same type.
• Enums. Returns the first declared element.
• Collection interfaces, such as List and Set. Returns the most appropriate empty container.
• Any type with a public constructor that has parameters with defaults.

Parameters:

type - - the type to construct a default value.

Returns:

A default value/instance, or NULL if not possible.

getMinimumConstructor

public <T> java.lang.reflect.Constructor<T> getMinimumConstructor(java.lang.Class<T> type)

Retrieve the constructor with the fewest number of parameters.

Parameters:

type - - type to construct.

Returns:

A constructor with the fewest number of parameters, or NULL if the type has no constructors.

getDefault

public <T> T getDefault(java.lang.Class<T> type,
               java.util.List<InstanceProvider> providers)

Retrieves a default instance or value that is assignable to this type.

This includes, but isn't limited too:

• Primitive types. Returns either zero or null.
• Primitive wrappers.
• String types. Returns an empty string.
• Arrays. Returns a zero-length array of the same type.
• Enums. Returns the first declared element.
• Collection interfaces, such as List and Set. Returns the most appropriate empty container.
• Any type with a public constructor that has parameters with defaults.