Package 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
    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 Details

    • 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:

    • 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()