eu.dnetlib.clients.functionality.alert.ws

Interface AlertWebService

All Superinterfaces:

eu.dnetlib.common.rmi.BaseService, eu.dnetlib.api.DriverServiceEndpoint<eu.dnetlib.api.functionality.AlertService>, DriverWebService<eu.dnetlib.api.functionality.AlertService>

All Known Implementing Classes:

AlertWebServiceImpl

public interface AlertWebService
extends DriverWebService<eu.dnetlib.api.functionality.AlertService>

This interface declares the available methods of an alert service which is accessible as a web service.

Author:

thanos@di.uoa.gr

See Also:

AlertService, AlertWebServiceException

Method Summary

Modifier and Type	Method and Description
void	addSubscription(eu.dnetlib.domain.functionality.AlertSubscription subscription) Add a new subscription.
void	addTemplate(eu.dnetlib.domain.functionality.AlertTemplate template) Add a template.
void	alert(URL notificationService, eu.dnetlib.domain.functionality.NotificationEvent event) Alert this service about an event generated by a notification service.
int	countAlertResults(URL notificationService, String queryId, Date date, String resultId) Count the results of an alert.
void	disableSubscription(String templateId, URL notificationService, String queryId, String resultId, String alertMode, URI subscriber) Disable a subscription.
void	enableSubscription(String templateId, URL notificationService, String queryId, String resultId, String alertMode, URI subscriber) Enable a subscription.
eu.dnetlib.domain.functionality.ResultPage	getAlertResults(URL notificationService, String queryId, String resultId, Date fromDate, Date toDate, int limit, int offset) Retrieve a page of the results of an alert.
eu.dnetlib.domain.functionality.ObjectPage<eu.dnetlib.domain.functionality.AlertSubscription>	getSubscriptions(int pageNumber, int pageSize) Retrieve a page of subscriptions.
SortedSet<eu.dnetlib.domain.functionality.AlertSubscription>	getSubscriptions(String alertMode, String subscriber, int limit, int offset) Retrieve some subscriptions by alert mode and subscriber.
SortedSet<String>	getSupportedAlertModes() Retrieve all the supported modes in which alerts can be sent.
eu.dnetlib.domain.functionality.ObjectPage<eu.dnetlib.domain.functionality.AlertTemplate>	getTemplates(int pageNumber, int pageSize) Retrieve a page of templates.
void	removeSubscription(String templateId, URL notificationService, String queryId, String resultId, String alertMode, URI subscriber) Remove a subscription.
void	removeTemplate(String templateId) Remove a template.

Methods inherited from interface eu.dnetlib.common.rmi.BaseService

identify, notify, start

Method Detail

getSupportedAlertModes

SortedSet<String> getSupportedAlertModes()

Retrieve all the supported modes in which alerts can be sent.

Returns:

a sorted set containing all the supported modes in which alerts can be sent

getTemplates

eu.dnetlib.domain.functionality.ObjectPage<eu.dnetlib.domain.functionality.AlertTemplate> getTemplates(int pageNumber,
                                                                                                       int pageSize)
                                                                                                throws AlertWebServiceException

Retrieve a page of templates.

Parameters:

pageNumber - the number of the page to retrieve

pageSize - the size of the page to retrieve

Returns:

an object page containing templates

Throws:

AlertWebServiceException - if any errors occur

addTemplate

void addTemplate(eu.dnetlib.domain.functionality.AlertTemplate template)
          throws AlertWebServiceException

Add a template.

Parameters:

template - the template to add

Throws:

AlertWebServiceException - if any errors occur

removeTemplate

void removeTemplate(String templateId)
             throws AlertWebServiceException

Remove a template.

Parameters:

templateId - the unique identifier of the template to remove

Throws:

AlertWebServiceException - if any errors occur

getSubscriptions

eu.dnetlib.domain.functionality.ObjectPage<eu.dnetlib.domain.functionality.AlertSubscription> getSubscriptions(int pageNumber,
                                                                                                               int pageSize)
                                                                                                        throws AlertWebServiceException

Retrieve a page of subscriptions.

Parameters:

pageNumber - the number of the page to retrieve

pageSize - the size of the page to retrieve

Returns:

an object page containing subscriptions

Throws:

AlertWebServiceException - if any errors occur

getSubscriptions

SortedSet<eu.dnetlib.domain.functionality.AlertSubscription> getSubscriptions(String alertMode,
                                                                              String subscriber,
                                                                              int limit,
                                                                              int offset)
                                                                       throws AlertWebServiceException

Retrieve some subscriptions by alert mode and subscriber.

Parameters:

alertMode - part of the alert mode to match

subscriber - part of the subscriber URI to match

limit - the maximum number of subscriptions to retrieve

offset - the offset to start at

Returns:

a sorted set of subscriptions

Throws:

AlertWebServiceException - if any errors occur

addSubscription

void addSubscription(eu.dnetlib.domain.functionality.AlertSubscription subscription)
              throws AlertWebServiceException

Add a new subscription.

Parameters:

subscription - the subscription to add

Throws:

AlertWebServiceException - if any errors occur

enableSubscription

void enableSubscription(String templateId,
                        URL notificationService,
                        String queryId,
                        String resultId,
                        String alertMode,
                        URI subscriber)
                 throws AlertWebServiceException

Enable a subscription.

Parameters:

templateId - the unique identifier of the template of the subscription to enable

notificationService - the URL of the notification service of the subscription to enable

queryId - the unique identifier of the notification query of the subscription to enable

resultId - the unique identifier of the result of the subscription to enable

alertMode - the alert mode of the subscription to enable

subscriber - the URI of the subscriber of the subscription to enable

Throws:

AlertWebServiceException - if any errors occur

disableSubscription

void disableSubscription(String templateId,
                         URL notificationService,
                         String queryId,
                         String resultId,
                         String alertMode,
                         URI subscriber)
                  throws AlertWebServiceException

Disable a subscription.

Parameters:

templateId - the unique identifier of the template of the subscription to disable

notificationService - the URL of the notification service of the subscription to disable

queryId - the unique identifier of the notification query of the subscription to disable

resultId - the unique identifier of the result of the subscription to disable

alertMode - the alert mode of the subscription to disable

subscriber - the URI of the subscriber of the subscription to disable

Throws:

AlertWebServiceException - if any errors occur

removeSubscription

void removeSubscription(String templateId,
                        URL notificationService,
                        String queryId,
                        String resultId,
                        String alertMode,
                        URI subscriber)
                 throws AlertWebServiceException

Remove a subscription.

Parameters:

templateId - the unique identifier of the template of the subscription to remove

notificationService - the URL of the notification service of the subscription to remove

queryId - the unique identifier of the notification query of the subscription to remove

resultId - the unique identifier of the result of the subscription to remove

alertMode - the alert mode of the subscription to remove

subscriber - the URI of the subscriber of the subscription to remove

Throws:

AlertWebServiceException - if any errors occur

countAlertResults

int countAlertResults(URL notificationService,
                      String queryId,
                      Date date,
                      String resultId)
               throws AlertWebServiceException

Count the results of an alert.

Parameters:

templateId - the unique identifier of the template of the alert results to count

notificationService - the URL of the notification service of the alert results to count

queryId - the unique identifier of the notification query of the alert results to count

date - the date that corresponds to the notification event of the alert results to count

resultId - the unique identifier of the notification result of the alert results to count

Returns:

the total number of the specified alert results

Throws:

eu.dnetlib.api.functionality.AlertServiceException - if any errors occur

AlertWebServiceException

getAlertResults

eu.dnetlib.domain.functionality.ResultPage getAlertResults(URL notificationService,
                                                           String queryId,
                                                           String resultId,
                                                           Date fromDate,
                                                           Date toDate,
                                                           int limit,
                                                           int offset)
                                                    throws AlertWebServiceException

Retrieve a page of the results of an alert.

Parameters:

notificationService - the URL of the notification service of the alert results to retrieve

queryId - the unique identfier of the notification query of the alert results to retrieve

resultId - the unique identifier of the notification result of the alert results to retrieve

fromDate - the date from which to retrieve alert results

toDate - the date up to which to retrieve alert results

limit - the maximum number of alert results to retrieve

offset - the offset to start at

Returns:

a result page

Throws:

AlertWebServiceException - if any errors occur

alert

void alert(URL notificationService,
           eu.dnetlib.domain.functionality.NotificationEvent event)
    throws AlertWebServiceException

Alert this service about an event generated by a notification service.

Parameters:

notificationService - the URL of the notification service

event - the notification event

Throws:

AlertWebServiceException - if any errors occur