javax.sip.address
Interface TelURL

All Superinterfaces:

Cloneable, Parameters, Serializable, URI

All Known Implementing Classes:

TelURLImpl

public interface TelURL

extends URI, Parameters

This class represents Tel URLs, which are used for addressing. The Tel URL starts with the scheme tel:. This tells the local entity that what follows is a URL that should be parsed as described in RFC2806. After that, the URL contains the phone number of the remote entity.

Within a SIP Message, TelURLs can be used to indicate the source and intended destination of a Request, redirection addresses and the current destination of a Request. All these Headers may contain TelURLs.

The TelURL interface extends the generic URI interface and provides additional convenience methods for the following components of a TelURL address, above the generic URI class:

• ISDN Subaddress - Phone numbers can also contain subaddresses, which are used to identify different remote entities under the same phone number.
• Post Dial - Phone numbers can also contain a post-dial sequence. This is what is often used with voice mailboxes and other services that are controlled by dialing numbers from your phone keypad while the call is in progress.
• Global - Phone numbers can be either "global" or "local". Global numbers are unambiguous everywhere. Local numbers are usable only within a certain area.
• URL parameters - Parameters affecting a request constructed from this URL. URL parameters are added to the end of the URL component and are separated by semi-colons. URL parameters take the form:
  parameter-name "=" parameter-value

See RFC2806 for more information on the use of TelURL's.

Version:

1.2

Author:

BEA Systems, NIST

Method Summary

String	getIsdnSubAddress() Returns the value of the isdnSubAddress parameter, or null if it is not set.
String	getPhoneContext() Returns the value of the phoneContext parameter, or null if it is not set.
String	getPhoneNumber() Returns the value of the phoneNumber parameter.
String	getPostDial() Returns the value of the postDial parameter, or null if it is not set.
boolean	isGlobal() Returns true if this TelURL is global i.e. if the TelURI has a global phone user.
void	setGlobal(boolean global) Sets phone user of this TelURL to be either global or local.
void	setIsdnSubAddress(String isdnSubAddress) Sets ISDN subaddress of this TelURL.
void	setPhoneContext(String phoneContext) Sets the phone context of this TelURL.
void	setPhoneNumber(String phoneNumber) Sets phone number of this TelURL.
void	setPostDial(String postDial) Sets post dial of this TelURL.
String	toString() This method returns the URI as a string.

Methods inherited from interface javax.sip.address.URI

clone, getScheme, isSipURI

Methods inherited from interface javax.sip.header.Parameters

getParameter, getParameterNames, removeParameter, setParameter

Method Detail

isGlobal

public boolean isGlobal()

Returns true if this TelURL is global i.e. if the TelURI has a global phone user.

Returns:

true if this TelURL represents a global phone user, and false otherwise.

setGlobal

public void setGlobal(boolean global)

Sets phone user of this TelURL to be either global or local. The default value is false, hence the TelURL is defaulted to local.

Parameters:

global - - the boolean value indicating if the TelURL has a global phone user.

setPostDial

public void setPostDial(String postDial)
                 throws ParseException

Sets post dial of this TelURL. The post-dial sequence describes what and when the local entity should send to the phone line.

Parameters:

postDial - - new value of the postDial parameter

Throws:

ParseException - which signals that an error has been reached unexpectedly while parsing the postDial value.

getPostDial

public String getPostDial()

Returns the value of the postDial parameter, or null if it is not set.

Returns:

the value of the postDial parameter

setPhoneNumber

public void setPhoneNumber(String phoneNumber)
                    throws ParseException

Sets phone number of this TelURL. The phone number may either be local or global determined by the isGlobal method in this interface. The phoneNumber argument should not contain the "+" associated with telephone numbers.

Parameters:

phoneNumber - - new value of the phoneNumber parameter

Throws:

ParseException - which signals that an error has been reached unexpectedly while parsing the phoneNumber value.

getPhoneNumber

public String getPhoneNumber()

Returns the value of the phoneNumber parameter. This method will not return the "+" associated with telephone numbers.

Returns:

the value of the phoneNumber parameter

setIsdnSubAddress

public void setIsdnSubAddress(String isdnSubAddress)
                       throws ParseException

Sets ISDN subaddress of this TelURL. If a subaddress is present, it is appended to the phone number after ";isub=".

Parameters:

isdnSubAddress - - new value of the isdnSubAddress parameter

Throws:

ParseException - which signals that an error has been reached unexpectedly while parsing the isdnSubAddress value.

getIsdnSubAddress

public String getIsdnSubAddress()

Returns the value of the isdnSubAddress parameter, or null if it is not set.

Returns:

the value of the isdnSubAddress parameter

setPhoneContext

public void setPhoneContext(String phoneContext)
                     throws ParseException

Sets the phone context of this TelURL.

Parameters:

phoneContext - - new value of the phoneContext parameter

Throws:

ParseException - which signals that an error has been reached unexpectedly while parsing the phoneContext value.

Since:

v1.2

getPhoneContext

public String getPhoneContext()

Returns the value of the phoneContext parameter, or null if it is not set.

Returns:

the value of the phoneContext parameter

Since:

v1.2

toString

public String toString()

This method returns the URI as a string.

Specified by:

toString in interface URI

Returns:

String The stringified version of the URI