SIP Service Engine© Documentations
 
  Top >   SIP Servlet Programming >   SPI (Service Provider Interface) >   Presence Management Interface
 
 

Presence Management Interface

The presence management interface is used to manage the ACL (Access Control List) of presence information about SIP Servlet Engine subscribers.

The structure of the presence management interface is as follows:

PresenceACLReader Interface

This interface is used to review the permission/rejection list for presence information about a registered user.

getAcceptList(URI presentity)
Gets a SipURI list of users who are permitted to review the specified user's presence information. If the specified user does not exist, InvalidSubscriberException must be thrown. If no permitted user exists, an empty list must be returned.
getDenyList(URI presentity)
Gets a SipURI list of users who are rejected to review the specified user's presence information. If the specified user does not exist, InvalidSubscriberException must be thrown. If no rejected user exists, an empty list must be returned.

PresenceACLEditor Interface

This interface is used to add or delete users who are permitted or rejected to review presence information about a registered user. This interface extends the PresenceReader interface.

You must define a class that implements the PresenceACLEditor interface to run a demo application properly.

addAcceptURI(URI presentity, String watcher)
Adds watcher permitted to review the presence information to the specified presentity user.
removeAcceptURI(URI presentity, String watcher)
Remove watcher permitted to review the presence information from the specified presentity user. If no presentity user exists, InvalidSubscriberException must be thrown.
addDenyURI(URI presentity, String watcher)
Adds watcher rejected to review the presence information to the specified presentity user. If no presentity user exists, InvalidSubscriberException must be thrown.
removeDenyURI(URI presentity, String watcher)
Remove watcher permitted to review the presence information from the specified presentity user. If no presentity user exists, InvalidSubscriberException must be thrown.

Last Modified:Mon Dec 27 15:09:25 JST 2004