Shared/com.erfangholami.androidsolidservices.shared.rdf.tickets/TicketRDF

TicketRDF

RDF codec for a single wallet ticket (schema:Ticket).

The document's primary subject #this is always a schema:Ticket. Everything the ticket admits to hangs off a reservation envelope, and the rest of the pass lives on sibling fragment nodes of the same document — see documents/TICKET_VOCAB.md for the full shape and the justification for every minted solidshare: term.

#this        schema:Ticket
├─ #reservation  schema:*Reservation  →(reservationFor) #event | #trip
│  #trip         schema:Flight | TrainTrip | BusTrip | BoatTrip  →(dep/arr) #from / #to
│  #event        schema:Event | subtype  →(location) #venue
├─ #seat{n}, #barcode{n}, #detail{n}, #rel{n}, #wifi{n}
└─ #issuer, #holder, #membership, #style, #carrier

Reads follow the RDF links rather than fixed node names, so the reservation, trip and event are discovered through solidshare:reservation / schema:reservationFor regardless of how the nodes were named.

Constructors

TicketRDF

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

Functions

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.

getArtifactUri

fun getArtifactUri(): String?

The pod URI of the original imported artifact (solidshare:artifact), or null.

getArtifactVerified

fun getArtifactVerified(): Boolean?

Whether the artifact's issuer signature verified (solidshare:artifactVerified), or null.

getCategory

fun getCategory(): TicketCategory

The pass category, tolerating unknown stored values as TicketCategory.GENERIC.

getContentType

open override fun getContentType(): String

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

getCreated

fun getCreated(): String?

The creation timestamp (dcterms:created, ISO-8601), or null.

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.

getImages

fun getImages(): TicketImages?

The pod URIs of the stored pass images (solidshare:logoImage …), or null when none.

getIndexStartDate

fun getIndexStartDate(): String?

The date a wallet list should sort by: the event start, or a journey's departure.

getIssuerName

fun getIssuerName(): String?

The issuing organisation's display name, from the issuer node or organizationName.

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

getModified

fun getModified(): String?

The last-modification timestamp (dcterms:modified, ISO-8601), or null.

getSize

fun getSize(): Long

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

getStyle

fun getStyle(): TicketStyle?

The pass's presentation (colours, logo), or null when none was stored.

getTitle

fun getTitle(): String

The display title (schema:name); "" when absent, so a throwaway shell never crashes.

getValidThrough

fun getValidThrough(): String?

The validity end (schema:validThrough, ISO-8601), or null.

setArtifactUri

fun setArtifactUri(artifactUri: String?)

Sets (or clears, when null) the artifact link.

setArtifactVerified

fun setArtifactVerified(verified: Boolean?)

Sets (or clears, when null) the artifact-verified flag.

setCreated

fun setCreated(isoDateTime: String)

Sets the creation timestamp (ISO-8601).

setImages

fun setImages(images: TicketImages?)

Sets (or clears, when null/blank) the stored pass image links.

setModified

fun setModified(isoDateTime: String)

Sets the last-modification timestamp (ISO-8601).

setTicketData

fun setTicketData(data: NewTicket)

Rewrites this ticket's writable state from data with replace semantics: every fragment node and every optional property is replaced by the snapshot's content. Only the type triple, dcterms:created, solidshare:artifact, solidshare:artifactVerified and the stored image links survive — those belong to the resource lifecycle, not the ticket's editable content.

setTitle

fun setTitle(title: String)

Sets the display title.

toNewTicket

fun toNewTicket(): NewTicket

Reads this ticket's complete writable state into a NewTicket snapshot.

writeToParcel

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