Spring Framework Event Handling

From NovaOrdis Knowledge Base
Jump to navigation Jump to search

External

Internal

TO PROCESS

Overview

One of application context's capabilities is to handle events. The events are by default synchronous, which has a few advantages, one of them being the fact that the listener is able to participated in the publisher's transaction context.

Threading Consideration

Spring event handling is single threaded and synchronous in nature. If an event is published, until and unless all receivers get the message, the processes are blocked and the flow will not continue.

Event

Events are instances extending ApplicationEvent.

Standard Events

  • ContextStartedEvent
  • ContextStoppedEvent

Custom Event

Publisher

Events can be published using publishers. Any custom publisher should inject an ApplicationEventPublisher object.

package org.springframework.context;

@FunctionalInterface
public interface ApplicationEventPublisher {

  default void publishEvent(ApplicationEvent event) {
    publishEvent((Object) event);
  }

  void publishEvent(Object event);
}

Events can be published directly in the application context:

Application Event Listener

Listeners should implement the ApplicationListener interface.

Adding Application Listeners

applicationContext.addApplicationListener(...);

Implementation Details