com.compoze.contact
Class Contact

java.lang.Object

  |

  +--com.compoze.contact.Contact

All Implemented Interfaces:

java.io.Serializable

public class Contact

extends java.lang.Object

implements java.io.Serializable

This class represents a contact.

To add and search for contacts, see the Contacts collection class. Once the contact is obtained, its accessor methods may be called to set and get properties. The update() method must be called to store any changes to the server.

Contact conforms to the vCard specification (RFC #2426). To generate a vCard compliant representation of a contact, user toVcardString().

The following table contains the mappings from Contact properties to their corresponding Java methods:

Contact Property	Java Methods
ContactProperty.ANNIVERSARY	getAnniversary()
ContactProperty.ASSISTANT_NAME	getAssistantName()
ContactProperty.AUTHOR	getAuthor()
ContactProperty.BIRTHDAY	getBirthday()
ContactProperty.COMPANY_NAME	getCompanyName()
ContactProperty.CATEGORY	getCategory()
ContactProperty.DATE_CREATED	getDateCreated()
ContactProperty.DATE_LAST_MODIFIED	getDateLastModified()
ContactProperty.DEPARTMENT_NAME	getDepartmentName()
ContactProperty.FIRST_NAME	getFirstName()
ContactProperty.MIDDLE_NAME	getMiddleName()
ContactProperty.LAST_NAME	getLastName()
ContactProperty.NAME_PREFIX	getNamePrefix()
ContactProperty.NAME_SUFFIX	getNameSuffix()
ContactProperty.NICKNAME	getNickname()
ContactProperty.MANAGER_NAME	getManagerName()
ContactProperty.OFFICE_LOCATION	getOfficeLocation()
ContactProperty.TITLE	getTitle()
ContactProperty.SPOUSE_NAME	getSpouseName()
ContactProperty.WEB_PAGE	getWebPage()
ContactProperty.FTP_SITE	getFtpSite()
ContactProperty.FLAG	getFlag()
ContactProperty.CAR_TELEPHONE_NUMBER	getCarTelephoneNumber()
ContactProperty.MOBILE_TELEPHONE_NUMBER	getMobileTelephoneNumber()
ContactProperty.PAGER_TELEPHONE_NUMBER	getPagerTelephoneNumber()
ContactProperty.OTHER_TELEPHONE_NUMBER	getOtherTelephoneNumber()
ContactProperty.BUSINESS_TELEPHONE_NUMBER	getBusinessTelephoneNumber()
ContactProperty.ASSISTANT_TELEPHONE_NUMBER	getAssistantTelephoneNumber()
ContactProperty.HOME_TELEPHONE_NUMBER	getHomeTelephoneNumber()
ContactProperty.HOME_FAX_NUMBER	getHomeFaxNumber()
ContactProperty.BUSINESS_FAX_NUMBER	getBusinessFaxNumber()
ContactProperty.EMAIL_ADDRESS	getEmailAddress()
ContactProperty.EMAIL2_ADDRESS	getEmail2Address()
ContactProperty.EMAIL3_ADDRESS	getEmail3Address()
ContactProperty.HOME_ADDRESS_POST_OFFICE_BOX	getHomeAddressPostOfficeBox()
ContactProperty.HOME_ADDRESS_STREET	getHomeAddressStreet()
ContactProperty.HOME_ADDRESS_CITY	getHomeAddressCity()
ContactProperty.HOME_ADDRESS_STATE_OR_PROVINCE	getHomeAddressStateOrProvince()
ContactProperty.HOME_ADDRESS_POSTAL_CODE	getHomeAddressPostalCode()
ContactProperty.HOME_ADDRESS_COUNTRY	getHomeAddressCountry()
ContactProperty.BUSINESS_ADDRESS_POST_OFFICE_BOX	getBusinessAddressPostOfficeBox()
ContactProperty.BUSINESS_ADDRESS_STREET	getBusinessAddressStreet()
ContactProperty.BUSINESS_ADDRESS_CITY	getBusinessAddressCity()
ContactProperty.BUSINESS_ADDRESS_STATE_OR_PROVINCE	getBusinessAddressStateOrProvince()
ContactProperty.BUSINESS_ADDRESS_POSTAL_CODE	getBusinessAddressPostalCode()
ContactProperty.BUSINESS_ADDRESS_COUNTRY	getBusinessAddressCountry()
ContactProperty.OTHER_ADDRESS_POST_OFFICE_BOX	getOtherAddressPostOfficeBox()
ContactProperty.OTHER_ADDRESS_STREET	getOtherAddressStreet()
ContactProperty.OTHER_ADDRESS_CITY	getOtherAddressCity()
ContactProperty.OTHER_ADDRESS_STATE_OR_PROVINCE	getOtherAddressStateOrProvince()
ContactProperty.OTHER_ADDRESS_POSTAL_CODE	getOtherAddressPostalCode()
ContactProperty.OTHER_ADDRESS_COUNTRY	getOtherAddressCountry()
ContactProperty.PICTURE_IMAGE	getPictureImage()
ContactProperty.CUSTOM_NUM1	getCustomNum1()
ContactProperty.CUSTOM_NUM2	getCustomNum2()
ContactProperty.CUSTOM_NUM3	getCustomNum3()
ContactProperty.CUSTOM_STR1	getCustomStr1()
ContactProperty.CUSTOM_STR2	getCustomStr2()
ContactProperty.CUSTOM_STR3	getCustomStr3()
ContactProperty.CUSTOM_STR4	getCustomStr4()

See Also:

Serialized Form

Constructor Summary

Contact()
Constructor.

Method Summary

void	clearFlag() Clears the flag on this contact.
void	delete() Updates the contact (saves the contact entry).
void	delete(boolean bArchive) Deletes the contact.
boolean	equals(java.lang.Object obj) Checks if the specified object is "equal to" this one.
void	flag(Flag flag) Flags this contact with the specified flag.
AccessManager	getAccessManager() Gets the access manager for this contact.
java.lang.String	getAddressCity() Gets the city of the contact which is the mailing address.
java.lang.String	getAddressCountry() Gets the country of the contact which is the mailing address.
java.lang.String	getAddressPostalCode() Gets the postal code of the contact which is the mailing address.
java.lang.String	getAddressPostOfficeBox() Gets the post office box of the contact which is the mailing address.
java.lang.String	getAddressStateOrProvince() Gets the state or province of the contact which is the mailing address.
java.lang.String	getAddressStreet() Gets the street address of the contact which is the mailing address.
java.util.Date	getAnniversary() Gets the anniversary for the contact.
java.lang.String	getAssistantName() Gets the assistant's name of the contact.
java.lang.String	getAssistantTelephoneNumber() Gets the assistant telephone number of the contact.
java.lang.String	getAuthor() Gets the name of the author.
java.util.Date	getBirthday() Gets the birthday for the contact.
java.lang.String	getBusinessAddressCity() Gets the business address city of the contact.
java.lang.String	getBusinessAddressCountry() Gets the business address country of the contact.
java.lang.String	getBusinessAddressPostalCode() Gets the business address postal code of the contact.
java.lang.String	getBusinessAddressPostOfficeBox() Gets the business address post office box of the contact.
java.lang.String	getBusinessAddressStateOrProvince() Gets the business address state or province of the contact.
java.lang.String	getBusinessAddressStreet() Gets the business address street of the contact.
java.lang.String	getBusinessFaxNumber() Gets the business fax number of the contact.
java.lang.String	getBusinessTelephoneNumber() Gets the business telephone number of the contact.
java.lang.String	getCarTelephoneNumber() Gets the car telephone number of the contact.
Category	getCategory() Gets the category of the contact.
java.lang.String	getCompanyName() Gets the company name of the contact.
long	getCustomNum1() Gets the custom number1 field of the contact.
long	getCustomNum2() Gets the custom number2 field of the contact.
long	getCustomNum3() Gets the custom number3 field of the contact.
java.lang.String	getCustomStr1() Gets the custom string1 field of the contact.
java.lang.String	getCustomStr2() Gets the custom string2 field of the contact.
java.lang.String	getCustomStr3() Gets the custom string3 field of the contact.
java.lang.String	getCustomStr4() Gets the custom string4 field of the contact.
java.util.Date	getDateCreated() Gets the date the contact was created.
java.util.Date	getDateLastModified() Gets the date the contact was last modified.
java.lang.String	getDepartmentName() Gets the department name of the contact.
java.lang.String	getEmail2Address() Gets the email2 address of the contact.
java.lang.String	getEmail3Address() Gets the email3 address of the contact.
java.lang.String	getEmailAddress() Gets the email address of the contact.
java.lang.String	getFirstName()
Flag	getFlag() Gets the flag of the contact.
java.lang.String	getFtpSite() Gets the ftp site of the contact.
java.lang.String	getGivenName() Gets the given name for a contact.
java.lang.String	getHomeAddressCity() Gets the home address city of the contact.
java.lang.String	getHomeAddressCountry() Gets the home address country of the contact.
java.lang.String	getHomeAddressPostalCode() Gets the home address postal code of the contact.
java.lang.String	getHomeAddressPostOfficeBox() Gets the home address post office box of the contact.
java.lang.String	getHomeAddressStateOrProvince() Gets the home address state or province of the contact.
java.lang.String	getHomeAddressStreet() Gets the home address street of the contact.
java.lang.String	getHomeFaxNumber() Gets the home fax number of the contact.
java.lang.String	getHomeTelephoneNumber() Gets the home telephone number of the contact.
long	getID() Gets the unique identifier (id) of the contact.
java.lang.String	getLastName() Gets the last name of the contact.
MailingAddress	getMailingAddress() Gets the mailing address of the contact.
java.lang.String	getManagerName() Gets the manager's name of the contact.
java.lang.String	getMiddleName() Gets the middle name of the contact.
java.lang.String	getMobileTelephoneNumber() Gets the mobile telephone number of the contact.
java.lang.String	getNamePrefix() Gets the name prefix of the contact.
java.lang.String	getNameSuffix() Gets the name suffix of the contact.
java.lang.String	getNickname() Gets the nickname of the contact.
java.lang.String	getOfficeLocation() Gets the office location of the contact.
java.lang.String	getOtherAddressCity() Gets the other address city of the contact.
java.lang.String	getOtherAddressCountry() Gets the other address country of the contact.
java.lang.String	getOtherAddressPostalCode() Gets the other address postal code of the contact.
java.lang.String	getOtherAddressPostOfficeBox() Gets the other address post office box of the contact.
java.lang.String	getOtherAddressStateOrProvince() Gets the other address state or province of the contact.
java.lang.String	getOtherAddressStreet() Gets the other address street of the contact.
java.lang.String	getOtherTelephoneNumber() Gets the other telephone number of the contact.
java.lang.String	getPagerTelephoneNumber() Gets the pager telephone number of the contact.
BinaryData	getPictureImage() Gets the picture image for the contact.
PrimaryTelephoneNumber	getPrimaryTelephoneNumber() Gets the setting for the primary telephone number.
java.lang.String	getSpouseName() Gets the spouse's name of the contact.
java.lang.String	getTelephoneNumber() Gets the telephone number of the contact which is the primary telephone number.
java.lang.String	getTitle() Gets the title of the contact.
java.lang.String	getWebPage() Gets the web page of the contact.
void	setAnniversary(java.util.Date anniversary) Sets the anniversary for the contact.
void	setAssistantName(java.lang.String sAssistantName) Sets the assistant's name of the contact.
void	setAssistantTelephoneNumber(java.lang.String sNumber) Sets the assistant telephone number of the contact.
void	setBirthday(java.util.Date birthday) Sets the birthday for the contact.
void	setBusinessAddressCity(java.lang.String sCity) Sets the business address city of the contact.
void	setBusinessAddressCountry(java.lang.String sCountry) Sets the business address country of the contact.
void	setBusinessAddressPostalCode(java.lang.String sPostalCode) Sets the business address postal code of the contact.
void	setBusinessAddressPostOfficeBox(java.lang.String sPostOfficeBox) Sets the business address post office box of the contact.
void	setBusinessAddressStateOrProvince(java.lang.String sStateOrProvince) Sets the business address state or province of the contact.
void	setBusinessAddressStreet(java.lang.String sStreet) Sets the business address street of the contact.
void	setBusinessFaxNumber(java.lang.String sNumber) Sets the business fax number of the contact.
void	setBusinessTelephoneNumber(java.lang.String sNumber) Sets the business telephone number of the contact.
void	setCarTelephoneNumber(java.lang.String sNumber) Sets the car telephone number of the contact.
void	setCategory(Category category) Sets the category of the contact.
void	setCompanyName(java.lang.String sCompanyName) Sets the company name of the contact.
void	setCustomNum1(long lCustomNum1) Sets the custom number1 field of the contact.
void	setCustomNum2(long lCustomNum2) Sets the custom number2 field of the contact.
void	setCustomNum3(long lCustomNum3) Sets the custom number3 field of the contact.
void	setCustomStr1(java.lang.String sCustomStr1) Sets the custom string1 field of the contact.
void	setCustomStr2(java.lang.String sCustomStr2) Sets the custom string2 field of the contact.
void	setCustomStr3(java.lang.String sCustomStr3) Sets the custom string3 field of the contact.
void	setCustomStr4(java.lang.String sCustomStr4) Sets the custom string4 field of the contact.
void	setDepartmentName(java.lang.String sDepartmentName) Sets the department name of the contact.
void	setEmail2Address(java.lang.String sAddress) Sets the email2 address of the contact.
void	setEmail3Address(java.lang.String sAddress) Sets the email3 address of the contact.
void	setEmailAddress(java.lang.String sAddress) Sets the email address of the contact.
void	setFirstName(java.lang.String sFirstName) Sets the first name of the contact.
void	setFtpSite(java.lang.String sFtpSite) Sets the ftp site of the contact.
void	setHomeAddressCity(java.lang.String sCity) Sets the home address city of the contact.
void	setHomeAddressCountry(java.lang.String sCountry) Sets the home address country of the contact.
void	setHomeAddressPostalCode(java.lang.String sPostalCode) Sets the home address postal code of the contact.
void	setHomeAddressPostOfficeBox(java.lang.String sPostOfficeBox) Sets the home address post office box of the contact.
void	setHomeAddressStateOrProvince(java.lang.String sStateOrProvince) Sets the home address state or province of the contact.
void	setHomeAddressStreet(java.lang.String sStreet) Sets the home address street of the contact.
void	setHomeFaxNumber(java.lang.String sNumber) Sets the home fax number of the contact.
void	setHomeTelephoneNumber(java.lang.String sNumber) Sets the home telephone number of the contact.
void	setLastName(java.lang.String sLastName) Sets the last name of the contact.
void	setMailingAddress(MailingAddress address) Sets the mailing address of the contact.
void	setManagerName(java.lang.String sManagerName) Sets the manager's name of the contact.
void	setMiddleName(java.lang.String sMiddleName) Sets the middle name of the contact.
void	setMobileTelephoneNumber(java.lang.String sNumber) Sets the mobile telephone number of the contact.
void	setNamePrefix(java.lang.String sNamePrefix) Sets the name prefix of the contact.
void	setNameSuffix(java.lang.String sNameSuffix) Sets the name suffix of the contact.
void	setNickname(java.lang.String sNickname) Sets the nickname of the contact.
void	setOfficeLocation(java.lang.String sOfficeLocation) Sets the office location of the contact.
void	setOtherAddressCity(java.lang.String sCity) Sets the other address city of the contact.
void	setOtherAddressCountry(java.lang.String sCountry) Sets the other address country of the contact.
void	setOtherAddressPostalCode(java.lang.String sPostalCode) Sets the other address postal code of the contact.
void	setOtherAddressPostOfficeBox(java.lang.String sPostOfficeBox) Sets the other address post office box of the contact.
void	setOtherAddressStateOrProvince(java.lang.String sStateOrProvince) Sets the other address state or province of the contact.
void	setOtherAddressStreet(java.lang.String sStreet) Sets the other address street of the contact.
void	setOtherTelephoneNumber(java.lang.String sNumber) Sets the other telephone number of the contact.
void	setPagerTelephoneNumber(java.lang.String sNumber) Sets the pager telephone number of the contact.
void	setPictureImage(BinaryData image) Sets the picture image for the contact.
void	setPrimaryTelephoneNumber(PrimaryTelephoneNumber primary) Sets the primary telephone number.
void	setSpouseName(java.lang.String sSpouseName) Sets the spouse's name of the contact.
void	setTitle(java.lang.String sTitle) Sets the title of the contact.
void	setWebPage(java.lang.String sWebPage) Sets the web page of the contact.
java.lang.String	toString() Returns a string representation of the object.
java.lang.String	toVcardString() Creates a string that contains the vCard compliant (RFC #2426) representation of the contact.
boolean	update() Updates the contact (saves the contact entry).
boolean	update(boolean bForce) Updates the contact (saves the contact entry).

Methods inherited from class java.lang.Object

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

Constructor Detail

Contact

public Contact()

Constructor.

Method Detail

getID

public long getID()

Gets the unique identifier (id) of the contact. This is non-zero number that uniquely identifies the contact.

Returns:

the id of the contact

getFirstName

public java.lang.String getFirstName()

setFirstName

public void setFirstName(java.lang.String sFirstName)

Sets the first name of the contact.

Parameters:

sFirstName - the first name of the contact or null if no first name is set

getCompanyName

public java.lang.String getCompanyName()

Gets the company name of the contact.

Returns:

the company name of the contact or null if no company name is set

setCompanyName

public void setCompanyName(java.lang.String sCompanyName)

Sets the company name of the contact.

Parameters:

sCompanyName - the company name of the contact or null if no company name is set

getCategory

public Category getCategory()

Gets the category of the contact.

Returns:

the category of the contact or null if no category is set

setCategory

public void setCategory(Category category)

Sets the category of the contact.

Parameters:

category - the category of the contact or null for no category

getDepartmentName

public java.lang.String getDepartmentName()

Gets the department name of the contact.

Returns:

the department name of the contact or null if no department name is set

setDepartmentName

public void setDepartmentName(java.lang.String sDepartmentName)

Sets the department name of the contact.

Parameters:

sDepartmentName - the department name of the contact or null if no department name is set

getManagerName

public java.lang.String getManagerName()

Gets the manager's name of the contact.

Returns:

the manager's name of the contact or null if no manager's name is set

setManagerName

public void setManagerName(java.lang.String sManagerName)

Sets the manager's name of the contact.

Parameters:

sManagerName - the manager's name of the contact or null if no manager's name is set

getAssistantName

public java.lang.String getAssistantName()

Gets the assistant's name of the contact.

Returns:

the assistant's name of the contact or null if no assistant's name is set

setAssistantName

public void setAssistantName(java.lang.String sAssistantName)

Sets the assistant's name of the contact.

Parameters:

sAssistantName - the assistant's name of the contact or null if no assistant's name is set

getOfficeLocation

public java.lang.String getOfficeLocation()

Gets the office location of the contact.

Returns:

the office location of the contact or null if no office location is set

setOfficeLocation

public void setOfficeLocation(java.lang.String sOfficeLocation)

Sets the office location of the contact.

Parameters:

sOfficeLocation - the office location of the contact or null if no office location is set

getTitle

public java.lang.String getTitle()

Gets the title of the contact.

Returns:

the title of the contact or null if no title is set

setTitle

public void setTitle(java.lang.String sTitle)

Sets the title of the contact.

Parameters:

sTitle - the title of the contact or null if no title is set

getBirthday

public java.util.Date getBirthday()

Gets the birthday for the contact.

Returns:

the birthday for the contact or null if no birthday is set

setBirthday

public void setBirthday(java.util.Date birthday)

Sets the birthday for the contact.

Parameters:

birthday - the birthday for the contact or null if no birthday is set

getAnniversary

public java.util.Date getAnniversary()

Gets the anniversary for the contact.

Returns:

the anniversary of the contact or null if no anniversary is set

setAnniversary

public void setAnniversary(java.util.Date anniversary)

Sets the anniversary for the contact.

Parameters:

anniversary - the anniversary for the contact or null if no anniversary is set

getSpouseName

public java.lang.String getSpouseName()

Gets the spouse's name of the contact.

Returns:

the spouse's name of the contact or null if no spouse's name is set

setSpouseName

public void setSpouseName(java.lang.String sSpouseName)

Sets the spouse's name of the contact.

Parameters:

sSpouseName - the anniversary of the contact or null if no anniversary is set

getWebPage

public java.lang.String getWebPage()

Gets the web page of the contact.

Returns:

the web page of the contact or null if no web page is set

setWebPage

public void setWebPage(java.lang.String sWebPage)

Sets the web page of the contact.

Parameters:

sWebPage - the web page of the contact or null if no web page is set

getFtpSite

public java.lang.String getFtpSite()

Gets the ftp site of the contact.

Returns:

the ftp site of the contact or null if no ftp site is set

setFtpSite

public void setFtpSite(java.lang.String sFtpSite)

Sets the ftp site of the contact.

Parameters:

sFtpSite - the ftp site of the contact or null if no ftp site is set

getFlag

public Flag getFlag()

Gets the flag of the contact.

Returns:

the flag of the contact or null for none

flag

public void flag(Flag flag)

Flags this contact with the specified flag.

Parameters:

flag - the flag

clearFlag

public void clearFlag()

Clears the flag on this contact.

getCarTelephoneNumber

public java.lang.String getCarTelephoneNumber()

Gets the car telephone number of the contact.

Returns:

the car telephone number of the contact or null if no car telephone number is set

setCarTelephoneNumber

public void setCarTelephoneNumber(java.lang.String sNumber)

Sets the car telephone number of the contact.

Parameters:

sNumber - the car telephone number of the contact or null for no car telephone number

getMobileTelephoneNumber

public java.lang.String getMobileTelephoneNumber()

Gets the mobile telephone number of the contact.

Returns:

the mobile telephone number of the contact or null if no mobile telephone number is set

setMobileTelephoneNumber

public void setMobileTelephoneNumber(java.lang.String sNumber)

Sets the mobile telephone number of the contact.

Parameters:

sNumber - the mobile telephone number of the contact or null for no mobile telephone number

getPagerTelephoneNumber

public java.lang.String getPagerTelephoneNumber()

Gets the pager telephone number of the contact.

Returns:

the pager telephone number of the contact or null if no pager telephone number is set

setPagerTelephoneNumber

public void setPagerTelephoneNumber(java.lang.String sNumber)

Sets the pager telephone number of the contact.

Parameters:

sNumber - the pager telephone number of the contact or null for no pager telephone number

getOtherTelephoneNumber

public java.lang.String getOtherTelephoneNumber()

Gets the other telephone number of the contact.

Returns:

the other telephone number of the contact or null if no other telephone number is set

setOtherTelephoneNumber

public void setOtherTelephoneNumber(java.lang.String sNumber)

Sets the other telephone number of the contact.

Parameters:

sNumber - the other telephone number of the contact or null for no other telephone number

getBusinessTelephoneNumber

public java.lang.String getBusinessTelephoneNumber()

Gets the business telephone number of the contact.

Returns:

the business telephone number of the contact or null if no business telephone number is set

setBusinessTelephoneNumber

public void setBusinessTelephoneNumber(java.lang.String sNumber)

Sets the business telephone number of the contact.

Parameters:

sNumber - the business telephone number of the contact or null for no business telephone number

getAssistantTelephoneNumber

public java.lang.String getAssistantTelephoneNumber()

Gets the assistant telephone number of the contact.

Returns:

the assistant telephone number of the contact or null if no assistant telephone number is set

setAssistantTelephoneNumber

public void setAssistantTelephoneNumber(java.lang.String sNumber)

Sets the assistant telephone number of the contact.

Parameters:

sNumber - the assistant telephone number of the contact or null for no assistant telephone number

getHomeTelephoneNumber

public java.lang.String getHomeTelephoneNumber()

Gets the home telephone number of the contact.

Returns:

the home telephone number of the contact or null if no home telephone number is set

setHomeTelephoneNumber

public void setHomeTelephoneNumber(java.lang.String sNumber)

Sets the home telephone number of the contact.

Parameters:

sNumber - the home telephone number of the contact or null for no home telephone number

getHomeFaxNumber

public java.lang.String getHomeFaxNumber()

Gets the home fax number of the contact.

Returns:

the home fax number of the contact or null if no home fax number is set

setHomeFaxNumber

public void setHomeFaxNumber(java.lang.String sNumber)

Sets the home fax number of the contact.

Parameters:

sNumber - the home fax number of the contact or null for no home fax number

getBusinessFaxNumber

public java.lang.String getBusinessFaxNumber()

Gets the business fax number of the contact.

Returns:

the business fax number of the contact or null if no business fax number is set

setBusinessFaxNumber

public void setBusinessFaxNumber(java.lang.String sNumber)

Sets the business fax number of the contact.

Parameters:

sNumber - the business fax number of the contact or null for no business fax number

getEmailAddress

public java.lang.String getEmailAddress()

Gets the email address of the contact.

Returns:

the email address of the contact or null if no email addressis set

setEmailAddress

public void setEmailAddress(java.lang.String sAddress)

Sets the email address of the contact.

Parameters:

sAddress - the email address of the contact or null for no email address

getEmail2Address

public java.lang.String getEmail2Address()

Gets the email2 address of the contact.

Returns:

the email2 address of the contact or null if no email2 addressis set

setEmail2Address

public void setEmail2Address(java.lang.String sAddress)

Sets the email2 address of the contact.

Parameters:

sAddress - the email2 address of the contact or null for no email2 address

getEmail3Address

public java.lang.String getEmail3Address()

Gets the email3 address of the contact.

Returns:

the email3 address of the contact or null if no email3 addressis set

setEmail3Address

public void setEmail3Address(java.lang.String sAddress)

Sets the email3 address of the contact.

Parameters:

sAddress - the email3 address of the contact or null for no email3 address

getHomeAddressPostOfficeBox

public java.lang.String getHomeAddressPostOfficeBox()

Gets the home address post office box of the contact.

Returns:

the home address post office box of the contact or null if no home address post office box set

setHomeAddressPostOfficeBox

public void setHomeAddressPostOfficeBox(java.lang.String sPostOfficeBox)

Sets the home address post office box of the contact.

Parameters:

sPostOfficeBox - the home address post office box of the contact or null for no home address post office box

getHomeAddressStreet

public java.lang.String getHomeAddressStreet()

Gets the home address street of the contact.

Returns:

the home address street of the contact or null if no home address street set

setHomeAddressStreet

public void setHomeAddressStreet(java.lang.String sStreet)

Sets the home address street of the contact.

Parameters:

sStreet - the home address street of the contact or null for no home address street

getHomeAddressCity

public java.lang.String getHomeAddressCity()

Gets the home address city of the contact.

Returns:

the home address city of the contact or null if no home address city set

setHomeAddressCity

public void setHomeAddressCity(java.lang.String sCity)

Sets the home address city of the contact.

Parameters:

sCity - the home address city of the contact or null for no home address city

getHomeAddressStateOrProvince

public java.lang.String getHomeAddressStateOrProvince()

Gets the home address state or province of the contact.

Returns:

the home address state or province of the contact or null if no home address state or province set

setHomeAddressStateOrProvince

public void setHomeAddressStateOrProvince(java.lang.String sStateOrProvince)

Sets the home address state or province of the contact.

Parameters:

sStateOrProvince - the home address state or province of the contact or null for no home address state or province

getHomeAddressPostalCode

public java.lang.String getHomeAddressPostalCode()

Gets the home address postal code of the contact.

Returns:

the home address postal code of the contact or null if no home address postal code set

setHomeAddressPostalCode

public void setHomeAddressPostalCode(java.lang.String sPostalCode)

Sets the home address postal code of the contact.

Parameters:

sPostalCode - the home address postal code of the contact or null for no home address postal code

getHomeAddressCountry

public java.lang.String getHomeAddressCountry()

Gets the home address country of the contact.

Returns:

the home address country of the contact or null if no home address country set

setHomeAddressCountry

public void setHomeAddressCountry(java.lang.String sCountry)

Sets the home address country of the contact.

Parameters:

sAddress - the home address country of the contact or null for no home address country

getBusinessAddressPostOfficeBox

public java.lang.String getBusinessAddressPostOfficeBox()

Gets the business address post office box of the contact.

Returns:

the business address post office box of the contact or null if no business address post office box set

setBusinessAddressPostOfficeBox

public void setBusinessAddressPostOfficeBox(java.lang.String sPostOfficeBox)

Sets the business address post office box of the contact.

Parameters:

sPostOfficeBox - the business address post office box of the contact or null for no business address post office box

getBusinessAddressStreet

public java.lang.String getBusinessAddressStreet()

Gets the business address street of the contact.

Returns:

the business address street of the contact or null if no business address street set

setBusinessAddressStreet

public void setBusinessAddressStreet(java.lang.String sStreet)

Sets the business address street of the contact.

Parameters:

sStreet - the business address street of the contact or null for no business address street

getBusinessAddressCity

public java.lang.String getBusinessAddressCity()

Gets the business address city of the contact.

Returns:

the business address city of the contact or null if no business address city set

setBusinessAddressCity

public void setBusinessAddressCity(java.lang.String sCity)

Sets the business address city of the contact.

Parameters:

sCity - the business address city of the contact or null for no business address city

getBusinessAddressStateOrProvince

public java.lang.String getBusinessAddressStateOrProvince()

Gets the business address state or province of the contact.

Returns:

the business address state or province of the contact or null if no business address state or province set

setBusinessAddressStateOrProvince

public void setBusinessAddressStateOrProvince(java.lang.String sStateOrProvince)

Sets the business address state or province of the contact.

Parameters:

sStateOrProvince - the business address state or province of the contact or null for no business address state or province

getBusinessAddressPostalCode

public java.lang.String getBusinessAddressPostalCode()

Gets the business address postal code of the contact.

Returns:

the business address postal code of the contact or null if no business address postal code set

setBusinessAddressPostalCode

public void setBusinessAddressPostalCode(java.lang.String sPostalCode)

Sets the business address postal code of the contact.

Parameters:

sPostalCode - the business address postal code of the contact or null for no business address postal code

getBusinessAddressCountry

public java.lang.String getBusinessAddressCountry()

Gets the business address country of the contact.

Returns:

the business address country of the contact or null if no business address country set

setBusinessAddressCountry

public void setBusinessAddressCountry(java.lang.String sCountry)

Sets the business address country of the contact.

Parameters:

sCountry - the business address country of the contact or null for no business address country

getOtherAddressPostOfficeBox

public java.lang.String getOtherAddressPostOfficeBox()

Gets the other address post office box of the contact.

Returns:

the other address post office box of the contact or null if no other address post office box set

setOtherAddressPostOfficeBox

public void setOtherAddressPostOfficeBox(java.lang.String sPostOfficeBox)

Sets the other address post office box of the contact.

Parameters:

sPostOfficeBox - the other address post office box of the contact or null for no other address post office box

getOtherAddressStreet

public java.lang.String getOtherAddressStreet()

Gets the other address street of the contact.

Returns:

the other address street of the contact or null if no other address street set

setOtherAddressStreet

public void setOtherAddressStreet(java.lang.String sStreet)

Sets the other address street of the contact.

Parameters:

sStreet - the other address street of the contact or null for no other address street

getOtherAddressCity

public java.lang.String getOtherAddressCity()

Gets the other address city of the contact.

Returns:

the other address city of the contact or null if no other address city set

setOtherAddressCity

public void setOtherAddressCity(java.lang.String sCity)

Sets the other address city of the contact.

Parameters:

sCity - the other address city of the contact or null for no other address city

getOtherAddressStateOrProvince

public java.lang.String getOtherAddressStateOrProvince()

Gets the other address state or province of the contact.

Returns:

the other address state or province of the contact or null if no other address state or province set

setOtherAddressStateOrProvince

public void setOtherAddressStateOrProvince(java.lang.String sStateOrProvince)

Sets the other address state or province of the contact.

Parameters:

sStateOrProvince - the other address state or province of the contact or null for no other address state or province

getOtherAddressPostalCode

public java.lang.String getOtherAddressPostalCode()

Gets the other address postal code of the contact.

Returns:

the other address postal code of the contact or null if no other address postal code set

setOtherAddressPostalCode

public void setOtherAddressPostalCode(java.lang.String sPostalCode)

Sets the other address postal code of the contact.

Parameters:

sPostalCode - the other address postal code of the contact or null for no other address postal code

getOtherAddressCountry

public java.lang.String getOtherAddressCountry()

Gets the other address country of the contact.

Returns:

the other address country of the contact or null if no other address country set

setOtherAddressCountry

public void setOtherAddressCountry(java.lang.String sCountry)

Sets the other address country of the contact.

Parameters:

sCountry - the other address country of the contact or null for no other address country

getMiddleName

public java.lang.String getMiddleName()

Gets the middle name of the contact.

Returns:

the middle name of the contact or null if no middle name is set

setMiddleName

public void setMiddleName(java.lang.String sMiddleName)

Sets the middle name of the contact.

Parameters:

sMiddleName - the middle name of the contact or null if no middle name is set

getLastName

public java.lang.String getLastName()

Gets the last name of the contact.

Returns:

the last name of the contact or null if no last name is set

setLastName

public void setLastName(java.lang.String sLastName)

Sets the last name of the contact.

Parameters:

sLastName - the last name of the contact or null if no last name is set

getNickname

public java.lang.String getNickname()

Gets the nickname of the contact.

Returns:

the nickname of the contact or null if no nickname is set

setNickname

public void setNickname(java.lang.String sNickname)

Sets the nickname of the contact.

Parameters:

sNickname - the nickname of the contact or null if no nickname is set

getNamePrefix

public java.lang.String getNamePrefix()

Gets the name prefix of the contact.

Returns:

the name prefix of the contact (for example, Mr.) or null if no name prefix is set

setNamePrefix

public void setNamePrefix(java.lang.String sNamePrefix)

Sets the name prefix of the contact.

Parameters:

sNamePrefix - the name prefix of the contact (for example, Mr.) or null if no name prefix is set

getNameSuffix

public java.lang.String getNameSuffix()

Gets the name suffix of the contact.

Returns:

the name suffix of the contact (for example, Mr.) or null if no name suffix is set

setNameSuffix

public void setNameSuffix(java.lang.String sNameSuffix)

Sets the name suffix of the contact.

Parameters:

sNameSuffix - the name suffix of the contact (for example, Mr.) or null if no name suffix is set

getCustomNum1

public long getCustomNum1()

Gets the custom number1 field of the contact.

Returns:

the custom number1 field of the contact or null if the custom number1 field is not set

setCustomNum1

public void setCustomNum1(long lCustomNum1)

Sets the custom number1 field of the contact.

Parameters:

lCustomNum1 - the custom number1 field of the contact

getCustomNum2

public long getCustomNum2()

Gets the custom number2 field of the contact.

Returns:

the custom number2 field of the contact or null if the custom number2 field is not set

setCustomNum2

public void setCustomNum2(long lCustomNum2)

Sets the custom number2 field of the contact.

Parameters:

lCustomNum2 - the custom number2 field of the contact

getCustomNum3

public long getCustomNum3()

Gets the custom number3 field of the contact.

Returns:

the custom number3 field of the contact or null if the custom number3 field is not set

setCustomNum3

public void setCustomNum3(long lCustomNum3)

Sets the custom number3 field of the contact.

Parameters:

lCustomNum3 - the custom number3 field of the contact

getCustomStr1

public java.lang.String getCustomStr1()

Gets the custom string1 field of the contact.

Returns:

the custom string1 field of the contact or null if the custom string1 field is not set

setCustomStr1

public void setCustomStr1(java.lang.String sCustomStr1)

Sets the custom string1 field of the contact.

Parameters:

sCustomStr1 - the custom string1 field of the contact

getCustomStr2

public java.lang.String getCustomStr2()

Gets the custom string2 field of the contact.

Returns:

the custom string2 field of the contact or null if the custom string2 field is not set

setCustomStr2

public void setCustomStr2(java.lang.String sCustomStr2)

Sets the custom string2 field of the contact.

Parameters:

sCustomStr2 - the custom string2 field of the contact

getCustomStr3

public java.lang.String getCustomStr3()

Gets the custom string3 field of the contact.

Returns:

the custom string3 field of the contact or null if the custom string3 field is not set

setCustomStr3

public void setCustomStr3(java.lang.String sCustomStr3)

Sets the custom string3 field of the contact.

Parameters:

sCustomStr3 - the custom string3 field of the contact

getCustomStr4

public java.lang.String getCustomStr4()

Gets the custom string4 field of the contact.

Returns:

the custom string4 field of the contact or null if the custom string4 field is not set

setCustomStr4

public void setCustomStr4(java.lang.String sCustomStr4)

Sets the custom string4 field of the contact.

Parameters:

sCustomStr4 - the custom string4 field of the contact

getAccessManager

public AccessManager getAccessManager()
                               throws AccessManagerException

Gets the access manager for this contact. The access manager is used to modify the permissions.

Returns:

the access manager for this contact

Throws:

AccessManagerException - an error occurs retrieving the access manager

See Also:

ContactPermission

getGivenName

public java.lang.String getGivenName()

Gets the given name for a contact. The name is assembled with the form:

 [name prefix] [first name] [middle name] [last name] [name suffix]
 

If the given name is an empty string, the setting contact.given_name from contact_resources.properties is returned. This will prevent an empty string from being returned. If you wish to return the empty string, set contact.given_name to blank.

Returns:

the given name

setPrimaryTelephoneNumber

public void setPrimaryTelephoneNumber(PrimaryTelephoneNumber primary)

Sets the primary telephone number.

Parameters:

primary - the primary telephone number (may not be null)

getPrimaryTelephoneNumber

public PrimaryTelephoneNumber getPrimaryTelephoneNumber()

Gets the setting for the primary telephone number. When calling getTelephoneNumber(), the primary telephone number is returned.

Returns:

the primary telephone number setting

getTelephoneNumber

public java.lang.String getTelephoneNumber()

Gets the telephone number of the contact which is the primary telephone number.

Returns:

the telephone number of the contact or null if no telephone number is set

setMailingAddress

public void setMailingAddress(MailingAddress address)

Sets the mailing address of the contact.

Parameters:

address - the mailing address (may not be null)

See Also:

getAddressStreet(), getAddressPostOfficeBox(), getAddressCity(), getAddressPostalCode(), getAddressStateOrProvince(), getAddressCountry()

getMailingAddress

public MailingAddress getMailingAddress()

Gets the mailing address of the contact.

Returns:

the mailing address of the contact

getAddressStreet

public java.lang.String getAddressStreet()

Gets the street address of the contact which is the mailing address.

Returns:

the street address of the contact or null if no mailing address is set

getAddressPostOfficeBox

public java.lang.String getAddressPostOfficeBox()

Gets the post office box of the contact which is the mailing address.

Returns:

the post office box of the contact or null if no post office box is set

getAddressCity

public java.lang.String getAddressCity()

Gets the city of the contact which is the mailing address.

Returns:

the city of the contact or null if no city is set

getAddressPostalCode

public java.lang.String getAddressPostalCode()

Gets the postal code of the contact which is the mailing address.

Returns:

the postal code of the contact or null if no postal code is set

getAddressStateOrProvince

public java.lang.String getAddressStateOrProvince()

Gets the state or province of the contact which is the mailing address.

Returns:

the state or province of the contact or null if no state or province is set

getAddressCountry

public java.lang.String getAddressCountry()

Gets the country of the contact which is the mailing address.

Returns:

the country of the contact or null if no country is set

getAuthor

public java.lang.String getAuthor()

Gets the name of the author. The author is the name of the user who originally created this contact.

Returns:

the author name

setPictureImage

public void setPictureImage(BinaryData image)

Sets the picture image for the contact. This field can be used to store a picture image or other binary data associated with the contact.

Parameters:

pictureImage - the picture image (null for no picture image)

getPictureImage

public BinaryData getPictureImage()

Gets the picture image for the contact.

Returns:

the picture image or null for no image

getDateCreated

public java.util.Date getDateCreated()

Gets the date the contact was created.

Returns:

the date created

getDateLastModified

public java.util.Date getDateLastModified()

Gets the date the contact was last modified.

Returns:

the date last modified

update

public boolean update()
               throws java.security.AccessControlException

Updates the contact (saves the contact entry). This method must be called to commit changes to the contact.

Returns:

true if the update is successful; false otherwise

Throws:

java.security.AccessControlException - the user does not have edit permissions for this contact

update

public boolean update(boolean bForce)
               throws java.security.AccessControlException

Updates the contact (saves the contact entry). This method must be called to commit changes to the contact.

Parameters:

bForce - true to force the update; false otherwise (currently ignored)

Returns:

true if the update is successful; false otherwise

Throws:

java.security.AccessControlException - occurs if the user does not have permission to edit the contact

delete

public void delete()
            throws java.security.AccessControlException

Updates the contact (saves the contact entry). This method must be called to commit changes to the contact.

The update tokens must match in order for the update to occur. If the specified token is null, empty or does not match the token on the contact record, the update will not succeed.

Parameters:

sToken - the for update token (may not be null)

Returns:

true if the update is successful; false if the specified token and update token in the contact do not match

Throws:

java.security.AccessControlException - the user does not have edit permissions for this contact

delete

public void delete(boolean bArchive)
            throws java.security.AccessControlException

Deletes the contact.

Parameters:

bArchive - true to archive the contact; false to delete

Throws:

java.security.AccessControlException - occurs if the user does not have permission to delete the contact

toVcardString

public java.lang.String toVcardString()

Creates a string that contains the vCard compliant (RFC #2426) representation of the contact.

Returns:

the vCard string

toString

public java.lang.String toString()

Returns a string representation of the object.

Overrides:

toString in class java.lang.Object

Returns:

the string representation of the object

equals

public boolean equals(java.lang.Object obj)

Checks if the specified object is "equal to" this one. This does not check equals for all properties of the contact, only checks if the contact id matches.

Overrides:

equals in class java.lang.Object

Parameters:

obj - the reference object with which to compare

Returns:

true if this object is the same as the obj argument; false otherwise