io.magus.methodmap

Class BoundMethodMap<K>

java.lang.Object

java.util.AbstractMap<K,V>

java.util.HashMap<K,MethodHandleInfo>

io.magus.methodmap.AbstractMethodMap<K>

io.magus.methodmap.BoundMethodMap<K>

Type Parameters:

K - The type of keys contained by the MethodMap

All Implemented Interfaces:

java.io.Serializable, java.lang.Cloneable, java.util.Map<K,MethodHandleInfo>

public class BoundMethodMap<K>
extends AbstractMethodMap<K>

MethodMap which is bound to a single object. All non-static methods are invoked with the the same object as the target.

See Also:

Serialized Form

Nested Class Summary

Nested classes/interfaces inherited from class java.util.AbstractMap

java.util.AbstractMap.SimpleEntry<K,V>, java.util.AbstractMap.SimpleImmutableEntry<K,V>

Nested classes/interfaces inherited from interface java.util.Map

java.util.Map.Entry<K,V>

Constructor Summary

Constructors

Constructor and Description
BoundMethodMap(MapEntryKeyFactory<K> entryKeyFactory, AbstractBoundMethodCollectionFactory methodCollectionFactory, java.lang.invoke.MethodHandles.Lookup lookup)

Method Summary

Modifier and Type	Method and Description
java.lang.Object	invoke(K key, ArgsFactory argsFactory) Invokes the methodhandle contained in the methodhandleinfo mapped to the provided key with arguments produced by the given argsfactory.
java.lang.Object	invoke(K key, java.lang.Object... args) Invokes the methodhandle contained in the methodhandleinfo mapped to the provided key with the given arguments.
java.lang.Object	invoke(java.lang.Object... args) Treats the first argument as the key, the remaining arguments as the methodhandle arguments, and invokes the methodhandle contained in the methodhandleinfo mapped to the provided key with the given arguments.

Methods inherited from class io.magus.methodmap.AbstractMethodMap

getMethodHandleInfo, invoke, invoke

Methods inherited from class java.util.HashMap

clear, clone, compute, computeIfAbsent, computeIfPresent, containsKey, containsValue, entrySet, forEach, get, getOrDefault, isEmpty, keySet, merge, put, putAll, putIfAbsent, remove, remove, replace, replace, replaceAll, size, values

Methods inherited from class java.util.AbstractMap

equals, hashCode, toString

Methods inherited from class java.lang.Object

finalize, getClass, notify, notifyAll, wait, wait, wait

Methods inherited from interface java.util.Map

equals, hashCode

Constructor Detail

BoundMethodMap

public BoundMethodMap(MapEntryKeyFactory<K> entryKeyFactory,
                      AbstractBoundMethodCollectionFactory methodCollectionFactory,
                      java.lang.invoke.MethodHandles.Lookup lookup)
               throws DuplicateKeyException,
                      java.lang.IllegalAccessException,
                      MethodCollectionProductionException,
                      MapEntryKeyProductionException

Parameters:

entryKeyFactory - the factory used to generate keys for each of the methods produced by methodCollectionFactory

methodCollectionFactory - Produces the collection of methods that will be included in this methodmap. The target object is also contained in this factory.

lookup - the lookup object used to convert the produced methods into methodhandles

Throws:

DuplicateKeyException - If more than one of the same key is generated for the entries of the methodmap.

java.lang.IllegalAccessException - If methodhandle lookup fails for any of the produced methods.

MethodCollectionProductionException - If the methodcollectionfactory fails to produce a method collection.

MapEntryKeyProductionException - If entry keys fail to be generated for any of the produced methods.

Method Detail

invoke

public java.lang.Object invoke(K key,
                               java.lang.Object... args)
                        throws UnmappedKeyException,
                               InvocationException

Description copied from class: AbstractMethodMap

Invokes the methodhandle contained in the methodhandleinfo mapped to the provided key with the given arguments.

Specified by:

invoke in class AbstractMethodMap<K>

Parameters:

key - the key to which the desired methodhandleinfo is mapped

args - the arguments to be passed to the methodhandle

Returns:

the result of executing the methodhandle with the provided arguments

Throws:

UnmappedKeyException - If there is no methodhandleinfo associated with the provided key.

InvocationException - If invocation fails.

invoke

public java.lang.Object invoke(K key,
                               ArgsFactory argsFactory)
                        throws UnmappedKeyException,
                               ArgsProductionException,
                               InvocationException

Description copied from class: AbstractMethodMap

Invokes the methodhandle contained in the methodhandleinfo mapped to the provided key with arguments produced by the given argsfactory.

Specified by:

invoke in class AbstractMethodMap<K>

Parameters:

key - the key to which the desired methodhandleinfo is mapped

argsFactory - Produces the arguments that are passed to the methodhandle.

Returns:

the result of executing the methodhandle with the produced arguments

Throws:

UnmappedKeyException - If there is no methodhandleinfo associated with the provided key.

ArgsProductionException - If the argsfactory fails to produce arguments.

InvocationException - If invocation fails.

invoke

public java.lang.Object invoke(java.lang.Object... args)
                        throws UnmappedKeyException,
                               InvocationException

Description copied from class: AbstractMethodMap

Treats the first argument as the key, the remaining arguments as the methodhandle arguments, and invokes the methodhandle contained in the methodhandleinfo mapped to the provided key with the given arguments.

Specified by:

invoke in class AbstractMethodMap<K>

Parameters:

args - the key to which the desired methodhandleinfo is mapped and the arguments to be passed to the methodhandle

Returns:

the result of executing the methodhandle with the provided arguments

Throws:

UnmappedKeyException - If there is no methodhandleinfo associated with the provided key.

InvocationException - If invocation fails.