com.bea.wcp.sip.engine.server
Class LockTimeoutException

java.lang.Object
  java.lang.Throwable
      java.lang.Exception
          com.bea.wcp.sip.engine.server.LockTimeoutException

All Implemented Interfaces:

java.io.Serializable

public class LockTimeoutException
extends java.lang.Exception

This exception is thrown when a method in Sessions is unable to get a lock it requires. It does not, per se, indicate an error in the system, but rather that another party is holding the required lock.

When this exception is received, we recommend the calling application take one of two actions. The simple option is to bounce the request back to the UAC with a 486 (Busy Here) and an application-appropriate retry interval in the Retry-After header. Of course, not all clients will respond correctly.

The other option is to encode the request in a timer, and set the timer to fire after the retry interval. This enables the request to be re-attempted later.

The application should NOT simply retry the request immediately, or even after sleeping for a time. It is likely in this situation that two parties already hold their "own" call-state locks, and are trying to get each others' lock. That is, they are deadlocked. Simply trying again will not solve the deadlock; one or both parties need to give up and come back later.

See Also:

Serialized Form

Constructor Summary

LockTimeoutException(java.lang.String s)

Method Summary

Methods inherited from class java.lang.Throwable

fillInStackTrace, getCause, getLocalizedMessage, getMessage, getStackTrace, initCause, printStackTrace, printStackTrace, printStackTrace, setStackTrace, toString

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait

Constructor Detail

LockTimeoutException

public LockTimeoutException(java.lang.String s)