1 package gov.nist.javax.sip; 2 3 import javax.sip.SipProvider; 4 5 /** 6 * Extensions to SipProvider under consideration for Version 2.0. 7 * 8 * @since 2.0 9 */ 10 11 public interface SipProviderExt extends SipProvider { 12 /** 13 * Sets a flag that indicates that automatic error handling is enabled for this dialog (the 14 * default when automatic dialog support is enabled). This flag is set by default to TRUE when 15 * the Dialog is automatically created by the provider ( automatic dialog support is true) and 16 * set to FALSE by default when the Dialog is created under program control ( automatic dialog 17 * support is false). When this flag is set to true, the stack will automatically send the 18 * following errors : 19 * 20 * <ul> 21 * <li> <b>500 Request Out of Order </b> for in-dialog requests that arrive out of order. 22 * <li> <b>482 Loop Detected </b> When a loop is detected for merged INVITE requests. 23 * <li> <b>400 Bad request </b> when a REFER is sent without a matching refer-to dialog. 24 * </ul> 25 * If this flag is set to false, the stack will not drop out of sequence ACKs but will pass 26 * these up to the application for handling. 27 * 28 * This flag is automatically set to true if any of the the following conditions is true: 29 * <ul> 30 * <li>The Back To Back User Agent flag is enabled for the Dialog.</li> 31 * <li>The Automatic Dialog Support flag is enabled for the Dialog </li> 32 * </ul> 33 * 34 * This flag should only be set at the time of Dialog creation ( before the Dialog has seen its first 35 * request or response). If set subsequently, the behavior of the flag is undefined. 36 * 37 * @since 2.0 38 */ 39 public void setDialogErrorsAutomaticallyHandled(); 40 } 41
