Class ReflectiveClientProxier

java.lang.Object

org.microbean.reference.AbstractClientProxier<Class<?>>

org.microbean.reference.ReflectiveClientProxier

All Implemented Interfaces:

ClientProxier

public class ReflectiveClientProxier
extends AbstractClientProxier<Class<?>>

An AbstractClientProxier implementation that uses Proxy machinery.

Author:

Laird Nelson

Constructor Summary

Constructors

Constructor	Description
ReflectiveClientProxier(Domain domain)	Creates a new ReflectiveClientProxier.
ReflectiveClientProxier(Domain domain, Function<? super List<? extends Class<?>>,? extends ClassLoader> clf)	Creates a new ReflectiveClientProxier.

Method Summary

Modifier and Type	Method	Description
protected <R> ClientProxy<R>	instantiate(ProxySpecification ps, Supplier<? extends R> instanceSupplier)	Called indirectly by the AbstractClientProxier.clientProxy(Request, Supplier) method when a new ClientProxy<R> instance needs to be created, creates a new instance of a ClientProxy<R> that proxies contextual instances supplied by the supplied instanceSupplier, and returns it.
protected MethodHandles.Lookup	lookup(Class<?> c)	Returns a MethodHandles.Lookup suitable for the supplied Class.

Methods inherited from class org.microbean.reference.AbstractClientProxier

classLoader, clientProxy, clientProxyClass, domain, generate, instantiate

Methods inherited from class java.lang.Object

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

Constructor Details

ReflectiveClientProxier

public ReflectiveClientProxier(Domain domain)

Creates a new ReflectiveClientProxier.

Parameters:

domain - a Domain; must not be null

Throws:

NullPointerException - if domain is null

See Also:

• ReflectiveClientProxier(Domain, Function)

ReflectiveClientProxier

public ReflectiveClientProxier(Domain domain,
 Function<? super List<? extends Class<?>>,? extends ClassLoader> clf)

Creates a new ReflectiveClientProxier.

Parameters:

domain - a Domain; must not be null

clf - a Function that returns a ClassLoader appropriate for a List of Class instances; must not be null

Throws:

NullPointerException - if any argument is null

Method Details

instantiate

protected <R> ClientProxy<R> instantiate(ProxySpecification ps,
 Supplier<? extends R> instanceSupplier)

Description copied from class: AbstractClientProxier

Called indirectly by the AbstractClientProxier.clientProxy(Request, Supplier) method when a new ClientProxy<R> instance needs to be created, creates a new instance of a ClientProxy<R> that proxies contextual instances supplied by the supplied instanceSupplier, and returns it.

The default implementation of this method eventually calls the AbstractClientProxier.instantiate(Class, Supplier) method with the return value of an indirect invocation of the AbstractClientProxier.clientProxyClass(Object, ClassLoader) method and the supplied Supplier and returns the result.

Overrides of this method that do something entirely different are not obligated to call the AbstractClientProxier.clientProxyClass(Object, ClassLoader) method or the AbstractClientProxier.instantiate(Class, Supplier) method. In such a case, those methods will be effectively orphaned.

Overrides:

instantiate in class AbstractClientProxier<Class<?>>

Type Parameters:

R - the type of contextual instance being proxied

Parameters:

ps - a ProxySpecification; must not be null

instanceSupplier - a Supplier of contextual instances of the <R> type; must not be null

Returns:

a non-null ClientProxy<R>

See Also:

• AbstractClientProxier.clientProxyClass(Object, ClassLoader)
• AbstractClientProxier.instantiate(Class, Supplier)

lookup

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

Description copied from class: AbstractClientProxier

Returns a MethodHandles.Lookup suitable for the supplied Class.

Specified by:

lookup in class AbstractClientProxier<Class<?>>

Parameters:

c - a Class; must not be null

Returns:

a MethodHandles.Lookup; never null

See Also:

• MethodHandles.lookup()
• MethodHandles.Lookup.in(Class)
• MethodHandles.privateLookupIn(Class, Lookup)