Class AbstractToolkitProxier<PS extends ProxySpecification,T>

java.lang.Object

org.microbean.proxy.AbstractProxier<PS>

org.microbean.proxy.AbstractToolkitProxier<PS,T>

Type Parameters:

PS - the ProxySpecification type

T - the toolkit representation of an unloaded Class

public abstract non-sealed class AbstractToolkitProxier<PS extends ProxySpecification,T>
extends AbstractProxier<PS>

An AbstractProxier built using some kind of toolkit, such as Byte Buddy and the like.

Author:

Laird Nelson

Constructor Summary

Constructors

Modifier	Constructor	Description
protected	AbstractToolkitProxier(Domain domain, MethodHandles.Lookup lookup)	Creates a new AbstractToolkitProxier.

Method Summary

Modifier and Type	Method	Description
protected abstract T	generate(PS ps)	Creates a generated class definition from the information present in the supplied ProxySpecification, and returns it for eventual supplying to an inovcation of the proxyClass(Object, ClassLoader) method.
protected MethodHandles.Lookup	lookup(Class<?> c)	Returns a MethodHandles.Lookup suitable for the supplied Class.
protected final Class<?>	proxyClass(PS ps)	Loads and returns the proxy class corresponding to the supplied proxy specification, generating it first if necessary.
protected abstract Class<?>	proxyClass(T t, ClassLoader cl)	Called by the proxyClass(ProxySpecification) method, converts the supplied class definition into a Class, using the supplied ClassLoader, and returns it.

Methods inherited from class org.microbean.proxy.AbstractProxier

classLoader, domain, proxy

Methods inherited from class java.lang.Object

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

Constructor Details

AbstractToolkitProxier

protected AbstractToolkitProxier(Domain domain,
 MethodHandles.Lookup lookup)

Creates a new AbstractToolkitProxier.

Parameters:

domain - a Domain; must not be null

lookup - a MethodHandles.Lookup; must not be null

Throws:

NullPointerException - if any argument is null

See Also:

• lookup(Class)

Method Details

generate

protected abstract T generate(PS ps)
                       throws Throwable

Creates a generated class definition from the information present in the supplied ProxySpecification, and returns it for eventual supplying to an inovcation of the proxyClass(Object, ClassLoader) method.

Parameters:

ps - a ProxySpecification; must not be null

Returns:

a non-null generated class definition

Throws:

NullPointerException - if ps is null

Throwable - if creation of the generated class definition fails

See Also:

• proxyClass(Object, ClassLoader)

lookup

protected MethodHandles.Lookup lookup(Class<?> c)

Returns a MethodHandles.Lookup suitable for the supplied Class.

Parameters:

c - a Class; must not be null

Returns:

a MethodHandles.Lookup suitable for the supplied Class 8

See Also:

• MethodHandles.Lookup.in(Class)

proxyClass

protected final Class<?> proxyClass(PS ps)
                             throws ClassNotFoundException

Loads and returns the proxy class corresponding to the supplied proxy specification, generating it first if necessary.

Parameters:

ps - a proxy specification; must not be null

Returns:

a non-null Class that is guaranteed to be assignable to Proxy.class

Throws:

ClassNotFoundException - if the class could not be found

See Also:

• generate(ProxySpecification)
• proxyClass(Object, ClassLoader)

proxyClass

protected abstract Class<?> proxyClass(T t,
 ClassLoader cl)
                                throws ClassNotFoundException

Called by the proxyClass(ProxySpecification) method, converts the supplied class definition into a Class, using the supplied ClassLoader, and returns it.

Overrides of this method must not call the proxyClass(ProxySpecification) method or undefined behavior may result.

Parameters:

t - a class definition; must not be null

cl - a ClassLoader; must not be null

Returns:

a non-null Class

Throws:

NullPointerException - if any argument is null

ClassNotFoundException - if an invocation of ClassLoader.loadClass(String) fails

See Also:

• proxyClass(ProxySpecification)