io.magus.methodmap.domain

Class MethodMapDomain<K,V>

java.lang.Object

java.util.AbstractMap<K,V>

java.util.HashMap<K,AbstractMethodMap<V>>

io.magus.methodmap.domain.MethodMapDomain<K,V>

Type Parameters:

K - Type of the keys contained by the MethodMapDomain

V - Type of the keys contained by all contained methodmaps

All Implemented Interfaces:

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

public class MethodMapDomain<K,V>
extends java.util.HashMap<K,AbstractMethodMap<V>>

Instances of this class can contain subclasses of AbstractMethodMap. The purpose of this class is to abstract away the process of invoking underlying instances of AutoInstantiatingMethodMap and other AbstractMethodMap implementations via a common interface.

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
MethodMapDomain()

Method Summary

Modifier and Type	Method and Description
AbstractMethodMap<V>	getMethodMap(K domain) Retrieves the methodmap mapped to the provided domain.
java.lang.Object	invoke(K domain, V key, ArgsFactory argsFactory) Convenience method for calling invoke(Object, Object, null, null, ArgsFactory)
java.lang.Object	invoke(K domain, V key, java.lang.Class<?>[] constructorParameterTypes, java.lang.Object[] constructorArgs, ArgsFactory argsFactory) Retrieves the methodmap mapped to the provided domain and calls invoke with the given argsfactory.
java.lang.Object	invoke(K domain, V key, java.lang.Class<?>[] constructorParameterTypes, java.lang.Object[] constructorArgs, java.lang.Object... args) Retrieves the methodmap mapped to the provided domain and calls invoke with the given arguments.
java.lang.Object	invoke(K domain, V key, java.lang.Object... args) Convenience method for calling invoke(Object, Object, null, null, Object...)
java.lang.Object	invoke(java.lang.Object... args) Treats the first argument as the domain, the second argument as the key, and the remaining arguments as the methodhandle arguments and calls invoke(Object, Object, Object...).

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

MethodMapDomain

public MethodMapDomain()

Method Detail

getMethodMap

public AbstractMethodMap<V> getMethodMap(K domain)
                                  throws UnmappedDomainException

Retrieves the methodmap mapped to the provided domain.

Parameters:

domain - the domain to which the desired methodmap is mapped

Returns:

the methodmap mapped to the provided domain

Throws:

UnmappedDomainException - If there is no methodmap mapped to the provided domain.

invoke

public java.lang.Object invoke(K domain,
                               V key,
                               java.lang.Class<?>[] constructorParameterTypes,
                               java.lang.Object[] constructorArgs,
                               java.lang.Object... args)
                        throws UnmappedDomainException,
                               java.lang.NoSuchMethodException,
                               java.lang.SecurityException,
                               java.lang.InstantiationException,
                               java.lang.IllegalAccessException,
                               java.lang.IllegalArgumentException,
                               java.lang.reflect.InvocationTargetException,
                               UnmappedKeyException,
                               InvocationException

Retrieves the methodmap mapped to the provided domain and calls invoke with the given arguments.

If the methodmap is an instance of AutoInstantiatingMethodMap then AutoInstantiatingMethodMap.invoke(Object, Class[], Object[], Object...) is invoked with key, constructorParameterTypes, constructorArgs, and args.

Otherwise AbstractMethodMap.invoke(Object, Object...) is invoked with key and args.

Parameters:

domain - the domain to which the desired methodmap is mapped

key - the key to which the desired methodhandleinfo is mapped

constructorParameterTypes - the parameter types of the desired constructor to use if the methodmap is an instance of AutoInstantiatingMethodMap

constructorArgs - the arguments to be passed to the desired constructor if the methodmap is an instance of AutoInstantiatingMethodMap

args - the arguments to be passed to the methodhandle

Returns:

the result of invoking the methodmap with the provided arguments

Throws:

UnmappedDomainException - If there is no methodmap mapped to the provided domain.

java.lang.NoSuchMethodException - See the documentation for AutoInstantiatingMethodMap.invoke(Object, Class[], Object[], Object...)

java.lang.SecurityException - See the documentation for AutoInstantiatingMethodMap.invoke(Object, Class[], Object[], Object...)

java.lang.InstantiationException - See the documentation for AutoInstantiatingMethodMap.invoke(Object, Class[], Object[], Object...)

java.lang.IllegalAccessException - See the documentation for AutoInstantiatingMethodMap.invoke(Object, Class[], Object[], Object...)

java.lang.IllegalArgumentException - See the documentation for AutoInstantiatingMethodMap.invoke(Object, Class[], Object[], Object...)

java.lang.reflect.InvocationTargetException - See the documentation for AutoInstantiatingMethodMap.invoke(Object, Class[], Object[], Object...)

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

InvocationException - If methodhandle invocation fails.

invoke

public java.lang.Object invoke(K domain,
                               V key,
                               java.lang.Class<?>[] constructorParameterTypes,
                               java.lang.Object[] constructorArgs,
                               ArgsFactory argsFactory)
                        throws UnmappedDomainException,
                               java.lang.NoSuchMethodException,
                               java.lang.SecurityException,
                               java.lang.InstantiationException,
                               java.lang.IllegalAccessException,
                               java.lang.IllegalArgumentException,
                               java.lang.reflect.InvocationTargetException,
                               ArgsProductionException,
                               UnmappedKeyException,
                               InvocationException

Retrieves the methodmap mapped to the provided domain and calls invoke with the given argsfactory.

If the methodmap is an instance of AutoInstantiatingMethodMap then AutoInstantiatingMethodMap.invoke(Object, Class[], Object[], ArgsFactory) is invoked with key, constructorParameterTypes, constructorArgs, and argsFactory.

Otherwise AbstractMethodMap.invoke(Object, ArgsFactory) is invoked with key and argsFactory.

Parameters:

domain - the domain to which the desired methodmap is mapped

key - the key to which the desired methodhandleinfo is mapped

constructorParameterTypes - the parameter types of the desired constructor to use if the methodmap is an instance of AutoInstantiatingMethodMap

constructorArgs - the arguments to be passed to the desired constructor if the methodmap is an instance of AutoInstantiatingMethodMap

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

Returns:

the result of invoking the methodhandle with the arguments produced by the provided argsfactory

Throws:

UnmappedDomainException - If there is no methodmap mapped to the provided domain.

java.lang.NoSuchMethodException - See the documentation for AutoInstantiatingMethodMap.invoke(Object, Class[], Object[], ArgsFactory)

java.lang.SecurityException - See the documentation for AutoInstantiatingMethodMap.invoke(Object, Class[], Object[], ArgsFactory)

java.lang.InstantiationException - See the documentation for AutoInstantiatingMethodMap.invoke(Object, Class[], Object[], ArgsFactory)

java.lang.IllegalAccessException - See the documentation for AutoInstantiatingMethodMap.invoke(Object, Class[], Object[], ArgsFactory)

java.lang.IllegalArgumentException - See the documentation for AutoInstantiatingMethodMap.invoke(Object, Class[], Object[], ArgsFactory)

java.lang.reflect.InvocationTargetException - See the documentation for AutoInstantiatingMethodMap.invoke(Object, Class[], Object[], ArgsFactory)

ArgsProductionException - If the argsfactory fails to produce arguments.

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

InvocationException - If methodhandle invocation fails.

invoke

public java.lang.Object invoke(K domain,
                               V key,
                               java.lang.Object... args)
                        throws java.lang.NoSuchMethodException,
                               java.lang.SecurityException,
                               java.lang.InstantiationException,
                               java.lang.IllegalAccessException,
                               java.lang.IllegalArgumentException,
                               java.lang.reflect.InvocationTargetException,
                               UnmappedDomainException,
                               UnmappedKeyException,
                               InvocationException

Convenience method for calling invoke(Object, Object, null, null, Object...)

Parameters:

domain - the domain to which the desired methodmap is mapped

key - the key to which the desired methodhandleinfo is mapped

args - the arguments to be passed to the methodhandle

Returns:

the result of invoking the methodhandle with the provided arguments

Throws:

java.lang.NoSuchMethodException - See the documentation for AutoInstantiatingMethodMap.invoke(Object, Class[], Object[], Object...)

java.lang.SecurityException - See the documentation for AutoInstantiatingMethodMap.invoke(Object, Class[], Object[], Object...)

java.lang.InstantiationException - See the documentation for AutoInstantiatingMethodMap.invoke(Object, Class[], Object[], Object...)

java.lang.IllegalAccessException - See the documentation for AutoInstantiatingMethodMap.invoke(Object, Class[], Object[], Object...)

java.lang.IllegalArgumentException - See the documentation for AutoInstantiatingMethodMap.invoke(Object, Class[], Object[], Object...)

java.lang.reflect.InvocationTargetException - See the documentation for AutoInstantiatingMethodMap.invoke(Object, Class[], Object[], Object...)

UnmappedDomainException - If there is no methodmap mapped to the provided domain.

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

InvocationException - If methodhandle invocation fails.

invoke

public java.lang.Object invoke(K domain,
                               V key,
                               ArgsFactory argsFactory)
                        throws java.lang.NoSuchMethodException,
                               java.lang.SecurityException,
                               java.lang.InstantiationException,
                               java.lang.IllegalAccessException,
                               java.lang.IllegalArgumentException,
                               java.lang.reflect.InvocationTargetException,
                               UnmappedDomainException,
                               ArgsProductionException,
                               UnmappedKeyException,
                               InvocationException

Convenience method for calling invoke(Object, Object, null, null, ArgsFactory)

Parameters:

domain - the domain to which the desired methodmap is mapped

key - the key to which the desired methodhandleinfo is mapped

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

Returns:

the result of invoking the methodhandle with the provided argsfactory

Throws:

java.lang.NoSuchMethodException - See the documentation for AutoInstantiatingMethodMap.invoke(Object, Class[], Object[], ArgsFactory)

java.lang.SecurityException - See the documentation for AutoInstantiatingMethodMap.invoke(Object, Class[], Object[], ArgsFactory)

java.lang.InstantiationException - See the documentation for AutoInstantiatingMethodMap.invoke(Object, Class[], Object[], ArgsFactory)

java.lang.IllegalAccessException - See the documentation for AutoInstantiatingMethodMap.invoke(Object, Class[], Object[], ArgsFactory)

java.lang.IllegalArgumentException - See the documentation for AutoInstantiatingMethodMap.invoke(Object, Class[], Object[], ArgsFactory)

java.lang.reflect.InvocationTargetException - See the documentation for AutoInstantiatingMethodMap.invoke(Object, Class[], Object[], ArgsFactory)

UnmappedDomainException - If there is no methodmap mapped to the provided domain.

ArgsProductionException - If the argsfactory fails to produce arguments.

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

InvocationException - If methodhandle invocation fails.

invoke

public java.lang.Object invoke(java.lang.Object... args)
                        throws java.lang.NoSuchMethodException,
                               java.lang.SecurityException,
                               java.lang.InstantiationException,
                               java.lang.IllegalAccessException,
                               java.lang.IllegalArgumentException,
                               java.lang.reflect.InvocationTargetException,
                               UnmappedDomainException,
                               UnmappedKeyException,
                               InvocationException

Treats the first argument as the domain, the second argument as the key, and the remaining arguments as the methodhandle arguments and calls invoke(Object, Object, Object...).

Parameters:

args - the arguments to be passed to the methodhandle

Returns:

the result of invoking the methodhandle with the provided arguments

Throws:

java.lang.NoSuchMethodException - See the documentation for AutoInstantiatingMethodMap.invoke(Object, Class[], Object[], Object...)

java.lang.SecurityException - See the documentation for AutoInstantiatingMethodMap.invoke(Object, Class[], Object[], Object...)

java.lang.InstantiationException - See the documentation for AutoInstantiatingMethodMap.invoke(Object, Class[], Object[], Object...)

java.lang.IllegalAccessException - See the documentation for AutoInstantiatingMethodMap.invoke(Object, Class[], Object[], Object...)

java.lang.IllegalArgumentException - See the documentation for AutoInstantiatingMethodMap.invoke(Object, Class[], Object[], Object...)

java.lang.reflect.InvocationTargetException - See the documentation for AutoInstantiatingMethodMap.invoke(Object, Class[], Object[], Object...)

UnmappedDomainException - If there is no methodmap mapped to the provided domain.

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

InvocationException - If methodhandle invocation fails.