org.springframework.context.event: public class: SimpleApplicationEventMulticaster

org.springframework.context.event
public class: SimpleApplicationEventMulticaster [javadoc | source]

java.lang.Object
   org.springframework.context.event.AbstractApplicationEventMulticaster
      org.springframework.context.event.SimpleApplicationEventMulticaster

All Implemented Interfaces:
ApplicationEventMulticaster

Simple implementation of the ApplicationEventMulticaster interface.

Multicasts all events to all registered listeners, leaving it up to the listeners to ignore events that they are not interested in. Listeners will usually perform corresponding instanceof checks on the passed-in event object.

By default, all listeners are invoked in the calling thread. This allows the danger of a rogue listener blocking the entire application, but adds minimal overhead. Specify an alternative TaskExecutor to have listeners executed in different threads, for example from a thread pool.

Also see:

setTaskExecutor

setConcurrentUpdates

author: Rod - Johnson

author: Juergen - Hoeller

Method from org.springframework.context.event.SimpleApplicationEventMulticaster Summary:
getTaskExecutor, multicastEvent, setTaskExecutor

Methods from org.springframework.context.event.AbstractApplicationEventMulticaster:
addApplicationListener, getApplicationListeners, removeAllListeners, removeApplicationListener, setCollectionClass, setConcurrentUpdates

Methods from java.lang.Object:
equals, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Method from org.springframework.context.event.SimpleApplicationEventMulticaster Detail:
protected TaskExecutor getTaskExecutor() { return this.taskExecutor; } Return the current TaskExecutor for this multicaster.
public void multicastEvent(ApplicationEvent event) { for (Iterator it = getApplicationListeners().iterator(); it.hasNext();) { final ApplicationListener listener = (ApplicationListener) it.next(); getTaskExecutor().execute(new Runnable() { public void run() { listener.onApplicationEvent(event); } }); } }
public void setTaskExecutor(TaskExecutor taskExecutor) { this.taskExecutor = (taskExecutor != null ? taskExecutor : new SyncTaskExecutor()); } Set the TaskExecutor to execute application listeners with. Default is a SyncTaskExecutor, executing the listeners synchronously in the calling thread. Consider specifying an asynchronous TaskExecutor here to not block the caller until all listeners have been executed. However, note that asynchronous execution will not participate in the caller's thread context (class loader, transaction association) unless the TaskExecutor explicitly supports this.

Method from org.springframework.context.event.SimpleApplicationEventMulticaster Detail:

 protected TaskExecutor getTaskExecutor() {
		return this.taskExecutor;
}

Return the current TaskExecutor for this multicaster.

 public  void multicastEvent(ApplicationEvent event) {
		for (Iterator it = getApplicationListeners().iterator(); it.hasNext();) {
			final ApplicationListener listener = (ApplicationListener) it.next();
			getTaskExecutor().execute(new Runnable() {
				public void run() {
					listener.onApplicationEvent(event);
				}
			});
		}
}

 public  void setTaskExecutor(TaskExecutor taskExecutor) {
	                                                                  	 
		this.taskExecutor = (taskExecutor != null ? taskExecutor : new SyncTaskExecutor());
}

Default is a SyncTaskExecutor, executing the listeners synchronously in the calling thread.

Consider specifying an asynchronous TaskExecutor here to not block the caller until all listeners have been executed. However, note that asynchronous execution will not participate in the caller's thread context (class loader, transaction association) unless the TaskExecutor explicitly supports this.