org.jasig.portlet.notice.service.jpa

Interface IJpaNotificationRESTService

All Known Implementing Classes:

JpaNotificationRESTService

public interface IJpaNotificationRESTService

Service for the REST-ful API for JPA Notifications.

Since:

3.0

Author:

Josh Helmer, jhelmer.unicon.net

Method Summary

Modifier and Type	Method and Description
AddresseeDTO	createAddressee(long notificationId, AddresseeDTO addressee) Create the addressee.
EventDTO	createEvent(long notificationId, EventDTO entry) Create an event.
EntryDTO	createNotification(EntryDTO notification) Create a notification.
AddresseeDTO	getAddressee(long addresseeId) Get a single addressee by id.
Set<AddresseeDTO>	getAddressees(long notificationId) Get the List addressees for a notification.
EventDTO	getEvent(long eventId) Get a single event.
List<EventDTO>	getEventsByNotification(long notificationId) Get the list of events by notification.
EntryDTO	getNotification(long id, boolean full) Get a notification by id.
List<EntryDTO>	getNotifications(Integer page, Integer pageSize) Get the list of notifications.

Method Detail

getNotifications

List<EntryDTO> getNotifications(Integer page,
                                Integer pageSize)

Get the list of notifications.

Parameters:

page - 0 based page #

pageSize - page size

Returns:

the list of entries.

getNotification

EntryDTO getNotification(long id,
                         boolean full)

Get a notification by id.

Parameters:

id - the notification id

full - if true, will fetch the addressee info as well, otherwise will omit

Returns:

The entry if found, else null

createNotification

EntryDTO createNotification(EntryDTO notification)

Create a notification.

Parameters:

notification - the notification object. Should *NOT* contain a populated id field.

Returns:

the newly created Entry

getAddressees

Set<AddresseeDTO> getAddressees(long notificationId)

Get the List addressees for a notification.

Parameters:

notificationId - the notification id

Returns:

the set of notifications

getAddressee

AddresseeDTO getAddressee(long addresseeId)

Get a single addressee by id.

Parameters:

addresseeId - the addressee id

Returns:

the addressee if found, else null

createAddressee

AddresseeDTO createAddressee(long notificationId,
                             AddresseeDTO addressee)

Create the addressee.

Parameters:

notificationId - the notification to attach the addressee to

addressee - the addressee object. Should *NOT* create an id

Returns:

the newly created addressee

getEventsByNotification

List<EventDTO> getEventsByNotification(long notificationId)

Get the list of events by notification.

Parameters:

notificationId - the notification id

Returns:

the list of events

getEvent

EventDTO getEvent(long eventId)

Get a single event.

Parameters:

eventId - the event id

Returns:

the event if found, else null

createEvent

EventDTO createEvent(long notificationId,
                     EventDTO entry)

Create an event.

Parameters:

notificationId - the notification id

entry - the entry to create. Should *NOT* contain an id.

Returns:

the newly created event