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)

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)	A convenience method that returns true if the supplied Method is the java.lang.Object#equals(java.lang.Object) method.
protected final boolean	hashCodeMethod(Method m)	A convenience method that returns true if the supplied Method is the java.lang.Object#hashCode() method.
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.

Methods inherited from class AbstractProxier

classLoader, domain

Methods inherited from class 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)

A convenience method that 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

hashCodeMethod

protected final boolean hashCodeMethod(Method m)

A convenience method that 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

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