Class AbstractReflectiveProxier<PS extends ProxySpecification>

java.lang.Object

org.microbean.proxy.AbstractProxier<PS>

org.microbean.proxy.AbstractReflectiveProxier<PS>

Type Parameters:

PS - the ProxySpecification type

public abstract non-sealed class AbstractReflectiveProxier<PS extends ProxySpecification>
extends AbstractProxier<PS>

An AbstractProxier that helps subclasses create proxies using the java.lang.reflect.Proxy machinery present in the Java Development Kit.

This class also contains various protected utility methods that help with converting reflective Types and Executables to their TypeMirror and ExecutableElement counterparts.

Author:

Laird Nelson

See Also:

• proxy(ProxySpecification, Supplier)
• type(Type)
• executableElement(Executable)

Constructor Summary

Constructors

Modifier	Constructor	Description
protected	AbstractReflectiveProxier(Domain domain)	Creates a new AbstractReflectiveProxier implementation.

Method Summary

Modifier and Type	Method	Description
protected final boolean	equalsMethod(Method m)	Returns true if the supplied Method is the java.lang.Object#equals(java.lang.Object) method.
protected final ExecutableElement	executableElement(Executable e)	Returns an ExecutableElement corresponding to the supplied Executable.
protected final boolean	hashCodeMethod(Method m)	Returns true if the supplied Method is the java.lang.Object#hashCode() method.
protected final Parameterizable	parameterizable(GenericDeclaration gd)	Returns a Parameterizable corresponding to the supplied GenericDeclaration.
protected abstract <R> Proxy<R>	proxy(PS ps, Class<?>[] interfaces, Supplier<? extends R> instanceSupplier)	Returns a Proxy appropriate for the supplied specification and Supplier of contextual instances.
final <R> Proxy<R>	proxy(PS ps, Supplier<? extends R> instanceSupplier)	Returns a Proxy appropriate for the supplied specification and Supplier of instances.
protected final TypeMirror	type(Type t)	Returns the TypeMirror corresponding to the supplied Type.
protected final TypeMirror[]	types(Type[] ts)	Returns an array of TypeMirrors whose elements correspond to the elements in the supplied Type array.

Methods inherited from class org.microbean.proxy.AbstractProxier

classLoader, domain

Methods inherited from class java.lang.Object

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

Constructor Details

AbstractReflectiveProxier

protected AbstractReflectiveProxier(Domain domain)

Creates a new AbstractReflectiveProxier implementation.

Parameters:

domain - a Domain; must not be null

Throws:

NullPointerException - if domain is null

Method Details

equalsMethod

protected final boolean equalsMethod(Method m)

Returns true if the supplied Method is the java.lang.Object#equals(java.lang.Object) method.

Parameters:

m - a Method; must not be null

Returns:

true if the supplied Method is the java.lang.Object#equals(java.lang.Object) method

Throws:

NullPointerException - if m is null

executableElement

protected final ExecutableElement executableElement(Executable e)

Returns an ExecutableElement corresponding to the supplied Executable.

Parameters:

e - an Executable; must not be null

Returns:

an ExecutableElement corresponding to the supplied Executable; never null

Throws:

NullPointerException - if e is null

IllegalArgumentException - if somehow e is neither a Constructor nor a Method

hashCodeMethod

protected final boolean hashCodeMethod(Method m)

Returns true if the supplied Method is the java.lang.Object#hashCode() method.

Parameters:

m - a Method; must not be null

Returns:

true if the supplied Method is the java.lang.Object#hashCode() method

Throws:

NullPointerException - if m is null

parameterizable

protected final Parameterizable parameterizable(GenericDeclaration gd)

Returns a Parameterizable corresponding to the supplied GenericDeclaration.

Parameters:

gd - a GenericDeclaration; must not be null

Returns:

a Parameterizable corresponding to the supplied GenericDeclaration; never null

Throws:

NullPointerException - if gd is null

IllegalArgumentException - if gd is neither a Class nor an Executable

proxy

public final <R> Proxy<R> proxy(PS ps,
 Supplier<? extends R> instanceSupplier)

Returns a Proxy appropriate for the supplied specification and Supplier of instances.

Specified by:

proxy in class AbstractProxier<PS extends ProxySpecification>

Type Parameters:

R - the contextual instance type

Parameters:

ps - an appropriate proxy specification; must not be null

instanceSupplier - a Supplier of contextual instances; must not be null; may or may not create a new contextual instance each time it is invoked; may or may not be invoked multiple times depending on the subclass implementation

Returns:

a non-null Proxy

Throws:

NullPointerException - if any argument is null

IllegalArgumentException - if the superclass is not java.lang.Object (only interfaces may be proxied reflectively)

See Also:

• proxy(ProxySpecification, Class[], Supplier)
• AbstractProxier.classLoader()

proxy

protected abstract <R> Proxy<R> proxy(PS ps,
 Class<?>[] interfaces,
 Supplier<? extends R> instanceSupplier)

Returns a Proxy appropriate for the supplied specification and Supplier of contextual instances.

Type Parameters:

R - the contextual instance type

Parameters:

ps - an appropriate proxy specification; must not be null

interfaces - the interfaces to implement; every element is guaranteed to be an interface

instanceSupplier - a Supplier of contextual instances; must not be null; may or may not create a new contextual instance each time it is invoked; may or may not be invoked multiple times depending on the subclass implementation

Returns:

a non-null Proxy

Throws:

NullPointerException - if any argument is null

type

protected final TypeMirror type(Type t)

Returns the TypeMirror corresponding to the supplied Type.

Parameters:

t - a Type; must not be null

Returns:

the TypeMirror corresponding to the supplied Type; never null

Throws:

NullPointerException - if t is null

IllegalArgumentException - if t is not a Class, GenericArrayType, ParameterizedType, TypeVariable or WildcardType

types

protected final TypeMirror[] types(Type[] ts)

Returns an array of TypeMirrors whose elements correspond to the elements in the supplied Type array.

Parameters:

ts - an array of Types; must not be null

Returns:

an array of TypeMirrors whose elements correspond to the elements in the supplied Type array; never null

Throws:

NullPointerException - if ts is null or contains null elements

IllegalArgumentException - if any element of ts is deemed illegal by the type(Type) method

See Also:

• type(Type)