summaryrefslogtreecommitdiffstats
path: root/java/gov/nist/javax/sip/DialogExt.java
diff options
context:
space:
mode:
Diffstat (limited to 'java/gov/nist/javax/sip/DialogExt.java')
-rw-r--r--java/gov/nist/javax/sip/DialogExt.java55
1 files changed, 55 insertions, 0 deletions
diff --git a/java/gov/nist/javax/sip/DialogExt.java b/java/gov/nist/javax/sip/DialogExt.java
new file mode 100644
index 0000000..ede39cd
--- /dev/null
+++ b/java/gov/nist/javax/sip/DialogExt.java
@@ -0,0 +1,55 @@
+package gov.nist.javax.sip;
+
+import javax.sip.Dialog;
+import javax.sip.SipProvider;
+
+/**
+ * Extensions for Next specification revision. These interfaces will remain unchanged and be
+ * merged with the next revision of the spec.
+ *
+ *
+ * @author mranga
+ *
+ */
+public interface DialogExt extends Dialog {
+
+ /**
+ * Returns the SipProvider that was used for the first transaction in this Dialog
+ *
+ * @return SipProvider
+ *
+ * @since 2.0
+ */
+ public SipProvider getSipProvider();
+
+ /**
+ * Sets a flag that indicates that this Dialog is part of a BackToBackUserAgent. If this flag
+ * is set, INVITEs are not allowed to interleave and timed out ACK transmission results in a
+ * BYE being sent to the other side. Setting this flag instructs the stack to automatically
+ * handle dialog errors. Once this flag is set for a dialog, it cannot be changed.
+ * This flag can be set on a stack-wide basis, on a per-provider basis or on a per Dialog basis.
+ * This flag must only be set at the time of Dialog creation. If the flag is set after the first
+ * request or response is seen by the Dialog, the behavior of this flag is undefined.
+ *
+ * @since 2.0
+ */
+ public void setBackToBackUserAgent();
+
+
+ /**
+ * Turn off sequence number validation for this dialog. This passes all requests to the
+ * application layer including those that arrive out of order. This is good for testing
+ * purposes. Validation is delegated to the application and the stack will not attempt to
+ * block requests arriving out of sequence from reaching the application. In particular, the
+ * validation of CSeq and the ACK retransmission recognition are delegated to the application.
+ * Your application will be responsible for error handling of these cases.
+ *
+ * @since 2.0
+ */
+ public void disableSequenceNumberValidation();
+
+
+
+
+
+}