Shared/com.erfangholami.androidsolidservices.shared.rdf.sharing/CatalogRDF

CatalogRDF

RDF wrapper for {podRoot}/solidshare/catalog.ttl, the owner-published list of resources they may consider sharing on request.

Each entry is a small named description:

<{resourceUri}>
    rdf:type           solidshare:CatalogEntry ;
    dcterms:title      "Trip photos" ;
    dcterms:description "Photos from Crete, summer 2026." ;
    foaf:depiction     <https://alice.pod/avatars/trip.jpg> .

The catalog itself is publicly readable; the listed resources remain private until granted.

The reflective constructor required by the Solid resource parser is provided.

Constructors

CatalogRDF

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

Functions

addEntry

fun addEntry(entry: CatalogEntry, vocab: ShareVocabulary = SolidShareVocabulary)

Writes the triples for entry into the catalog 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.

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.

getEntries

fun getEntries(vocab: ShareVocabulary = SolidShareVocabulary): List<CatalogEntry>

Returns every entry recorded in the catalog.

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.

writeToParcel

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