org.jasig.portlet.notice

Interface INotificationService

All Known Implementing Classes:

AbstractJdbcNotificationService, AbstractNotificationService, AbstractNotificationServiceDecorator, AnyRowResourceContentJdbcNotificationService, CacheNotificationService, ClassLoaderResourceNotificationService, DemoNotificationService, FavoriteNotificationServiceDecorator, FilteringNotificationServiceDecorator, HideNotificationServiceDecorator, JpaNotificationService, LegacyEmergencyAlertsDemoNotifictionService, PortletEventNotificationService, ReadNotificationServiceDecorator, RestfulJsonNotificationService, RomeNotificationService, SSPTaskNotificationService

public interface INotificationService

This is the central interface of the Notifications API. It is used to retrieve notifications from data sources.

Method Summary

Modifier and Type	Method and Description
void	collect(javax.portlet.EventRequest req, javax.portlet.EventResponse res) Deprecated. Prefer interactions that are not based on the Portlet API
org.jasig.portlet.notice.NotificationResponse	fetch(javax.servlet.http.HttpServletRequest request) Provide the current collection of Notifications information for the specified user.
org.jasig.portlet.notice.NotificationResponse	fetch(javax.portlet.PortletRequest req) Deprecated. Prefer interactions that are not based on the Portlet API
java.lang.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) Deprecated. Prefer interactions that are not based on the Portlet API
boolean	isValid(javax.portlet.PortletRequest req, org.jasig.portlet.notice.NotificationResponse previousResponse) Deprecated. Prefer interactions that are not based on the Portlet API

Method Detail

getName

java.lang.String getName()

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

Returns:

A unique name for this service

invoke

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

Deprecated. Prefer interactions that are not based on the Portlet API

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().

Parameters:

req - The current ActionRequest

res - The current ActionResponse

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

collect

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

Deprecated. Prefer interactions that are not based on the Portlet API

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.

Parameters:

req - The current EventRequest

res - The current EventResponse

fetch

@Deprecated
org.jasig.portlet.notice.NotificationResponse fetch(javax.portlet.PortletRequest req)

Deprecated. Prefer interactions that are not based on the Portlet API

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

Parameters:

req - The PortletRequest

Returns:

A collection of notifications and/or errors

isValid

@Deprecated
boolean isValid(javax.portlet.PortletRequest req,
                            org.jasig.portlet.notice.NotificationResponse previousResponse)

Deprecated. Prefer interactions that are not based on the Portlet API

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.

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

fetch

org.jasig.portlet.notice.NotificationResponse fetch(javax.servlet.http.HttpServletRequest request)

Provide the current collection of Notifications information for the specified user.

Parameters:

request - The REST request

Returns:

An abstraction representing the user's categorized notifications

Since:

4.0