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 status code of the response is not in the range 101-199
• the request was not an INVITE
• the UAC did not indicate support for the 100rel extension in the request
• the container doesn't support the 100rel extension

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