org.trellisldp.api

Class JoiningResourceService

java.lang.Object

org.trellisldp.api.JoiningResourceService

All Implemented Interfaces:

ImmutableDataService<Resource>, MutableDataService<Resource>, ResourceService, RetrievalService<Resource>

public abstract class JoiningResourceService
extends Object
implements ResourceService

Uses two underlying persistence services (an ImmutableDataService and a MutableDataService) to provide the ResourceService API.

See Also:

ImmutableDataService, MutableDataService

Constructor Summary

Constructors

Constructor and Description
JoiningResourceService(MutableDataService<Resource> mutableData, ImmutableDataService<Resource> immutableData)

Method Summary

Modifier and Type	Method and Description
CompletionStage<Void>	add(IRI id, Dataset dataset)
CompletionStage<Void>	create(Metadata metadata, Dataset dataset) Create a resource in the server.
CompletionStage<Void>	delete(Metadata metadata) Delete a resource from the server.
CompletionStage<Resource>	get(IRI identifier) Get a resource by the given identifier.
CompletionStage<Void>	replace(Metadata metadata, Dataset dataset) Replace a resource in the server.

Methods inherited from class java.lang.Object

equals, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Methods inherited from interface org.trellisldp.api.ResourceService

generateIdentifier, skolemize, supportedInteractionModels, toExternal, toInternal, touch, unskolemize

Constructor Detail

JoiningResourceService

public JoiningResourceService(MutableDataService<Resource> mutableData,
                              ImmutableDataService<Resource> immutableData)

Parameters:

mutableData - service in which to persist mutable data

immutableData - service in which to persist immutable data

Method Detail

get

public CompletionStage<Resource> get(IRI identifier)

Description copied from interface: RetrievalService

Get a resource by the given identifier.

Specified by:

get in interface RetrievalService<Resource>

Parameters:

identifier - the resource identifier

Returns:

the resource

add

public CompletionStage<Void> add(IRI id,
                                 Dataset dataset)

Specified by:

add in interface ImmutableDataService<Resource>

Parameters:

id - 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.

create

public CompletionStage<Void> create(Metadata metadata,
                                    Dataset dataset)

Description copied from interface: MutableDataService

Create a resource in the server.

Specified by:

create in interface MutableDataService<Resource>

Parameters:

metadata - metadata for the new resource

dataset - the dataset to be persisted

Returns:

a new completion stage that, when the stage completes normally, indicates that the supplied data were successfully created 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.

replace

public CompletionStage<Void> replace(Metadata metadata,
                                     Dataset dataset)

Description copied from interface: MutableDataService

Replace a resource in the server.

Specified by:

replace in interface MutableDataService<Resource>

Parameters:

metadata - metadata for the resource

dataset - the dataset to be persisted

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.

delete

public CompletionStage<Void> delete(Metadata metadata)

Description copied from interface: MutableDataService

Delete a resource from the server.

Specified by:

delete in interface MutableDataService<Resource>

Parameters:

metadata - metadata for the resource

Returns:

a new completion stage that, when the stage completes normally, indicates that the resource was successfully deleted from the corresponding persistence layer. In the case of an unsuccessful delete 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.