com.helger.commons.callback

Class CallbackList<CALLBACKTYPE extends ICallback>

java.lang.Object

com.helger.commons.callback.CallbackList<CALLBACKTYPE>

Type Parameters:

CALLBACKTYPE - The callback type.

All Implemented Interfaces:

ICallbackList<CALLBACKTYPE>, ICommonsIterable<CALLBACKTYPE>, ICloneable<CallbackList<CALLBACKTYPE>>, Serializable, Iterable<CALLBACKTYPE>

@ThreadSafe
public class CallbackList<CALLBACKTYPE extends ICallback>
extends Object
implements ICallbackList<CALLBACKTYPE>, ICloneable<CallbackList<CALLBACKTYPE>>

This class manages a list of callbacks.

Author:

Philip Helger

See Also:

Serialized Form

Constructor Summary

Constructors

Constructor and Description
CallbackList()
CallbackList(CallbackList<CALLBACKTYPE> aOther)

Method Summary

Modifier and Type	Method and Description
CallbackList<CALLBACKTYPE>	addCallback(CALLBACKTYPE aCallback) Add a callback.
void	forEach(Consumer<? super CALLBACKTYPE> aConsumer) Invoke all registered callbacks in a safe manner.
EContinue	forEachBreakable(Function<? super CALLBACKTYPE,EContinue> aFunction) A special version of Iterable.forEach(Consumer) that can break iteration if a certain requirement is fulfilled.
ICommonsList<CALLBACKTYPE>	getAllCallbacks()
CALLBACKTYPE	getCallbackAtIndex(int nIndex) Get the callback at the specified index.
int	getCallbackCount()
CallbackList<CALLBACKTYPE>	getClone()
boolean	hasCallbacks()
Iterator<CALLBACKTYPE>	iterator()
EChange	removeAllCallbacks() Remove all callbacks
EChange	removeCallback(CALLBACKTYPE aCallback) Remove the specified callback
String	toString()

Methods inherited from class java.lang.Object

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

Methods inherited from interface com.helger.commons.collection.ext.ICommonsIterable

containsAny, containsNone, containsOnly, findAll, findAllInstanceOf, findAllMapped, findAllMapped, findAllMapped, findFirst, findFirst, findFirstMapped, findFirstMapped, forEach, forEach, getIteratorCount, getIteratorCount

Methods inherited from interface java.lang.Iterable

spliterator

Constructor Detail

CallbackList

public CallbackList()

CallbackList

public CallbackList(@Nonnull
                    CallbackList<CALLBACKTYPE> aOther)

Method Detail

addCallback

@Nonnull
public CallbackList<CALLBACKTYPE> addCallback(@Nonnull
                                                        CALLBACKTYPE aCallback)

Add a callback.

Parameters:

aCallback - May not be null.

Returns:

this

removeCallback

@Nonnull
public EChange removeCallback(@Nullable
                                        CALLBACKTYPE aCallback)

Remove the specified callback

Parameters:

aCallback - May be null.

Returns:

EChange

removeAllCallbacks

@Nonnull
public EChange removeAllCallbacks()

Remove all callbacks

Returns:

EChange

getAllCallbacks

@Nonnull
 @ReturnsMutableCopy
public ICommonsList<CALLBACKTYPE> getAllCallbacks()

Specified by:

getAllCallbacks in interface ICallbackList<CALLBACKTYPE extends ICallback>

Returns:

A list of all callbacks. Never null and only containing non-null elements.

getCallbackAtIndex

@Nullable
public CALLBACKTYPE getCallbackAtIndex(@Nonnegative
                                                  int nIndex)

Description copied from interface: ICallbackList

Get the callback at the specified index.

Specified by:

getCallbackAtIndex in interface ICallbackList<CALLBACKTYPE extends ICallback>

Parameters:

nIndex - The index to be retrieved. Should be ≥ 0.

Returns:

null if the provided index is invalid.

getCallbackCount

@Nonnegative
public int getCallbackCount()

Specified by:

getCallbackCount in interface ICallbackList<CALLBACKTYPE extends ICallback>

Returns:

The number of contained callbacks. Always ≥ 0.

hasCallbacks

public boolean hasCallbacks()

Specified by:

hasCallbacks in interface ICallbackList<CALLBACKTYPE extends ICallback>

Returns:

true if at least a single callback is present, false otherwise.

getClone

@Nonnull
public CallbackList<CALLBACKTYPE> getClone()

Specified by:

getClone in interface ICloneable<CallbackList<CALLBACKTYPE extends ICallback>>

Returns:

A 100% deep-copy of the implementing class.

iterator

@Nonnull
public Iterator<CALLBACKTYPE> iterator()

Specified by:

iterator in interface Iterable<CALLBACKTYPE extends ICallback>

forEach

public void forEach(@Nonnull
                    Consumer<? super CALLBACKTYPE> aConsumer)

Description copied from interface: ICallbackList

Invoke all registered callbacks in a safe manner.

Specified by:

forEach in interface ICallbackList<CALLBACKTYPE extends ICallback>

Specified by:

forEach in interface Iterable<CALLBACKTYPE extends ICallback>

Parameters:

aConsumer - The action to be performed with the respective callback. This method cannot return a value. May not be null.

forEachBreakable

@Nonnull
public EContinue forEachBreakable(@Nonnull
                                            Function<? super CALLBACKTYPE,EContinue> aFunction)

Description copied from interface: ICommonsIterable

A special version of Iterable.forEach(Consumer) that can break iteration if a certain requirement is fulfilled.

Specified by:

forEachBreakable in interface ICommonsIterable<CALLBACKTYPE extends ICallback>

Parameters:

aFunction - The consumer to be invoked. May not be null.

Returns:

EContinue.BREAK if iteration was stopped, EContinue.CONTINUE otherwise.

toString

public String toString()

Overrides:

toString in class Object