javax.servlet.sip
Class Rel100Exception

java.lang.Object
  |
  +--java.lang.Throwable
        |
        +--java.lang.Exception
              |
              +--javax.servlet.ServletException
                    |
                    +--javax.servlet.sip.Rel100Exception
All Implemented Interfaces:
java.io.Serializable

public class Rel100Exception
extends javax.servlet.ServletException

Indicates that a provisional response cannot be sent reliably.

This is thrown by the container when an application requested that a provisional response be sent reliably (using the 100rel extension defined in RFC 3262) but one or more of the conditions for using 100rel is not satisfied:

The actual reason why SipServletResponse.sendReliably() failed can be discovered through getReason().

See Also:
Serialized Form

Field Summary
static int NO_UAC_SUPPORT
          Reason code indicating that the UAC didn't indicate support for the reliable responses extension in the request.
static int NOT_1XX
          Reason code indicating that SipServletResponse.sendReliably() was invoked on a final or a 100 response.
static int NOT_INVITE
          Reason code indicating that SipServletResponse.sendReliably() was invoked for a response to a non-INVITE request.
static int NOT_SUPPORTED
          Reason code indicating that the container does not support reliable provisional response.
 
Constructor Summary
Rel100Exception(int reason)
          Constructs a new Rel100Exception with the specified error reason.
 
Method Summary
 java.lang.String getMessage()
          Returns message phrase suitable for the reason integer code.
 int getReason()
          Returns an integer code indicating the specific reason why this exception was thrown.
 
Methods inherited from class javax.servlet.ServletException
getRootCause
 
Methods inherited from class java.lang.Throwable
fillInStackTrace, getLocalizedMessage, printStackTrace, printStackTrace, printStackTrace, toString
 
Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait
 

Field Detail

NOT_1XX

public static final int NOT_1XX
Reason code indicating that SipServletResponse.sendReliably() was invoked on a final or a 100 response.

NOT_INVITE

public static final int NOT_INVITE
Reason code indicating that SipServletResponse.sendReliably() was invoked for a response to a non-INVITE request.

NO_UAC_SUPPORT

public static final int NO_UAC_SUPPORT
Reason code indicating that the UAC didn't indicate support for the reliable responses extension in the request.

NOT_SUPPORTED

public static final int NOT_SUPPORTED
Reason code indicating that the container does not support reliable provisional response.
Constructor Detail

Rel100Exception

public Rel100Exception(int reason)
Constructs a new Rel100Exception with the specified error reason.
Parameters:
reason - one of NOT_1XX, NOT_INVITE, NO_UAC_SUPPORT, NOT_SUPPORTED
Method Detail

getReason

public int getReason()
Returns an integer code indicating the specific reason why this exception was thrown.
Returns:
one of NOT_1XX, NOT_INVITE, NO_UAC_SUPPORT, NOT_SUPPORTED

getMessage

public java.lang.String getMessage()
Returns message phrase suitable for the reason integer code.
Overrides:
getMessage in class java.lang.Throwable
Returns:
descriptive message phrase


SIP Servlet API 1.0