Enum LimiterInstruction.Action
- java.lang.Object
-
- java.lang.Enum<LimiterInstruction.Action>
-
- com.opencloud.javax.sip.slee.overload.LimiterInstruction.Action
-
- All Implemented Interfaces:
Serializable
,Comparable<LimiterInstruction.Action>
- Enclosing class:
- LimiterInstruction
public static enum LimiterInstruction.Action extends Enum<LimiterInstruction.Action>
Represents the Action for aLimiterInstruction
-
-
Enum Constant Summary
Enum Constants Enum Constant Description ACCEPT
The request is accepted by the overload control plugin as a normal request.DISCARD
The request is rejected by the overload control plugin and should be discarded with no SIP response sent.EXEMPT
The request is accepted by the overload control plugin and is considered exempt from regular SIP RA rate limiting.REJECT
The request is rejected by the overload control plugin.
-
Method Summary
All Methods Static Methods Concrete Methods Modifier and Type Method Description static LimiterInstruction.Action
valueOf(String name)
Returns the enum constant of this type with the specified name.static LimiterInstruction.Action[]
values()
Returns an array containing the constants of this enum type, in the order they are declared.
-
-
-
Enum Constant Detail
-
ACCEPT
public static final LimiterInstruction.Action ACCEPT
The request is accepted by the overload control plugin as a normal request. The SIP RA will pass the request up the software stack where it may be subject to regular SIP RA rate limiting. This means the request could still be rejected by the RA due to rate limiter overload conditions.
-
EXEMPT
public static final LimiterInstruction.Action EXEMPT
The request is accepted by the overload control plugin and is considered exempt from regular SIP RA rate limiting. The RA will pass the request up the software stack without any further rate limiting considerations of its own.
-
REJECT
public static final LimiterInstruction.Action REJECT
The request is rejected by the overload control plugin. The limiter instruction for this action may include anoptional response
. The SIP RA will send this response to the request, if provided, otherwise it will send its default overload control rejection response.Caution must be used when rejecting requests, as doing so may break various call flows and application state machines. As a rule of thumb, do not reject mid-dialog requests, and consider carefully which initial requests should be exempt from overload control.
-
DISCARD
public static final LimiterInstruction.Action DISCARD
The request is rejected by the overload control plugin and should be discarded with no SIP response sent. Any associated server transaction state is also discarded.Discarded requests may be observable through side effects such as statistics, TCP sequence numbers, and so-on.
Extreme caution must be used when discarding requests, the specific algorithm must be very well thought through. If in doubt, never discard a request.
-
-
Method Detail
-
values
public static LimiterInstruction.Action[] values()
Returns an array containing the constants of this enum type, in the order they are declared. This method may be used to iterate over the constants as follows:for (LimiterInstruction.Action c : LimiterInstruction.Action.values()) System.out.println(c);
- Returns:
- an array containing the constants of this enum type, in the order they are declared
-
valueOf
public static LimiterInstruction.Action valueOf(String name)
Returns the enum constant of this type with the specified name. The string must match exactly an identifier used to declare an enum constant in this type. (Extraneous whitespace characters are not permitted.)- Parameters:
name
- the name of the enum constant to be returned.- Returns:
- the enum constant with the specified name
- Throws:
IllegalArgumentException
- if this enum type has no constant with the specified nameNullPointerException
- if the argument is null
-
-