|
|
@ -27,6 +27,7 @@ package org.springframework.context; |
|
|
|
* @see ApplicationContext |
|
|
|
* @see ApplicationContext |
|
|
|
* @see ApplicationEventPublisherAware |
|
|
|
* @see ApplicationEventPublisherAware |
|
|
|
* @see org.springframework.context.ApplicationEvent |
|
|
|
* @see org.springframework.context.ApplicationEvent |
|
|
|
|
|
|
|
* @see org.springframework.context.event.ApplicationEventMulticaster |
|
|
|
* @see org.springframework.context.event.EventPublicationInterceptor |
|
|
|
* @see org.springframework.context.event.EventPublicationInterceptor |
|
|
|
*/ |
|
|
|
*/ |
|
|
|
@FunctionalInterface |
|
|
|
@FunctionalInterface |
|
|
@ -35,9 +36,16 @@ public interface ApplicationEventPublisher { |
|
|
|
/** |
|
|
|
/** |
|
|
|
* Notify all <strong>matching</strong> listeners registered with this |
|
|
|
* Notify all <strong>matching</strong> listeners registered with this |
|
|
|
* application of an application event. Events may be framework events |
|
|
|
* application of an application event. Events may be framework events |
|
|
|
* (such as RequestHandledEvent) or application-specific events. |
|
|
|
* (such as ContextRefreshedEvent) or application-specific events. |
|
|
|
|
|
|
|
* <p>Such an event publication step is effectively a hand-off to the |
|
|
|
|
|
|
|
* multicaster and does not imply synchronous/asynchronous execution |
|
|
|
|
|
|
|
* or even immediate execution at all. Event listeners are encouraged |
|
|
|
|
|
|
|
* to be as efficient as possible, individually using asynchronous |
|
|
|
|
|
|
|
* execution for longer-running and potentially blocking operations. |
|
|
|
* @param event the event to publish |
|
|
|
* @param event the event to publish |
|
|
|
* @see org.springframework.web.context.support.RequestHandledEvent |
|
|
|
* @see #publishEvent(Object) |
|
|
|
|
|
|
|
* @see org.springframework.context.event.ContextRefreshedEvent |
|
|
|
|
|
|
|
* @see org.springframework.context.event.ContextClosedEvent |
|
|
|
*/ |
|
|
|
*/ |
|
|
|
default void publishEvent(ApplicationEvent event) { |
|
|
|
default void publishEvent(ApplicationEvent event) { |
|
|
|
publishEvent((Object) event); |
|
|
|
publishEvent((Object) event); |
|
|
@ -48,8 +56,14 @@ public interface ApplicationEventPublisher { |
|
|
|
* application of an event. |
|
|
|
* application of an event. |
|
|
|
* <p>If the specified {@code event} is not an {@link ApplicationEvent}, |
|
|
|
* <p>If the specified {@code event} is not an {@link ApplicationEvent}, |
|
|
|
* it is wrapped in a {@link PayloadApplicationEvent}. |
|
|
|
* it is wrapped in a {@link PayloadApplicationEvent}. |
|
|
|
|
|
|
|
* <p>Such an event publication step is effectively a hand-off to the |
|
|
|
|
|
|
|
* multicaster and does not imply synchronous/asynchronous execution |
|
|
|
|
|
|
|
* or even immediate execution at all. Event listeners are encouraged |
|
|
|
|
|
|
|
* to be as efficient as possible, individually using asynchronous |
|
|
|
|
|
|
|
* execution for longer-running and potentially blocking operations. |
|
|
|
* @param event the event to publish |
|
|
|
* @param event the event to publish |
|
|
|
* @since 4.2 |
|
|
|
* @since 4.2 |
|
|
|
|
|
|
|
* @see #publishEvent(ApplicationEvent) |
|
|
|
* @see PayloadApplicationEvent |
|
|
|
* @see PayloadApplicationEvent |
|
|
|
*/ |
|
|
|
*/ |
|
|
|
void publishEvent(Object event); |
|
|
|
void publishEvent(Object event); |
|
|
|