FileDocCategorySizeDatePackage
SipDialog.javaAPI DocphoneME MR2 API (J2ME)3117Wed May 02 18:00:42 BST 2007javax.microedition.sip

SipDialog

public interface SipDialog
SipDialog represents one SIP Dialog.
see
JSR180 spec, v 1.0.1, p 42-47

Fields Summary
public static final byte
TERMINATED
no response or error response (3xx-6xx) received (or sent). Also if the dialog is terminated with BYE or un-SUBSCRIBE.
public static final byte
EARLY
provisional 101-199 response received (or sent) Method getNewClientConnection() can not be called in this state.
public static final byte
CONFIRMED
final 2xx response received (or sent) All methods available.
Constructors Summary
Methods Summary
public java.lang.StringgetDialogID()
Returns the ID of the SIP Dialog.

return
Dialog ID (Call-ID + remote tag + local tag). Returns null if the dialog is terminated.

public javax.microedition.sip.SipClientConnectiongetNewClientConnection(java.lang.String method)
Returns new SipClientConnection in this dialog.

see
JSR180 spec, v 1.0.1, p 45
param
method - given method
return
SipClientConnection with preset headers.
throws
IllegalArgumentException - if the method is invalid
throws
SipException - INVALID_STATE if the new connection can not be established in the current state of dialog.

public bytegetState()
Returns the state of the SIP Dialog.

return
dialog state byte number.

public booleanisSameDialog(javax.microedition.sip.SipConnection sc)
Does the given SipConnection belong to this dialog.

param
sc - SipConnection to be checked, can be either SipClientConnection or SipServerConnection
return
true if the SipConnection belongs to the this dialog. Returns false if the connection is not part of this dialog or the dialog is terminated.