类 AbstractApplicationEventMulticaster
- java.lang.Object
- org.springframework.context.event.AbstractApplicationEventMulticaster
public abstract class AbstractApplicationEventMulticaster extends Object implements ApplicationEventMulticaster, BeanClassLoaderAware, BeanFactoryAware
Abstract implementation of theApplicationEventMulticasterinterface, providing the basic listener registration facility.Doesn't permit multiple instances of the same listener by default, as it keeps listeners in a linked Set. The collection class used to hold ApplicationListener objects can be overridden through the "collectionClass" bean property.
Implementing ApplicationEventMulticaster's actual
ApplicationEventMulticaster.multicastEvent(org.springframework.context.ApplicationEvent)method is left to subclasses.SimpleApplicationEventMulticastersimply multicasts all events to all registered listeners, invoking them in the calling thread. Alternative implementations could be more sophisticated in those respects.- 从以下版本开始:
- 1.2.3
- 作者:
- Juergen Hoeller, Stephane Nicoll
- 另请参阅:
getApplicationListeners(ApplicationEvent, ResolvableType),SimpleApplicationEventMulticaster
构造器概要
构造器 构造器 说明 AbstractApplicationEventMulticaster()
方法概要
所有方法 实例方法 具体方法 修饰符和类型 方法 说明 voidaddApplicationListener(ApplicationListener<?> listener)Add a listener to be notified of all events.voidaddApplicationListenerBean(String listenerBeanName)Add a listener bean to be notified of all events.protected Collection<ApplicationListener<?>>getApplicationListeners()Return a Collection containing all ApplicationListeners.protected Collection<ApplicationListener<?>>getApplicationListeners(ApplicationEvent event, ResolvableType eventType)Return a Collection of ApplicationListeners matching the given event type.voidremoveAllListeners()Remove all listeners registered with this multicaster.voidremoveApplicationListener(ApplicationListener<?> listener)Remove a listener from the notification list.voidremoveApplicationListenerBean(String listenerBeanName)Remove a listener bean from the notification list.voidsetBeanClassLoader(ClassLoader classLoader)Callback that supplies the beanclass loaderto a bean instance.voidsetBeanFactory(BeanFactory beanFactory)Callback that supplies the owning factory to a bean instance.protected booleansupportsEvent(Class<?> listenerType, ResolvableType eventType)Filter a listener early through checking its generically declared event type before trying to instantiate it.protected booleansupportsEvent(ApplicationListener<?> listener, ResolvableType eventType, Class<?> sourceType)Determine whether the given listener supports the given event.从类继承的方法 java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
从接口继承的方法 org.springframework.context.event.ApplicationEventMulticaster
multicastEvent, multicastEvent
构造器详细资料
AbstractApplicationEventMulticaster
public AbstractApplicationEventMulticaster()
方法详细资料
setBeanClassLoader
public void setBeanClassLoader(ClassLoader classLoader)
从接口复制的说明:BeanClassLoaderAwareCallback that supplies the beanclass loaderto a bean instance.Invoked after the population of normal bean properties but before an initialization callback such as
InitializingBean'sInitializingBean.afterPropertiesSet()method or a custom init-method.- 指定者:
setBeanClassLoader在接口中BeanClassLoaderAware- 参数:
classLoader- the owning class loader; may benullin which case a defaultClassLoadermust be used, for example theClassLoaderobtained viaClassUtils.getDefaultClassLoader()
setBeanFactory
public void setBeanFactory(BeanFactory beanFactory)
从接口复制的说明:BeanFactoryAwareCallback that supplies the owning factory to a bean instance.Invoked after the population of normal bean properties but before an initialization callback such as
InitializingBean.afterPropertiesSet()or a custom init-method.- 指定者:
setBeanFactory在接口中BeanFactoryAware- 参数:
beanFactory- owning BeanFactory (nevernull). The bean can immediately call methods on the factory.- 另请参阅:
BeanInitializationException
addApplicationListener
public void addApplicationListener(ApplicationListener<?> listener)
从接口复制的说明:ApplicationEventMulticasterAdd a listener to be notified of all events.- 指定者:
addApplicationListener在接口中ApplicationEventMulticaster- 参数:
listener- the listener to add
addApplicationListenerBean
public void addApplicationListenerBean(String listenerBeanName)
从接口复制的说明:ApplicationEventMulticasterAdd a listener bean to be notified of all events.- 指定者:
addApplicationListenerBean在接口中ApplicationEventMulticaster- 参数:
listenerBeanName- the name of the listener bean to add
removeApplicationListener
public void removeApplicationListener(ApplicationListener<?> listener)
从接口复制的说明:ApplicationEventMulticasterRemove a listener from the notification list.- 指定者:
removeApplicationListener在接口中ApplicationEventMulticaster- 参数:
listener- the listener to remove
removeApplicationListenerBean
public void removeApplicationListenerBean(String listenerBeanName)
从接口复制的说明:ApplicationEventMulticasterRemove a listener bean from the notification list.- 指定者:
removeApplicationListenerBean在接口中ApplicationEventMulticaster- 参数:
listenerBeanName- the name of the listener bean to add
removeAllListeners
public void removeAllListeners()
从接口复制的说明:ApplicationEventMulticasterRemove all listeners registered with this multicaster.After a remove call, the multicaster will perform no action on event notification until new listeners are being registered.
getApplicationListeners
protected Collection<ApplicationListener<?>> getApplicationListeners()
Return a Collection containing all ApplicationListeners.- 返回:
- a Collection of ApplicationListeners
- 另请参阅:
ApplicationListener
getApplicationListeners
protected Collection<ApplicationListener<?>> getApplicationListeners(ApplicationEvent event, ResolvableType eventType)
Return a Collection of ApplicationListeners matching the given event type. Non-matching listeners get excluded early.- 参数:
event- the event to be propagated. Allows for excluding non-matching listeners early, based on cached matching information.eventType- the event type- 返回:
- a Collection of ApplicationListeners
- 另请参阅:
ApplicationListener
supportsEvent
protected boolean supportsEvent(Class<?> listenerType, ResolvableType eventType)
Filter a listener early through checking its generically declared event type before trying to instantiate it.If this method returns
truefor a given listener as a first pass, the listener instance will get retrieved and fully evaluated through asupportsEvent(ApplicationListener, ResolvableType, Class)call afterwards.- 参数:
listenerType- the listener's type as determined by the BeanFactoryeventType- the event type to check- 返回:
- whether the given listener should be included in the candidates for the given event type
supportsEvent
protected boolean supportsEvent(ApplicationListener<?> listener, ResolvableType eventType, Class<?> sourceType)
Determine whether the given listener supports the given event.The default implementation detects the
SmartApplicationListenerandGenericApplicationListenerinterfaces. In case of a standardApplicationListener, aGenericApplicationListenerAdapterwill be used to introspect the generically declared type of the target listener.- 参数:
listener- the target listener to checkeventType- the event type to check againstsourceType- the source type to check against- 返回:
- whether the given listener should be included in the candidates for the given event type