com.datagis.com4j

Class GenericNativeWindow.EventInvocationCache

java.lang.Object

java.util.AbstractMap<K,V>

java.util.HashMap<String,GenericNativeWindow.EventInvocationItem>

com.datagis.com4j.GenericNativeWindow.EventInvocationCache

All Implemented Interfaces:

Serializable, Cloneable, Map<String,GenericNativeWindow.EventInvocationItem>

Enclosing class:

GenericNativeWindow<T extends com4j.Com4jObject,E extends ComEventListener>

protected class GenericNativeWindow.EventInvocationCache
extends HashMap<String,GenericNativeWindow.EventInvocationItem>

This HashMap derived class provides a fast mapping mechanism between the name of an event method invoked on the native event interface and the corresponding method to be invoked on a registered NativeWindowListener together with its event id.

Since:

TEJ1.0

Author:

Carsten Klein

See Also:

Serialized Form

Nested Class Summary

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

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

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

Map.Entry<K,V>

Field Summary

Fields

Modifier and Type	Field and Description
protected Class<?>	eventListenerClazz The class or interface on which the methods to be invoked are declared.
protected Class<?>[]	eventMethodSignature The signature of the event methods to be invoked as needed by java.lang.Class.getMethod(String, Class ...)

Constructor Summary

Constructors

Constructor and Description
EventInvocationCache() Creates a new EventInvocationCache populated with all events declared in NativeWindowListener.

Method Summary

Modifier and Type	Method and Description
GenericNativeWindow.EventInvocationItem	put(Method method, int eventId) Associates the name of the method specified with the specified method and event id as a EventInvocationItem object in this cache instance.
GenericNativeWindow.EventInvocationItem	put(String methodName, int eventId) Associates the method name specified with this method declared on NativeWindowListener and the specified event id as a EventInvocationItem object in this cache instance.

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

Field Detail

eventListenerClazz

protected final Class<?> eventListenerClazz

The class or interface on which the methods to be invoked are declared. This is used when looking up a method my its name with java.lang.Class.getMethod(String, Class ...) in method EventInvocationItem.add(String, int).

eventMethodSignature

protected final Class<?>[] eventMethodSignature

The signature of the event methods to be invoked as needed by java.lang.Class.getMethod(String, Class ...). All methods declared in NativeWindowListener take a single parameter NativeWindowEvent.

Constructor Detail

EventInvocationCache

public EventInvocationCache()

Creates a new EventInvocationCache populated with all events declared in NativeWindowListener.

Method Detail

put

public GenericNativeWindow.EventInvocationItem put(Method method,
                                                   int eventId)

Associates the name of the method specified with the specified method and event id as a EventInvocationItem object in this cache instance. If the cache previously contained a method with the same name, the old cache entry is replaced. The method specified must be declared on NativeWindowListener or any descendant of it.

Parameters:

method - the method to be used with this cache entry

eventId - the event id to be used with this cache entry

Returns:

the previous cache entry EventInvocationItem value associated with the name of the method , or null if there was no entry for the specified method

Throws:

IllegalArgumentException - if the method specified was not declared on NativeWindowListener or any descendant of it

See Also:

put(String, int), NativeWindowListener

put

public GenericNativeWindow.EventInvocationItem put(String methodName,
                                                   int eventId)

Associates the method name specified with this method declared on NativeWindowListener and the specified event id as a EventInvocationItem object in this cache instance. If the cache previously contained a method with the same name, the old cache entry is replaced.

Parameters:

methodName - the method name to be used with this cache entry

eventId - the event id to be used with this cache entry

Returns:

the previous cache entry EventInvocationItem value associated with the name of the method , or null if there was no entry for the specified method

See Also:

put(Method, int), NativeWindowListener