org.jboss.weld.bean.proxy

Interface ProxyInstantiator

All Superinterfaces:

Service

All Known Implementing Classes:

DefaultProxyInstantiator

public interface ProxyInstantiator
extends Service

Implementations of this interface are capable of creating instances of a given proxy class. This can either be done simply by calling Class.newInstance() or using more advanced mechanism (e.g. sun.misc.Unsafe)

Author:

Jozef Hartinger

See Also:

DefaultProxyInstantiator, UnsafeProxyInstantiator, ReflectionFactoryProxyInstantiator

Nested Class Summary

Nested Classes

Modifier and Type	Interface and Description
static class	ProxyInstantiator.Factory

Method Summary

Modifier and Type	Method and Description
boolean	isUsingConstructor() Indicates whether this instantiator calls proxy class' no-arg constructor or whether it uses an alternative mechanism to obtain a proxy class instance.
<T> T	newInstance(java.lang.Class<T> clazz) Create a new instance of a proxy class.
<T> UnproxyableResolutionException	validateNoargConstructor(java.lang.reflect.Constructor<T> constructor, java.lang.Class<?> clazz, Bean<?> declaringBean) Validate, whether the given constructor is sufficient for a class to be proxyable.

Methods inherited from interface org.jboss.weld.bootstrap.api.Service

cleanup

Method Detail

newInstance

<T> T newInstance(java.lang.Class<T> clazz)
           throws java.lang.InstantiationException,
                  java.lang.IllegalAccessException

Create a new instance of a proxy class. This method needs to be run from a privileged context.

Type Parameters:

T - the proxy class

Parameters:

clazz - the class

Returns:

an instance of a proxy class

Throws:

java.lang.InstantiationException

java.lang.IllegalAccessException

validateNoargConstructor

<T> UnproxyableResolutionException validateNoargConstructor(java.lang.reflect.Constructor<T> constructor,
                                                            java.lang.Class<?> clazz,
                                                            Bean<?> declaringBean)
                                                     throws UnproxyableResolutionException

Validate, whether the given constructor is sufficient for a class to be proxyable.

Parameters:

constructor - the given constructor

clazz - the given class

declaringBean - the declaring bean

Returns:

an UnproxyableResolutionException if the given class is not proxyable due to the given constructor, null otherwise

Throws:

UnproxyableResolutionException

isUsingConstructor

boolean isUsingConstructor()

Indicates whether this instantiator calls proxy class' no-arg constructor or whether it uses an alternative mechanism to obtain a proxy class instance.

Returns:

true if this implementation uses proxy class' no-arg constructor for creating new instances, false otherwise