org.springframework.context.event

Class SourceFilteringListener

java.lang.Object

org.springframework.context.event.SourceFilteringListener

All Implemented Interfaces:

EventListener, ApplicationListener<ApplicationEvent>, GenericApplicationListener, SmartApplicationListener, Ordered

public class SourceFilteringListener
extends Object
implements GenericApplicationListener, SmartApplicationListener

ApplicationListener decorator that filters events from a specified event source, invoking its delegate listener for matching ApplicationEvent objects only.

Can also be used as base class, overriding the onApplicationEventInternal(org.springframework.context.ApplicationEvent) method instead of specifying a delegate listener.

Since:

2.0.5

Author:

Juergen Hoeller, Stephane Nicoll

Field Summary

Fields inherited from interface org.springframework.core.Ordered

HIGHEST_PRECEDENCE, LOWEST_PRECEDENCE

Constructor Summary

Constructors

Modifier	Constructor and Description
protected	SourceFilteringListener(Object source) Create a SourceFilteringListener for the given event source, expecting subclasses to override the onApplicationEventInternal(org.springframework.context.ApplicationEvent) method (instead of specifying a delegate listener).
	SourceFilteringListener(Object source, ApplicationListener<?> delegate) Create a SourceFilteringListener for the given event source.

Method Summary

Modifier and Type	Method and Description
int	getOrder() Get the order value of this object.
void	onApplicationEvent(ApplicationEvent event) Handle an application event.
protected void	onApplicationEventInternal(ApplicationEvent event) Actually process the event, after having filtered according to the desired event source already.
boolean	supportsEventType(Class<? extends ApplicationEvent> eventType) Determine whether this listener actually supports the given event type.
boolean	supportsEventType(ResolvableType eventType) Determine whether this listener actually supports the given event type.
boolean	supportsSourceType(Class<?> sourceType) Determine whether this listener actually supports the given source type.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

SourceFilteringListener

public SourceFilteringListener(Object source,
                               ApplicationListener<?> delegate)

Create a SourceFilteringListener for the given event source.

Parameters:

source - the event source that this listener filters for, only processing events from this source

delegate - the delegate listener to invoke with event from the specified source

SourceFilteringListener

protected SourceFilteringListener(Object source)

Create a SourceFilteringListener for the given event source, expecting subclasses to override the onApplicationEventInternal(org.springframework.context.ApplicationEvent) method (instead of specifying a delegate listener).

Parameters:

source - the event source that this listener filters for, only processing events from this source

Method Detail

onApplicationEvent

public void onApplicationEvent(ApplicationEvent event)

Description copied from interface: ApplicationListener

Handle an application event.

Specified by:

onApplicationEvent in interface ApplicationListener<ApplicationEvent>

Parameters:

event - the event to respond to

supportsEventType

public boolean supportsEventType(ResolvableType eventType)

Description copied from interface: GenericApplicationListener

Determine whether this listener actually supports the given event type.

Specified by:

supportsEventType in interface GenericApplicationListener

Parameters:

eventType - the event type (never null)

supportsEventType

public boolean supportsEventType(Class<? extends ApplicationEvent> eventType)

Description copied from interface: SmartApplicationListener

Determine whether this listener actually supports the given event type.

Specified by:

supportsEventType in interface SmartApplicationListener

Parameters:

eventType - the event type (never null)

supportsSourceType

public boolean supportsSourceType(Class<?> sourceType)

Description copied from interface: GenericApplicationListener

Determine whether this listener actually supports the given source type.

Specified by:

supportsSourceType in interface GenericApplicationListener

Specified by:

supportsSourceType in interface SmartApplicationListener

Parameters:

sourceType - the source type, or null if no source

getOrder

public int getOrder()

Description copied from interface: Ordered

Get the order value of this object.

Higher values are interpreted as lower priority. As a consequence, the object with the lowest value has the highest priority (somewhat analogous to Servlet load-on-startup values).

Same order values will result in arbitrary sort positions for the affected objects.

Specified by:

getOrder in interface Ordered

Returns:

the order value

See Also:

Ordered.HIGHEST_PRECEDENCE, Ordered.LOWEST_PRECEDENCE

onApplicationEventInternal

protected void onApplicationEventInternal(ApplicationEvent event)

Actually process the event, after having filtered according to the desired event source already.

The default implementation invokes the specified delegate, if any.

Parameters:

event - the event to process (matching the specified source)