org.apache.dubbo.event

Interface Listenable<E extends EventListener<?>>

All Known Subinterfaces:

EventDispatcher

All Known Implementing Classes:

AbstractEventDispatcher, DirectEventDispatcher, ParallelEventDispatcher

public interface Listenable<E extends EventListener<?>>

Dubbo Event Listenable

Since:

2.7.5

See Also:

EventDispatcher

Method Summary

Modifier and Type	Method and Description
void	addEventListener(E listener) Add a Dubbo event listener
default void	addEventListeners(E listener, E... others) Add one or more Dubbo event listeners
default void	addEventListeners(Iterable<E> listeners) Add multiple Dubbo event listeners
static void	assertListener(EventListener<?> listener) Assets the listener is valid or not
List<E>	getAllEventListeners() Get all registered Dubbo event listeners
default void	removeAllEventListeners() Remove all Dubbo event listeners
void	removeEventListener(E listener) Remove a Dubbo event listener
default void	removeEventListeners(Iterable<E> listeners) Remove a Dubbo event listener

Method Detail

addEventListener

void addEventListener(E listener)
               throws NullPointerException,
                      IllegalArgumentException

Add a Dubbo event listener

Parameters:

listener - a Dubbo event listener If current EventListener is existed, return false

Throws:

NullPointerException - if listener argument is null

IllegalArgumentException - if listener argument is not concrete instance

addEventListeners

default void addEventListeners(E listener,
                               E... others)
                        throws NullPointerException,
                               IllegalArgumentException

Add one or more Dubbo event listeners

Parameters:

listener - a Dubbo event listener

others - an optional Dubbo event listeners

Throws:

NullPointerException - if one of arguments is null

IllegalArgumentException - if one of arguments argument is not concrete instance

addEventListeners

default void addEventListeners(Iterable<E> listeners)
                        throws NullPointerException,
                               IllegalArgumentException

Add multiple Dubbo event listeners

Parameters:

listeners - the Dubbo event listeners

Throws:

NullPointerException - if listeners argument is null

IllegalArgumentException - if any element of listeners is not concrete instance

removeEventListener

void removeEventListener(E listener)
                  throws NullPointerException,
                         IllegalArgumentException

Remove a Dubbo event listener

Parameters:

listener - a Dubbo event listener

Throws:

NullPointerException - if listener argument is null

IllegalArgumentException

removeEventListeners

default void removeEventListeners(Iterable<E> listeners)
                           throws NullPointerException,
                                  IllegalArgumentException

Remove a Dubbo event listener

Parameters:

listeners - the Dubbo event listeners

Throws:

NullPointerException - if listener argument is null

IllegalArgumentException - if any element of listeners is not concrete instance

removeAllEventListeners

default void removeAllEventListeners()

Remove all Dubbo event listeners

getAllEventListeners

List<E> getAllEventListeners()

Get all registered Dubbo event listeners

Returns:

non-null read-only ordered Dubbo event listeners

See Also:

EventListener.getPriority()

assertListener

static void assertListener(EventListener<?> listener)
                    throws NullPointerException

Assets the listener is valid or not

Parameters:

listener - the instance of EventListener

Throws:

NullPointerException