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

NameEmailIndexRDF

class NameEmailIndexRDF : SolidRDFResource

RDF representation of the people (name-email) index document for a Solid address book.

The name-email index lists all vcard:Individual contact entries belonging to an address book, using vcard:inAddressBook triples. It is separate from the address-book root so that the contact list can be loaded and updated independently.

Construct from a pod response by passing the parsed quads, or create a new empty instance by supplying only the identifier.

Constructors

NameEmailIndexRDF

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

Functions

addContact

fun addContact(addressBookUri: String, contact: ContactRDF)

Adds contact to this index under addressBookUri, recording the contact's type and display name inline so the index can be rendered without fetching each contact document.

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.

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.

getAllQuads

fun getAllQuads(): List<RdfQuad>

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

getContacts

fun getContacts(addressBookUri: String): List<Contact>

Returns lightweight Contact summaries for all contacts belonging to addressBookUri.

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.

getEntity

open override fun getEntity(): InputStream

Returns the resource representation as a byte stream.

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.

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

getSize

fun getSize(): Long

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

removeContact

fun removeContact(contactUri: String): Boolean

Removes all index entries for contactUri (both the vcard:inAddressBook link and the contact's own cached triples).

updateContactName

fun updateContactName(contactUri: String, newName: String): Boolean

Rewrites the cached vcard:fn for contactUri to newName.

writeToParcel

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