com.comphenix.protocol.reflect.instances

Class DefaultInstances

java.lang.Object

com.comphenix.protocol.reflect.instances.DefaultInstances

public class DefaultInstances
extends java.lang.Object

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(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)
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... instaceProviders) 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.
<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.

Methods inherited from class java.lang.Object

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

Field Detail

DEFAULT

public static 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(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... instaceProviders)

Construct a default instance generator using the given instance providers.

Parameters:

instaceProviders - - array 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.

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.