VCard (ez-vcard 0.12.2 API)

java.lang.Object
- ezvcard.VCard

All Implemented Interfaces:

Iterable<VCardProperty>
```
public class VCard
extends Object
implements Iterable<VCardProperty>
```
Represents a vCard.

Author:

Michael Angstadt

Constructor Summary

Constructors
Constructor and Description
`VCard()` Creates a new vCard set to version 3.0.
`VCard(VCard original)` Creates a deep copy of the given vCard.
`VCard(VCardVersion version)` Creates a new vCard.

Method Summary

All Methods Instance Methods Concrete Methods
Modifier and Type	Method and Description
`void`	`addAddress(Address address)` Adds a mailing address.
`void`	`addAddressAlt(Address... altRepresentations)` Adds a mailing address.
`void`	`addCalendarRequestUri(CalendarRequestUri calendarRequestUri)` Adds a URI that can be used to schedule a meeting with the person on his or her calendar.
`void`	`addCalendarRequestUriAlt(CalendarRequestUri... altRepresentations)` Adds a URI that can be used to schedule a meeting with the person on his or her calendar.
`void`	`addCalendarUri(CalendarUri calendarUri)` Adds a URI that points to the person's calendar.
`void`	`addCalendarUriAlt(CalendarUri... altRepresentations)` Adds a URI that points to the person's calendar.
`void`	`addCategories(Categories categories)` Adds a list of "keywords" or "tags" that can be used to describe the person.
`void`	`addCategoriesAlt(Categories... altRepresentations)` Adds a list of "keywords" or "tags" that can be used to describe the person.
`void`	`addClientPidMap(ClientPidMap clientPidMap)` Adds a property that is used to assign a globally-unique identifier to an individual property instance.
`void`	`addEmail(Email email)` Adds an email address.
`Email`	`addEmail(String email, EmailType... types)` Adds an email address.
`void`	`addEmailAlt(Email... altRepresentations)` Adds an email address.
`void`	`addExpertise(Expertise expertise)` Adds a professional subject area that the person is knowledgeable in.
`Expertise`	`addExpertise(String expertise)` Adds a professional subject area that the person is knowledgeable in.
`void`	`addExpertiseAlt(Expertise... altRepresentations)` Adds a professional subject area that the person is knowledgeable in.
`RawProperty`	`addExtendedProperty(String name, String value)` Adds an extended property.
`RawProperty`	`addExtendedProperty(String name, String value, VCardDataType dataType)` Adds an extended property.
`void`	`addFbUrl(FreeBusyUrl fbUrl)` Adds a URL that can be used to determine when the person is free or busy.
`void`	`addFbUrlAlt(FreeBusyUrl... altRepresentations)` Adds a URL that can be used to determine when the person is free or busy.
`void`	`addFormattedName(FormattedName formattedName)` Adds a version of the person's full name.
`void`	`addFormattedNameAlt(FormattedName... altRepresentations)` Adds a version of the person's full name.
`void`	`addGeo(Geo geo)` Adds a geographical position of where the person lives/works.
`void`	`addGeoAlt(Geo... altRepresentations)` Adds a geographical position of where the person lives/works.
`void`	`addHobby(Hobby hobby)` Adds a hobby that the person actively engages in.
`Hobby`	`addHobby(String hobby)` Adds a hobby that the person actively engages in.
`void`	`addHobbyAlt(Hobby... altRepresentations)` Adds a hobby that the person actively engages in.
`void`	`addImpp(Impp impp)` Adds an instant messaging handle.
`void`	`addImppAlt(Impp... altRepresentations)` Adds an instant messaging handle.
`void`	`addInterest(Interest interest)` Adds an interest.
`Interest`	`addInterest(String interest)` Adds an interest.
`void`	`addInterestAlt(Interest... altRepresentations)` Adds an interest.
`void`	`addKey(Key key)` Adds a public encryption key.
`void`	`addKeyAlt(Key... altRepresentations)` Adds a public encryption key.
`void`	`addLanguage(Language language)` Adds a language that the person speaks.
`Language`	`addLanguage(String language)` Adds a language that the person speaks.
`void`	`addLanguageAlt(Language... altRepresentations)` Adds a language that the person speaks.
`void`	`addLogo(Logo logo)` Adds a logo to the vCard, such as a company logo.
`void`	`addLogoAlt(Logo... altRepresentations)` Adds a logo to the vCard, such as a company logo.
`void`	`addMember(Member member)` Adds a member to the group that this vCard represents.
`void`	`addMemberAlt(Member... altRepresentations)` Adds a member to the group that this vCard represents.
`void`	`addNickname(Nickname nickname)` Adds a set of nicknames for the person.
`void`	`addNicknameAlt(Nickname... altRepresentations)` Adds a collection of nicknames for the person.
`void`	`addNote(Note note)` Adds a note.
`Note`	`addNote(String note)` Adds a note.
`void`	`addNoteAlt(Note... altRepresentations)` Adds a note.
`void`	`addOrganization(Organization organization)` Adds a hierarchy of departments to which the person belongs.
`void`	`addOrganizationAlt(Organization... altRepresentations)` Adds a hierarchy of department(s) to which the person belongs.
`void`	`addOrgDirectory(OrgDirectory orgDirectory)` Adds an organization directory.
`OrgDirectory`	`addOrgDirectory(String orgDirectory)` Adds an organization directory.
`void`	`addOrgDirectoryAlt(OrgDirectory... altRepresentations)` Adds an organization directory.
`void`	`addOrphanedLabel(Label label)` Adds a mailing label which is not associated with an `Address` property.
`void`	`addPhoto(Photo photo)` Adds a photo to the vCard, such as the person's portrait.
`void`	`addPhotoAlt(Photo... altRepresentations)` Adds a photo to the vCard, such as the person's portrait.
`void`	`addProperty(VCardProperty property)` Adds a property.
`<T extends VCardProperty & HasAltId> void`	`addPropertyAlt(Class<T> propertyClass, Collection<T> altRepresentations)` Adds a property in the form of a collection of alternative representations.
`<T extends VCardProperty & HasAltId> void`	`addPropertyAlt(Class<T> propertyClass, T... altRepresentations)` Adds a property in the form of a collection of alternative representations.
`void`	`addRelated(Related related)` Adds someone that the person is related to.
`void`	`addRelatedAlt(Related... altRepresentations)` Adds someone that the person is related to.
`void`	`addRole(Role role)` Adds a role associated with the person.
`Role`	`addRole(String role)` Adds a role associated with the person.
`void`	`addRoleAlt(Role... altRepresentations)` Adds a role associated with the person.
`void`	`addSound(Sound sound)` Adds a sound to the vCard, such as a pronunciation of the person's name.
`void`	`addSoundAlt(Sound... altRepresentations)` Adds a sound to the vCard, such as a pronunciation of the person's name.
`void`	`addSource(Source source)` Adds a URI that can be used to retrieve the most up-to-date version of the person's vCard.
`Source`	`addSource(String source)` Adds a URI that can be used to retrieve the most up-to-date version of the person's vCard.
`void`	`addSourceAlt(Source... altRepresentations)` Adds a URI that can be used to retrieve the most up-to-date version of the person's vCard.
`Telephone`	`addTelephoneNumber(String telephoneNumber, TelephoneType... types)` Adds a telephone number.
`void`	`addTelephoneNumber(Telephone telephoneNumber)` Adds a telephone number.
`void`	`addTelephoneNumberAlt(Telephone... altRepresentations)` Adds a telephone number.
`void`	`addTimezone(Timezone timezone)` Adds a timezone the person lives/works in.
`void`	`addTimezoneAlt(Timezone... altRepresentations)` Adds a timezone the person lives/works in.
`Title`	`addTitle(String title)` Adds a title associated with the person.
`void`	`addTitle(Title title)` Adds a title associated with the person.
`void`	`addTitleAlt(Title... altRepresentations)` Adds a title associated with the person.
`Url`	`addUrl(String url)` Adds a URL.
`void`	`addUrl(Url url)` Adds a URL.
`void`	`addUrlAlt(Url... altRepresentations)` Adds a URL.
`void`	`addXml(Xml xml)` Adds XML data to the vCard.
`void`	`addXmlAlt(Xml... altRepresentations)` Adds XML data to the vCard.
`boolean`	`equals(Object obj)`
`List<Address>`	`getAddresses()` Gets the mailing addresses.
`Agent`	`getAgent()` Gets information about the person's agent.
`List<Anniversary>`	`getAnniversaries()` Gets all `Anniversary` property instances.
`Anniversary`	`getAnniversary()` Gets the person's anniversary.
`Birthday`	`getBirthday()` Gets the person's birthday.
`List<Birthday>`	`getBirthdays()` Gets all `Birthday` property instances.
`Birthplace`	`getBirthplace()` Gets the person's birthplace.
`List<Birthplace>`	`getBirthplaces()` Gets all `Birthplace` property instances.
`List<CalendarRequestUri>`	`getCalendarRequestUris()` Gets the URIs that can be used to schedule a meeting with the person on his or her calendar.
`List<CalendarUri>`	`getCalendarUris()` Gets the URIs that point to the person's calendar.
`Categories`	`getCategories()` Gets the list of "keywords" or "tags" that can be used to describe the person.
`List<Categories>`	`getCategoriesList()` Gets all instances of the `Categories` property.
`Classification`	`getClassification()` Gets the classification of the vCard, which describes the sensitivity of the information in the vCard.
`List<ClientPidMap>`	`getClientPidMaps()` Gets the properties that are used to assign globally-unique identifiers to individual property instances.
`Deathdate`	`getDeathdate()` Gets the person's time of death.
`List<Deathdate>`	`getDeathdates()` Gets all `Deathdate` property instances.
`Deathplace`	`getDeathplace()` Gets the person's place of death.
`List<Deathplace>`	`getDeathplaces()` Gets all `Deathplace` property instances.
`List<Email>`	`getEmails()` Gets the email addresses.
`List<Expertise>`	`getExpertise()` Gets the professional subject areas that the person is knowledgeable in.
`List<RawProperty>`	`getExtendedProperties()` Gets all extended properties.
`List<RawProperty>`	`getExtendedProperties(String name)` Gets all extended properties with a given name.
`RawProperty`	`getExtendedProperty(String name)` Gets the first extended property with a given name.
`List<FreeBusyUrl>`	`getFbUrls()` Gets the URLs that can be used to determine when the person is free or busy.
`FormattedName`	`getFormattedName()` Gets the person's full name.
`List<FormattedName>`	`getFormattedNames()` Gets all instances of the `FormattedName` property.
`Gender`	`getGender()` Gets the gender of the person.
`Geo`	`getGeo()` Gets the geographical position of where the person lives/works.
`List<Geo>`	`getGeos()` Gets all instances of the `Geo` property.
`List<Hobby>`	`getHobbies()` Gets the hobbies that the person actively engages in.
`List<Impp>`	`getImpps()` Gets the instant messaging handles.
`List<Interest>`	`getInterests()` Gets the person's interests.
`List<Key>`	`getKeys()` Gets the public encryption keys.
`Kind`	`getKind()` Gets the type of entity this vCard represents.
`List<Language>`	`getLanguages()` Gets the languages that the person speaks.
`List<Logo>`	`getLogos()` Gets the logos attached to the vCard, such a company logo.
`Mailer`	`getMailer()` Gets the email client that the person uses.
`List<Member>`	`getMembers()` Gets the members of the group that this vCard represents.
`Nickname`	`getNickname()` Gets the person's nicknames.
`List<Nickname>`	`getNicknames()` Gets all instances of the `Nickname` property.
`List<Note>`	`getNotes()` Gets the notes.
`Organization`	`getOrganization()` Gets the hierarchy of department(s) to which the person belongs.
`List<Organization>`	`getOrganizations()` Gets all instances of the `Organization` property.
`List<OrgDirectory>`	`getOrgDirectories()` Gets the organization directories.
`List<Label>`	`getOrphanedLabels()` Gets all mailing labels that could not be assigned to an `Address` property.
`List<Photo>`	`getPhotos()` Gets the photos attached to the vCard, such as the person's portrait.
`ProductId`	`getProductId()` Gets the product ID, which identifies the software that created the vCard.
`Profile`	`getProfile()` Gets the profile property.
`Collection<VCardProperty>`	`getProperties()` Gets all the properties in this vCard.
`<T extends VCardProperty> List<T>`	`getProperties(Class<T> clazz)` Gets all properties of a given class.
`<T extends VCardProperty & HasAltId> List<List<T>>`	`getPropertiesAlt(Class<T> clazz)` Gets all properties of a given class, grouping the alternative representations of each property together (see: `description of ALTID`)
`<T extends VCardProperty> T`	`getProperty(Class<T> clazz)` Gets the first property of a given class.
`List<Related>`	`getRelations()` Gets a list of people that the person is related to.
`Revision`	`getRevision()` Gets the time that the vCard was last modified.
`List<Role>`	`getRoles()` Gets the roles associated with the person.
`SortString`	`getSortString()` Gets the string that should be used to sort the vCard.
`List<Sound>`	`getSounds()` Gets the sounds attached to the vCard, such as a pronunciation of the person's name.
`SourceDisplayText`	`getSourceDisplayText()` Gets a textual representation of the `Source` property.
`List<Source>`	`getSources()` Gets the URIs that can be used to retrieve the most up-to-date version of the person's vCard.
`StructuredName`	`getStructuredName()` Gets the individual components of the person's name.
`List<StructuredName>`	`getStructuredNames()` Gets all structured name properties.
`List<Telephone>`	`getTelephoneNumbers()` Gets the telephone numbers.
`Timezone`	`getTimezone()` Gets the timezone the person lives/works in.
`List<Timezone>`	`getTimezones()` Gets all instances of the `Timezone` property.
`List<Title>`	`getTitles()` Gets the titles associated with the person.
`Uid`	`getUid()` Gets the unique identifier of the vCard.
`List<Url>`	`getUrls()` Gets the URLs.
`VCardVersion`	`getVersion()` Gets the version attached to this vCard.
`List<Xml>`	`getXmls()` Gets any XML data that is attached to the vCard.
`int`	`hashCode()`
`Iterator<VCardProperty>`	`iterator()` Iterates through each of the vCard's properties in no particular order.
`List<RawProperty>`	`removeExtendedProperty(String name)` Removes all extended properties that have the given name.
`<T extends VCardProperty> List<T>`	`removeProperties(Class<T> clazz)` Removes all properties of a given class.
`boolean`	`removeProperty(VCardProperty property)` Removes a property instance from the vCard.
`void`	`setAgent(Agent agent)` Sets information about the person's agent.
`void`	`setAnniversary(Anniversary anniversary)` Sets the person's anniversary.
`Anniversary`	`setAnniversary(LocalDate date)` Sets the person's anniversary.
`void`	`setAnniversaryAlt(Anniversary... altRepresentations)` Sets the person's anniversary.
`void`	`setBirthday(Birthday birthday)` Sets the person's birthday.
`Birthday`	`setBirthday(LocalDate date)` Sets the person's birthday.
`void`	`setBirthdayAlt(Birthday... altRepresentations)` Sets the person's birthday.
`void`	`setBirthplace(Birthplace birthplace)` Sets the person's birthplace.
`void`	`setBirthplaceAlt(Birthplace... altRepresentations)` Sets the person's birthplace.
`void`	`setCategories(Categories categories)` Sets the list of "keywords" or "tags" that can be used to describe the person.
`Categories`	`setCategories(String... categories)` Sets the list of "keywords" or "tags" that can be used to describe the person.
`void`	`setCategoriesAlt(Categories... altRepresentations)` Sets the list of "keywords" or "tags" that can be used to describe the person.
`void`	`setClassification(Classification classification)` Sets the classification of the vCard, which describes the sensitivity of the information in the vCard.
`Classification`	`setClassification(String classification)` Sets the classification of the vCard, which describes the sensitivity of the information in the vCard.
`void`	`setDeathdate(Deathdate deathdate)` Sets the person's time of death.
`Deathdate`	`setDeathdate(LocalDate date)` Sets the person's time of death.
`void`	`setDeathdateAlt(Deathdate... altRepresentations)` Sets the person's time of death.
`void`	`setDeathplace(Deathplace deathplace)` Sets the person's place of death.
`void`	`setDeathplaceAlt(Deathplace... altRepresentations)` Sets the person's place of death.
`RawProperty`	`setExtendedProperty(String name, String value)` Replaces all existing extended properties with the given name with a single property instance.
`RawProperty`	`setExtendedProperty(String name, String value, VCardDataType dataType)` Replaces all existing extended properties with the given name with a single property instance.
`void`	`setFormattedName(FormattedName formattedName)` Sets the person's full name.
`FormattedName`	`setFormattedName(String formattedName)` Sets the person's full name.
`void`	`setFormattedNameAlt(FormattedName... altRepresentations)` Sets the person's full name.
`void`	`setGender(Gender gender)` Sets the gender of the person.
`Geo`	`setGeo(double latitude, double longitude)` Sets the geographical position of where the person lives/works.
`void`	`setGeo(Geo geo)` Sets the geographical position of where the person lives/works.
`void`	`setGeoAlt(Geo... altRepresentations)` Sets the geographical position of where the person lives/works.
`void`	`setKind(Kind kind)` Sets the type of entity this vCard represents.
`void`	`setMailer(Mailer mailer)` Sets the email client that the person uses.
`Mailer`	`setMailer(String mailer)` Sets the email client that the person uses.
`void`	`setNickname(Nickname nickname)` Sets the person's nicknames.
`Nickname`	`setNickname(String... nicknames)` Sets the person's nicknames.
`void`	`setNicknameAlt(Nickname... altRepresentations)` Sets the person's nicknames.
`void`	`setOrganization(Organization organization)` Sets the hierarchy of departments to which the person belongs.
`Organization`	`setOrganization(String... departments)` Sets the hierarchy of departments to which the person belongs.
`void`	`setOrganizationAlt(Organization... altRepresentations)` Sets the hierarchy of department(s) to which the person belongs.
`void`	`setProductId(ProductId productId)` Sets the product ID, which identifies the software that created the vCard.
`ProductId`	`setProductId(String productId)` Sets the product ID, which identifies the software that created the vCard.
`void`	`setProfile(Profile profile)` Sets the profile property.
`<T extends VCardProperty> List<T>`	`setProperty(Class<T> clazz, T property)` Replaces all existing properties of the given class with a single property instance.
`List<VCardProperty>`	`setProperty(VCardProperty property)` Replaces all existing properties of the given property instance's class with the given property instance.
`<T extends VCardProperty & HasAltId> List<T>`	`setPropertyAlt(Class<T> propertyClass, Collection<T> altRepresentations)` Sets a property in the form of a collection of alternative representations.
`<T extends VCardProperty & HasAltId> List<T>`	`setPropertyAlt(Class<T> propertyClass, T... altRepresentations)` Sets a property in the form of a collection of alternative representations.
`void`	`setRevision(Revision revision)` Sets the time that the vCard was last modified.
`Revision`	`setRevision(Temporal rev)` Sets the time that the vCard was last modified.
`void`	`setSortString(SortString sortString)` Sets the string that should be used to sort the vCard.
`SortString`	`setSortString(String sortString)` Sets the string that should be used to sort the vCard.
`void`	`setSourceDisplayText(SourceDisplayText sourceDisplayText)` Sets a textual representation of the `Source` property.
`SourceDisplayText`	`setSourceDisplayText(String sourceDisplayText)` Sets a textual representation of the `Source` property.
`void`	`setStructuredName(StructuredName structuredName)` Sets the individual components of the person's name.
`void`	`setStructuredNameAlt(StructuredName... altRepresentations)` Sets the individual components of the person's name.
`void`	`setTimezone(Timezone timezone)` Sets the timezone the person lives/works in.
`void`	`setTimezoneAlt(Timezone... altRepresentations)` Sets the timezone the person lives/works in.
`void`	`setUid(Uid uid)` Sets the unique identifier of the vCard.
`void`	`setVersion(VCardVersion version)` Sets the version of this vCard.
`Stream<VCardProperty>`	`stream()` Generates a stream of this vCard's properties.
`String`	`toString()`
`ValidationWarnings`	`validate(VCardVersion version)` Checks this vCard for data consistency problems or deviations from the spec.
`String`	`write()` Marshals this vCard to its text representation.
`void`	`write(OutputStream out)` Marshals this vCard to its text representation.
`void`	`write(Path file)` Marshals this vCard to its text representation.
`void`	`write(Writer writer)` Marshals this vCard to its text representation.
`String`	`writeHtml()` Marshals this vCard to a basic HTML page (hCard).
`void`	`writeHtml(OutputStream out)` Marshals this vCard to a basic HTML page (hCard).
`void`	`writeHtml(Path file)` Marshals this vCard to a basic HTML page (hCard).
`void`	`writeHtml(Writer writer)` Marshals this vCard to a basic HTML page (hCard).
`String`	`writeJson()` Marshals this vCard to its JSON representation (jCard).
`void`	`writeJson(OutputStream out)` Marshals this vCard to its JSON representation (jCard).
`void`	`writeJson(Path file)` Marshals this vCard to its JSON representation (jCard).
`void`	`writeJson(Writer writer)` Marshals this vCard to its JSON representation (jCard).
`String`	`writeXml()` Marshals this vCard to its XML representation (xCard).
`void`	`writeXml(OutputStream out)` Marshals this vCard to its XML representation (xCard).
`void`	`writeXml(Path file)` Marshals this vCard to its XML representation (xCard).
`void`	`writeXml(Writer writer)` Marshals this vCard to its XML representation (xCard).

Methods inherited from class java.lang.Object
clone, finalize, getClass, notify, notifyAll, wait, wait, wait

Methods inherited from interface java.lang.Iterable
forEach, spliterator

- Constructor Detail
  - VCard
```
public VCard()
```
    Creates a new vCard set to version 3.0.
  - VCard
```
public VCard(VCardVersion version)
```
    Creates a new vCard.
    
    Parameters:
    
    version - the version to assign to the vCard
  - VCard
```
public VCard(VCard original)
```
    Creates a deep copy of the given vCard.
    
    Parameters:
    
    original - the vCard to copy
- Method Detail
  - write
```
public String write()
```
    Marshals this vCard to its text representation.
    
    The vCard will be marshalled to whatever vCard version is assigned to this object (see setVersion(VCardVersion)). If no version is set, then it will be marshalled to 3.0.
    
    Use the VCardWriter class for more control over the marshalling process and to write multiple vCards to the same stream.
    
    Returns:
    
    the vCard string
    
    See Also:
    
    VCardWriter, vCard 2.1, RFC 2426 (3.0), RFC 6350 (4.0)
  - write
```
public void write(Path file)
           throws IOException
```
    Marshals this vCard to its text representation.
    
    The vCard will be marshalled to whatever vCard version is assigned to this object (see setVersion(VCardVersion)). If no version is set, then it will be marshalled to 3.0.
    
    Use the VCardWriter class for more control over the marshalling process and to write multiple vCards to the same stream.
    
    Parameters:
    
    file - the file to write the vCard to
    
    Throws:
    
    IOException - if there's a problem writing to the file
    
    See Also:
    
    VCardWriter, vCard 2.1, RFC 2426 (3.0), RFC 6350 (4.0)
  - write
```
public void write(OutputStream out)
           throws IOException
```
    Marshals this vCard to its text representation.
    
    The vCard will be marshalled to whatever vCard version is assigned to this object (see setVersion(VCardVersion)). If no version is set, then it will be marshalled to 3.0.
    
    Use the VCardWriter class for more control over the marshalling process and to write multiple vCards to the same stream.
    
    Parameters:
    
    out - the output stream to write the vCard to
    
    Throws:
    
    IOException - if there's a problem writing to the output stream
    
    See Also:
    
    VCardWriter, vCard 2.1, RFC 2426 (3.0), RFC 6350 (4.0)
  - write
```
public void write(Writer writer)
           throws IOException
```
    Marshals this vCard to its text representation.
    
    The vCard will be marshalled to whatever vCard version is assigned to this object (see setVersion(VCardVersion)). If no version is set, then it will be marshalled to 3.0.
    
    Use the VCardWriter class for more control over the marshalling process and to write multiple vCards to the same stream.
    
    Parameters:
    
    writer - the writer to write the vCard to
    
    Throws:
    
    IOException - if there's a problem writing to the writer
    
    See Also:
    
    VCardWriter, vCard 2.1, RFC 2426 (3.0), RFC 6350 (4.0)
  - writeXml
```
public String writeXml()
```
    Marshals this vCard to its XML representation (xCard).
    
    Use the XCardWriter class for more control over the marshalling process and to write multiple vCards to the same stream.
    
    Returns:
    
    the vCard XML document
    
    See Also:
    
    XCardWriter, RFC 6351
  - writeXml
```
public void writeXml(Path file)
              throws IOException,
                     TransformerException
```
    Marshals this vCard to its XML representation (xCard).
    
    Use the XCardWriter class for more control over the marshalling process and to write multiple vCards to the same stream.
    
    Parameters:
    
    file - the file to write to
    
    Throws:
    
    IOException - if there's a problem writing to the file
    
    TransformerException - if there's a problem writing the vCard
    
    See Also:
    
    XCardWriter, RFC 6351
  - writeXml
```
public void writeXml(OutputStream out)
              throws TransformerException
```
    Marshals this vCard to its XML representation (xCard).
    
    Use the XCardWriter class for more control over the marshalling process and to write multiple vCards to the same stream.
    
    Parameters:
    
    out - the output stream to write the vCard to
    
    Throws:
    
    TransformerException - if there's a problem writing to the output stream
    
    See Also:
    
    XCardWriter, RFC 6351
  - writeXml
```
public void writeXml(Writer writer)
              throws TransformerException
```
    Marshals this vCard to its XML representation (xCard).
    
    Use the XCardWriter class for more control over the marshalling process and to write multiple vCards to the same stream.
    
    Parameters:
    
    writer - the writer to write the vCard to
    
    Throws:
    
    TransformerException - if there's a problem writing to the writer
    
    See Also:
    
    XCardWriter, RFC 6351
  - writeHtml
```
public String writeHtml()
```
    Marshals this vCard to a basic HTML page (hCard).
    
    Use the HCardPage class for more control over the marshalling process and to write multiple vCards to the same stream.
    
    Returns:
    
    the HTML page
    
    See Also:
    
    HCardPage, hCard 1.0
  - writeHtml
```
public void writeHtml(Path file)
               throws IOException
```
    Marshals this vCard to a basic HTML page (hCard).
    
    Use the HCardPage class for more control over the marshalling process and to write multiple vCards to the same stream.
    
    Parameters:
    
    file - the file to write to
    
    Throws:
    
    IOException - if there's a problem writing to the file
    
    See Also:
    
    HCardPage, hCard 1.0
  - writeHtml
```
public void writeHtml(OutputStream out)
               throws IOException
```
    Marshals this vCard to a basic HTML page (hCard).
    
    Use the HCardPage class for more control over the marshalling process and to write multiple vCards to the same stream.
    
    Parameters:
    
    out - the output stream to write to
    
    Throws:
    
    IOException - if there's a problem writing to the output stream
    
    See Also:
    
    HCardPage, hCard 1.0
  - writeHtml
```
public void writeHtml(Writer writer)
               throws IOException
```
    Marshals this vCard to a basic HTML page (hCard).
    
    Use the HCardPage class for more control over the marshalling process and to write multiple vCards to the same stream.
    
    Parameters:
    
    writer - the writer to write to
    
    Throws:
    
    IOException - if there's a problem writing to the writer
    
    See Also:
    
    HCardPage, hCard 1.0
  - writeJson
```
public String writeJson()
```
    Marshals this vCard to its JSON representation (jCard).
    
    Use the JCardWriter class for more control over the marshalling process and to write multiple vCards to the same stream.
    
    Returns:
    
    the JSON string
    
    See Also:
    
    JCardWriter, RFC 7095
  - writeJson
```
public void writeJson(Path file)
               throws IOException
```
    Marshals this vCard to its JSON representation (jCard).
    
    Use the JCardWriter class for more control over the marshalling process and to write multiple vCards to the same stream.
    
    Parameters:
    
    file - the file to write the vCard to
    
    Throws:
    
    IOException - if there's a problem writing to the file
    
    See Also:
    
    JCardWriter, RFC 7095
  - writeJson
```
public void writeJson(OutputStream out)
               throws IOException
```
    Marshals this vCard to its JSON representation (jCard).
    
    Use the JCardWriter class for more control over the marshalling process and to write multiple vCards to the same stream.
    
    Parameters:
    
    out - the output stream to write the vCard to
    
    Throws:
    
    IOException - if there's a problem writing to the output stream
    
    See Also:
    
    JCardWriter, RFC 7095
  - writeJson
```
public void writeJson(Writer writer)
               throws IOException
```
    Marshals this vCard to its JSON representation (jCard).
    
    Use the JCardWriter class for more control over the marshalling process and to write multiple vCards to the same stream.
    
    Parameters:
    
    writer - the writer to write the vCard to
    
    Throws:
    
    IOException - if there's a problem writing to the writer
    
    See Also:
    
    JCardWriter, RFC 7095
  - getVersion
```
public VCardVersion getVersion()
```
    Gets the version attached to this vCard.
    
    Returns:
    
    the vCard version
  - setVersion
```
public void setVersion(VCardVersion version)
```
    Sets the version of this vCard.
    
    When marshalling a vCard with the VCardWriter class, use the setTargetVersion method to define what version the vCard should be marshalled as. VCardWriter does not look at the version that is set on the VCard object.
    
    Parameters:
    
    version - the vCard version
  - getKind
```
public Kind getKind()
```
    Gets the type of entity this vCard represents.
    
    Property name: KIND
    Supported versions: 4.0
    
    Returns:
    
    the kind property or null if not set
    
    See Also:
    
    RFC 6350 p.25
  - setKind
```
public void setKind(Kind kind)
```
    Sets the type of entity this vCard represents.
    
    Property name: KIND
    Supported versions: 4.0
    
    Parameters:
    
    kind - the kind property or null to remove
    
    See Also:
    
    RFC 6350 p.25
  - getGender
```
public Gender getGender()
```
    Gets the gender of the person.
    
    Property name: GENDER
    Supported versions: 4.0
    
    Returns:
    
    the gender property or null if not set
    
    See Also:
    
    RFC 6350 p.32
  - setGender
```
public void setGender(Gender gender)
```
    Sets the gender of the person.
    
    Property name: GENDER
    Supported versions: 4.0
    
    Parameters:
    
    gender - the gender property or null to remove
    
    See Also:
    
    RFC 6350 p.32
  - getMembers
```
public List<Member> getMembers()
```
    Gets the members of the group that this vCard represents.
    
    Note: If a vCard has any Member properties, then it must also have a Kind property whose value is set to "group".
    
    Property name: MEMBER
    Supported versions: 4.0
    
    Returns:
    
    the members properties (any changes made this list will affect the VCard object and vice versa)
    
    See Also:
    
    RFC 6350 p.41
  - addMember
```
public void addMember(Member member)
```
    Adds a member to the group that this vCard represents.
    
    Note: If a vCard has any Member properties, then it must also have a Kind property whose value is set to "group".
    
    Property name: MEMBER
    Supported versions: 4.0
    
    Parameters:
    
    member - the member property to add
    
    See Also:
    
    RFC 6350 p.41
  - addMemberAlt
```
public void addMemberAlt(Member... altRepresentations)
```
    Adds a member to the group that this vCard represents.
    
    Note: If a vCard has any Member properties, then it must also have a Kind property whose value is set to "group".
    
    Property name: MEMBER
    Supported versions: 4.0
    
    Parameters:
    
    altRepresentations - the alternative representations of the same value. These properties contain the same information, but in different forms (such as different languages). See this description of the ALTID parameter for more information. Note that this method automatically assigns an appropriate ALTID parameter to each property.
    
    See Also:
    
    RFC 6350 p.41
  - getProfile
```
public Profile getProfile()
```
    Gets the profile property. This property simply identifies the vCard as a vCard.
    
    Property name: PROFILE
    Supported versions: 3.0
    
    Returns:
    
    the profile property or null if not set
    
    See Also:
    
    RFC 2426 p.5
  - setProfile
```
public void setProfile(Profile profile)
```
    Sets the profile property. This property simply identifies the vCard as a vCard.
    
    Property name: PROFILE
    Supported versions: 3.0
    
    Parameters:
    
    profile - the profile property or null to remove
    
    See Also:
    
    RFC 2426 p.5
  - getClassification
```
public Classification getClassification()
```
    Gets the classification of the vCard, which describes the sensitivity of the information in the vCard.
    
    Property name: CLASS
    Supported versions: 3.0
    
    Returns:
    
    the classification property or null if not set
    
    See Also:
    
    RFC 2426 p.26
  - setClassification
```
public void setClassification(Classification classification)
```
    Sets the classification of the vCard, which describes the sensitivity of the information in the vCard.
    
    Property name: CLASS
    Supported versions: 3.0
    
    Parameters:
    
    classification - the classification property or null to remove
    
    See Also:
    
    RFC 2426 p.26
  - setClassification
```
public Classification setClassification(String classification)
```
    Sets the classification of the vCard, which describes the sensitivity of the information in the vCard.
    
    Supported versions: 3.0
    Property name: CLASS
    
    Parameters:
    
    classification - the classification (e.g. "PUBLIC", "PRIVATE", "CONFIDENTIAL") or null to remove
    
    Returns:
    
    the property object that was created
    
    See Also:
    
    RFC 2426 p.26
  - getSources
```
public List<Source> getSources()
```
    Gets the URIs that can be used to retrieve the most up-to-date version of the person's vCard.
    
    Property name: SOURCE Supported versions: 3.0, 4.0
    
    Returns:
    
    the source properties (any changes made this list will affect the VCard object and vice versa)
    
    See Also:
    
    RFC 6350 p.24, RFC 2426 p.5
  - addSource
```
public void addSource(Source source)
```
    Adds a URI that can be used to retrieve the most up-to-date version of the person's vCard.
    
    Property name: SOURCE Supported versions: 3.0, 4.0
    
    Parameters:
    
    source - the source property
    
    See Also:
    
    RFC 6350 p.24, RFC 2426 p.5
  - addSource
```
public Source addSource(String source)
```
    Adds a URI that can be used to retrieve the most up-to-date version of the person's vCard.
    
    Property name: SOURCE
    Supported versions: 3.0, 4.0
    
    Parameters:
    
    source - the source URI (e.g. "http://example.com/vcard.vcf")
    
    Returns:
    
    the property object that was created
    
    See Also:
    
    RFC 6350 p.24, RFC 2426 p.5
  - addSourceAlt
```
public void addSourceAlt(Source... altRepresentations)
```
    Adds a URI that can be used to retrieve the most up-to-date version of the person's vCard.
    
    Property name: SOURCE
    Supported versions: 4.0*
    * Only 4.0 supports alternative representations
    
    Parameters:
    
    altRepresentations - the alternative representations of the same value. These properties contain the same information, but in different forms (such as different languages). See this description of the ALTID parameter for more information. Note that this method automatically assigns an appropriate ALTID parameter to each property.
    
    See Also:
    
    RFC 6350 p.24
  - getSourceDisplayText
```
public SourceDisplayText getSourceDisplayText()
```
    Gets a textual representation of the Source property.
    
    Property name: NAME
    Supported versions: 3.0
    
    Returns:
    
    the property or null if not set
    
    See Also:
    
    RFC 2426 p.5
  - setSourceDisplayText
```
public void setSourceDisplayText(SourceDisplayText sourceDisplayText)
```
    Sets a textual representation of the Source property.
    
    Property name: NAME
    Supported versions: 3.0
    
    Parameters:
    
    sourceDisplayText - the property null to remove
    
    See Also:
    
    RFC 2426 p.5
  - setSourceDisplayText
```
public SourceDisplayText setSourceDisplayText(String sourceDisplayText)
```
    Sets a textual representation of the Source property.
    
    Property name: NAME
    Supported versions: 3.0
    
    Parameters:
    
    sourceDisplayText - a textual representation of the vCard source or null to remove
    
    Returns:
    
    the property object that was created
    
    See Also:
    
    RFC 2426 p.5
  - getFormattedNames
```
public List<FormattedName> getFormattedNames()
```
    Gets all instances of the FormattedName property.
    
    Version 4.0 vCards may have multiple instances if alternative representations are defined (see addFormattedNameAlt) or if properties with different TYPE parameters are defined.
    
    Property name: FN
    Supported versions: 4.0*
    * Only 4.0 supports multiple instances
    
    Returns:
    
    the formatted name properties (any changes made this list will affect the VCard object and vice versa)
    
    See Also:
    
    RFC 6350 p.28, RFC 2426 p.8, vCard 2.1 p.9
  - getFormattedName
```
public FormattedName getFormattedName()
```
    Gets the person's full name.
    
    Property name: FN
    Supported versions: 2.1, 3.0, 4.0
    
    Returns:
    
    the first formatted name property or null if not set
    
    See Also:
    
    RFC 6350 p.28, RFC 2426 p.8, vCard 2.1 p.9
  - setFormattedNameAlt
```
public void setFormattedNameAlt(FormattedName... altRepresentations)
```
    Sets the person's full name.
    
    Property name: FN
    Supported versions: 4.0*
    * Only 4.0 supports alternative representations
    
    Parameters:
    
    altRepresentations - the alternative representations of the same value. These properties contain the same information, but in different forms (such as different languages). See this description of the ALTID parameter for more information. Note that this method automatically assigns an appropriate ALTID parameter to each property.
    
    See Also:
    
    RFC 6350 p.28, RFC 2426 p.8, vCard 2.1 p.9
  - addFormattedNameAlt
```
public void addFormattedNameAlt(FormattedName... altRepresentations)
```
    Adds a version of the person's full name.
    
    Property name: FN
    Supported versions: 4.0*
    * Only 4.0 supports alternative representations
    
    Parameters:
    
    altRepresentations - the alternative representations of the same value. These properties contain the same information, but in different forms (such as different languages). See this description of the ALTID parameter for more information. Note that this method automatically assigns an appropriate ALTID parameter to each property.
    
    See Also:
    
    RFC 6350 p.28, RFC 2426 p.8, vCard 2.1 p.9
  - setFormattedName
```
public void setFormattedName(FormattedName formattedName)
```
    Sets the person's full name.
    
    Property name: FN
    Supported versions: 2.1, 3.0, 4.0
    
    Parameters:
    
    formattedName - the formatted name property or null to remove
    
    See Also:
    
    RFC 6350 p.28, RFC 2426 p.8, vCard 2.1 p.9
  - addFormattedName
```
public void addFormattedName(FormattedName formattedName)
```
    Adds a version of the person's full name.
    
    Property name: FN
    Supported versions: 4.0*
    * Only 4.0 supports multiple instances
    
    Parameters:
    
    formattedName - the formatted name property to add
    
    See Also:
    
    RFC 6350 p.28, RFC 2426 p.8, vCard 2.1 p.9
  - setFormattedName
```
public FormattedName setFormattedName(String formattedName)
```
    Sets the person's full name.
    
    Property name: FN
    Supported versions: 2.1, 3.0, 4.0
    
    Parameters:
    
    formattedName - the formatted name (e.g. "John Doe") or null to remove
    
    Returns:
    
    the property object that was created
    
    See Also:
    
    RFC 6350 p.28, RFC 2426 p.8, vCard 2.1 p.9
  - getStructuredNames
```
public List<StructuredName> getStructuredNames()
```
    Gets all structured name properties.
    
    Version 4.0 vCards may have multiple instances if alternative representations are defined (see setStructuredNameAlt) or if properties with different TYPE parameters are defined.
    
    Property name: N
    Supported versions: 4.0*
    * Only 4.0 supports alternative representations
    
    Returns:
    
    the structured name properties (any changes made this list will affect the VCard object and vice versa)
    
    See Also:
    
    RFC 6350 p.29, RFC 2426 p.9, vCard 2.1 p.9
  - getStructuredName
```
public StructuredName getStructuredName()
```
    Gets the individual components of the person's name.
    
    Property name: N
    Supported versions: 2.1, 3.0, 4.0
    
    Returns:
    
    the first structured name property or null if not set
    
    See Also:
    
    RFC 6350 p.29, RFC 2426 p.9, vCard 2.1 p.9
  - setStructuredNameAlt
```
public void setStructuredNameAlt(StructuredName... altRepresentations)
```
    Sets the individual components of the person's name.
    
    Property name: N
    Supported versions: 4.0*
    * Only 4.0 supports alternative representations
    
    Parameters:
    
    altRepresentations - the alternative representations of the same value. These properties contain the same information, but in different forms (such as different languages). See this description of the ALTID parameter for more information. Note that this method automatically assigns an appropriate ALTID parameter to each property.
    
    See Also:
    
    RFC 6350 p.29, RFC 2426 p.9, vCard 2.1 p.9
  - setStructuredName
```
public void setStructuredName(StructuredName structuredName)
```
    Sets the individual components of the person's name.
    Property name: N
    Supported versions: 2.1, 3.0, 4.0
    
    Parameters:
    
    structuredName - the structured name property or null to remove
  - getNicknames
```
public List<Nickname> getNicknames()
```
    Gets all instances of the Nickname property.
    
    Version 4.0 vCards may have multiple instances if alternative representations are defined (see setNicknameAlt) or if properties with different TYPE parameters are defined.
    
    Property name: NICKNAME
    Supported versions: 3.0, 4.0
    
    Returns:
    
    the nickname properties (any changes made this list will affect the VCard object and vice versa)
    
    See Also:
    
    RFC 6350 p.29, RFC 2426 p.9
  - getNickname
```
public Nickname getNickname()
```
    Gets the person's nicknames.
    
    Property name: NICKNAME
    Supported versions: 3.0, 4.0
    
    Returns:
    
    the nickname property (may contain multiple values) or null if not set
    
    See Also:
    
    RFC 6350 p.29, RFC 2426 p.9
  - setNicknameAlt
```
public void setNicknameAlt(Nickname... altRepresentations)
```
    Sets the person's nicknames.
    
    Property name: NICKNAME
    Supported versions: 4.0*
    * Only 4.0 supports alternative representations
    
    Parameters:
    
    altRepresentations - the alternative representations of the same value. These properties contain the same information, but in different forms (such as different languages). See this description of the ALTID parameter for more information. Note that this method automatically assigns an appropriate ALTID parameter to each property.
    
    See Also:
    
    RFC 6350 p.29, RFC 2426 p.9
  - addNicknameAlt
```
public void addNicknameAlt(Nickname... altRepresentations)
```
    Adds a collection of nicknames for the person.
    
    Property name: NICKNAME
    Supported versions: 4.0*
    * Only 4.0 supports alternative representations
    
    Parameters:
    
    altRepresentations - the alternative representations of the same value. These properties contain the same information, but in different forms (such as different languages). See this description of the ALTID parameter for more information. Note that this method automatically assigns an appropriate ALTID parameter to each property.
    
    See Also:
    
    RFC 6350 p.29, RFC 2426 p.9
  - setNickname
```
public void setNickname(Nickname nickname)
```
    Sets the person's nicknames.
    
    Property name: NICKNAME
    Supported versions: 3.0, 4.0
    
    Parameters:
    
    nickname - the nickname property (may contain multiple values) or null to remove
    
    See Also:
    
    RFC 6350 p.29, RFC 2426 p.9
  - addNickname
```
public void addNickname(Nickname nickname)
```
    Adds a set of nicknames for the person.
    
    Note that only version 4.0 vCards support multiple instances of this property.
    
    Property name: NICKNAME
    Supported versions: 4.0*
    * Only 4.0 supports multiple instances
    
    Parameters:
    
    nickname - the nickname property (may contain multiple values)
    
    See Also:
    
    RFC 6350 p.29, RFC 2426 p.9
  - setNickname
```
public Nickname setNickname(String... nicknames)
```
    Sets the person's nicknames.
    
    Property name: NICKNAME
    Supported versions: 3.0, 4.0
    
    Parameters:
    
    nicknames - the nicknames (e.g. "John", "Jon")
    
    Returns:
    
    the property object that was created
    
    See Also:
    
    RFC 6350 p.29, RFC 2426 p.9
  - getSortString
```
public SortString getSortString()
```
    Gets the string that should be used to sort the vCard. This typically set to the person's family name (last name).
    
    For 4.0 vCards, this information is stored in the StructuredName.getSortAs() and/or Organization.getSortAs() methods.
    
    Property name: SORT-STRING
    Supported versions: 3.0
    
    Returns:
    
    the sort string property or null if not set
    
    See Also:
    
    RFC 2426 p.22
  - setSortString
```
public void setSortString(SortString sortString)
```
    Sets the string that should be used to sort the vCard. This typically set to the person's family name (last name).
    
    For 4.0 vCards, this information is stored in the StructuredName.getSortAs() and/or Organization.getSortAs() methods.
    
    Property name: SORT-STRING
    Supported versions: 3.0
    
    Parameters:
    
    sortString - the sort string property or null to remove
    
    See Also:
    
    RFC 2426 p.22
  - setSortString
```
public SortString setSortString(String sortString)
```
    Sets the string that should be used to sort the vCard. This typically set to the person's family name (last name).
    
    For 4.0 vCards, this information is stored in the StructuredName.getSortAs() and/or Organization.getSortAs() methods.
    
    Property name: SORT-STRING
    Supported versions: 3.0
    
    Parameters:
    
    sortString - the sort string (e.g. "Armour" if the person's last name is "d'Armour") or null to remove
    
    Returns:
    
    the property object that was created
    
    See Also:
    
    RFC 2426 p.22
  - getTitles
```
public List<Title> getTitles()
```
    Gets the titles associated with the person.
    
    Property name: TITLE
    Supported versions: 2.1, 3.0, 4.0
    
    Returns:
    
    the title properties (any changes made this list will affect the VCard object and vice versa)
    
    See Also:
    
    RFC 6350 p.39, RFC 2426 p.17, vCard 2.1 p.17
  - addTitle
```
public void addTitle(Title title)
```
    Adds a title associated with the person.
    
    Property name: TITLE
    Supported versions: 2.1, 3.0, 4.0
    
    Parameters:
    
    title - the title property to add
    
    See Also:
    
    RFC 6350 p.39, RFC 2426 p.17, vCard 2.1 p.17
  - addTitle
```
public Title addTitle(String title)
```
    Adds a title associated with the person.
    
    Property name: TITLE
    Supported versions: 2.1, 3.0, 4.0
    
    Parameters:
    
    title - the title to add (e.g. "V.P. Research and Development")
    
    Returns:
    
    the property object that was created
    
    See Also:
    
    RFC 6350 p.39, RFC 2426 p.17, vCard 2.1 p.17
  - addTitleAlt
```
public void addTitleAlt(Title... altRepresentations)
```
    Adds a title associated with the person.
    
    Property name: TITLE
    Supported versions: 4.0*
    * Only 4.0 supports alternative representations
    
    Parameters:
    
    altRepresentations - the alternative representations of the same value. These properties contain the same information, but in different forms (such as different languages). See this description of the ALTID parameter for more information. Note that this method automatically assigns an appropriate ALTID parameter to each property.
    
    See Also:
    
    RFC 6350 p.39, RFC 2426 p.17, vCard 2.1 p.17
  - getRoles
```
public List<Role> getRoles()
```
    Gets the roles associated with the person.
    
    Property name: ROLE
    Supported versions: 2.1, 3.0, 4.0
    
    Returns:
    
    the role properties (any changes made this list will affect the VCard object and vice versa)
    
    See Also:
    
    RFC 6350 p.39, RFC 2426 p.18, vCard 2.1 p.17
  - addRole
```
public void addRole(Role role)
```
    Adds a role associated with the person.
    
    Property name: ROLE
    Supported versions: 2.1, 3.0, 4.0
    
    Parameters:
    
    role - the role property to add
    
    See Also:
    
    RFC 6350 p.39, RFC 2426 p.18, vCard 2.1 p.17
  - addRole
```
public Role addRole(String role)
```
    Adds a role associated with the person.
    
    Property name: ROLE
    Supported versions: 2.1, 3.0, 4.0
    
    Parameters:
    
    role - the role to add (e.g. "Executive")
    
    Returns:
    
    the property object that was created
    
    See Also:
    
    RFC 6350 p.39, RFC 2426 p.18, vCard 2.1 p.17
  - addRoleAlt
```
public void addRoleAlt(Role... altRepresentations)
```
    Adds a role associated with the person.
    
    Property name: ROLE
    Supported versions: 4.0*
    * Only 4.0 supports alternative representations
    
    Parameters:
    
    altRepresentations - the alternative representations of the same value. These properties contain the same information, but in different forms (such as different languages). See this description of the ALTID parameter for more information. Note that this method automatically assigns an appropriate ALTID parameter to each property.
    
    See Also:
    
    RFC 6350 p.39, RFC 2426 p.18, vCard 2.1 p.17
  - getPhotos
```
public List<Photo> getPhotos()
```
    Gets the photos attached to the vCard, such as the person's portrait.
    
    Property name: PHOTO
    Supported versions: 2.1, 3.0, 4.0
    
    Returns:
    
    the photo properties (any changes made this list will affect the VCard object and vice versa)
    
    See Also:
    
    RFC 6350 p.30, RFC 2426 p.10, vCard 2.1 p.10
  - addPhoto
```
public void addPhoto(Photo photo)
```
    Adds a photo to the vCard, such as the person's portrait.
    
    Property name: PHOTO
    Supported versions: 2.1, 3.0, 4.0
    
    Parameters:
    
    photo - the photo property to add
    
    See Also:
    
    RFC 6350 p.30, RFC 2426 p.10, vCard 2.1 p.10
  - addPhotoAlt
```
public void addPhotoAlt(Photo... altRepresentations)
```
    Adds a photo to the vCard, such as the person's portrait.
    
    Property name: PHOTO
    Supported versions: 4.0*
    * Only 4.0 supports alternative representations
    
    Parameters:
    
    altRepresentations - the alternative representations of the same value. These properties contain the same information, but in different forms (such as different languages). See this description of the ALTID parameter for more information. Note that this method automatically assigns an appropriate ALTID parameter to each property.
    
    See Also:
    
    RFC 6350 p.30, RFC 2426 p.10, vCard 2.1 p.10
  - getLogos
```
public List<Logo> getLogos()
```
    Gets the logos attached to the vCard, such a company logo.
    
    Property name: LOGO
    Supported versions: 2.1, 3.0, 4.0
    
    Returns:
    
    the logo properties (any changes made this list will affect the VCard object and vice versa)
    
    See Also:
    
    RFC 6350 p.40, RFC 2426 p.18, vCard 2.1 p.17
  - addLogo
```
public void addLogo(Logo logo)
```
    Adds a logo to the vCard, such as a company logo.
    
    Property name: LOGO
    Supported versions: 2.1, 3.0, 4.0
    
    Parameters:
    
    logo - the logo property to add
    
    See Also:
    
    RFC 6350 p.40, RFC 2426 p.18, vCard 2.1 p.17
  - addLogoAlt
```
public void addLogoAlt(Logo... altRepresentations)
```
    Adds a logo to the vCard, such as a company logo.
    
    Property name: LOGO
    Supported versions: 4.0*
    * Only 4.0 supports alternative representations
    
    Parameters:
    
    altRepresentations - the alternative representations of the same value. These properties contain the same information, but in different forms (such as different languages). See this description of the ALTID parameter for more information. Note that this method automatically assigns an appropriate ALTID parameter to each property.
    
    See Also:
    
    RFC 6350 p.40, RFC 2426 p.18, vCard 2.1 p.17
  - getSounds
```
public List<Sound> getSounds()
```
    Gets the sounds attached to the vCard, such as a pronunciation of the person's name.
    
    Property name: SOUND
    Supported versions: 2.1, 3.0, 4.0
    
    Returns:
    
    the sound properties (any changes made this list will affect the VCard object and vice versa)
    
    See Also:
    
    RFC 6350 p.45, RFC 2426 p.23, vCard 2.1 p.20
  - addSound
```
public void addSound(Sound sound)
```
    Adds a sound to the vCard, such as a pronunciation of the person's name.
    
    Property name: SOUND
    Supported versions: 2.1, 3.0, 4.0
    
    Parameters:
    
    sound - the sound property to add
    
    See Also:
    
    RFC 6350 p.45, RFC 2426 p.23, vCard 2.1 p.20
  - addSoundAlt
```
public void addSoundAlt(Sound... altRepresentations)
```
    Adds a sound to the vCard, such as a pronunciation of the person's name.
    
    Property name: SOUND
    Supported versions: 4.0*
    * Only 4.0 supports alternative representations
    
    Parameters:
    
    altRepresentations - the alternative representations of the same value. These properties contain the same information, but in different forms (such as different languages). See this description of the ALTID parameter for more information. Note that this method automatically assigns an appropriate ALTID parameter to each property.
    
    See Also:
    
    RFC 6350 p.45, RFC 2426 p.23, vCard 2.1 p.20
  - getBirthplaces
```
public List<Birthplace> getBirthplaces()
```
    Gets all Birthplace property instances.
    
    There may be multiple instances if alternative representations are defined (see setBirthplaceAlt).
    
    Property name: BIRTHPLACE
    Supported versions: 4.0
    
    Returns:
    
    the birthplace properties (any changes made this list will affect the VCard object and vice versa)
    
    See Also:
    
    RFC 6474 p.2
  - getBirthplace
```
public Birthplace getBirthplace()
```
    Gets the person's birthplace.
    
    Property name: BIRTHPLACE
    Supported versions: 4.0
    
    Returns:
    
    the first birthplace property or null if not set
    
    See Also:
    
    RFC 6474 p.2
  - setBirthplaceAlt
```
public void setBirthplaceAlt(Birthplace... altRepresentations)
```
    Sets the person's birthplace.
    
    Property name: BIRTHPLACE
    Supported versions: 4.0
    
    Parameters:
    
    altRepresentations - the alternative representations of the same value. These properties contain the same information, but in different forms (such as different languages). See this description of the ALTID parameter for more information. Note that this method automatically assigns an appropriate ALTID parameter to each property.
    
    See Also:
    
    RFC 6474 p.2
  - setBirthplace
```
public void setBirthplace(Birthplace birthplace)
```
    Sets the person's birthplace.
    
    Property name: BIRTHPLACE
    Supported versions: 4.0
    
    Parameters:
    
    birthplace - the birthplace property or null to remove
    
    See Also:
    
    RFC 6474 p.2
  - getDeathplaces
```
public List<Deathplace> getDeathplaces()
```
    Gets all Deathplace property instances.
    
    There may be multiple instances if alternative representations are defined (see setDeathplaceAlt).
    
    Property name: DEATHPLACE
    Supported versions: 4.0
    
    Returns:
    
    the deathplace properties (any changes made this list will affect the VCard object and vice versa)
    
    See Also:
    
    RFC 6474 p.3
  - getDeathplace
```
public Deathplace getDeathplace()
```
    Gets the person's place of death.
    
    Property name: DEATHPLACE
    Supported versions: 4.0
    
    Returns:
    
    the first deathplace property or null if not set
    
    See Also:
    
    RFC 6474 p.3
  - setDeathplaceAlt
```
public void setDeathplaceAlt(Deathplace... altRepresentations)
```
    Sets the person's place of death.
    
    Property name: DEATHPLACE
    Supported versions: 4.0
    
    Parameters:
    
    altRepresentations - the alternative representations of the same value. These properties contain the same information, but in different forms (such as different languages). See this description of the ALTID parameter for more information. Note that this method automatically assigns an appropriate ALTID parameter to each property.
    
    See Also:
    
    RFC 6474 p.3
  - setDeathplace
```
public void setDeathplace(Deathplace deathplace)
```
    Sets the person's place of death.
    
    Property name: DEATHPLACE
    Supported versions: 4.0
    
    Parameters:
    
    deathplace - the deathplace property or null to remove
    
    See Also:
    
    RFC 6474 p.3
  - getDeathdates
```
public List<Deathdate> getDeathdates()
```
    Gets all Deathdate property instances.
    
    There may be multiple instances if alternative representations are defined (see setDeathdateAlt).
    
    Property name: DEATHDATE
    Supported versions: 4.0
    
    Returns:
    
    the death date properties (any changes made this list will affect the VCard object and vice versa)
    
    See Also:
    
    RFC 6474 p.4
  - getDeathdate
```
public Deathdate getDeathdate()
```
    Gets the person's time of death.
    
    Property name: DEATHDATE
    Supported versions: 4.0
    
    Returns:
    
    the first death date property or null if not set
    
    See Also:
    
    RFC 6474, RFC 6474 p.4
  - setDeathdateAlt
```
public void setDeathdateAlt(Deathdate... altRepresentations)
```
    Sets the person's time of death.
    
    Property name: DEATHDATE
    Supported versions: 4.0
    
    Parameters:
    
    altRepresentations - the alternative representations of the same value. These properties contain the same information, but in different forms (such as different languages). See this description of the ALTID parameter for more information. Note that this method automatically assigns an appropriate ALTID parameter to each property.
    
    See Also:
    
    RFC 6474 p.4
  - setDeathdate
```
public Deathdate setDeathdate(LocalDate date)
```
    Sets the person's time of death.
    
    Property name: DEATHDATE
    Supported versions: 4.0
    
    Parameters:
    
    date - the death date or null to remove
    
    Returns:
    
    the property object that was created
    
    See Also:
    
    RFC 6474, RFC 6474 p.4
  - setDeathdate
```
public void setDeathdate(Deathdate deathdate)
```
    Sets the person's time of death.
    
    Property name: DEATHDATE
    Supported versions: 4.0
    
    Parameters:
    
    deathdate - the death date property or null to remove
    
    See Also:
    
    RFC 6474, RFC 6474 p.4
  - getBirthdays
```
public List<Birthday> getBirthdays()
```
    Gets all Birthday property instances.
    
    There may be multiple instances if alternative representations are defined (see setBirthdayAlt).
    
    Property name: BDAY
    Supported versions: 4.0*
    * Only 4.0 supports alternative representations
    
    Returns:
    
    the birthday properties (any changes made this list will affect the VCard object and vice versa)
    
    See Also:
    
    RFC 6350 p.30, RFC 2426 p.11, vCard 2.1 p.11
  - getBirthday
```
public Birthday getBirthday()
```
    Gets the person's birthday.
    
    Property name: BDAY
    Supported versions: 2.1, 3.0, 4.0
    
    Returns:
    
    the first birthday property or null if not set
    
    See Also:
    
    RFC 6350 p.30, RFC 2426 p.11, vCard 2.1 p.11
  - setBirthdayAlt
```
public void setBirthdayAlt(Birthday... altRepresentations)
```
    Sets the person's birthday.
    
    Property name: BDAY
    Supported versions: 4.0*
    * Only 4.0 supports alternative representations
    
    Parameters:
    
    altRepresentations - the alternative representations of the same value. These properties contain the same information, but in different forms (such as different languages). See this description of the ALTID parameter for more information. Note that this method automatically assigns an appropriate ALTID parameter to each property.
    
    See Also:
    
    RFC 6350 p.30, RFC 2426 p.11, vCard 2.1 p.11
  - setBirthday
```
public Birthday setBirthday(LocalDate date)
```
    Sets the person's birthday.
    
    Property name: BDAY
    Supported versions: 2.1, 3.0, 4.0
    
    Parameters:
    
    date - the birthday or null to remove
    
    Returns:
    
    the property object that was created
    
    See Also:
    
    RFC 6350 p.30, RFC 2426 p.11, vCard 2.1 p.11
  - setBirthday
```
public void setBirthday(Birthday birthday)
```
    Sets the person's birthday.
    
    Property name: BDAY
    Supported versions: 2.1, 3.0, 4.0
    
    Parameters:
    
    birthday - the birthday or null to remove
    
    See Also:
    
    RFC 6350 p.30, RFC 2426 p.11, vCard 2.1 p.11
  - getAnniversaries
```
public List<Anniversary> getAnniversaries()
```
    Gets all Anniversary property instances.
    
    There may be multiple instances if alternative representations are defined (see setAnniversaryAlt ).
    
    Property name: ANNIVERSARY
    Supported versions: 4.0
    
    Returns:
    
    the anniversary properties (any changes made this list will affect the VCard object and vice versa)
    
    See Also:
    
    RFC 6350 p.31
  - getAnniversary
```
public Anniversary getAnniversary()
```
    Gets the person's anniversary.
    
    Property name: ANNIVERSARY
    Supported versions: 4.0
    
    Returns:
    
    the first anniversary property or null if not set
    
    See Also:
    
    RFC 6350 p.31
  - setAnniversaryAlt
```
public void setAnniversaryAlt(Anniversary... altRepresentations)
```
    Sets the person's anniversary.
    
    Property name: ANNIVERSARY
    Supported versions: 4.0
    
    Parameters:
    
    altRepresentations - the alternative representations of the same value. These properties contain the same information, but in different forms (such as different languages). See this description of the ALTID parameter for more information. Note that this method automatically assigns an appropriate ALTID parameter to each property.
    
    See Also:
    
    RFC 6350 p.31
  - setAnniversary
```
public Anniversary setAnniversary(LocalDate date)
```
    Sets the person's anniversary.
    
    Property name: ANNIVERSARY
    Supported versions: 4.0
    
    Parameters:
    
    date - the date of the anniversary or null to remove
    
    Returns:
    
    the property object that was created
    
    See Also:
    
    RFC 6350 p.31
  - setAnniversary
```
public void setAnniversary(Anniversary anniversary)
```
    Sets the person's anniversary.
    
    Property name: ANNIVERSARY
    Supported versions: 4.0
    
    Parameters:
    
    anniversary - the anniversary property or null to remove
    
    See Also:
    
    RFC 6350 p.31
  - getRevision
```
public Revision getRevision()
```
    Gets the time that the vCard was last modified.
    Property name: REV
    Supported versions: 2.1, 3.0, 4.0
    
    Returns:
    
    the revision property or null if not set
    
    See Also:
    
    RFC 6350 p.45, RFC 2426 p.22, vCard 2.1 p.19
  - setRevision
```
public void setRevision(Revision revision)
```
    Sets the time that the vCard was last modified.
    
    Property name: REV
    Supported versions: 2.1, 3.0, 4.0
    
    Parameters:
    
    revision - the revision property or null to remove
    
    See Also:
    
    RFC 6350 p.45, RFC 2426 p.22, vCard 2.1 p.19
  - setRevision
```
public Revision setRevision(Temporal rev)
```
    Sets the time that the vCard was last modified.
    
    Property name: REV
    Supported versions: 2.1, 3.0, 4.0
    
    Parameters:
    
    rev - the last modified time (Instant recommended) or null to remove
    
    Returns:
    
    the property object that was created
    
    See Also:
    
    RFC 6350 p.45, RFC 2426 p.22, vCard 2.1 p.19
  - getProductId
```
public ProductId getProductId()
```
    Gets the product ID, which identifies the software that created the vCard.
    
    Property name: PRODID
    Supported versions: 3.0, 4.0
    
    Returns:
    
    the product ID property or null if not set
    
    See Also:
    
    RFC 6350 p.44, RFC 2426 p.21
  - setProductId
```
public void setProductId(ProductId productId)
```
    Sets the product ID, which identifies the software that created the vCard.
    
    Property name: PRODID
    Supported versions: 3.0, 4.0
    
    Parameters:
    
    productId - the product ID property or null to remove
    
    See Also:
    
    RFC 6350 p.44, RFC 2426 p.21
  - setProductId
```
public ProductId setProductId(String productId)
```
    Sets the product ID, which identifies the software that created the vCard.
    
    Property name: PRODID
    Supported versions: 3.0, 4.0
    
    Parameters:
    
    productId - the product ID (e.g. "ez-vcard 1.0") or null to remove
    
    Returns:
    
    the property object that was created
    
    See Also:
    
    RFC 6350 p.44, RFC 2426 p.21
  - getAddresses
```
public List<Address> getAddresses()
```
    Gets the mailing addresses.
    
    Property name: ADR
    Supported versions: 2.1, 3.0, 4.0
    
    Returns:
    
    the mailing address properties (any changes made this list will affect the VCard object and vice versa)
    
    See Also:
    
    RFC 6350 p.32, RFC 2426 p.11, vCard 2.1 p.11
  - addAddress
```
public void addAddress(Address address)
```
    Adds a mailing address.
    
    Property name: ADR
    Supported versions: 2.1, 3.0, 4.0
    
    Parameters:
    
    address - the mailing address property to add
    
    See Also:
    
    RFC 6350 p.32, RFC 2426 p.11, vCard 2.1 p.11
  - addAddressAlt
```
public void addAddressAlt(Address... altRepresentations)
```
    Adds a mailing address.
    
    Property name: ADR
    Supported versions: 4.0*
    * Only 4.0 supports alternative representations
    
    Parameters:
    
    altRepresentations - the alternative representations of the same value. These properties contain the same information, but in different forms (such as different languages). See this description of the ALTID parameter for more information. Note that this method automatically assigns an appropriate ALTID parameter to each property.
    
    See Also:
    
    RFC 6350 p.32, RFC 2426 p.11, vCard 2.1 p.11
  - getOrphanedLabels
```
public List<Label> getOrphanedLabels()
```
    Gets all mailing labels that could not be assigned to an Address property. Use Address.getLabel() to get a label that has been assigned to an address.
    
    Property name: LABEL
    Supported versions: 2.1, 3.0
    
    Returns:
    
    the orphaned label properties (any changes made this list will affect the VCard object and vice versa)
    
    See Also:
    
    RFC 2426 p.13, vCard 2.1 p.12
  - addOrphanedLabel
```
public void addOrphanedLabel(Label label)
```
    Adds a mailing label which is not associated with an Address property.
    
    Use of this method is strongly discouraged. To add a mailing label to an address, use the Address.setLabel(java.lang.String) method.
    
    Property name: LABEL
    Supported versions: 2.1, 3.0
    
    Parameters:
    
    label - the orphaned label property to add
    
    See Also:
    
    RFC 2426 p.13, vCard 2.1 p.12
  - getEmails
```
public List<Email> getEmails()
```
    Gets the email addresses.
    
    Property name: EMAIL
    Supported versions: 2.1, 3.0, 4.0
    
    Returns:
    
    the email address properties (any changes made this list will affect the VCard object and vice versa)
    
    See Also:
    
    RFC 6350 p.36, RFC 2426 p.15, vCard 2.1 p.15
  - addEmail
```
public void addEmail(Email email)
```
    Adds an email address.
    
    Property name: EMAIL
    Supported versions: 2.1, 3.0, 4.0
    
    Parameters:
    
    email - the email address property to add
    
    See Also:
    
    RFC 6350 p.36, RFC 2426 p.15, vCard 2.1 p.15
  - addEmail
```
public Email addEmail(String email,
                      EmailType... types)
```
    Adds an email address.
    
    Property name: EMAIL
    Supported versions: 2.1, 3.0, 4.0
    
    Parameters:
    
    email - the email address to add (e.g. "johndoe@aol.com")
    
    types - the type(s) to assign to the email
    
    Returns:
    
    the property object that was created
    
    See Also:
    
    RFC 6350 p.36, RFC 2426 p.15, vCard 2.1 p.15
  - addEmailAlt
```
public void addEmailAlt(Email... altRepresentations)
```
    Adds an email address.
    
    Property name: EMAIL
    Supported versions: 4.0*
    * Only 4.0 supports alternative representations
    
    Parameters:
    
    altRepresentations - the alternative representations of the same value. These properties contain the same information, but in different forms (such as different languages). See this description of the ALTID parameter for more information. Note that this method automatically assigns an appropriate ALTID parameter to each property.
    
    See Also:
    
    RFC 6350 p.36, RFC 2426 p.15, vCard 2.1 p.15
  - getTelephoneNumbers
```
public List<Telephone> getTelephoneNumbers()
```
    Gets the telephone numbers.
    
    Property name: TEL
    Supported versions: 2.1, 3.0, 4.0
    
    Returns:
    
    the telephone number properties (any changes made this list will affect the VCard object and vice versa)
    
    See Also:
    
    RFC 6350 p.34, RFC 2426 p.14, vCard 2.1 p.13
  - addTelephoneNumber
```
public void addTelephoneNumber(Telephone telephoneNumber)
```
    Adds a telephone number.
    
    Property name: TEL
    Supported versions: 2.1, 3.0, 4.0
    
    Parameters:
    
    telephoneNumber - the telephone number property to add
    
    See Also:
    
    RFC 6350 p.34, RFC 2426 p.14, vCard 2.1 p.13
  - addTelephoneNumber
```
public Telephone addTelephoneNumber(String telephoneNumber,
                                    TelephoneType... types)
```
    Adds a telephone number.
    
    Property name: TEL
    Supported versions: 2.1, 3.0, 4.0
    
    Parameters:
    
    telephoneNumber - the telephone number to add (e.g. "+1 555-555-5555")
    
    types - the type(s) to assign to the telephone number (e.g. "cell", "work", etc)
    
    Returns:
    
    the property object that was created
    
    See Also:
    
    RFC 6350 p.34, RFC 2426 p.14, vCard 2.1 p.13
  - addTelephoneNumberAlt
```
public void addTelephoneNumberAlt(Telephone... altRepresentations)
```
    Adds a telephone number.
    
    Property name: TEL
    Supported versions: 4.0*
    * Only 4.0 supports alternative representations
    
    Parameters:
    
    altRepresentations - the alternative representations of the same value. These properties contain the same information, but in different forms (such as different languages). See this description of the ALTID parameter for more information. Note that this method automatically assigns an appropriate ALTID parameter to each property.
    
    See Also:
    
    RFC 6350 p.34, RFC 2426 p.14, vCard 2.1 p.13
  - getMailer
```
public Mailer getMailer()
```
    Gets the email client that the person uses.
    
    Property name: MAILER
    Supported versions: 2.1, 3.0
    
    Returns:
    
    the mailer property or null if not set
    
    See Also:
    
    RFC 2426 p.15, vCard 2.1 p.15
  - setMailer
```
public void setMailer(Mailer mailer)
```
    Sets the email client that the person uses.
    
    Property name: MAILER
    Supported versions: 2.1, 3.0
    
    Parameters:
    
    mailer - the mailer property or null to remove
    
    See Also:
    
    RFC 2426 p.15, vCard 2.1 p.15
  - setMailer
```
public Mailer setMailer(String mailer)
```
    Sets the email client that the person uses.
    
    Property name: MAILER
    Supported versions: 2.1, 3.0
    
    Parameters:
    
    mailer - the email client (e.g. "Thunderbird") or null to remove
    
    Returns:
    
    the property object that was created
    
    See Also:
    
    RFC 2426 p.15, vCard 2.1 p.15
  - getUrls
```
public List<Url> getUrls()
```
    Gets the URLs. URLs can point to websites such as a personal homepage or business website.
    
    Property name: URL
    Supported versions: 2.1, 3.0, 4.0
    
    Returns:
    
    the URL properties (any changes made this list will affect the VCard object and vice versa)
    
    See Also:
    
    RFC 6350 p.47, RFC 2426 p.25, vCard 2.1 p.21
  - addUrl
```
public void addUrl(Url url)
```
    Adds a URL. URLs can point to websites such as a personal homepage or business website.
    
    Property name: URL
    Supported versions: 2.1, 3.0, 4.0
    
    Parameters:
    
    url - the URL property to add
    
    See Also:
    
    RFC 6350 p.47, RFC 2426 p.25, vCard 2.1 p.21
  - addUrl
```
public Url addUrl(String url)
```
    Adds a URL. URLs can point to websites such as a personal homepage or business website.
    
    Property name: URL
    Supported versions: 2.1, 3.0, 4.0
    
    Parameters:
    
    url - the URL to add (e.g. "http://example.com")
    
    Returns:
    
    the property object that was created
    
    See Also:
    
    RFC 6350 p.47, RFC 2426 p.25, vCard 2.1 p.21
  - addUrlAlt
```
public void addUrlAlt(Url... altRepresentations)
```
    Adds a URL. URLs can point to websites such as a personal homepage or business website.
    
    Property name: URL
    Supported versions: 4.0*
    * Only 4.0 supports alternative representations
    
    Parameters:
    
    altRepresentations - the alternative representations of the same value. These properties contain the same information, but in different forms (such as different languages). See this description of the ALTID parameter for more information. Note that this method automatically assigns an appropriate ALTID parameter to each property.
    
    See Also:
    
    RFC 6350 p.47, RFC 2426 p.25, vCard 2.1 p.21
  - getTimezones
```
public List<Timezone> getTimezones()
```
    Gets all instances of the Timezone property.
    
    Version 4.0 vCards may have multiple instances if alternative representations are defined (see setTimezoneAlt) or if properties with different TYPE parameters are defined.
    
    Property name: TZ
    Supported versions: 4.0*
    * Only 4.0 supports multiple instances
    
    Returns:
    
    the timezone properties (any changes made this list will affect the VCard object and vice versa)
    
    See Also:
    
    RFC 6350 p.22, RFC 2426 p.16, vCard 2.1 p.16
  - getTimezone
```
public Timezone getTimezone()
```
    Gets the timezone the person lives/works in.
    
    Property name: TZ
    Supported versions: 2.1, 3.0, 4.0
    
    Returns:
    
    the first timezone property or null if not set
    
    See Also:
    
    RFC 6350 p.22, RFC 2426 p.16, vCard 2.1 p.16
  - setTimezoneAlt
```
public void setTimezoneAlt(Timezone... altRepresentations)
```
    Sets the timezone the person lives/works in.
    
    Property name: TZ
    Supported versions: 4.0*
    * Only 4.0 supports alternative representations
    
    Parameters:
    
    altRepresentations - the alternative representations of the same value. These properties contain the same information, but in different forms (such as different languages). See this description of the ALTID parameter for more information. Note that this method automatically assigns an appropriate ALTID parameter to each property.
    
    See Also:
    
    RFC 6350 p.22, RFC 2426 p.16, vCard 2.1 p.16
  - addTimezoneAlt
```
public void addTimezoneAlt(Timezone... altRepresentations)
```
    Adds a timezone the person lives/works in.
    
    Property name: TZ
    Supported versions: 4.0*
    * Only 4.0 supports alternative representations
    
    Parameters:
    
    altRepresentations - the alternative representations of the same value. These properties contain the same information, but in different forms (such as different languages). See this description of the ALTID parameter for more information. Note that this method automatically assigns an appropriate ALTID parameter to each property.
    
    See Also:
    
    RFC 6350 p.22, RFC 2426 p.16, vCard 2.1 p.16
  - setTimezone
```
public void setTimezone(Timezone timezone)
```
    Sets the timezone the person lives/works in.
    
    Property name: TZ
    Supported versions: 2.1, 3.0, 4.0
    
    Parameters:
    
    timezone - the timezone property or null to remove
    
    See Also:
    
    RFC 6350 p.22, RFC 2426 p.16, vCard 2.1 p.16
  - addTimezone
```
public void addTimezone(Timezone timezone)
```
    Adds a timezone the person lives/works in.
    
    Property name: TZ
    Supported versions: 4.0*
    * Only 4.0 supports multiple instances
    
    Parameters:
    
    timezone - the timezone property to add
    
    See Also:
    
    RFC 6350 p.22, RFC 2426 p.16, vCard 2.1 p.16
  - getGeos
```
public List<Geo> getGeos()
```
    Gets all instances of the Geo property.
    
    Version 4.0 vCards may have multiple instances if alternative representations are defined (see setGeoAlt) or if properties with different TYPE parameters are defined.
    
    Property name: GEO
    Supported versions: 4.0*
    * Only 4.0 supports multiple instances
    
    Returns:
    
    the geo properties (any changes made this list will affect the VCard object and vice versa)
    
    See Also:
    
    RFC 6350 p.38, RFC 2426 p.16, vCard 2.1 p.16
  - getGeo
```
public Geo getGeo()
```
    Gets the geographical position of where the person lives/works.
    
    Property name: GEO
    Supported versions: 2.1, 3.0, 4.0
    
    Returns:
    
    the first geo property or null if not set
    
    See Also:
    
    RFC 6350 p.38, RFC 2426 p.16, vCard 2.1 p.16
  - setGeoAlt
```
public void setGeoAlt(Geo... altRepresentations)
```
    Sets the geographical position of where the person lives/works.
    
    Property name: GEO
    Supported versions: 4.0*
    * Only 4.0 supports alternative representations
    
    Parameters:
    
    altRepresentations - the alternative representations of the same value. These properties contain the same information, but in different forms (such as different languages). See this description of the ALTID parameter for more information. Note that this method automatically assigns an appropriate ALTID parameter to each property.
    
    See Also:
    
    RFC 6350 p.38, RFC 2426 p.16, vCard 2.1 p.16
  - addGeoAlt
```
public void addGeoAlt(Geo... altRepresentations)
```
    Adds a geographical position of where the person lives/works.
    
    Property name: GEO
    Supported versions: 4.0*
    * Only 4.0 supports alternative representations
    
    Parameters:
    
    altRepresentations - the alternative representations of the same value. These properties contain the same information, but in different forms (such as different languages). See this description of the ALTID parameter for more information. Note that this method automatically assigns an appropriate ALTID parameter to each property.
    
    See Also:
    
    RFC 6350 p.38, RFC 2426 p.16, vCard 2.1 p.16
  - setGeo
```
public void setGeo(Geo geo)
```
    Sets the geographical position of where the person lives/works.
    
    Property name: GEO
    Supported versions: 2.1, 3.0, 4.0
    
    Parameters:
    
    geo - the geo property or null to remove
    
    See Also:
    
    RFC 6350 p.38, RFC 2426 p.16, vCard 2.1 p.16
  - addGeo
```
public void addGeo(Geo geo)
```
    Adds a geographical position of where the person lives/works. Note that only version 4.0 vCards support multiple instances of this property.
    
    Property name: GEO
    Supported versions: 4.0*
    * Only 4.0 supports multiple instances
    
    Parameters:
    
    geo - the geo property to add
    
    See Also:
    
    RFC 6350 p.38, RFC 2426 p.16, vCard 2.1 p.16
  - setGeo
```
public Geo setGeo(double latitude,
                  double longitude)
```
    Sets the geographical position of where the person lives/works.
    
    Property name: GEO
    Supported versions: 2.1, 3.0, 4.0
    
    Parameters:
    
    latitude - the latitude
    
    longitude - the longitude
    
    Returns:
    
    the property object that was created
    
    See Also:
    
    RFC 6350 p.38, RFC 2426 p.16, vCard 2.1 p.16
  - getOrganizations
```
public List<Organization> getOrganizations()
```
    Gets all instances of the Organization property.
    
    Version 4.0 vCards may have multiple instances if alternative representations are defined (see setOrganizationAlt) or if properties with different TYPE parameters are defined.
    
    Property name: ORG
    Supported versions: 4.0*
    * Only 4.0 supports multiple instances
    
    Returns:
    
    the organization properties (any changes made this list will affect the VCard object and vice versa)
    
    See Also:
    
    RFC 6350 p.40, RFC 2426 p.20, vCard 2.1 p.19
  - getOrganization
```
public Organization getOrganization()
```
    Gets the hierarchy of department(s) to which the person belongs.
    
    Property name: ORG
    Supported versions: 2.1, 3.0, 4.0
    
    Returns:
    
    the first organization property or null if not set
    
    See Also:
    
    RFC 6350 p.40, RFC 2426 p.20, vCard 2.1 p.19
  - setOrganizationAlt
```
public void setOrganizationAlt(Organization... altRepresentations)
```
    Sets the hierarchy of department(s) to which the person belongs.
    
    Property name: ORG
    Supported versions: 4.0*
    * Only 4.0 supports alternative representations
    
    Parameters:
    
    altRepresentations - the alternative representations of the same value. These properties contain the same information, but in different forms (such as different languages). See this description of the ALTID parameter for more information. Note that this method automatically assigns an appropriate ALTID parameter to each property.
    
    See Also:
    
    RFC 6350 p.40, RFC 2426 p.20, vCard 2.1 p.19
  - addOrganizationAlt
```
public void addOrganizationAlt(Organization... altRepresentations)
```
    Adds a hierarchy of department(s) to which the person belongs.
    
    Property name: ORG
    Supported versions: 4.0*
    * Only 4.0 supports alternative representations
    
    Parameters:
    
    altRepresentations - the alternative representations of the same value. These properties contain the same information, but in different forms (such as different languages). See this description of the ALTID parameter for more information. Note that this method automatically assigns an appropriate ALTID parameter to each property.
    
    See Also:
    
    RFC 6350 p.40, RFC 2426 p.20, vCard 2.1 p.19
  - setOrganization
```
public void setOrganization(Organization organization)
```
    Sets the hierarchy of departments to which the person belongs.
    
    Property name: ORG
    Supported versions: 2.1, 3.0, 4.0
    
    Parameters:
    
    organization - the organization property or null to remove
    
    See Also:
    
    RFC 6350 p.40, RFC 2426 p.20, vCard 2.1 p.19
  - addOrganization
```
public void addOrganization(Organization organization)
```
    Adds a hierarchy of departments to which the person belongs. Note that only version 4.0 vCards support multiple instances of this property.
    
    Property name: ORG
    Supported versions: 4.0*
    * Only 4.0 supports multiple instances
    
    Parameters:
    
    organization - the organization property to add
    
    See Also:
    
    RFC 6350 p.40, RFC 2426 p.20, vCard 2.1 p.19
  - setOrganization
```
public Organization setOrganization(String... departments)
```
    Sets the hierarchy of departments to which the person belongs.
    
    Property name: ORG
    Supported versions: 2.1, 3.0, 4.0
    
    Parameters:
    
    departments - the ordered list of department(s), starting with the broadest and ending with the most specific (e.g. "Google", "Gmail Team", "Spam Detection Squad") or an empty arguments list to remove
    
    Returns:
    
    the property object that was created
    
    See Also:
    
    RFC 6350 p.40, RFC 2426 p.20, vCard 2.1 p.19
  - getCategoriesList
```
public List<Categories> getCategoriesList()
```
    Gets all instances of the Categories property.
    
    Version 4.0 vCards may have multiple instances if alternative representations are defined (see setCategoriesAlt) or if properties with different TYPE parameters are defined.
    
    Property name: CATEGORIES
    Supported versions: 4.0*
    * Only 4.0 supports multiple instances
    
    Returns:
    
    the categories properties (any changes made this list will affect the VCard object and vice versa)
    
    See Also:
    
    RFC 6350 p.43, RFC 2426 p.20
  - getCategories
```
public Categories getCategories()
```
    Gets the list of "keywords" or "tags" that can be used to describe the person.
    
    Property name: CATEGORIES
    Supported versions: 3.0, 4.0
    
    Returns:
    
    the first categories property (can contain multiple values) or null if not set
    
    See Also:
    
    RFC 6350 p.43, RFC 2426 p.20
  - setCategoriesAlt
```
public void setCategoriesAlt(Categories... altRepresentations)
```
    Sets the list of "keywords" or "tags" that can be used to describe the person.
    
    Property name: CATEGORIES
    Supported versions: 4.0*
    * Only 4.0 supports alternative representations
    
    Parameters:
    
    altRepresentations - the alternative representations of the same value. These properties contain the same information, but in different forms (such as different languages). See this description of the ALTID parameter for more information. Note that this method automatically assigns an appropriate ALTID parameter to each property.
    
    See Also:
    
    RFC 6350 p.43, RFC 2426 p.20
  - addCategoriesAlt
```
public void addCategoriesAlt(Categories... altRepresentations)
```
    Adds a list of "keywords" or "tags" that can be used to describe the person.
    
    Property name: CATEGORIES
    Supported versions: 4.0*
    * Only 4.0 supports alternative representations
    
    Parameters:
    
    altRepresentations - the alternative representations of the same value. These properties contain the same information, but in different forms (such as different languages). See this description of the ALTID parameter for more information. Note that this method automatically assigns an appropriate ALTID parameter to each property.
    
    See Also:
    
    RFC 6350 p.43, RFC 2426 p.20
  - setCategories
```
public void setCategories(Categories categories)
```
    Sets the list of "keywords" or "tags" that can be used to describe the person.
    
    Property name: CATEGORIES
    Supported versions: 3.0, 4.0
    
    Parameters:
    
    categories - the categories property (can contain multiple values) or null to remove
    
    See Also:
    
    RFC 6350 p.43, RFC 2426 p.20
  - addCategories
```
public void addCategories(Categories categories)
```
    Adds a list of "keywords" or "tags" that can be used to describe the person. Note that only version 4.0 vCards support multiple instances of this property.
    
    Property name: CATEGORIES
    Supported versions: 4.0*
    * Only 4.0 supports multiple instances
    
    Parameters:
    
    categories - the categories property to add (can contain multiple values)
    
    See Also:
    
    RFC 6350 p.43, RFC 2426 p.20
  - setCategories
```
public Categories setCategories(String... categories)
```
    Sets the list of "keywords" or "tags" that can be used to describe the person.
    
    Property name: CATEGORIES
    Supported versions: 3.0, 4.0
    
    Parameters:
    
    categories - the categories (e.g. "swimmer", "biker", "knitter") or an empty arguments list to remove
    
    Returns:
    
    the property object that was created
    
    See Also:
    
    RFC 6350 p.43, RFC 2426 p.20
  - getAgent
```
public Agent getAgent()
```
    Gets information about the person's agent.
    
    Property name: AGENT
    Supported versions: 2.1, 3.0
    
    Returns:
    
    the agent property or null if not set
    
    See Also:
    
    RFC 2426 p.19, vCard 2.1 p.18
  - setAgent
```
public void setAgent(Agent agent)
```
    Sets information about the person's agent.
    
    Property name: AGENT
    Supported versions: 2.1, 3.0
    
    Parameters:
    
    agent - the agent property or null to remove
    
    See Also:
    
    RFC 2426 p.19, vCard 2.1 p.18
  - getNotes
```
public List<Note> getNotes()
```
    Gets the notes. Notes contain free-form, miscellaneous text.
    
    Property name: NOTE
    Supported versions: 2.1, 3.0, 4.0
    
    Returns:
    
    the note properties (any changes made this list will affect the VCard object and vice versa)
    
    See Also:
    
    RFC 6350 p.44, RFC 2426 p.21, vCard 2.1 p.19
  - addNote
```
public void addNote(Note note)
```
    Adds a note. Notes contain free-form, miscellaneous text.
    
    Property name: NOTE
    Supported versions: 2.1, 3.0, 4.0
    
    Parameters:
    
    note - the note property to add
    
    See Also:
    
    RFC 6350 p.44, RFC 2426 p.21, vCard 2.1 p.19
  - addNote
```
public Note addNote(String note)
```
    Adds a note. Notes contain free-form, miscellaneous text.
    
    Property name: NOTE
    Supported versions: 2.1, 3.0, 4.0
    
    Parameters:
    
    note - the note to add
    
    Returns:
    
    the property object that was created
    
    See Also:
    
    RFC 6350 p.44, RFC 2426 p.21, vCard 2.1 p.19
  - addNoteAlt
```
public void addNoteAlt(Note... altRepresentations)
```
    Adds a note. Notes contain free-form, miscellaneous text.
    
    Property name: NOTE
    Supported versions: 4.0*
    * Only 4.0 supports alternative representations
    
    Parameters:
    
    altRepresentations - the alternative representations of the same value. These properties contain the same information, but in different forms (such as different languages). See this description of the ALTID parameter for more information. Note that this method automatically assigns an appropriate ALTID parameter to each property.
    
    See Also:
    
    RFC 6350 p.44, RFC 2426 p.21, vCard 2.1 p.19
  - getUid
```
public Uid getUid()
```
    Gets the unique identifier of the vCard.
    
    Property name: UID
    Supported versions: 2.1, 3.0, 4.0
    
    Returns:
    
    the unique identifier property or null if not set
    
    See Also:
    
    RFC 6350 p.46, RFC 2426 p.24, vCard 2.1 p.21
  - setUid
```
public void setUid(Uid uid)
```
    Sets the unique identifier of the vCard.
    
    Property name: UID
    Supported versions: 2.1, 3.0, 4.0
    
    Parameters:
    
    uid - the unique identifier property or null to remove
    
    See Also:
    
    RFC 6350 p.46, RFC 2426 p.24, vCard 2.1 p.21
  - getKeys
```
public List<Key> getKeys()
```
    Gets the public encryption keys.
    
    Property name: KEY
    Supported versions: 2.1, 3.0, 4.0
    
    Returns:
    
    the key properties (any changes made this list will affect the VCard object and vice versa)
    
    See Also:
    
    RFC 6350 p.48, RFC 2426 p.26, vCard 2.1 p.22
  - addKey
```
public void addKey(Key key)
```
    Adds a public encryption key.
    
    Property name: KEY
    Supported versions: 2.1, 3.0, 4.0
    
    Parameters:
    
    key - the key property to add
    
    See Also:
    
    RFC 6350 p.48, RFC 2426 p.26, vCard 2.1 p.22
  - addKeyAlt
```
public void addKeyAlt(Key... altRepresentations)
```
    Adds a public encryption key.
    
    Property name: KEY
    Supported versions: 4.0*
    * Only 4.0 supports alternative representations
    
    Parameters:
    
    altRepresentations - the alternative representations of the same value. These properties contain the same information, but in different forms (such as different languages). See this description of the ALTID parameter for more information. Note that this method automatically assigns an appropriate ALTID parameter to each property.
    
    See Also:
    
    RFC 6350 p.48, RFC 2426 p.26, vCard 2.1 p.22
  - getImpps
```
public List<Impp> getImpps()
```
    Gets the instant messaging handles.
    
    Property name: IMPP
    Supported versions: 3.0, 4.0
    
    Returns:
    
    the IMPP properties (any changes made this list will affect the VCard object and vice versa)
    
    See Also:
    
    RFC 6350 p.36, RFC 4770
  - addImpp
```
public void addImpp(Impp impp)
```
    Adds an instant messaging handle.
    
    Property name: IMPP
    Supported versions: 3.0, 4.0
    
    Parameters:
    
    impp - the IMPP property to add
    
    See Also:
    
    RFC 6350 p.36, RFC 4770
  - addImppAlt
```
public void addImppAlt(Impp... altRepresentations)
```
    Adds an instant messaging handle.
    
    Property name: IMPP
    Supported versions: 4.0*
    * Only 4.0 supports alternative representations
    
    Parameters:
    
    altRepresentations - the alternative representations of the same value. These properties contain the same information, but in different forms (such as different languages). See this description of the ALTID parameter for more information. Note that this method automatically assigns an appropriate ALTID parameter to each property.
    
    See Also:
    
    RFC 6350 p.36, RFC 4770
  - getRelations
```
public List<Related> getRelations()
```
    Gets a list of people that the person is related to.
    
    Property name: RELATED
    Supported versions: 4.0
    
    Returns:
    
    the relation properties (any changes made this list will affect the VCard object and vice versa)
    
    See Also:
    
    RFC 6350 p.42
  - addRelated
```
public void addRelated(Related related)
```
    Adds someone that the person is related to.
    
    Property name: RELATED
    Supported versions: 4.0
    
    Parameters:
    
    related - the relation property to add
    
    See Also:
    
    RFC 6350 p.42
  - addRelatedAlt
```
public void addRelatedAlt(Related... altRepresentations)
```
    Adds someone that the person is related to.
    
    Property name: RELATED
    Supported versions: 4.0
    
    Parameters:
    
    altRepresentations - the alternative representations of the same value. These properties contain the same information, but in different forms (such as different languages). See this description of the ALTID parameter for more information. Note that this method automatically assigns an appropriate ALTID parameter to each property.
    
    See Also:
    
    RFC 6350 p.42
  - getLanguages
```
public List<Language> getLanguages()
```
    Gets the languages that the person speaks.
    
    Property name: LANG
    Supported versions: 4.0
    
    Returns:
    
    the language properties (any changes made this list will affect the VCard object and vice versa)
    
    See Also:
    
    RFC 6350 p.37
  - addLanguage
```
public void addLanguage(Language language)
```
    Adds a language that the person speaks.
    
    Property name: LANG
    Supported versions: 4.0
    
    Parameters:
    
    language - the language property to add
    
    See Also:
    
    RFC 6350 p.37
  - addLanguage
```
public Language addLanguage(String language)
```
    Adds a language that the person speaks.
    
    Property name: LANG
    Supported versions: 4.0
    
    Parameters:
    
    language - the language to add (e.g. "en-us")
    
    Returns:
    
    the property object that was created
    
    See Also:
    
    RFC 6350 p.37
  - addLanguageAlt
```
public void addLanguageAlt(Language... altRepresentations)
```
    Adds a language that the person speaks.
    
    Property name: LANG
    Supported versions: 4.0
    
    Parameters:
    
    altRepresentations - the alternative representations of the same value. These properties contain the same information, but in different forms (such as different languages). See this description of the ALTID parameter for more information. Note that this method automatically assigns an appropriate ALTID parameter to each property.
    
    See Also:
    
    RFC 6350 p.37
  - getCalendarRequestUris
```
public List<CalendarRequestUri> getCalendarRequestUris()
```
    Gets the URIs that can be used to schedule a meeting with the person on his or her calendar.
    
    Property name: CALADRURI
    Supported versions: 4.0
    
    Returns:
    
    the calendar request URI properties (any changes made this list will affect the VCard object and vice versa)
    
    See Also:
    
    RFC 6350 p.50
  - addCalendarRequestUri
```
public void addCalendarRequestUri(CalendarRequestUri calendarRequestUri)
```
    Adds a URI that can be used to schedule a meeting with the person on his or her calendar.
    
    Property name: CALADRURI
    Supported versions: 4.0
    
    Parameters:
    
    calendarRequestUri - the calendar request URI property to add
    
    See Also:
    
    RFC 6350 p.50
  - addCalendarRequestUriAlt
```
public void addCalendarRequestUriAlt(CalendarRequestUri... altRepresentations)
```
    Adds a URI that can be used to schedule a meeting with the person on his or her calendar.
    
    Property name: CALADRURI
    Supported versions: 4.0
    
    Parameters:
    
    altRepresentations - the alternative representations of the same value. These properties contain the same information, but in different forms (such as different languages). See this description of the ALTID parameter for more information. Note that this method automatically assigns an appropriate ALTID parameter to each property.
    
    See Also:
    
    RFC 6350 p.50
  - getCalendarUris
```
public List<CalendarUri> getCalendarUris()
```
    Gets the URIs that point to the person's calendar.
    
    Property name: CALURI
    Supported versions: 4.0
    
    Returns:
    
    the calendar URI properties (any changes made this list will affect the VCard object and vice versa)
    
    See Also:
    
    RFC 6350 p.50
  - addCalendarUri
```
public void addCalendarUri(CalendarUri calendarUri)
```
    Adds a URI that points to the person's calendar.
    
    Property name: CALURI
    Supported versions: 4.0
    
    Parameters:
    
    calendarUri - the calendar URI property to add
    
    See Also:
    
    RFC 6350 p.50
  - addCalendarUriAlt
```
public void addCalendarUriAlt(CalendarUri... altRepresentations)
```
    Adds a URI that points to the person's calendar.
    
    Property name: CALURI
    Supported versions: 4.0
    
    Parameters:
    
    altRepresentations - the alternative representations of the same value. These properties contain the same information, but in different forms (such as different languages). See this description of the ALTID parameter for more information. Note that this method automatically assigns an appropriate ALTID parameter to each property.
    
    See Also:
    
    RFC 6350 p.50
  - getFbUrls
```
public List<FreeBusyUrl> getFbUrls()
```
    Gets the URLs that can be used to determine when the person is free or busy.
    
    Property name: FBURL
    Supported versions: 4.0
    
    Returns:
    
    the free-busy URL properties (any changes made this list will affect the VCard object and vice versa)
    
    See Also:
    
    RFC 6350 p.49
  - addFbUrl
```
public void addFbUrl(FreeBusyUrl fbUrl)
```
    Adds a URL that can be used to determine when the person is free or busy.
    
    Property name: FBURL
    Supported versions: 4.0
    
    Parameters:
    
    fbUrl - the free-busy URL property to add
    
    See Also:
    
    RFC 6350 p.49
  - addFbUrlAlt
```
public void addFbUrlAlt(FreeBusyUrl... altRepresentations)
```
    Adds a URL that can be used to determine when the person is free or busy.
    
    Property name: FBURL
    Supported versions: 4.0
    
    Parameters:
    
    altRepresentations - the alternative representations of the same value. These properties contain the same information, but in different forms (such as different languages). See this description of the ALTID parameter for more information. Note that this method automatically assigns an appropriate ALTID parameter to each property.
    
    See Also:
    
    RFC 6350 p.49
  - getClientPidMaps
```
public List<ClientPidMap> getClientPidMaps()
```
    Gets the properties that are used to assign globally-unique identifiers to individual property instances. They are used for merging together different versions of the same vCard.
    
    Property name: CLIENTPIDMAP
    Supported versions: 4.0
    
    Returns:
    
    the client PID map properties (any changes made this list will affect the VCard object and vice versa)
    
    See Also:
    
    RFC 6350 p.47
  - addClientPidMap
```
public void addClientPidMap(ClientPidMap clientPidMap)
```
    Adds a property that is used to assign a globally-unique identifier to an individual property instance. They are used for merging together different versions of the same vCard.
    
    Property name: CLIENTPIDMAP
    Supported versions: 4.0
    
    Parameters:
    
    clientPidMap - the client PID map property to add
    
    See Also:
    
    RFC 6350 p.47
  - getXmls
```
public List<Xml> getXmls()
```
    Gets any XML data that is attached to the vCard.
    
    These properties may be present if the vCard was encoded in XML ("xCard" format) and the XML document contained non-standard elements. In this case, the properties would contain all of the non-standard XML elements.
    
    Property name: XML
    Supported versions: 4.0
    
    Returns:
    
    the XML properties (any changes made this list will affect the VCard object and vice versa)
    
    See Also:
    
    RFC 6350 p.27
  - addXml
```
public void addXml(Xml xml)
```
    Adds XML data to the vCard.
    
    These properties may be present if the vCard was encoded in XML ("xCard" format) and the XML document contained non-standard elements. In this case, the properties would contain all of the non-standard XML elements.
    
    Property name: XML
    Supported versions: 4.0
    
    Parameters:
    
    xml - the XML property to add
    
    See Also:
    
    RFC 6350 p.27
  - addXmlAlt
```
public void addXmlAlt(Xml... altRepresentations)
```
    Adds XML data to the vCard.
    
    These properties may be present if the vCard was encoded in XML ("xCard" format) and the XML document contained non-standard elements. In this case, the properties would contain all of the non-standard XML elements.
    
    Property name: XML
    Supported versions: 4.0
    
    Parameters:
    
    altRepresentations - the alternative representations of the same value. These properties contain the same information, but in different forms (such as different languages). See this description of the ALTID parameter for more information. Note that this method automatically assigns an appropriate ALTID parameter to each property.
    
    See Also:
    
    RFC 6350 p.27
  - getExpertise
```
public List<Expertise> getExpertise()
```
    Gets the professional subject areas that the person is knowledgeable in.
    
    Property name: EXPERTISE
    Supported versions: 4.0
    
    Returns:
    
    the expertise properties (any changes made this list will affect the VCard object and vice versa)
    
    See Also:
    
    RFC 6715 p.3
  - addExpertise
```
public void addExpertise(Expertise expertise)
```
    Adds a professional subject area that the person is knowledgeable in.
    
    Property name: EXPERTISE
    Supported versions: 4.0
    
    Parameters:
    
    expertise - the expertise property to add
    
    See Also:
    
    RFC 6715 p.3
  - addExpertise
```
public Expertise addExpertise(String expertise)
```
    Adds a professional subject area that the person is knowledgeable in.
    
    Property name: EXPERTISE
    Supported versions: 4.0
    
    Parameters:
    
    expertise - the professional subject area to add (e.g. "programming")
    
    Returns:
    
    the property object that was created
    
    See Also:
    
    RFC 6715 p.3
  - addExpertiseAlt
```
public void addExpertiseAlt(Expertise... altRepresentations)
```
    Adds a professional subject area that the person is knowledgeable in.
    
    Property name: EXPERTISE
    Supported versions: 4.0
    
    Parameters:
    
    altRepresentations - the alternative representations of the same value. These properties contain the same information, but in different forms (such as different languages). See this description of the ALTID parameter for more information. Note that this method automatically assigns an appropriate ALTID parameter to each property.
    
    See Also:
    
    RFC 6715 p.3
  - getHobbies
```
public List<Hobby> getHobbies()
```
    Gets the hobbies that the person actively engages in.
    
    Property name: HOBBY
    Supported versions: 4.0
    
    Returns:
    
    the hobby properties (any changes made this list will affect the VCard object and vice versa)
    
    See Also:
    
    RFC 6715 p.4
  - addHobby
```
public void addHobby(Hobby hobby)
```
    Adds a hobby that the person actively engages in.
    
    Property name: HOBBY
    Supported versions: 4.0
    
    Parameters:
    
    hobby - the hobby property to add
    
    See Also:
    
    RFC 6715 p.4
  - addHobby
```
public Hobby addHobby(String hobby)
```
    Adds a hobby that the person actively engages in.
    
    Property name: HOBBY
    Supported versions: 4.0
    
    Parameters:
    
    hobby - the hobby to add (e.g. "photography")
    
    Returns:
    
    the property object that was created
    
    See Also:
    
    RFC 6715 p.4
  - addHobbyAlt
```
public void addHobbyAlt(Hobby... altRepresentations)
```
    Adds a hobby that the person actively engages in.
    
    Property name: HOBBY
    Supported versions: 4.0
    
    Parameters:
    
    altRepresentations - the alternative representations of the same value. These properties contain the same information, but in different forms (such as different languages). See this description of the ALTID parameter for more information. Note that this method automatically assigns an appropriate ALTID parameter to each property.
    
    See Also:
    
    RFC 6715 p.4
  - getInterests
```
public List<Interest> getInterests()
```
    Gets the person's interests.
    
    Property name: INTEREST
    Supported versions: 4.0
    
    Returns:
    
    the interest properties (any changes made this list will affect the VCard object and vice versa)
    
    See Also:
    
    RFC 6715 p.5
  - addInterest
```
public void addInterest(Interest interest)
```
    Adds an interest.
    
    Property name: INTEREST
    Supported versions: 4.0
    
    Parameters:
    
    interest - the interest property to add
    
    See Also:
    
    RFC 6715 p.5
  - addInterest
```
public Interest addInterest(String interest)
```
    Adds an interest.
    
    Property name: INTEREST
    Supported versions: 4.0
    
    Parameters:
    
    interest - the interest to add (e.g. "football")
    
    Returns:
    
    the property object that was created
    
    See Also:
    
    RFC 6715 p.5
  - addInterestAlt
```
public void addInterestAlt(Interest... altRepresentations)
```
    Adds an interest.
    
    Property name: INTEREST
    Supported versions: 4.0
    
    Parameters:
    
    altRepresentations - the alternative representations of the same value. These properties contain the same information, but in different forms (such as different languages). See this description of the ALTID parameter for more information. Note that this method automatically assigns an appropriate ALTID parameter to each property.
    
    See Also:
    
    RFC 6715 p.5
  - getOrgDirectories
```
public List<OrgDirectory> getOrgDirectories()
```
    Gets the organization directories.
    
    Property name: ORG-DIRECTORY
    Supported versions: 4.0
    
    Returns:
    
    the organization directory properties (any changes made this list will affect the VCard object and vice versa)
    
    See Also:
    
    RFC 6715 p.6
  - addOrgDirectory
```
public void addOrgDirectory(OrgDirectory orgDirectory)
```
    Adds an organization directory.
    
    Property name: ORG-DIRECTORY
    Supported versions: 4.0
    
    Parameters:
    
    orgDirectory - the organization directory property to add
    
    See Also:
    
    RFC 6715 p.6
  - addOrgDirectory
```
public OrgDirectory addOrgDirectory(String orgDirectory)
```
    Adds an organization directory.
    
    Property name: ORG-DIRECTORY
    Supported versions: 4.0
    
    Parameters:
    
    orgDirectory - the organization directory to add (e.g. "http://company.com/staff")
    
    Returns:
    
    the property object that was created
    
    See Also:
    
    RFC 6715 p.6
  - addOrgDirectoryAlt
```
public void addOrgDirectoryAlt(OrgDirectory... altRepresentations)
```
    Adds an organization directory.
    
    Property name: ORG-DIRECTORY
    Supported versions: 4.0
    
    Parameters:
    
    altRepresentations - the alternative representations of the same value. These properties contain the same information, but in different forms (such as different languages). See this description of the ALTID parameter for more information. Note that this method automatically assigns an appropriate ALTID parameter to each property.
    
    See Also:
    
    RFC 6715 p.6
  - iterator
```
public Iterator<VCardProperty> iterator()
```
    Iterates through each of the vCard's properties in no particular order. Does not include the "BEGIN", "END", or "VERSION" properties.
    
    Specified by:
    
    iterator in interface Iterable<VCardProperty>
    
    Returns:
    
    the iterator
  - getProperty
```
public <T extends VCardProperty> T getProperty(Class<T> clazz)
```
    Gets the first property of a given class.
    
    Type Parameters:
    
    T - the property class
    
    Parameters:
    
    clazz - the property class
    
    Returns:
    
    the property or null if not found
  - getProperties
```
public <T extends VCardProperty> List<T> getProperties(Class<T> clazz)
```
    Gets all properties of a given class.
    
    Type Parameters:
    
    T - the property class
    
    Parameters:
    
    clazz - the property class
    
    Returns:
    
    the properties (any changes made this list will affect the VCard object and vice versa)
  - getPropertiesAlt
```
public <T extends VCardProperty & HasAltId> List<List<T>> getPropertiesAlt(Class<T> clazz)
```
    Gets all properties of a given class, grouping the alternative representations of each property together (see: description of ALTID)
    
    Type Parameters:
    
    T - the property class
    
    Parameters:
    
    clazz - the property class
    
    Returns:
    
    the properties (this list is immutable)
  - getProperties
```
public Collection<VCardProperty> getProperties()
```
    Gets all the properties in this vCard.
    
    Returns:
    
    the properties (this list is immutable)
  - addProperty
```
public void addProperty(VCardProperty property)
```
    Adds a property.
    
    Parameters:
    
    property - the property to add
  - setProperty
```
public List<VCardProperty> setProperty(VCardProperty property)
```
    Replaces all existing properties of the given property instance's class with the given property instance.
    
    Parameters:
    
    property - the property
    
    Returns:
    
    the properties that were replaced (this list is immutable)
  - setProperty
```
public <T extends VCardProperty> List<T> setProperty(Class<T> clazz,
                                                     T property)
```
    Replaces all existing properties of the given class with a single property instance. If the property instance is null, then all instances of that property will be removed.
    
    Type Parameters:
    
    T - the property class
    
    Parameters:
    
    clazz - the property class (e.g. "Note.class")
    
    property - the property or null to remove
    
    Returns:
    
    the properties that were replaced (this list is immutable)
  - removeProperty
```
public boolean removeProperty(VCardProperty property)
```
    Removes a property instance from the vCard.
    
    Parameters:
    
    property - the property to remove
    
    Returns:
    
    true if it was removed, false if it wasn't found
  - removeProperties
```
public <T extends VCardProperty> List<T> removeProperties(Class<T> clazz)
```
    Removes all properties of a given class.
    
    Type Parameters:
    
    T - the property class
    
    Parameters:
    
    clazz - the class of the properties to remove (e.g. "Note.class")
    
    Returns:
    
    the properties that were removed (this list is immutable)
  - getExtendedProperty
```
public RawProperty getExtendedProperty(String name)
```
    Gets the first extended property with a given name.
    
    Parameters:
    
    name - the property name (e.g. "X-ALT-DESC")
    
    Returns:
    
    the property or null if none were found
  - getExtendedProperties
```
public List<RawProperty> getExtendedProperties(String name)
```
    Gets all extended properties with a given name.
    
    Parameters:
    
    name - the property name (e.g. "X-ALT-DESC")
    
    Returns:
    
    the properties (this list is immutable)
  - getExtendedProperties
```
public List<RawProperty> getExtendedProperties()
```
    Gets all extended properties.
    
    Returns:
    
    the properties (any changes made this list will affect the VCard object and vice versa)
  - addExtendedProperty
```
public RawProperty addExtendedProperty(String name,
                                       String value)
```
    Adds an extended property.
    
    Parameters:
    
    name - the property name (e.g. "X-ALT-DESC")
    
    value - the property value
    
    Returns:
    
    the property object that was created
  - addExtendedProperty
```
public RawProperty addExtendedProperty(String name,
                                       String value,
                                       VCardDataType dataType)
```
    Adds an extended property.
    
    Parameters:
    
    name - the property name (e.g. "X-ALT-DESC")
    
    value - the property value
    
    dataType - the property value's data type
    
    Returns:
    
    the property object that was created
  - setExtendedProperty
```
public RawProperty setExtendedProperty(String name,
                                       String value)
```
    Replaces all existing extended properties with the given name with a single property instance.
    
    Parameters:
    
    name - the property name (e.g. "X-ALT-DESC")
    
    value - the property value
    
    Returns:
    
    the property object that was created
  - setExtendedProperty
```
public RawProperty setExtendedProperty(String name,
                                       String value,
                                       VCardDataType dataType)
```
    Replaces all existing extended properties with the given name with a single property instance.
    
    Parameters:
    
    name - the property name (e.g. "X-ALT-DESC")
    
    value - the property value
    
    dataType - the property value's data type
    
    Returns:
    
    the property object that was created
  - removeExtendedProperty
```
public List<RawProperty> removeExtendedProperty(String name)
```
    Removes all extended properties that have the given name.
    
    Parameters:
    
    name - the component name (e.g. "X-ALT-DESC")
    
    Returns:
    
    the properties that were removed (this list is immutable)
  - addPropertyAlt
```
public <T extends VCardProperty & HasAltId> void addPropertyAlt(Class<T> propertyClass,
                                                                T... altRepresentations)
```
    Adds a property in the form of a collection of alternative representations. This method will generate a unique ALTID parameter value and assign it to each of the property instances (see: description of ALTID).
    
    Type Parameters:
    
    T - the property class
    
    Parameters:
    
    propertyClass - the property class
    
    altRepresentations - the alternative representations of the property to add
  - addPropertyAlt
```
public <T extends VCardProperty & HasAltId> void addPropertyAlt(Class<T> propertyClass,
                                                                Collection<T> altRepresentations)
```
    Adds a property in the form of a collection of alternative representations. This method will generate a unique ALTID parameter value and assign it to each of the property instances (see: description of ALTID).
    
    Type Parameters:
    
    T - the property class
    
    Parameters:
    
    propertyClass - the property class
    
    altRepresentations - the alternative representations of the property to add
  - setPropertyAlt
```
public <T extends VCardProperty & HasAltId> List<T> setPropertyAlt(Class<T> propertyClass,
                                                                   T... altRepresentations)
```
    Sets a property in the form of a collection of alternative representations. This method will generate a unique ALTID parameter value and assign it to each of the property instances (see: description of ALTID).
    
    Type Parameters:
    
    T - the property class
    
    Parameters:
    
    propertyClass - the property class
    
    altRepresentations - the alternative representations of the property to add
    
    Returns:
    
    the properties that were replaced (this list is immutable)
  - setPropertyAlt
```
public <T extends VCardProperty & HasAltId> List<T> setPropertyAlt(Class<T> propertyClass,
                                                                   Collection<T> altRepresentations)
```
    Sets a property in the form of a collection of alternative representations. This method will generate a unique ALTID parameter value and assign it to each of the property instances (see: description of ALTID).
    
    Type Parameters:
    
    T - the property class
    
    Parameters:
    
    propertyClass - the property class
    
    altRepresentations - the alternative representations of the property to add
    
    Returns:
    
    the properties that were replaced (this list is immutable)
  - validate
```
public ValidationWarnings validate(VCardVersion version)
```
    Checks this vCard for data consistency problems or deviations from the spec. These problems will not prevent the vCard from being written to a data stream, but may prevent it from being parsed correctly by the consuming application. These problems can largely be avoided by reading the Javadocs of the property classes, or by being familiar with the vCard standard.
    
    Parameters:
    
    version - the version to check the vCard against (use VCardVersion.V4_0 for xCard and jCard)
    
    Returns:
    
    the validation warnings
  - stream
```
public Stream<VCardProperty> stream()
```
    Generates a stream of this vCard's properties.
    
    Returns:
    
    a stream of the properties
  - toString
```
public String toString()
```
    Overrides:
    
    toString in class Object
  - hashCode
```
public int hashCode()
```
    Overrides:
    
    hashCode in class Object
  - equals
```
public boolean equals(Object obj)
```
    Overrides:
    
    equals in class Object

Class VCard

Constructor Summary

Method Summary

Methods inherited from class java.lang.Object

Methods inherited from interface java.lang.Iterable

Constructor Detail

VCard

VCard

VCard

Method Detail

write

write

write

write

writeXml

writeXml

writeXml

writeXml

writeHtml

writeHtml

writeHtml

writeHtml

writeJson

writeJson

writeJson

writeJson

getVersion

setVersion

getKind

setKind

getGender

setGender

getMembers

addMember

addMemberAlt

getProfile

setProfile

getClassification

setClassification

setClassification

getSources

addSource

addSource

addSourceAlt

getSourceDisplayText

setSourceDisplayText

setSourceDisplayText

getFormattedNames

getFormattedName

setFormattedNameAlt

addFormattedNameAlt

setFormattedName

addFormattedName

setFormattedName

getStructuredNames

getStructuredName

setStructuredNameAlt

setStructuredName

getNicknames

getNickname

setNicknameAlt

addNicknameAlt

setNickname

addNickname

setNickname

getSortString

setSortString

setSortString

getTitles

addTitle

addTitle

addTitleAlt

getRoles

addRole

addRole

addRoleAlt

getPhotos

addPhoto

addPhotoAlt

getLogos