org.apache.juneau.reflect

Class ConstructorInfo

java.lang.Object

org.apache.juneau.reflect.ExecutableInfo

org.apache.juneau.reflect.ConstructorInfo

All Implemented Interfaces:

Comparable<ConstructorInfo>

@BeanIgnore
public final class ConstructorInfo
extends ExecutableInfo
implements Comparable<ConstructorInfo>

Lightweight utility class for introspecting information about a constructor.

Constructor Summary

Constructors

Modifier	Constructor and Description
protected	ConstructorInfo(ClassInfo declaringClass, Constructor<?> c, Constructor<?> rc) Constructor.

Method Summary

Modifier and Type	Method and Description
int	compareTo(ConstructorInfo o)
<T extends Annotation> T	getAnnotation(Class<T> a) Finds the annotation of the specified type defined on this constructor.
<T extends Annotation> T	getAnnotation(Class<T> a, MetaProvider mp) Finds the annotation of the specified type defined on this constructor.
boolean	hasAnnotation(Class<? extends Annotation> a) Returns true if the specified annotation is present on this constructor.
<T> Constructor<T>	inner() Returns the wrapped method.
<T> T	invoke(Object... args) Shortcut for calling the new-instance method on the underlying constructor.
ConstructorInfo	makeAccessible(Visibility v) Makes constructor accessible if it matches the visibility requirements, or returns null if it doesn't.
static ConstructorInfo	of(ClassInfo declaringClass, Constructor<?> c, Constructor<?> rc) Convenience method for instantiating a ConstructorInfo;
static ConstructorInfo	of(Constructor<?> c) Convenience method for instantiating a ConstructorInfo;

Methods inherited from class org.apache.juneau.reflect.ExecutableInfo

getDeclaringClass, getExceptionTypes, getFullName, getParam, getParamCount, getParameterAnnotations, getParameterAnnotations, getParams, getParamType, getParamTypes, getRawExceptionTypes, getRawGenericParamType, getRawGenericParamTypes, getRawParameter, getRawParameters, getRawParamType, getRawParamTypes, getShortName, getSimpleName, hasFuzzyParamTypes, hasFuzzyParamTypes, hasName, hasName, hasName, hasNoParams, hasNumParams, hasParams, hasParamTypeParents, hasParamTypeParents, hasParamTypes, hasParamTypes, isAbstract, isAll, isAny, isConstructor, isDeprecated, isNotAbstract, isNotDeprecated, isNotPublic, isNotStatic, isPublic, isStatic, isVisible, setAccessible, toString

Methods inherited from class java.lang.Object

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

Constructor Detail

ConstructorInfo

protected ConstructorInfo(ClassInfo declaringClass,
                          Constructor<?> c,
                          Constructor<?> rc)

Constructor.

Parameters:

declaringClass - The class that declares this method.

c - The constructor being wrapped.

rc - The "real" constructor if the constructor above is defined against a CGLIB proxy.

Method Detail

of

public static ConstructorInfo of(ClassInfo declaringClass,
                                 Constructor<?> c,
                                 Constructor<?> rc)

Convenience method for instantiating a ConstructorInfo;

Parameters:

declaringClass - The class that declares this method.

c - The constructor being wrapped.

rc - The "real" constructor if the constructor above is defined against a CGLIB proxy.

Returns:

A new ConstructorInfo object, or null if the method was null;

of

public static ConstructorInfo of(Constructor<?> c)

Convenience method for instantiating a ConstructorInfo;

Parameters:

c - The constructor being wrapped.

Returns:

A new ConstructorInfo object, or null if the method was null;

inner

public <T> Constructor<T> inner()

Returns the wrapped method.

Returns:

The wrapped method.

getAnnotation

public final <T extends Annotation> T getAnnotation(Class<T> a)

Finds the annotation of the specified type defined on this constructor.

Parameters:

a - The annotation to search for.

Returns:

The annotation if found, or null if not.

getAnnotation

public final <T extends Annotation> T getAnnotation(Class<T> a,
                                                    MetaProvider mp)

Finds the annotation of the specified type defined on this constructor.

Parameters:

a - The annotation to search for.

mp - The meta provider for looking up annotations on classes/methods/fields.

Returns:

The first annotation found, or null if it doesn't exist.

hasAnnotation

public final boolean hasAnnotation(Class<? extends Annotation> a)

Returns true if the specified annotation is present on this constructor.

Parameters:

a - The annotation to check for.

Returns:

true if the specified annotation is present on this constructor.

invoke

public <T> T invoke(Object... args)
             throws ExecutableException

Shortcut for calling the new-instance method on the underlying constructor.

Parameters:

args - the arguments used for the method call

Returns:

The object returned from the constructor.

Throws:

ExecutableException - Exception occurred on invoked constructor/method/field.

makeAccessible

public ConstructorInfo makeAccessible(Visibility v)

Makes constructor accessible if it matches the visibility requirements, or returns null if it doesn't.

Security exceptions thrown on the call to AccessibleObject.setAccessible(boolean) are quietly ignored.

Parameters:

v - The minimum visibility.

Returns:

The same constructor if visibility requirements met, or null if visibility requirement not met or call to AccessibleObject.setAccessible(boolean) throws a security exception.

compareTo

public int compareTo(ConstructorInfo o)

Specified by:

compareTo in interface Comparable<ConstructorInfo>