org.jasig.portlet.notice.service.filter

Class FilteringNotificationServiceDecorator

java.lang.Object

org.jasig.portlet.notice.service.filter.FilteringNotificationServiceDecorator

All Implemented Interfaces:

INotificationService

public class FilteringNotificationServiceDecorator
extends Object
implements INotificationService

This INotificationService reduces the number of notices shown based on filtering rules. For example, 'show only notices of priority 1' or 'show only notices in the Library category'.

Since:

3.1

Constructor Summary

Constructors

Constructor and Description
FilteringNotificationServiceDecorator()

Method Summary

Modifier and Type	Method and Description
void	collect(javax.portlet.EventRequest req, javax.portlet.EventResponse res) This method allows INotificationService implementations that receive portlet events to collect notifications from other portlets in the portal.
NotificationResponse	fetch(javax.portlet.PortletRequest req) Provide the current collection of Notifications information for the user represented by the PortletRequest.
String	getName() Returns the name of the service, which should be unique in the portlet app.
void	invoke(javax.portlet.ActionRequest req, javax.portlet.ActionResponse res, boolean refresh) This method 'primes the pump' for INotificationService implementations.
boolean	isValid(javax.portlet.PortletRequest req, NotificationResponse previousResponse) Indicates whether a previous (presumably cached) NotificationResponse is still valid.
void	setEnclosedNotificationService(INotificationService enclosedNotificationService)

Methods inherited from class java.lang.Object

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

Constructor Detail

FilteringNotificationServiceDecorator

public FilteringNotificationServiceDecorator()

Method Detail

setEnclosedNotificationService

public void setEnclosedNotificationService(INotificationService enclosedNotificationService)

getName

public String getName()

Description copied from interface: INotificationService

Returns the name of the service, which should be unique in the portlet app.

Specified by:

getName in interface INotificationService

Returns:

A unique name for this service

invoke

public void invoke(javax.portlet.ActionRequest req,
                   javax.portlet.ActionResponse res,
                   boolean refresh)

Description copied from interface: INotificationService

This method 'primes the pump' for INotificationService implementations. Not all concrete services will need this method, and those that don't can safely make it a no-op. But those that do need it can rely on receiving a call to invoke() before receiving a call to fetch().

Specified by:

invoke in interface INotificationService

Parameters:

req - The current ActionRequest

res - The current ActionResponse

refresh - If true, the service should expire any cached data

collect

public void collect(javax.portlet.EventRequest req,
                    javax.portlet.EventResponse res)

Description copied from interface: INotificationService

This method allows INotificationService implementations that receive portlet events to collect notifications from other portlets in the portal. Not all concrete services will need this method, and those that don't can safely make it a no-op.

Specified by:

collect in interface INotificationService

Parameters:

req - The current EventRequest

res - The current EventResponse

fetch

public NotificationResponse fetch(javax.portlet.PortletRequest req)

Description copied from interface: INotificationService

Provide the current collection of Notifications information for the user represented by the PortletRequest.

Specified by:

fetch in interface INotificationService

Parameters:

req - The PortletRequest

Returns:

A collection of notifications and/or errors

isValid

public boolean isValid(javax.portlet.PortletRequest req,
                       NotificationResponse previousResponse)

Description copied from interface: INotificationService

Indicates whether a previous (presumably cached) NotificationResponse is still valid. A few service implementations will be able to make this determination without contacting a remote service or doing anything computationally expensive. Those that can't should just return true; they will have the chance to update their responses when the cached version expires or when the user clicks refresh.

Specified by:

isValid in interface INotificationService

Parameters:

req - The current request

previousResponse - A response provided by this service at an earlier point

Returns:

true if the earlier response is still acceptable for the present