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.

Author:

Copyright (c) 2021, Oracle and/or its affiliates. All rights reserved.

Method Summary

Modifier and Type	Method and Description
Object	doAction(String applicationSessionId, WlssAction action) Deprecated. com.bea.wcp.sip.WlssSipSessionsUtil.doAction(String applicationSessionId, WlssAction action) should be used instead
boolean	hasLock(String applicationSessionId) Deprecated. com.bea.wcp.sip.WlssSipSessionsUtil.hasLock(String applicationSessionId) should be used instead

Method Detail

doAction

Object doAction(String applicationSessionId,
                WlssAction action)
         throws 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:

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

Exception

See Also:

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

hasLock

boolean hasLock(String applicationSessionId)

Deprecated. com.bea.wcp.sip.WlssSipSessionsUtil.hasLock(String applicationSessionId) should be used instead

Parameters:

applicationSessionId - the SipApplicationSession's id

Returns:

boolean

See Also:

SipApplicationSession.getId()