at.chrl.callbacks

Interface EnhancedObject

public interface EnhancedObject

Generic interface for all enhanced object.
NEVER IMPLEMENT THIS CLASS MANUALLY!!!

Thread safety, concurrency, deadlocks:
It's allowed to remove/add listeners from listeners.
Listeners are stored in the CopyOnWriteArrayList , so their behavior is similar.
Briefly speaking, if you will try to remove/add a listener from another listener - the current invocation won't be affected, current implementation allocates all listeners that are going to be invoked before execution.

Callback.beforeCall(Object, Object[]) and Callback.afterCall(Object, Object[], Object) are treated as separate invocations, so adding/removing listener in beforeCall will affect afterCall.

Author:

SoulKeeper

Method Summary

Modifier and Type	Method and Description
void	addCallback(Callback callback) Adds callback to this object.
ReentrantReadWriteLock	getCallbackLock() Returns lock that is used to ensure thread safety
Map<Class<? extends Callback>,List<Callback>>	getCallbacks() Returns all callbacks associated with this.
void	removeCallback(Callback callback) Removes callback from this object.
void	setCallbacks(Map<Class<? extends Callback>,List<Callback>> callbacks) Associates callback map with this object.

Method Detail

addCallback

void addCallback(Callback callback)

Adds callback to this object.
concurrency description

Parameters:

callback - instance of callback to add

See Also:

ObjectCallbackHelper.addCallback(Callback, EnhancedObject)

removeCallback

void removeCallback(Callback callback)

Removes callback from this object.
concurrency description

Parameters:

callback - instance of callback to remove

See Also:

ObjectCallbackHelper.removeCallback(Callback, EnhancedObject)

getCallbacks

Map<Class<? extends Callback>,List<Callback>> getCallbacks()

Returns all callbacks associated with this.

Iteration over this map is not thread-safe, please make sure that getCallbackLock() is locked in read mode to read.

Same for writing. If you are going to write something here - please make sure that getCallbackLock() is in write mode

Returns:

map with callbacks associated with this object or null if there is no callbacks

setCallbacks

void setCallbacks(Map<Class<? extends Callback>,List<Callback>> callbacks)

Associates callback map with this object.

Please make sure that getCallbackLock() is in write-mode lock when calling this method

Parameters:

callbacks - callbackMap or null

getCallbackLock

ReentrantReadWriteLock getCallbackLock()

Returns lock that is used to ensure thread safety

Returns:

lock that is used to ensure thread safety