com.ibm.soa.parlayx21.presence
Class PresenceNotificationBindingStub

java.lang.Object
  extended by com.ibm.ws.webservices.engine.client.Stub
      extended by com.ibm.soa.parlayx21.presence.PresenceNotificationBindingStub
All Implemented Interfaces:
PresenceNotification, java.rmi.Remote, javax.xml.rpc.Stub

public class PresenceNotificationBindingStub
extends com.ibm.ws.webservices.engine.client.Stub
implements PresenceNotification


Nested Class Summary
 
Nested classes/interfaces inherited from class com.ibm.ws.webservices.engine.client.Stub
com.ibm.ws.webservices.engine.client.Stub.Invoke
 
Field Summary
 
Fields inherited from class com.ibm.ws.webservices.engine.client.Stub
cachedEndpoint, cachedhttpProxyHost, cachedhttpProxyPassword, cachedhttpProxyPort, cachedhttpProxyUser, cachedhttpRedirectEnabled, cachedhttpsProxyHost, cachedhttpsProxyPassword, cachedhttpsProxyPort, cachedhttpsProxyUser, cachedPassword, cachedPortName, cachedProperties, cachedRequestSoapHeaders, cachedRequestTransportHeaders, cachedResponseSoapHeaders, cachedResponseSoapHeaderTemplates, cachedResponseTransportHeaders, cachedResponseTransportHeadersTemplate, cachedSessionContext, cachedsslCfgName, cachedTimeout, cachedUsername, cachedWriteTimeout, connection, engine, maintainSession, maintainSessionSet, messageContexts, service
 
Fields inherited from interface javax.xml.rpc.Stub
ENDPOINT_ADDRESS_PROPERTY, PASSWORD_PROPERTY, SESSION_MAINTAIN_PROPERTY, USERNAME_PROPERTY
 
Constructor Summary
PresenceNotificationBindingStub(java.net.URL endpointURL, javax.xml.rpc.Service service)
           
 
Method Summary
 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 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.
 
Methods inherited from class com.ibm.ws.webservices.engine.client.Stub
_getProperty, _getPropertyNames, _setProperty, convert, getPassword, getPortName, getTimeout, getTypeMapping, getUsername, primeMessageContext, setMaintainSession, setPassword, setPortName, setPortName, setTimeout, setUsername, setWriteTimeout, validateSoapHeadersHashMap, validateTransportPropertiesHashMap
 
Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
 

Constructor Detail

PresenceNotificationBindingStub

public PresenceNotificationBindingStub(java.net.URL endpointURL,
                                       javax.xml.rpc.Service service)
                                throws com.ibm.ws.webservices.engine.WebServicesFault
Throws:
com.ibm.ws.webservices.engine.WebServicesFault
Method Detail

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.