程序包 cn.taketoday.context.event

接口 ApplicationEventMulticaster

所有已知实现类:

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 Framework ApplicationContext, can use an ApplicationEventMulticaster as a delegate for actually publishing events.

从以下版本开始:

4.0 2021/12/8 15:18

作者:

Rod Johnson, Juergen Hoeller, Stephane Nicoll, Harry Yang

另请参阅:

• ApplicationListener

方法概要

修饰符和类型	方法	说明
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, cn.taketoday.core.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, e.g. for annotated EventListener methods).

方法详细资料

addApplicationListener

void addApplicationListener(ApplicationListener<?> listener)

Add a listener to be notified of all events.

参数:

listener - the listener to add

另请参阅:

• removeApplicationListener(ApplicationListener)
• removeApplicationListeners(Predicate)

addApplicationListenerBean

void addApplicationListenerBean(String listenerBeanName)

Add a listener bean to be notified of all events.

参数:

listenerBeanName - the name of the listener bean to add

另请参阅:

• removeApplicationListenerBean(String)
• removeApplicationListenerBeans(Predicate)

removeApplicationListener

void removeApplicationListener(ApplicationListener<?> listener)

Remove a listener from the notification list.

参数:

listener - the listener to remove

另请参阅:

• addApplicationListener(ApplicationListener)
• removeApplicationListeners(Predicate)

removeApplicationListenerBean

void removeApplicationListenerBean(String listenerBeanName)

Remove a listener bean from the notification list.

参数:

listenerBeanName - the name of the listener bean to remove

另请参阅:

• 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, e.g. for annotated EventListener methods).

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

参数:

predicate - the predicate to identify listener instances to remove, e.g. checking SmartApplicationListener.getListenerId()

另请参阅:

• 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.

参数:

predicate - the predicate to identify listener bean names to remove

另请参阅:

• 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.

另请参阅:

• 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.

参数:

event - the event to multicast

multicastEvent

void multicastEvent(ApplicationEvent event,
 @Nullable
 cn.taketoday.core.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.

参数:

event - the event to multicast

eventType - the type of event (can be null)