Package org.springframework.context.event

Interface ApplicationEventMulticaster

All Known Implementing Classes:

AbstractApplicationEventMulticaster, SimpleApplicationEventMulticaster

public interface ApplicationEventMulticaster

Interface to be implemented by objects that can manage a number of ApplicationListener objects and publish events to them.

An ApplicationEventPublisher, typically a Spring ApplicationContext, can use an ApplicationEventMulticaster as a delegate for actually publishing events.

Author:

Rod Johnson, Juergen Hoeller, Stephane Nicoll

See Also:

• ApplicationListener

Method Summary

Modifier and Type	Method	Description
void	addApplicationListener(ApplicationListener<?> listener)	Add a listener to be notified of all events.
void	addApplicationListenerBean(String listenerBeanName)	Add a listener bean to be notified of all events.
void	multicastEvent(ApplicationEvent event)	Multicast the given application event to appropriate listeners.
void	multicastEvent(ApplicationEvent event, ResolvableType eventType)	Multicast the given application event to appropriate listeners.
void	removeAllListeners()	Remove all listeners registered with this multicaster.
void	removeApplicationListener(ApplicationListener<?> listener)	Remove a listener from the notification list.
void	removeApplicationListenerBean(String listenerBeanName)	Remove a listener bean from the notification list.
void	removeApplicationListenerBeans(Predicate<String> predicate)	Remove all matching listener beans from the set of registered listener bean names (referring to bean classes which in turn implement the ApplicationListener interface directly).
void	removeApplicationListeners(Predicate<ApplicationListener<?>> predicate)	Remove all matching listeners from the set of registered ApplicationListener instances (which includes adapter classes such as ApplicationListenerMethodAdapter, for example, for annotated EventListener methods).

Method Details

addApplicationListener

void addApplicationListener(ApplicationListener<?> listener)

Add a listener to be notified of all events.

Parameters:

listener - the listener to add

See Also:

• removeApplicationListener(ApplicationListener)
• removeApplicationListeners(Predicate)

addApplicationListenerBean

void addApplicationListenerBean(String listenerBeanName)

Add a listener bean to be notified of all events.

Parameters:

listenerBeanName - the name of the listener bean to add

See Also:

• removeApplicationListenerBean(String)
• removeApplicationListenerBeans(Predicate)

removeApplicationListener

void removeApplicationListener(ApplicationListener<?> listener)

Remove a listener from the notification list.

Parameters:

listener - the listener to remove

See Also:

• addApplicationListener(ApplicationListener)
• removeApplicationListeners(Predicate)

removeApplicationListenerBean

void removeApplicationListenerBean(String listenerBeanName)

Remove a listener bean from the notification list.

Parameters:

listenerBeanName - the name of the listener bean to remove

See Also:

• addApplicationListenerBean(String)
• removeApplicationListenerBeans(Predicate)

removeApplicationListeners

void removeApplicationListeners(Predicate<ApplicationListener<?>> predicate)

Remove all matching listeners from the set of registered ApplicationListener instances (which includes adapter classes such as ApplicationListenerMethodAdapter, for example, for annotated EventListener methods).

Note: This just applies to instance registrations, not to listeners registered by bean name.

Parameters:

predicate - the predicate to identify listener instances to remove, for example, checking SmartApplicationListener.getListenerId()

Since:

5.3.5

See Also:

• addApplicationListener(ApplicationListener)
• removeApplicationListener(ApplicationListener)

removeApplicationListenerBeans

void removeApplicationListenerBeans(Predicate<String> predicate)

Remove all matching listener beans from the set of registered listener bean names (referring to bean classes which in turn implement the ApplicationListener interface directly).

Note: This just applies to bean name registrations, not to programmatically registered ApplicationListener instances.

Parameters:

predicate - the predicate to identify listener bean names to remove

Since:

5.3.5

See Also:

• addApplicationListenerBean(String)
• removeApplicationListenerBean(String)

removeAllListeners

void removeAllListeners()

Remove all listeners registered with this multicaster.

After a remove call, the multicaster will perform no action on event notification until new listeners are registered.

See Also:

• removeApplicationListeners(Predicate)

multicastEvent

void multicastEvent(ApplicationEvent event)

Multicast the given application event to appropriate listeners.

Consider using multicastEvent(ApplicationEvent, ResolvableType) if possible as it provides better support for generics-based events.

If a matching ApplicationListener does not support asynchronous execution, it must be run within the calling thread of this multicast call.

Parameters:

event - the event to multicast

See Also:

• ApplicationListener.supportsAsyncExecution()

multicastEvent

void multicastEvent(ApplicationEvent event,
 @Nullable
 ResolvableType eventType)

Multicast the given application event to appropriate listeners.

If the eventType is null, a default type is built based on the event instance.

If a matching ApplicationListener does not support asynchronous execution, it must be run within the calling thread of this multicast call.

Parameters:

event - the event to multicast

eventType - the type of event (can be null)

Since:

4.2

See Also:

• ApplicationListener.supportsAsyncExecution()