ezvcard.property
Class Telephone

java.lang.Object
  ezvcard.property.VCardProperty
      ezvcard.property.Telephone

All Implemented Interfaces:

HasAltId, Comparable<VCardProperty>

public class Telephone
extends VCardProperty
implements HasAltId

A telephone number.

Code sample

 VCard vcard = new VCard();
 Telephone tel = new Telephone("(123) 555-6789");
 tel.addType(TelephoneType.HOME);
 tel.setPref(2); //the second-most preferred
 vcard.addTelephoneNumber(tel);
 
 TelUri uri = new TelUri.Builder("+1-800-555-9876").extension("111").build();
 tel = new Telephone(uri);
 tel.addType(TelephoneType.WORK);
 tel.setPref(1); //the most preferred
 vcard.addTelephoneNumber(tel);
 

Property name: TEL

Supported versions: 2.1, 3.0, 4.0

Author:

Michael Angstadt

Field Summary

Fields inherited from class ezvcard.property.VCardProperty

group, parameters

Constructor Summary

Telephone(String text)
Creates a telephone property.

Telephone(TelUri uri)
Creates a telephone property.

Method Summary

protected void	_validate(List<Warning> warnings, VCardVersion version, VCard vcard) Checks the property for data consistency problems or deviations from the spec.
void	addPid(int localId, int clientPidMapRef) Adds a PID value.
void	addType(TelephoneType type) Adds a TYPE parameter.
String	getAltId() Gets the property's ALTID parameter.
List<Integer[]>	getPids() Gets all PID values.
Integer	getPref() Gets the preference value.
String	getText() Gets the telephone number as a text value.
Set<TelephoneType>	getTypes() Gets all the TYPE parameters.
TelUri	getUri() Gets a "tel" URI representing the phone number.
void	removePids() Removes all PID values.
void	removeType(TelephoneType type) Removes a TYPE parameter.
void	setAltId(String altId) Sets the property's ALTID parameter.
void	setPref(Integer pref) Sets the preference value.
void	setText(String text) Sets the telephone number as a text value.
void	setUri(TelUri uri) Sets a "tel" URI representing the phone number.

Methods inherited from class ezvcard.property.VCardProperty

_supportedVersions, addParameter, compareTo, getGroup, getParameter, getParameters, getParameters, getSupportedVersions, removeParameter, setGroup, setParameter, setParameters, validate

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

Telephone

public Telephone(String text)

Creates a telephone property.

Parameters:

text - the telephone number (e.g. "(123) 555-6789")

Telephone

public Telephone(TelUri uri)

Creates a telephone property.

Parameters:

uri - a "tel" URI representing the telephone number (vCard 4.0 only)

Method Detail

getText

public String getText()

Gets the telephone number as a text value.

Returns:

the telephone number or null if the text value is not set

setText

public void setText(String text)

Sets the telephone number as a text value.

Parameters:

text - the telephone number

getUri

public TelUri getUri()

Gets a "tel" URI representing the phone number.

Supported versions: 4.0

Returns:

the "tel" URI or null if it is not set

setUri

public void setUri(TelUri uri)

Sets a "tel" URI representing the phone number.

Supported versions: 4.0

Parameters:

uri - the "tel" URI

getTypes

public Set<TelephoneType> getTypes()

Gets all the TYPE parameters.

Returns:

the TYPE parameters or empty set if there are none

addType

public void addType(TelephoneType type)

Adds a TYPE parameter.

Parameters:

type - the TYPE parameter to add

removeType

public void removeType(TelephoneType type)

Removes a TYPE parameter.

Parameters:

type - the TYPE parameter to remove

getPids

public List<Integer[]> getPids()

Description copied from class: VCardProperty

Gets all PID values.

Supported versions: 4.0

Returns:

the PID values or empty set if there are none

See Also:

VCardParameters.getPids()

addPid

public void addPid(int localId,
                   int clientPidMapRef)

Description copied from class: VCardProperty

Adds a PID value.

Supported versions: 4.0

Parameters:

localId - the local ID

clientPidMapRef - the ID used to reference the property's globally unique identifier in the CLIENTPIDMAP property.

See Also:

VCardParameters.addPid(int, int)

removePids

public void removePids()

Description copied from class: VCardProperty

Removes all PID values.

Supported versions: 4.0

See Also:

VCardParameters.removePids()

getPref

public Integer getPref()

Description copied from class: VCardProperty

Gets the preference value. The lower the number, the more preferred this property instance is compared with other properties in the same vCard of the same type. If a property doesn't have a preference value, then it is considered the least preferred.

Supported versions: 4.0

Returns:

the preference value or null if it doesn't exist

See Also:

VCardParameters.getPref()

setPref

public void setPref(Integer pref)

Description copied from class: VCardProperty

Sets the preference value. The lower the number, the more preferred this property instance is compared with other properties in the same vCard of the same type. If a property doesn't have a preference value, then it is considered the least preferred.

Supported versions: 4.0

Parameters:

pref - the preference value or null to remove

See Also:

VCardParameters.setPref(java.lang.Integer)

getAltId

public String getAltId()

Description copied from interface: HasAltId

Gets the property's ALTID parameter.

Supported versions: 4.0

Specified by:

getAltId in interface HasAltId

Returns:

the ALTID or null if it doesn't exist

See Also:

VCardParameters.getAltId()

setAltId

public void setAltId(String altId)

Description copied from interface: HasAltId

Sets the property's ALTID parameter.

Supported versions: 4.0

Specified by:

setAltId in interface HasAltId

Parameters:

altId - the ALTID or null to remove

See Also:

VCardParameters.setAltId(java.lang.String)

_validate

protected void _validate(List<Warning> warnings,
                         VCardVersion version,
                         VCard vcard)

Description copied from class: VCardProperty

Checks the property for data consistency problems or deviations from the spec. Meant to be overridden by child classes that wish to provide validation logic.

Overrides:

_validate in class VCardProperty

Parameters:

warnings - the list to add the warnings to

version - the version to check the property against

vcard - the vCard this property belongs to