Contact

java.lang.Object
- ohos.sysappcomponents.contact.entity.Contact

```
public class Contact
extends Object
```
Provides information about a contact.
This class provides methods to obtain basic attributes of a contact, such as the email address, event information, group information, instant messaging (IM) address, name, nickname, note, organization, phone number, portrait, postal address, relation, SIP address, and website.

从以下版本开始:

3

SystemCapability

SystemCapability.SysAppComponents#CONTACT

字段概要

字段
限定符和类型字段说明

static long INVALID_CONTACT_ID
Indicates an invalid contact ID.

字段
限定符和类型	字段	说明
`static long`	`INVALID_CONTACT_ID`	Indicates an invalid contact ID.

构造器概要

构造器
构造器说明

Contact()

构造器
构造器	说明
`Contact()`

方法概要

所有方法实例方法具体方法
限定符和类型	方法	说明
`void`	`addEmail(Email email)`	Adds an email address to this contact.
`void`	`addEvent(Event event)`	Adds an event (special date) to this contact.
`void`	`addGroup(Group group)`	Adds this contact to a group.
`void`	`addImAddress(ImAddress imAddress)`	Adds an IM address to this contact.
`void`	`addPhoneNumber(PhoneNumber phoneNumber)`	Adds a phone number to this contact.
`void`	`addPostalAddress(PostalAddress postalAddress)`	Adds a postal address to this contact.
`void`	`addRelation(Relation relation)`	Adds a relation to this contact.
`void`	`addSipAddress(SipAddress sipAddress)`	Adds a Session Initiation Protocol (SIP) address to this contact.
`void`	`addWebsite(Website website)`	Adds a website to this contact.
`List<Email>`	`getEmails()`	Obtains the email address list of this contact.
`List<Event>`	`getEvents()`	Obtains the contact event (special date) list.
`List<Group>`	`getGroups()`	Obtains the list of groups to which this contact belongs.
`long`	`getId()`	Obtains the contact ID.
`List<ImAddress>`	`getImAddresses()`	Obtains the list of IM addresses of this contact.
`String`	`getKey()`	Obtains the query key that identifies this contact.
`Name`	`getName()`	Obtains the contact name.
`NickName`	`getNickName()`	Obtains the contact nickName.
`Note`	`getNote()`	Obtains the contact note.
`Organization`	`getOrganization()`	Obtains organization information about this contact.
`List<PhoneNumber>`	`getPhoneNumbers()`	Obtains the phone number list of this contact.
`Portrait`	`getPortrait()`	Obtains the contact portrait.
`List<PostalAddress>`	`getPostalAddresses()`	Obtains the postal address list of this contact.
`List<Relation>`	`getRelations()`	Obtains the relation list of this contact.
`List<SipAddress>`	`getSipAddresses()`	Obtains the list of SIP addresses of this contact.
`List<Website>`	`getWebsites()`	Obtains the website list of this contact.
`void`	`setContactAttributes(ContactAttributes attributes)`	Sets contact attributes.
`void`	`setEmails(List<Email> emails)`	Set emails address to this contact.
`void`	`setEvents(List<Event> events)`	Set event (special date) to this contact.
`void`	`setGroups(List<Group> groups)`	Set this contact to group.
`void`	`setImAddresses(List<ImAddress> imAddresses)`	Set IM address to this contact.
`void`	`setName(Name name)`	Sets a name for this contact.
`void`	`setNickName(NickName nickName)`	Sets a nickName for this contact.
`void`	`setNote(Note note)`	Sets a note for this contact.
`void`	`setOrganization(Organization organization)`	Sets organization information about this contact.
`void`	`setPhoneNumbers(List<PhoneNumber> phoneNumbers)`	Set phone number to this contact.
`void`	`setPortrait(Portrait portrait)`	Sets a portrait for this contact.
`void`	`setPostalAddresses(List<PostalAddress> postalAddresses)`	Set postal address to this contact.
`void`	`setRelations(List<Relation> relations)`	Set relation to this contact.
`void`	`setSipAddresses(List<SipAddress> sipAddresses)`	Set Session Initiation Protocol (SIP) address to this contact.
`void`	`setWebsites(List<Website> websites)`	Set website to this contact.

从类继承的方法 java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

- 字段详细资料
  - INVALID_CONTACT_ID
```
public static final long INVALID_CONTACT_ID
```
    Indicates an invalid contact ID.
    The constant value is -1.
    
    从以下版本开始:
    
    3
    
    另请参阅:
    
    常量字段值
- 构造器详细资料
  - Contact
```
public Contact()
```
- 方法详细资料
  - getId
```
public long getId()
```
    Obtains the contact ID.
    
    返回:
    
    Returns the contact ID.
    
    从以下版本开始:
    
    3
  - getPhoneNumbers
```
public List<PhoneNumber> getPhoneNumbers()
```
    Obtains the phone number list of this contact.
    
    返回:
    
    Returns the phone number list.
    
    从以下版本开始:
    
    3
  - setPhoneNumbers
```
public void setPhoneNumbers(List<PhoneNumber> phoneNumbers)
```
    Set phone number to this contact.
    
    参数:
    
    phoneNumbers - Indicates the List.
    
    从以下版本开始:
    
    7
  - addPhoneNumber
```
public void addPhoneNumber(PhoneNumber phoneNumber)
```
    Adds a phone number to this contact.
    
    参数:
    
    phoneNumber - Indicates the phone number to add.
    
    从以下版本开始:
    
    3
  - getPortrait
```
public Portrait getPortrait()
```
    Obtains the contact portrait.
    
    返回:
    
    Returns the portrait.
    
    从以下版本开始:
    
    3
  - setPortrait
```
public void setPortrait(Portrait portrait)
```
    Sets a portrait for this contact.
    
    参数:
    
    portrait - Indicates the contact portrait to set.
    
    从以下版本开始:
    
    3
  - getOrganization
```
public Organization getOrganization()
```
    Obtains organization information about this contact.
    
    返回:
    
    Returns the contact's organization.
    
    从以下版本开始:
    
    3
  - setOrganization
```
public void setOrganization(Organization organization)
```
    Sets organization information about this contact.
    
    参数:
    
    organization - Indicates the organization to set.
    
    从以下版本开始:
    
    3
  - getName
```
public Name getName()
```
    Obtains the contact name.
    
    返回:
    
    Returns the contact name.
    
    从以下版本开始:
    
    3
  - setName
```
public void setName(Name name)
```
    Sets a name for this contact.
    
    参数:
    
    name - Indicates the name to set.
    
    从以下版本开始:
    
    3
  - getKey
```
public String getKey()
```
    Obtains the query key that identifies this contact.
    
    返回:
    
    Returns the query key.
    
    从以下版本开始:
    
    3
  - getEmails
```
public List<Email> getEmails()
```
    Obtains the email address list of this contact.
    
    返回:
    
    Returns the email address list.
    
    从以下版本开始:
    
    3
  - setEmails
```
public void setEmails(List<Email> emails)
```
    Set emails address to this contact.
    
    参数:
    
    emails - Indicates the email list.
    
    从以下版本开始:
    
    7
  - addEmail
```
public void addEmail(Email email)
```
    Adds an email address to this contact.
    
    参数:
    
    email - Indicates the email address to add.
    
    从以下版本开始:
    
    3
  - getImAddresses
```
public List<ImAddress> getImAddresses()
```
    Obtains the list of IM addresses of this contact.
    
    返回:
    
    Returns the IM address list.
    
    从以下版本开始:
    
    3
  - setImAddresses
```
public void setImAddresses(List<ImAddress> imAddresses)
```
    Set IM address to this contact.
    
    参数:
    
    imAddresses - Indicates the contact IM address to add List.
    
    从以下版本开始:
    
    7
  - addImAddress
```
public void addImAddress(ImAddress imAddress)
```
    Adds an IM address to this contact.
    
    参数:
    
    imAddress - Indicates the contact IM address to add.
    
    从以下版本开始:
    
    3
  - getNickName
```
public NickName getNickName()
```
    Obtains the contact nickName.
    
    返回:
    
    Returns the nickName.
    
    从以下版本开始:
    
    3
  - setNickName
```
public void setNickName(NickName nickName)
```
    Sets a nickName for this contact.
    
    参数:
    
    nickName - Indicates the nickName to set.
    
    从以下版本开始:
    
    3
  - getSipAddresses
```
public List<SipAddress> getSipAddresses()
```
    Obtains the list of SIP addresses of this contact.
    
    返回:
    
    Returns the SIP address list.
    
    从以下版本开始:
    
    3
  - setSipAddresses
```
public void setSipAddresses(List<SipAddress> sipAddresses)
```
    Set Session Initiation Protocol (SIP) address to this contact.
    
    参数:
    
    sipAddresses - Indicates the SIP address to add list.
    
    从以下版本开始:
    
    7
  - addSipAddress
```
public void addSipAddress(SipAddress sipAddress)
```
    Adds a Session Initiation Protocol (SIP) address to this contact.
    
    参数:
    
    sipAddress - Indicates the SIP address to add.
    
    从以下版本开始:
    
    3
  - getPostalAddresses
```
public List<PostalAddress> getPostalAddresses()
```
    Obtains the postal address list of this contact.
    
    返回:
    
    Returns the postal address list.
    
    从以下版本开始:
    
    3
  - setPostalAddresses
```
public void setPostalAddresses(List<PostalAddress> postalAddresses)
```
    Set postal address to this contact.
    
    参数:
    
    postalAddresses - Indicates the postal address to add list.
    
    从以下版本开始:
    
    7
  - addPostalAddress
```
public void addPostalAddress(PostalAddress postalAddress)
```
    Adds a postal address to this contact.
    
    参数:
    
    postalAddress - Indicates the postal address to add.
    
    从以下版本开始:
    
    3
  - getGroups
```
public List<Group> getGroups()
```
    Obtains the list of groups to which this contact belongs.
    
    返回:
    
    Returns the contact group list.
    
    从以下版本开始:
    
    3
  - setGroups
```
public void setGroups(List<Group> groups)
```
    Set this contact to group.
    
    参数:
    
    groups - Indicates the group where the contact is to add list.
    
    从以下版本开始:
    
    7
  - addGroup
```
public void addGroup(Group group)
```
    Adds this contact to a group.
    
    参数:
    
    group - Indicates the group where the contact is to add.
    
    从以下版本开始:
    
    3
  - getNote
```
public Note getNote()
```
    Obtains the contact note.
    
    返回:
    
    Returns the note.
    
    从以下版本开始:
    
    3
  - setNote
```
public void setNote(Note note)
```
    Sets a note for this contact.
    
    参数:
    
    note - Indicates the note to set.
    
    从以下版本开始:
    
    3
  - getEvents
```
public List<Event> getEvents()
```
    Obtains the contact event (special date) list.
    
    返回:
    
    Returns the contact event (special date) list.
    
    从以下版本开始:
    
    3
  - setEvents
```
public void setEvents(List<Event> events)
```
    Set event (special date) to this contact.
    
    参数:
    
    events - Indicates the contact event (special date) to add list.
    
    从以下版本开始:
    
    7
  - addEvent
```
public void addEvent(Event event)
```
    Adds an event (special date) to this contact.
    
    参数:
    
    event - Indicates the contact event (special date) to add.
    
    从以下版本开始:
    
    3
  - getWebsites
```
public List<Website> getWebsites()
```
    Obtains the website list of this contact.
    
    返回:
    
    Returns the website list.
    
    从以下版本开始:
    
    3
  - setWebsites
```
public void setWebsites(List<Website> websites)
```
    Set website to this contact.
    
    参数:
    
    websites - Indicates the website to add list.
    
    从以下版本开始:
    
    7
  - addWebsite
```
public void addWebsite(Website website)
```
    Adds a website to this contact.
    
    参数:
    
    website - Indicates the website to add.
    
    从以下版本开始:
    
    3
  - getRelations
```
public List<Relation> getRelations()
```
    Obtains the relation list of this contact.
    
    返回:
    
    Returns the relation list.
    
    从以下版本开始:
    
    3
  - setRelations
```
public void setRelations(List<Relation> relations)
```
    Set relation to this contact.
    
    参数:
    
    relations - Indicates the information about the contact relation to list.
    
    从以下版本开始:
    
    7
  - addRelation
```
public void addRelation(Relation relation)
```
    Adds a relation to this contact.
    
    参数:
    
    relation - Indicates the information about the contact relation to set.
    
    从以下版本开始:
    
    3
  - setContactAttributes
```
public void setContactAttributes(ContactAttributes attributes)
```
    Sets contact attributes.
    
    参数:
    
    attributes - Indicates the ContactAttributes object to set.
    
    从以下版本开始:
    
    3

类 Contact

字段概要

构造器概要

方法概要

从类继承的方法 java.lang.Object

字段详细资料

INVALID_CONTACT_ID

构造器详细资料

Contact

方法详细资料

getId

getPhoneNumbers

setPhoneNumbers

addPhoneNumber

getPortrait

setPortrait

getOrganization

setOrganization

getName

setName

getKey

getEmails

setEmails

addEmail

getImAddresses

setImAddresses

addImAddress

getNickName

setNickName

getSipAddresses

setSipAddresses

addSipAddress

getPostalAddresses

setPostalAddresses

addPostalAddress

getGroups

setGroups

addGroup

getNote

setNote

getEvents

setEvents

addEvent

getWebsites

setWebsites

addWebsite

getRelations

setRelations

addRelation

setContactAttributes