com.atlassian.jira.bc.filter

Class DefaultFilterSubscriptionService

java.lang.Object

com.atlassian.jira.bc.filter.DefaultFilterSubscriptionService

All Implemented Interfaces:

FilterSubscriptionService

public class DefaultFilterSubscriptionService
extends Object
implements FilterSubscriptionService

Uses Atlassian Scheduler

Constructor Summary

Constructors

Constructor and Description
DefaultFilterSubscriptionService(JiraAuthenticationContext jiraAuthenticationContext, SubscriptionManager subscriptionManager, com.atlassian.scheduler.SchedulerService schedulerService)

Method Summary

Modifier and Type	Method and Description
String	getCronExpression(JiraServiceContext context, FilterSubscription subscription) Retrieve the cron expression associated with this subscription
Date	getNextSendTime(FilterSubscription sub) Returns the next send time for this subscription.
String	getPrettySchedule(JiraServiceContext context, String cronExpression) Renders a human readable description of the given cron expression or returns the cron expression if it can't be parsed by the com.atlassian.core.cron.parser.CronExpressionParser.
Collection<FilterSubscription>	getVisibleFilterSubscriptions(ApplicationUser user, SearchRequest filter) Retrieves a list of subscriptions that a given user can see for a given filter.
void	storeSubscription(JiraServiceContext context, Long filterId, String groupName, String expr, boolean emailOnEmpty) Create and store a subscription that uses the given cron expression
void	updateSubscription(JiraServiceContext context, Long subscriptionId, String groupName, String expr, boolean emailOnEmpty) Updates the subscription to the new given values and persists.
void	validateCronExpression(JiraServiceContext context, String expr) Validates a given cron expression Errors are passed back in the ErrorCollection of the JiraServiceContext

Methods inherited from class java.lang.Object

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

Constructor Detail

DefaultFilterSubscriptionService

public DefaultFilterSubscriptionService(JiraAuthenticationContext jiraAuthenticationContext,
                                        SubscriptionManager subscriptionManager,
                                        com.atlassian.scheduler.SchedulerService schedulerService)

Method Detail

validateCronExpression

public void validateCronExpression(JiraServiceContext context,
                                   String expr)

Description copied from interface: FilterSubscriptionService

Validates a given cron expression Errors are passed back in the ErrorCollection of the JiraServiceContext

Specified by:

validateCronExpression in interface FilterSubscriptionService

Parameters:

context - jira service context

expr - Expression to evaluate

storeSubscription

public void storeSubscription(JiraServiceContext context,
                              Long filterId,
                              String groupName,
                              String expr,
                              boolean emailOnEmpty)

Description copied from interface: FilterSubscriptionService

Create and store a subscription that uses the given cron expression

Specified by:

storeSubscription in interface FilterSubscriptionService

Parameters:

context - jira service context

filterId - Id of the filter subscribing to

groupName - Sent to group (may be null if sent to self)

expr - Cron expression to store

emailOnEmpty - send email if filter returns no results

updateSubscription

public void updateSubscription(JiraServiceContext context,
                               Long subscriptionId,
                               String groupName,
                               String expr,
                               boolean emailOnEmpty)

Description copied from interface: FilterSubscriptionService

Updates the subscription to the new given values and persists.

Specified by:

updateSubscription in interface FilterSubscriptionService

Parameters:

context - jira service context

subscriptionId - Id of the subscription being updated

groupName - Sent to group (may be null if sent to self)

expr - Cron expression to store

emailOnEmpty - send email if filter returns no results

getPrettySchedule

public String getPrettySchedule(JiraServiceContext context,
                                String cronExpression)

Description copied from interface: FilterSubscriptionService

Renders a human readable description of the given cron expression or returns the cron expression if it can't be parsed by the com.atlassian.core.cron.parser.CronExpressionParser.

Specified by:

getPrettySchedule in interface FilterSubscriptionService

Parameters:

context - the jira service context.

cronExpression - a cron expression.

Returns:

a locale-specific sentence describing the cron string (or on failure, the cron string).

getCronExpression

public String getCronExpression(JiraServiceContext context,
                                FilterSubscription subscription)

Description copied from interface: FilterSubscriptionService

Retrieve the cron expression associated with this subscription

Specified by:

getCronExpression in interface FilterSubscriptionService

Returns:

the cron expression associated with this subscription

getVisibleFilterSubscriptions

public Collection<FilterSubscription> getVisibleFilterSubscriptions(ApplicationUser user,
                                                                    SearchRequest filter)

Description copied from interface: FilterSubscriptionService

Retrieves a list of subscriptions that a given user can see for a given filter. I.e. The owner can see all subscriptions for a filter, otherwise you can only see your own subscriptions.

Specified by:

getVisibleFilterSubscriptions in interface FilterSubscriptionService

Parameters:

user - The user that can see the subscriptions

filter - The filter with teh associated subscriptions

Returns:

A Collection of GenericValue subscriptions

getNextSendTime

@Nullable
public Date getNextSendTime(@Nonnull
                                      FilterSubscription sub)

Description copied from interface: FilterSubscriptionService

Returns the next send time for this subscription. This may return null if the scheduler does not support the reporting of next send times.

Specified by:

getNextSendTime in interface FilterSubscriptionService

Parameters:

sub - The subscription

Returns:

Next send time