com.atlassian.bamboo.notification
Class AbstractNotificationEventListener<T extends com.atlassian.event.Event>

java.lang.Object
  com.atlassian.bamboo.notification.AbstractNotificationEventListener<T>

Type Parameters:

T - Event to which this listener would listen to.

All Implemented Interfaces:

HibernateEventListener, com.atlassian.event.EventListener

Direct Known Subclasses:

AfterXFailedNotificationListener, BuildCompletedNotificationListener, BuildErrorNotificationListener, BuildHungNotificationListener, BuildMissingCapableAgentNotificationListener, BuildQueueTimeoutNotificationListener, CommentNotificationListener

public abstract class AbstractNotificationEventListener<T extends com.atlassian.event.Event>
extends Object
implements HibernateEventListener

Base class for notification listeners

Field Summary

protected CachedPlanManager	cachedPlanManager
protected Class<T>	eventClass
protected NotificationDispatcher	notificationDispatcher
protected NotificationManager	notificationManager
protected Set<Class<? extends NotificationType>>	notificationTypeFilter
protected PlanManager	planManager Deprecated. since 5.4 use cachedPlanManager instead
protected SystemNotificationService	systemNotificationService

Constructor Summary

protected

AbstractNotificationEventListener(Class<T> eventClass, Set<Class<? extends NotificationType>> notificationTypeFilter)

Method Summary

protected <N extends Notification> N	createNotificationComponent(Class<N> notificationClass) Deprecated. since 5.9 use BambooNotificationUtils.createNotification(Class)
protected Iterable<NotificationRule>	filterNotificationRules(Iterable<NotificationRule> iterable, T event) Filter passed Iterable by list of classes in notificationTypeFilter and by call to NotificationType#isNotificationRequired(Event).
Class<? extends com.atlassian.event.Event>[]	getHandledEventClasses()
protected Iterable<NotificationRule>	getNotificationRules(ImmutablePlan plan, T event) Return notification rules effective for a given plan and event.
protected ImmutablePlan	getPlan(T event) Try to retrieve plan using data in the event.
protected Iterable<NotificationRule>	getSystemNotificationRules(T event) Return system notification rules effective for a given event.
void	handleEvent(com.atlassian.event.Event event) Implementation of HibernateEventListener#handleEvent
abstract void	handleEvent(T event, ImmutablePlan plan) Notification event listeners must implement this method to handle incoming events.
void	setCachedPlanManager(CachedPlanManager cachedPlanManager)
void	setNotificationDispatcher(NotificationDispatcher notificationDispatcher)
void	setNotificationManager(NotificationManager notificationManager)
void	setPlanManager(PlanManager planManager)
void	setSystemNotificationService(SystemNotificationService systemNotificationService)

Methods inherited from class java.lang.Object

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

Field Detail

notificationDispatcher

protected NotificationDispatcher notificationDispatcher

notificationManager

protected NotificationManager notificationManager

planManager

@Deprecated
protected PlanManager planManager

Deprecated. since 5.4 use cachedPlanManager instead

cachedPlanManager

protected CachedPlanManager cachedPlanManager

systemNotificationService

protected SystemNotificationService systemNotificationService

eventClass

protected final Class<T extends com.atlassian.event.Event> eventClass

notificationTypeFilter

protected final Set<Class<? extends NotificationType>> notificationTypeFilter

Constructor Detail

AbstractNotificationEventListener

protected AbstractNotificationEventListener(Class<T> eventClass,
                                            Set<Class<? extends NotificationType>> notificationTypeFilter)

Parameters:

eventClass - Class of event this listener would listen to

notificationTypeFilter - Set of notification types this listener is interested in

Method Detail

getHandledEventClasses

public Class<? extends com.atlassian.event.Event>[] getHandledEventClasses()

Specified by:

getHandledEventClasses in interface HibernateEventListener

Specified by:

getHandledEventClasses in interface com.atlassian.event.EventListener

getNotificationRules

protected Iterable<NotificationRule> getNotificationRules(@NotNull
                                                          ImmutablePlan plan,
                                                          @NotNull
                                                          T event)

Return notification rules effective for a given plan and event. List of notification rules from a plan is filtered by list of classes in notificationTypeFilter and by call to NotificationType#isNotificationRequired(Event).

Parameters:

plan - Plan which notification rules list will be filtered

event - Event which is being handled. It is passed to NotificationType#isNotificationRequired method to filter out notification rules

Returns:

Notification rules effective for a given plan and event

getSystemNotificationRules

protected Iterable<NotificationRule> getSystemNotificationRules(@NotNull
                                                                T event)

Return system notification rules effective for a given event. List of system notification rules is filtered by list of classes in notificationTypeFilter and by call to NotificationType#isNotificationRequired(Event).

Parameters:

event - Event which is being handled. It is passed to NotificationType#isNotificationRequired method to filter out notification rules

Returns:

System notification rules effective for a given event

filterNotificationRules

protected Iterable<NotificationRule> filterNotificationRules(@NotNull
                                                             Iterable<NotificationRule> iterable,
                                                             @NotNull
                                                             T event)

Filter passed Iterable by list of classes in notificationTypeFilter and by call to NotificationType#isNotificationRequired(Event).

Parameters:

iterable - Input iterable

event - Event which is being handled. It is passed to NotificationType#isNotificationRequired method to filter out notification rules

Returns:

Filtered Iterable

handleEvent

public abstract void handleEvent(@NotNull
                                 T event,
                                 @NotNull
                                 ImmutablePlan plan)

Notification event listeners must implement this method to handle incoming events.

Parameters:

event - event to be handled (narrowed to effective class of event being handled)

plan - plan which is related to event being handled

handleEvent

public void handleEvent(com.atlassian.event.Event event)

Implementation of HibernateEventListener#handleEvent

Specified by:

handleEvent in interface HibernateEventListener

Specified by:

handleEvent in interface com.atlassian.event.EventListener

Parameters:

event - Event to be handled

createNotificationComponent

@Deprecated
protected <N extends Notification> N createNotificationComponent(Class<N> notificationClass)

Deprecated. since 5.9 use BambooNotificationUtils.createNotification(Class)

Creates Notification object using Spring

Type Parameters:

N -

Parameters:

notificationClass - Requested notification class

Returns:

Notification object created with Spring

getPlan

@Nullable
protected ImmutablePlan getPlan(@NotNull
                                         T event)

Try to retrieve plan using data in the event.

Parameters:

event - Event being handled

Returns:

Plan object referred by the event

setNotificationDispatcher

public void setNotificationDispatcher(NotificationDispatcher notificationDispatcher)

setNotificationManager

public void setNotificationManager(NotificationManager notificationManager)

setPlanManager

public void setPlanManager(PlanManager planManager)

setCachedPlanManager

public void setCachedPlanManager(CachedPlanManager cachedPlanManager)

setSystemNotificationService

public void setSystemNotificationService(SystemNotificationService systemNotificationService)