com.ibm.soa.parlayx21.presence
Class PresenceNotificationProxy

java.lang.Object
  extended by com.ibm.soa.parlayx21.presence.PresenceNotificationProxy
All Implemented Interfaces:
PresenceNotification, java.rmi.Remote

public class PresenceNotificationProxy
extends java.lang.Object
implements PresenceNotification


Constructor Summary
PresenceNotificationProxy()
           
 
Method Summary
 java.lang.String getEndpoint()
           
 PresenceNotification getPresenceNotification()
           
 void notifySubscription(java.net.URI presentity, PresencePermission[] decisions)
          This asynchronous method notifies the watcher that the server or the presentity handled the pending subscription.
 void setEndpoint(java.lang.String endpoint)
           
 void statusChanged(java.lang.String correlator, java.net.URI presentity, PresenceAttribute[] changedAttributes)
          The asynchronous operation is called by the Web Service when an attribute for which notifications were requested changes.
 void statusEnd(java.lang.String correlator)
          The notifications have ended for this correlator.
 void subscriptionEnded(java.net.URI presentity, java.lang.String reason)
          This asynchronous operation is called by the Web Service to notify the watcher (application) that the subscription has terminated.
 void useJNDI(boolean useJNDI)
           
 
Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
 

Constructor Detail

PresenceNotificationProxy

public PresenceNotificationProxy()
Method Detail

useJNDI

public void useJNDI(boolean useJNDI)

getEndpoint

public java.lang.String getEndpoint()

setEndpoint

public void setEndpoint(java.lang.String endpoint)

getPresenceNotification

public PresenceNotification getPresenceNotification()

statusChanged

public void statusChanged(java.lang.String correlator,
                          java.net.URI presentity,
                          PresenceAttribute[] changedAttributes)
                   throws java.rmi.RemoteException
Description copied from interface: PresenceNotification

The asynchronous operation is called by the Web Service when an attribute for which notifications were requested changes.

Specified by:
statusChanged in interface PresenceNotification
Parameters:
correlator - xsd:string

Identifies the notification request.

presentity - xsd:anyURI

The presentity whose presence status has changed.

changedAttributes - PresenceAttribute [1..unbounded]

The new presence data.

Throws:
java.rmi.RemoteException

statusEnd

public void statusEnd(java.lang.String correlator)
               throws java.rmi.RemoteException
Description copied from interface: PresenceNotification

The notifications have ended for this correlator. This message will be delivered when the duration or count for notifications have been completed. This message will not be delivered in the case of an error ending the notifications or deliberate ending of the notifications (using endPresenceNotification operation).

Referenced faults

None.

Specified by:
statusEnd in interface PresenceNotification
Parameters:
correlator - xsd:string

Correlator provided in request to set up this notification.

Throws:
java.rmi.RemoteException

notifySubscription

public void notifySubscription(java.net.URI presentity,
                               PresencePermission[] decisions)
                        throws java.rmi.RemoteException
Description copied from interface: PresenceNotification

This asynchronous method notifies the watcher that the server or the presentity handled the pending subscription.

Referenced faults

None.

Specified by:
notifySubscription in interface PresenceNotification
Parameters:
presentity - xsd:anyURI

The presentity whose attributes the watcher wants to monitor.

decisions - PresencePermission [0..unbounded]

Denote the attributes the server/presentity accepted to expose.

Throws:
java.rmi.RemoteException

subscriptionEnded

public void subscriptionEnded(java.net.URI presentity,
                              java.lang.String reason)
                       throws java.rmi.RemoteException
Description copied from interface: PresenceNotification

This asynchronous operation is called by the Web Service to notify the watcher (application) that the subscription has terminated. Typical reasons are a timeout of the underlying SIP soft state subscription (in accordance with [8] and [5]) or the decision of the presentity to block further presence information to that watcher. Since the subscription request has no expiration parameters, the service implementation may provide an inactivity timer that also triggers the subscriptionEnded operation.

Referenced faults

None.

Specified by:
subscriptionEnded in interface PresenceNotification
Parameters:
presentity - xsd:anyURI

The presentity to which the subscription has terminated.

reason - xsd:string

Timeout, Blocked.

Throws:
java.rmi.RemoteException


Copyright © 2003 IBM Corp. All Rights Reserved.