org.opencrx.application.uses.ezvcard.util

Class TelUri

java.lang.Object

org.opencrx.application.uses.ezvcard.util.TelUri

public final class TelUri
extends java.lang.Object

Represents a URI for encoding telephone numbers.

Example tel URI: tel:+1-212-555-0101

This class is immutable. Use the TelUri.Builder object to construct a new instance, or the parse(java.lang.String) method to parse a tel URI string.

Examples:

 TelUri uri = new TelUri.Builder("+1-212-555-0101").extension("123").build();
 TelUri uri = TelUri.parse("tel:+1-212-555-0101;ext=123");
 TelUri copy = new TelUri.Builder(original).extension("124").build();
 

Author:

Michael Angstadt

See Also:

RFC 3966

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static class	TelUri.Builder

Method Summary

Modifier and Type	Method and Description
boolean	equals(java.lang.Object obj)
java.lang.String	getExtension() Gets the extension.
java.lang.String	getIsdnSubaddress() Gets the ISDN sub address.
java.lang.String	getNumber() Gets the phone number.
java.lang.String	getParameter(java.lang.String name) Gets a parameter value.
java.util.Map<java.lang.String,java.lang.String>	getParameters() Gets all parameters.
java.lang.String	getPhoneContext() Gets the phone context.
int	hashCode()
static TelUri	parse(java.lang.String uri) Parses a tel URI.
java.lang.String	toString() Converts this tel URI to its string representation.

Methods inherited from class java.lang.Object

clone, finalize, getClass, notify, notifyAll, wait, wait, wait

Method Detail

parse

public static TelUri parse(java.lang.String uri)

Parses a tel URI.

Parameters:

uri - the URI

Returns:

the parsed tel URI

Throws:

java.lang.IllegalArgumentException - if the URI cannot be parsed

getNumber

public java.lang.String getNumber()

Gets the phone number.

Returns:

the phone number

getPhoneContext

public java.lang.String getPhoneContext()

Gets the phone context.

Returns:

the phone context (e.g. "example.com") or null if not set

getExtension

public java.lang.String getExtension()

Gets the extension.

Returns:

the extension (e.g. "101") or null if not set

getIsdnSubaddress

public java.lang.String getIsdnSubaddress()

Gets the ISDN sub address.

Returns:

the ISDN sub address or null if not set

getParameter

public java.lang.String getParameter(java.lang.String name)

Gets a parameter value.

Parameters:

name - the parameter name

Returns:

the parameter value or null if not found

getParameters

public java.util.Map<java.lang.String,java.lang.String> getParameters()

Gets all parameters.

Returns:

all parameters

toString

public java.lang.String toString()

Converts this tel URI to its string representation.

Overrides:

toString in class java.lang.Object

Returns:

the tel URI's string representation

hashCode

public int hashCode()

Overrides:

hashCode in class java.lang.Object

equals

public boolean equals(java.lang.Object obj)

Overrides:

equals in class java.lang.Object