Package dev.getelements.elements.rt.remote

Class ProxyBuilder<ProxyT>

java.lang.Object

dev.getelements.elements.rt.remote.ProxyBuilder<ProxyT>

public class ProxyBuilder<ProxyT>
extends Object

Constructor Summary

Constructors

Constructor	Description
ProxyBuilder(Class<ProxyT> interfaceClassT)	Creates a ProxyBuilder<ProxyT> for the supplied interface type.
ProxyBuilder(Class<ProxyT> interfaceClassT, String name)	Creates a ProxyBuilder<ProxyT> for the supplied interface type.

Method Summary

Modifier and Type	Method	Description
ProxyT	build()	Returns new instance of ProxyBuilder using the built-in Proxy functionality.
ProxyBuilder<ProxyT>	dontProxyDefaultMethods()	Given any interface methods that are declared as "default" this will ensure that they are not proxied.
MethodAssignment<ProxyBuilder<ProxyT>>	handler(InvocationHandler invocationHandler)	Specifies an instance of InvocationHandler, which can be used to handle invocations against a Method through a MethodAssignment.
ProxyBuilder<ProxyT>	withDefaultHandler(InvocationHandler defaultInvocationHandler)	Specifies the default InvocationHandler, which gets called when no other InvocationHandler is able to handle the invocation.
ProxyBuilder<ProxyT>	withDefaultHashCodeAndEquals()	Specifies the Object.hashCode() and Object.equals(Object) method.
ProxyBuilder<ProxyT>	withHandlersForRemoteDispatcher(RemoteInvocationDispatcher remoteInvocationDispatcher)	Generates an InvocationHandler for each method int he class marked RemotelyInvokable using the specifed RemoteInvocationDispatcher.
ProxyBuilder<ProxyT>	withHandlersForRemoteInvoker(RemoteInvoker remoteInvoker)	Generates an InvocationHandler for each method in the class marked RemotelyInvokable using the specified RemoteInvoker.
ProxyBuilder<ProxyT>	withMethodHandleCache(BiFunction<dev.getelements.elements.rt.remote.MethodHandleKey,Supplier<MethodHandle>,MethodHandle> methodHandleCache)	Allows for hte specification of a cache-getter function.
ProxyBuilder<ProxyT>	withSharedMethodHandleCache()	Uses the SharedMethodHandleCache.getSharedMethodHandleCache() to cache method handles.
ProxyBuilder<ProxyT>	withToString()	Specifies the a default Object.toString() method, which simply returns the value "Proxy for the.class.Name"
ProxyBuilder<ProxyT>	withToString(String toString)	Specifies the a default Object.toString() method, which simply returns the hardcoded value.

Methods inherited from class java.lang.Object

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

Constructor Details

ProxyBuilder

public ProxyBuilder(Class<ProxyT> interfaceClassT)

Creates a ProxyBuilder<ProxyT> for the supplied interface type.

Parameters:

interfaceClassT -

ProxyBuilder

public ProxyBuilder(Class<ProxyT> interfaceClassT,
 String name)

Creates a ProxyBuilder<ProxyT> for the supplied interface type.

Parameters:

interfaceClassT -

name - Relates to Invocation.getName() and maps to the naming used in Named.

Method Details

dontProxyDefaultMethods

public ProxyBuilder<ProxyT> dontProxyDefaultMethods()

Given any interface methods that are declared as "default" this will ensure that they are not proxied.

Returns:

this instance

withSharedMethodHandleCache

public ProxyBuilder<ProxyT> withSharedMethodHandleCache()

Uses the SharedMethodHandleCache.getSharedMethodHandleCache() to cache method handles.

Returns:

this instance

withMethodHandleCache

public ProxyBuilder<ProxyT> withMethodHandleCache(BiFunction<dev.getelements.elements.rt.remote.MethodHandleKey,Supplier<MethodHandle>,MethodHandle> methodHandleCache)

Allows for hte specification of a cache-getter function. If the underlying cache

Parameters:

methodHandleCache - a Function<dev.getelements.elements.rt.remote.MethodHandleKey,MethodHandle> used to retrieve cached instances

Returns:

handler

public MethodAssignment<ProxyBuilder<ProxyT>> handler(InvocationHandler invocationHandler)

Specifies an instance of InvocationHandler, which can be used to handle invocations against a Method through a MethodAssignment.

Parameters:

invocationHandler - the InvocationHandler

Returns:

a MethodAssignment used to assign this InvocationHandler to a specific Method

withDefaultHandler

public ProxyBuilder<ProxyT> withDefaultHandler(InvocationHandler defaultInvocationHandler)

Specifies the default InvocationHandler, which gets called when no other InvocationHandler is able to handle the invocation.

Parameters:

defaultInvocationHandler - the default InvocationHandler

Returns:

this instance

withToString

public ProxyBuilder<ProxyT> withToString()

Specifies the a default Object.toString() method, which simply returns the value "Proxy for the.class.Name"

Returns:

this instance

withToString

public ProxyBuilder<ProxyT> withToString(String toString)

Specifies the a default Object.toString() method, which simply returns the hardcoded value.

Parameters:

toString - the value to return when Object.toString() is invoked on the proxy.

Returns:

this instance

withDefaultHashCodeAndEquals

public ProxyBuilder<ProxyT> withDefaultHashCodeAndEquals()

Specifies the Object.hashCode() and Object.equals(Object) method. Object.hashCode() will be implemented System.identityHashCode(Object) and equals will be implemented as "=="

Returns:

this instance

withHandlersForRemoteInvoker

public ProxyBuilder<ProxyT> withHandlersForRemoteInvoker(RemoteInvoker remoteInvoker)

Generates an InvocationHandler for each method in the class marked RemotelyInvokable using the specified RemoteInvoker.

Returns:

this instance

withHandlersForRemoteDispatcher

public ProxyBuilder<ProxyT> withHandlersForRemoteDispatcher(RemoteInvocationDispatcher remoteInvocationDispatcher)

Generates an InvocationHandler for each method int he class marked RemotelyInvokable using the specifed RemoteInvocationDispatcher.

Parameters:

remoteInvocationDispatcher - the RemoteInvocationDispatcher

Returns:

this instance

build

public ProxyT build()

Returns new instance of ProxyBuilder using the built-in Proxy functionality.

Returns:

the ProxyBuilder instance.