com.bea.wcp.util
Interface Sessions

public interface Sessions

A utility class for supporting converged applications having HTTP and SIP Sessions. An instance of this class is available as the ServletContext attribute "com.bea.wcp.util.Sessions" for converged applications. Several methods in this class need to lock underlying sessions (call states, strictly speaking), and that locking could possibly fail. This does not necessarily indicate an error condition, merely that the object is busy, and accessed by another thread. When a lock can not be obtained, but nothing is actually wrong, a runtime exception of type UnableToLockException is thrown.

Method Summary

java.lang.Object

doAction(java.lang.String applicationSessionId, WlssAction action) Deprecated. com.bea.wcp.sip.WlssSipSessionsUtil.doAction(String applicationSessionId, WlssAction action) should be used instead

Method Detail

doAction

java.lang.Object doAction(java.lang.String applicationSessionId,
                          WlssAction action)
                          throws java.lang.Exception

Deprecated. com.bea.wcp.sip.WlssSipSessionsUtil.doAction(String applicationSessionId, WlssAction action) should be used instead

This method allows a way to execute a WlssAction in a transactional manner. During the execution of this method, no other thread or engine tier cluster member will be allowed access to the call-state pertaining to the SipApplicationSession with applicationSessionId. When this API is used by the applications, the container guarentees that the business logic contained within the WlssAction will be executed with a lock on the SipApplicationSession instance corresponding to the applicationSessionId.

Parameters:

applicationSessionId - id of the SipApplicationSession that needs to be updated in a transactional manner.

action - WlssAction which is passed by the application

Returns:

Returns the result of the WlssAction's run method (may be null)

Throws:

java.lang.IllegalArgumentException - if applicationSessionId or action parameters were null or if callId could not be extracted from the applicationSessionId

java.lang.Exception

See Also:

WlssSipSessionsUtil.doAction(String, com.bea.wcp.sip.WlssAction)