Shared/com.erfangholami.androidsolidservices.shared.rdf.contacts/ContactRDF

ContactRDF

RDF representation of a single Solid contact (vcard:Individual).

Wraps the quads of one contact document on a pod and exposes typed accessors and mutators. Construct from a pod response by passing the parsed quads, or create a new empty instance by supplying only the identifier.

All mutator methods update the in-memory quad list; call the contacts data module to persist the change to the pod.

Constructors

ContactRDF

constructor(identifier: String, contentType: String? = null, quads: List<RdfQuad>? = null, headers: SolidHeaders? = null)

Functions

addAddress

fun addAddress(entry: AddressEntry): Boolean

Adds a postal address on a counter-labelled blank node (_:addr{n}), always typed vcard:Address plus vcard:Home/vcard:Work when classified. Does nothing and returns false when entry has no non-blank part.

addEmail

fun addEmail(address: String, type: EmailType = EmailType.OTHER): Boolean

Adds a typed vcard:hasEmail entry on a counter-labelled blank node (_:email{n}). EmailType.OTHER entries are written without a type triple. Does nothing and returns false when address is blank or already present.

addImpp

fun addImpp(handle: String, type: ImType = ImType.OTHER): Boolean

Adds a typed vcard:hasInstantMessage entry on a counter-labelled blank node (_:im{n}). ImType.OTHER entries are written without a type triple. The handle is stored verbatim as an xsd:string value — instant-messaging identifiers span many schemes and bare forms, so it is kept exactly as provided. Does nothing and returns false when handle is blank or already present.

addPhone

fun addPhone(number: String, type: PhoneType = PhoneType.OTHER): Boolean

Adds a typed vcard:hasTelephone entry on a counter-labelled blank node (_:phone{n}). PhoneType.OTHER entries are written without a type triple, byte-compatible with legacy writers. Does nothing and returns false when number is blank or already present.

addQuad

fun addQuad(subject: String, predicate: String, obj: String, maxNumber: Int = 1)

Adds a triple whose object is an IRI (or blank node).

addQuadLiteral

fun addQuadLiteral(subject: String, predicate: String, value: String, datatype: String? = XSD.STRING, language: String? = null, maxNumber: Int = 1)

Adds a triple whose object is a literal.

addUrl

fun addUrl(type: URLType, url: String): Boolean

Adds url to this contact as a typed vcard:url entry.

clearProperties

fun clearProperties(predicate: String, subject: String = itselfSubject)

Removes every triple with the given predicate for subject.

open override fun close()

describeContents

open override fun describeContents(): Int

ensureType

fun ensureType(subject: String, typeIri: String)

Ensures subject carries an rdf:type triple with typeIri, preserving any other type triples already present.

findAllProperties

fun findAllProperties(predicate: String): List<String>

Returns the object values of every triple with the given predicate, across all subjects.

findAllPropertiesForSubject

fun findAllPropertiesForSubject(subject: String, predicate: String): List<String>

Returns the object values of every triple matching the given subject and predicate.

findProperty

fun findProperty(predicate: String): String?

Returns the object value of the first triple with the given predicate, or null if none.

findPropertyForSubject

fun findPropertyForSubject(subject: String, predicate: String): String?

Returns the object value of the first triple matching subject and predicate, or null.

getAddresses

fun getAddresses(): List<AddressEntry>

Returns all postal addresses (vcard:hasAddress). Nodes missing the vcard:Address class type still parse; entries with no address part are skipped.

getAllQuads

fun getAllQuads(): List<RdfQuad>

Returns a snapshot copy of all triples held by this resource.

getAnniversary

fun getAnniversary(): String?

Returns the contact's anniversary (vcard:anniversary) raw lexical value, or null.

getBirthday

fun getBirthday(): String?

Returns the contact's birthday (vcard:bday) as its raw lexical value, or null if absent.

getCategories

fun getCategories(): List<String>

The contact's category tags (vcard:hasCategory literals).

getContentType

open override fun getContentType(): String

The media type of the resource representation (the value of its Content-Type).

getCreatedTime

fun getCreatedTime(): Long?

The creation time in epoch milliseconds, from this resource's own dcterms:created (then stat:ctime) triple, or null when neither is present.

getEmailEntries

fun getEmailEntries(): List<EmailEntry>

Returns all email addresses with their vCard classification. Untyped legacy nodes read as EmailType.OTHER; a leading mailto: scheme is stripped from the value.

getEntity

open override fun getEntity(): InputStream

Returns the resource representation as a byte stream.

getFullName

fun getFullName(): String

Returns the contact's formatted display name (vcard:fn).

getGender

fun getGender(): Gender?

The contact's gender (vcard:hasGender, an ontology gender-class IRI), or null.

getGeos

fun getGeos(): List<String>

The contact's geographic positions (vcard:hasGeo), as stored IRIs — typically geo: URIs. An entry stored on a blank node by a foreign writer is read through its vcard:value.

getHeaders

open override fun getHeaders(): SolidHeaders

The HTTP headers associated with this resource (empty when constructed locally).

getIdentifier

open override fun getIdentifier(): String

The URI that identifies this resource on the pod.

getImEntries

fun getImEntries(): List<ImEntry>

Returns all instant-messaging handles (vcard:hasInstantMessage) with their vCard classification. Untyped legacy nodes read as ImType.OTHER.

getJobTitle

fun getJobTitle(): String?

Returns the contact's job title (vcard:title), or null if absent.

getLanguages

fun getLanguages(): List<String>

The contact's languages (vcard:hasLanguage entry nodes' vcard:language tags), in stored order.

getLastModified

fun getLastModified(): Long?

The last-modified time in epoch milliseconds. Prefers this resource's own dcterms:modified (then stat:mtime) triple and falls back to the Last-Modified header. null when none is present.

getMetadata

open override fun getMetadata(): SolidMetadata

getName

fun getName(): Name?

Returns the contact's structured name (vcard:hasName) as a Name, or null if the contact has no structured-name node.

getNickname

fun getNickname(): String?

Returns the contact's nickname (vcard:nickname), or null if absent.

getNote

fun getNote(): String?

Returns the contact's note (vcard:note), or null if absent.

getOrganizationName

fun getOrganizationName(): String?

Returns the contact's organization name (vcard:organization-name), or null if absent.

getOrganizationUnit

fun getOrganizationUnit(): String?

Returns the contact's organizational unit (vcard:organization-unit), or null.

getPhoneEntries

fun getPhoneEntries(): List<PhoneEntry>

Returns all phone numbers with their vCard classification. Untyped legacy nodes and nodes carrying unrecognized types read as PhoneType.OTHER; a leading tel: scheme is stripped from the value.

getPhotoUrl

fun getPhotoUrl(): String?

Returns the URL of the contact's photo (vcard:hasPhoto), or null if absent.

getRole

fun getRole(): String?

Returns the contact's role (vcard:role), or null if absent.

getSize

fun getSize(): Long

The size of this resource in bytes (its Content-Length), or 0 when the server did not report one.

getUid

fun getUid(): String?

Returns the contact's persistent identifier (vcard:hasUID), or null.

getUrlEntries

fun getUrlEntries(): List<UrlEntry>

Returns all typed URLs as UrlEntry values (wrapper over getUrls).

getUrls

fun getUrls(): List<Pair<URLType, String>>

Returns all URLs associated with this contact (vcard:url), each paired with its URLType classification. URLs without a recognized type default to URLType.Home.

removeEmailAddress

fun removeEmailAddress(emailAddress: String): Boolean

Removes the vcard:hasEmail entry for emailAddress from this contact's quad list.

removePhoneNumber

fun removePhoneNumber(phoneNumber: String): Boolean

Removes the vcard:hasTelephone entry for phoneNumber from this contact's quad list.

removePhoto

fun removePhoto(): Boolean

Removes the contact's photo link (vcard:hasPhoto).

removeUrl

fun removeUrl(url: String): Boolean

Removes the vcard:url entry whose value is url from this contact's quad list.

setAnniversary

fun setAnniversary(anniversary: String?)

Sets (or clears, when null) the contact's anniversary (vcard:anniversary), typed xsd:dateTime when the value contains a time component and xsd:date otherwise.

setBirthday

fun setBirthday(birthday: String?)

Sets (or clears, when null) the contact's birthday (vcard:bday).

setCategories

fun setCategories(categories: List<String>)

Replaces the contact's category tags with categories (trimmed, de-duplicated, blanks dropped).

setContactData

fun setContactData(data: ContactData)

Rewrites this contact's writable state from data with replace semantics: every multi-valued entry (phones, emails, instant messages, addresses, URLs) and every optional literal is replaced by the snapshot's content; properties absent from data are removed. The photo link (vcard:hasPhoto) is left untouched.

setFullName

fun setFullName(name: String)

Sets the contact's formatted display name.

setGender

fun setGender(gender: Gender?)

Sets (or clears, when null) the contact's gender (vcard:hasGender, an IRI).

setGeos

fun setGeos(geos: List<String>)

Replaces the contact's geographic positions with geos (trimmed, de-duplicated, blanks dropped). Each entry is stored as a direct IRI object per the W3C vCard ontology (vcard:hasGeo <geo:…>); a bare lat,lng pair is prefixed with the geo: scheme so the stored object is always a valid IRI.

setJobTitle

fun setJobTitle(jobTitle: String?)

Sets (or clears, when null) the contact's job title (vcard:title).

setLanguages

fun setLanguages(languages: List<String>)

Replaces the contact's languages with languages (BCP-47 tags; trimmed, de-duplicated case-insensitively, blanks dropped). Each tag lives on a counter-labelled blank node (_:lang{n}) carrying vcard:language, the W3C vCard ontology mapping of the vCard 4.0 LANG property.

setName

fun setName(name: Name?)

Sets (or clears) the contact's structured name (vcard:hasName).

setNickname

fun setNickname(nickname: String?)

Sets (or clears, when null) the contact's nickname (vcard:nickname).

setNote

fun setNote(note: String?)

Sets (or clears, when null) the contact's note (vcard:note).

setOrganizationName

fun setOrganizationName(organizationName: String?)

Sets (or clears, when null) the contact's organization name (vcard:organization-name).

setOrganizationUnit

fun setOrganizationUnit(unit: String?)

Sets (or clears, when null) the contact's organizational unit.

setPhoto

fun setPhoto(photoUri: String)

Sets the contact's photo link (vcard:hasPhoto) to photoUri.

setRole

fun setRole(role: String?)

Sets (or clears, when null) the contact's role (vcard:role).

setUid

fun setUid(uid: String?)

Sets (or clears, when null) the contact's persistent identifier (vcard:hasUID, IRI). A value that is already an absolute IRI (urn:uuid:…, https://…) is stored verbatim; anything else (e.g. a bare UID from a .vcf import) is wrapped as urn:uid:{percent-encoded value} so the stored object is always a valid IRI.

toContactData

fun toContactData(): ContactData

Reads this contact's complete writable state into a ContactData snapshot.

writeToParcel

open override fun writeToParcel(dest: Parcel, flags: Int)