org.apache.ws.notification.base
Interface Subscription

All Superinterfaces:
org.apache.ws.resource.PropertiesResource, org.apache.ws.resource.Resource, org.apache.ws.resource.lifetime.ScheduledResourceTerminationResource, Subscription
All Known Implementing Classes:
AbstractSubscription

public interface Subscription
extends org.apache.ws.resource.PropertiesResource, Subscription, org.apache.ws.resource.lifetime.ScheduledResourceTerminationResource

Interface to be implemented by subscription resources. Exposes the information associated with a subscription request, as well as resource lifetime-related state.


Method Summary
 org.apache.ws.addressing.EndpointReference getConsumerReference()
          Gets the consumer EPR associated with this subscription.
 org.apache.ws.resource.properties.query.QueryExpression getPrecondition()
          Gets the precondition associated with this subscription.
 NotificationProducerResource getProducerResource()
          Gets the producer resource associated with this subscription.
 org.apache.ws.resource.properties.query.QueryExpression getSelector()
          Gets the selector associated with this subscription.
 TopicExpression getTopicExpression()
          Gets the topic expression associated with this subscription.
 boolean getUseNotify()
          Wrap notification messages in the notify element?
 boolean isPaused()
          Returns true if this subscription is currently paused, or false otherwise.
 void pause()
          Temporarily suspends the delivery of notification messages for this subscription.
 void resume()
          Resumes the delivery of notification messages for this subscription.
 void setEndpointReference(org.apache.ws.addressing.EndpointReference epr)
           
 void setNotificationConsumer(NotificationConsumer notificationConsumer)
           
 void setNotificationProducer(NotificationProducer notificationProducer)
           
 void setPolicy(java.lang.Object policy)
           
 void setPrecondition(org.apache.ws.resource.properties.query.QueryExpression precondition)
           
 void setSelector(org.apache.ws.resource.properties.query.QueryExpression selector)
           
 void setUseNotify(boolean useNotify)
           
 
Methods inherited from interface org.apache.ws.resource.PropertiesResource
getResourcePropertySet, setResourcePropertySet
 
Methods inherited from interface org.apache.ws.resource.Resource
addTerminationListener, destroy, getEndpointReference, getID, init, setID
 
Methods inherited from interface org.apache.ws.pubsub.Subscription
getCreationTime, getFilters, getNotificationConsumer, getNotificationProducer, getSubscriptionEndConsumer, getTerminationTime, setTerminationTime, unsubscribe
 
Methods inherited from interface org.apache.ws.resource.lifetime.ScheduledResourceTerminationResource
getCurrentTime, getTerminationTime, setTerminationTime
 

Method Detail

getTopicExpression

public TopicExpression getTopicExpression()
Gets the topic expression associated with this subscription.

Returns:
the topic expression

getPrecondition

public org.apache.ws.resource.properties.query.QueryExpression getPrecondition()
Gets the precondition associated with this subscription.

Returns:
the precondition, or null if no precondition was specified in the subscribe request

getSelector

public org.apache.ws.resource.properties.query.QueryExpression getSelector()
Gets the selector associated with this subscription.

Returns:
the selector, or null if no selector was specified in the subscribe request

getUseNotify

public boolean getUseNotify()
Wrap notification messages in the notify element?

Specified by:
getUseNotify in interface Subscription
Returns:
true (default) if notify should be used, or false if not

isPaused

public boolean isPaused()
Returns true if this subscription is currently paused, or false otherwise.

Returns:
true if this subscription is currently paused, or false otherwise

pause

public void pause()
           throws java.lang.Exception
Temporarily suspends the delivery of notification messages for this subscription.

Throws:
java.lang.Exception - if unable to suspend message delivery

resume

public void resume()
            throws java.lang.Exception
Resumes the delivery of notification messages for this subscription.

Throws:
java.lang.Exception - if unable to resume message delivery

getProducerResource

public NotificationProducerResource getProducerResource()
Gets the producer resource associated with this subscription.

Returns:
the producer resource

setEndpointReference

public void setEndpointReference(org.apache.ws.addressing.EndpointReference epr)

setNotificationConsumer

public void setNotificationConsumer(NotificationConsumer notificationConsumer)

setNotificationProducer

public void setNotificationProducer(NotificationProducer notificationProducer)

getConsumerReference

public org.apache.ws.addressing.EndpointReference getConsumerReference()
Gets the consumer EPR associated with this subscription.

Returns:
the consumer EPR associated with this subscription

setPolicy

public void setPolicy(java.lang.Object policy)

setPrecondition

public void setPrecondition(org.apache.ws.resource.properties.query.QueryExpression precondition)

setSelector

public void setSelector(org.apache.ws.resource.properties.query.QueryExpression selector)

setUseNotify

public void setUseNotify(boolean useNotify)


Copyright © 2004-2005 Apache Software Foundation. All Rights Reserved.