eu.dnetlib.enabling.is.sn.rmi

Interface ISSNService

All Superinterfaces:

BaseService

public interface ISSNService
extends BaseService

Method Summary

Modifier and Type	Method and Description
boolean	actionCreatePerformed(String resourceType, String profileId, String profile) fossil.
boolean	actionDeletePerformed(String resourceType, String profileId) fossil.
boolean	actionUpdatePerformed(String resourceType, String profileId, String profileBefore, String profileAfter) fossil.
String	getCurrentMessage(String topic) fossil.
List<String>	listSubscriptions() list all subscriptions.
boolean	pauseSubscription(String subscrId) puts a subcription in a paused state.
boolean	renew(String subscrId, int terminationTime) Used to renew the subscription before it expires.
boolean	resumeSubscription(String subscrId) resumes a paused subscription.
String	subscribe(W3CEndpointReference consumerReference, String topicExpression, int initialTerminationTime)
boolean	unsubscribe(String subscrId)

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

identify, notify, start

Method Detail

getCurrentMessage

String getCurrentMessage(String topic)
                  throws ISSNException

fossil.

Parameters:

topic -

Returns:

Throws:

ISSNException

pauseSubscription

boolean pauseSubscription(String subscrId)
                   throws ISSNException

puts a subcription in a paused state. paused subscription are not notified even when triggered.

Parameters:

subscrId - subscription identifier

Returns:

returns false if the subscription is already paused.

Throws:

ISSNException - may happen

renew

boolean renew(String subscrId,
              int terminationTime)
       throws ISSNException

Used to renew the subscription before it expires.

In practice it resets the ttl to another value, so it can be used to reset a infinte ttl subscription to a finite value.

Parameters:

subscrId - subscription id

terminationTime - new ttl (from now), or 0 (infinite)

Returns:

true if successful

Throws:

ISSNException - may happen

resumeSubscription

boolean resumeSubscription(String subscrId)
                    throws ISSNException

resumes a paused subscription.

Parameters:

subscrId - subscription id

Returns:

true if resumed. false if it was not paused.

Throws:

ISSNException - may happen

subscribe

String subscribe(W3CEndpointReference consumerReference,
                 String topicExpression,
                 int initialTerminationTime)
          throws ISSNException,
                 SubscriptionRequestRejectedException

Parameters:

consumerReference - epr to be called when the notification is triggered

topicExpression - topic expression to register

initialTerminationTime - ttl in seconds (0 = infinite)

Returns:

subscription id

Throws:

ISSNException - may happen

SubscriptionRequestRejectedException

unsubscribe

boolean unsubscribe(String subscrId)
             throws ISSNException

Throws:

ISSNException

actionCreatePerformed

boolean actionCreatePerformed(String resourceType,
                              String profileId,
                              String profile)
                       throws ISSNException

fossil.

Parameters:

resourceType -

profileId -

profile -

Returns:

Throws:

ISSNException

actionUpdatePerformed

boolean actionUpdatePerformed(String resourceType,
                              String profileId,
                              String profileBefore,
                              String profileAfter)
                       throws ISSNException

fossil.

Parameters:

resourceType -

profileId -

profileBefore -

profileAfter -

Returns:

Throws:

ISSNException

actionDeletePerformed

boolean actionDeletePerformed(String resourceType,
                              String profileId)
                       throws ISSNException

fossil.

Parameters:

resourceType -

profileId -

Returns:

Throws:

ISSNException

listSubscriptions

List<String> listSubscriptions()

list all subscriptions. Mostly for debug reasons.

Returns:

list of subscription ids.