org.trellisldp.api

Interface ImmutableDataService<T>

Type Parameters:

T - the type of resource that can be persisted by this service

All Superinterfaces:

RetrievalService<T>

All Known Subinterfaces:

ResourceService

All Known Implementing Classes:

JoiningResourceService, TriplestoreResourceService

public interface ImmutableDataService<T>
extends RetrievalService<T>

A service that persists resources by appending to their records. Nothing that is recorded by add(org.apache.commons.rdf.api.IRI, org.apache.commons.rdf.api.Dataset) will be deleted by using add again.

Method Summary

Modifier and Type	Method and Description
CompletionStage<Void>	add(IRI identifier, Dataset dataset)

Methods inherited from interface org.trellisldp.api.RetrievalService

get

Method Detail

add

CompletionStage<Void> add(IRI identifier,
                          Dataset dataset)

Parameters:

identifier - the identifier under which to persist a dataset

dataset - a dataset to persist

Returns:

a new completion stage that, when the stage completes normally, indicates that the supplied data were successfully stored in the corresponding persistence layer. In the case of an unsuccessful write operation, the CompletionStage will complete exceptionally and can be handled with CompletionStage.handle(java.util.function.BiFunction<? super T, java.lang.Throwable, ? extends U>), CompletionStage.exceptionally(java.util.function.Function<java.lang.Throwable, ? extends T>) or similar methods.