net.rim.blackberry.api.pdap.contactlinking
Class DefaultLinkableContact

java.lang.Object
  net.rim.blackberry.api.pdap.contactlinking.AbstractLinkableContact
      net.rim.blackberry.api.pdap.contactlinking.DefaultLinkableContact

All Implemented Interfaces:

LinkableContact

public class DefaultLinkableContact
extends AbstractLinkableContact
implements LinkableContact

A simple implementation of LinkableContact.

Category:

Signed: This element is only accessible by signed applications. If you intend to use this element, please visit http://www.blackberry.com/go/codesigning to obtain a set of code signing keys. Code signing is only required for applications running on BlackBerry smartphones; development on BlackBerry Smartphone Simulators can occur without code signing.

Since:

BlackBerry API 5.0.0

Field Summary

Fields inherited from interface net.rim.blackberry.api.pdap.contactlinking.LinkableContact

EMAIL, FAX_PHONE, FAX_PHONE2, HOME_PHONE, HOME_PHONE2, MOBILE_PHONE, MOBILE_PHONE2, NAME, OTHER_PHONE, PIN, WORK_PHONE, WORK_PHONE2

Constructor Summary
	DefaultLinkableContact(String contactID) Creates a new DefaultLinkableContact with the supplied contact ID.
	DefaultLinkableContact(String contactID, long applicationID) Creates a new DefaultLinkableContact with the supplied contact ID and application ID.

Method Summary
	long	getApplicationID() Gets the unique ID that identifies the application this contact is from.
	String	getContactID() Gets the ID of this contact.
	void	setApplicationID(long applicationID) Sets this contact's application ID.
	void	setContactID(String contactID) Sets this contact's ID.

Methods inherited from class net.rim.blackberry.api.pdap.contactlinking.AbstractLinkableContact

getString, setString

Methods inherited from class java.lang.Object

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

Methods inherited from interface net.rim.blackberry.api.pdap.contactlinking.LinkableContact

getString

Constructor Detail

DefaultLinkableContact

public DefaultLinkableContact(String contactID)

Creates a new DefaultLinkableContact with the supplied contact ID. Before this contact can be used, its application ID must be set.

Parameters:

contactID - The unique ID of this contact.

Throws:

NullPointerException - if contactID is null.

Category:

Signed: This element is only accessible by signed applications. If you intend to use this element, please visit http://www.blackberry.com/go/codesigning to obtain a set of code signing keys. Code signing is only required for applications running on BlackBerry smartphones; development on BlackBerry Smartphone Simulators can occur without code signing.

Since:

BlackBerry API 5.0.0

DefaultLinkableContact

public DefaultLinkableContact(String contactID,
                              long applicationID)

Creates a new DefaultLinkableContact with the supplied contact ID and application ID.

Parameters:

contactID - The unique ID of this contact.

applicationID - The unique ID of the application this contact is from.

Throws:

NullPointerException - if contactID is null.

Category:

Signed: This element is only accessible by signed applications. If you intend to use this element, please visit http://www.blackberry.com/go/codesigning to obtain a set of code signing keys. Code signing is only required for applications running on BlackBerry smartphones; development on BlackBerry Smartphone Simulators can occur without code signing.

Since:

BlackBerry API 5.0.0

Method Detail

setApplicationID

public void setApplicationID(long applicationID)

Sets this contact's application ID. This is the unique ID used to identify the application this contact is from. A LinkableContact must have an application ID.

Parameters:

applicationID - The ID of the application this contact is from.

Category:

Signed: This element is only accessible by signed applications. If you intend to use this element, please visit http://www.blackberry.com/go/codesigning to obtain a set of code signing keys. Code signing is only required for applications running on BlackBerry smartphones; development on BlackBerry Smartphone Simulators can occur without code signing.

Since:

BlackBerry API 5.0.0

getApplicationID

public long getApplicationID()

Gets the unique ID that identifies the application this contact is from. A LinkableContact must have an application ID.

Specified by:

getApplicationID in interface LinkableContact

Returns:

The unique application ID.

Category:

Signed: This element is only accessible by signed applications. If you intend to use this element, please visit http://www.blackberry.com/go/codesigning to obtain a set of code signing keys. Code signing is only required for applications running on BlackBerry smartphones; development on BlackBerry Smartphone Simulators can occur without code signing.

Since:

BlackBerry API 5.0.0

setContactID

public void setContactID(String contactID)

Sets this contact's ID. This ID is used to uniquely identify the user in your application. A LinkableContact must have a contact ID.

Parameters:

contactID - The unique ID that identifies this contact in your application.

Throws:

NullPointerException - if contactID is null.

Category:

Signed: This element is only accessible by signed applications. If you intend to use this element, please visit http://www.blackberry.com/go/codesigning to obtain a set of code signing keys. Code signing is only required for applications running on BlackBerry smartphones; development on BlackBerry Smartphone Simulators can occur without code signing.

Since:

BlackBerry API 5.0.0

getContactID

public String getContactID()

Gets the ID of this contact. This is the unique ID used to identify a contact in your application. A LinkableContact must have a contact ID.

Specified by:

getContactID in interface LinkableContact

Returns:

The unique ID as a string.

Category:

Signed: This element is only accessible by signed applications. If you intend to use this element, please visit http://www.blackberry.com/go/codesigning to obtain a set of code signing keys. Code signing is only required for applications running on BlackBerry smartphones; development on BlackBerry Smartphone Simulators can occur without code signing.

Since:

BlackBerry API 5.0.0