org.dspace.eperson.service

Interface SubscribeService

All Known Implementing Classes:

SubscribeServiceImpl

public interface SubscribeService

Service interface class for the Subscription object. The implementation of this class is responsible for all business logic calls for the Subscription object and is autowired by spring Class defining methods for sending new item e-mail alerts to users

Author:

kevinvandevelde at atmire.com

Method Summary

Modifier and Type	Method and Description
void	deleteByCollection(Context context, Collection collection)
void	deleteByEPerson(Context context, EPerson ePerson)
List<Subscription>	findAll(Context context)
List<Collection>	getAvailableSubscriptions(Context context) Find out which collections the currently logged in e-person can subscribe to
List<Collection>	getAvailableSubscriptions(Context context, EPerson eperson) Find out which collections an e-person can subscribe to
List<Subscription>	getSubscriptions(Context context, EPerson eperson) Find out which collections an e-person is subscribed to
boolean	isSubscribed(Context context, EPerson eperson, Collection collection) Is that e-person subscribed to that collection?
void	subscribe(Context context, EPerson eperson, Collection collection) Subscribe an e-person to a collection.
void	unsubscribe(Context context, EPerson eperson, Collection collection) Unsubscribe an e-person to a collection.

Method Detail

findAll

List<Subscription> findAll(Context context)
                    throws SQLException

Throws:

SQLException

subscribe

void subscribe(Context context,
               EPerson eperson,
               Collection collection)
        throws SQLException,
               AuthorizeException

Subscribe an e-person to a collection. An e-mail will be sent every day a new item appears in the collection.

Parameters:

context - DSpace context

eperson - EPerson to subscribe

collection - Collection to subscribe to

Throws:

SQLException

AuthorizeException

unsubscribe

void unsubscribe(Context context,
                 EPerson eperson,
                 Collection collection)
          throws SQLException,
                 AuthorizeException

Unsubscribe an e-person to a collection. Passing in null for the collection unsubscribes the e-person from all collections they are subscribed to.

Parameters:

context - DSpace context

eperson - EPerson to unsubscribe

collection - Collection to unsubscribe from

Throws:

SQLException

AuthorizeException

getSubscriptions

List<Subscription> getSubscriptions(Context context,
                                    EPerson eperson)
                             throws SQLException

Find out which collections an e-person is subscribed to

Parameters:

context - DSpace context

eperson - EPerson

Returns:

array of collections e-person is subscribed to

Throws:

SQLException

getAvailableSubscriptions

List<Collection> getAvailableSubscriptions(Context context)
                                    throws SQLException

Find out which collections the currently logged in e-person can subscribe to

Parameters:

context - DSpace context

Returns:

array of collections the currently logged in e-person can subscribe to

Throws:

SQLException

getAvailableSubscriptions

List<Collection> getAvailableSubscriptions(Context context,
                                           EPerson eperson)
                                    throws SQLException

Find out which collections an e-person can subscribe to

Parameters:

context - DSpace context

eperson - EPerson

Returns:

array of collections e-person can subscribe to

Throws:

SQLException

isSubscribed

boolean isSubscribed(Context context,
                     EPerson eperson,
                     Collection collection)
              throws SQLException

Is that e-person subscribed to that collection?

Parameters:

context - DSpace context

eperson - find out if this e-person is subscribed

collection - find out if subscribed to this collection

Returns:

true if they are subscribed

Throws:

SQLException

deleteByCollection

void deleteByCollection(Context context,
                        Collection collection)
                 throws SQLException

Throws:

SQLException

deleteByEPerson

void deleteByEPerson(Context context,
                     EPerson ePerson)
              throws SQLException

Throws:

SQLException