org.xwiki.notifications.filters

Interface NotificationFilterPreferenceManager

@Role
public interface NotificationFilterPreferenceManager

Provide an interface for interacting with user notification filters preferences.

Since:

10.9

Version:

$Id: 5a1609cdff177992365c7214df4fbd4791d6ab2a $

Method Summary

Modifier and Type	Method and Description
void	deleteFilterPreference(DocumentReference user, String filterPreferenceId) Delete a filter preference.
Stream<NotificationFilterPreference>	getFilterPreferences(Collection<NotificationFilterPreference> filterPreferences, NotificationFilter filter) Get from the given filter preferences the ones that match the given filter.
Stream<NotificationFilterPreference>	getFilterPreferences(Collection<NotificationFilterPreference> filterPreferences, NotificationFilter filter, NotificationFilterType filterType) Get from the given filter preferences the ones that match the given filter and the given filter type.
Stream<NotificationFilterPreference>	getFilterPreferences(Collection<NotificationFilterPreference> filterPreferences, NotificationFilter filter, NotificationFilterType filterType, NotificationFormat format) Get from the given filter preferences the ones that match the given filter, filter type and format.
Collection<NotificationFilterPreference>	getFilterPreferences(DocumentReference user) Get the notification filter preferences of the given user.
void	saveFilterPreferences(DocumentReference user, Set<NotificationFilterPreference> notificationFilterPreferences) Save the given set of NotificationFilterPreference against their respective NotificationFilterPreferenceProvider.
void	setFilterPreferenceEnabled(DocumentReference user, String filterPreferenceId, boolean enabled) Enable or disable a filter preference.
void	setStartDateForUser(DocumentReference user, Date startDate) Update the start date for every filter preference that the user has.

Method Detail

getFilterPreferences

Collection<NotificationFilterPreference> getFilterPreferences(DocumentReference user)
                                                       throws NotificationException

Get the notification filter preferences of the given user.

Parameters:

user - a reference of the user

Returns:

the list of the notification filter preferences of the given user.

Throws:

NotificationException - if an error occurs

getFilterPreferences

Stream<NotificationFilterPreference> getFilterPreferences(Collection<NotificationFilterPreference> filterPreferences,
                                                          NotificationFilter filter)

Get from the given filter preferences the ones that match the given filter.

Parameters:

filterPreferences - a list of filter preferences

filter - a notification filter

Returns:

a stream returning the filter preferences that match the given filter

getFilterPreferences

Stream<NotificationFilterPreference> getFilterPreferences(Collection<NotificationFilterPreference> filterPreferences,
                                                          NotificationFilter filter,
                                                          NotificationFilterType filterType)

Get from the given filter preferences the ones that match the given filter and the given filter type.

Parameters:

filterPreferences - a list of filter preferences

filter - a notification filter

filterType - a filter type

Returns:

a stream returning the filter preferences that match the given filter and filter type

getFilterPreferences

Stream<NotificationFilterPreference> getFilterPreferences(Collection<NotificationFilterPreference> filterPreferences,
                                                          NotificationFilter filter,
                                                          NotificationFilterType filterType,
                                                          NotificationFormat format)

Get from the given filter preferences the ones that match the given filter, filter type and format.

Parameters:

filterPreferences - a list of filter preferences

filter - a notification filter

filterType - a filter type

format - a notification format

Returns:

a stream returning the filter preferences that match the given filter, filter type and format

saveFilterPreferences

void saveFilterPreferences(DocumentReference user,
                           Set<NotificationFilterPreference> notificationFilterPreferences)

Save the given set of NotificationFilterPreference against their respective NotificationFilterPreferenceProvider.

Parameters:

user - the user to use

notificationFilterPreferences - a set of NotificationFilterPreference to save

Since:

10.11RC1, 10.8.3, 9.11.9

deleteFilterPreference

void deleteFilterPreference(DocumentReference user,
                            String filterPreferenceId)
                     throws NotificationException

Delete a filter preference.

Parameters:

user - the user to use

filterPreferenceId - id of the filter preference

Throws:

NotificationException - if an error happens

Since:

10.11RC1, 10.8.3, 9.11.9

setFilterPreferenceEnabled

void setFilterPreferenceEnabled(DocumentReference user,
                                String filterPreferenceId,
                                boolean enabled)
                         throws NotificationException

Enable or disable a filter preference.

Parameters:

user - the user to use

filterPreferenceId - id of the filter preference

enabled - either or not the filter preference should be enabled

Throws:

NotificationException - if an error happens

Since:

10.11RC1, 10.8.3, 9.11.9

setStartDateForUser

void setStartDateForUser(DocumentReference user,
                         Date startDate)
                  throws NotificationException

Update the start date for every filter preference that the user has.

Parameters:

user - the user to use

startDate - the new start date

Throws:

NotificationException - if an error occurs