Oracle Fusion Middleware
Oracle WebLogic SIP Server API Reference
11g Release 1 (10.3.4)

Part Number E17873-02

com.bea.wcp.profile
Interface ProfileListener

All Superinterfaces:
java.util.EventListener

public interface ProfileListener
extends java.util.EventListener

This interface is used to notify the application that changes of some kind have occurred to subscriptions that were made using ProfileService.subscribe(javax.servlet.sip.SipApplicationSession, String, java.io.Serializable) or one of the sibling methods.
Note that as described in ProfileSubscription, a subscription is in one of three states: PENDING, ACTIVE, or INACTIVE.
The application is most likely interested in the update() notifications. Such updates are received only in the ACTIVE state.


Method Summary
 void activation(ProfileSubscription ps)
          Called when a profile subscription moves from PENDING to ACTIVE state.
 void expiry(ProfileSubscription ps)
          Called when a subscription moves from ACTIVE to INACTIVE state.
 void failure(ProfileSubscription ps, ProfileException e)
          Called when an active subscription is terminated due to an error.
 void modification(ProfileSubscription ps)
          Called when the terms of an active subscription are modified.
 void rejection(ProfileSubscription ps, ProfileException e)
          Called when a profileSubscription moves from PENDING to INACTIVE state.
 void update(ProfileSubscription ps, org.w3c.dom.Document doc)
          Invoked when a change happens to a Document to which a subscription has been made.
 

Method Detail

update

void update(ProfileSubscription ps,
            org.w3c.dom.Document doc)
Invoked when a change happens to a Document to which a subscription has been made.
The subscription was and remains in ACTIVE state.

Parameters:
ps - the profile subscription
doc - the document

expiry

void expiry(ProfileSubscription ps)
Called when a subscription moves from ACTIVE to INACTIVE state. The typical reason for doing so is that the subscription was for a finite duration, and has expired.

Parameters:
ps - the profile subscription

activation

void activation(ProfileSubscription ps)
Called when a profile subscription moves from PENDING to ACTIVE state.

Parameters:
ps - the profile subscription

rejection

void rejection(ProfileSubscription ps,
               ProfileException e)
Called when a profileSubscription moves from PENDING to INACTIVE state. Typically, the subscription was rejected by the controlling server.

Parameters:
ps - the profile subscription
e - the exception that prevented the operation from succeeding

failure

void failure(ProfileSubscription ps,
             ProfileException e)
Called when an active subscription is terminated due to an error. The state was ACTIVE, but is now INACTIVE.

Parameters:
ps - the profile subscription.

modification

void modification(ProfileSubscription ps)
Called when the terms of an active subscription are modified. Typically this indicates that a request to extend the subscription was successful. Note this does not indicate an update to the document.

Parameters:
ps - the profile subscription

Copyright 1996, 2010, Oracle and/or its affiliates. All rights reserved. Oracle is a registered trademark of Oracle Corporation and/or its affiliates. Other names may be trademarks of their respective owners.

Oracle Fusion Middleware
Oracle WebLogic SIP Server API Reference
11g Release 1 (10.3.4)

Part Number E17873-02