it.poliba.sisinflab.coap.ldp.resources

Class CoAPLDPResourceManager

java.lang.Object

it.poliba.sisinflab.coap.ldp.resources.CoAPLDPResourceManager

public class CoAPLDPResourceManager
extends java.lang.Object

Manages all the read/write operations on the RDF repository

Constructor Summary

Constructors

Constructor and Description
CoAPLDPResourceManager(java.lang.String baseUri) Creates an in-memory RDF repository.

Method Summary

Modifier and Type	Method and Description
void	addHandledNamespace(java.lang.String prefix, java.lang.String namespace) Adds a well-known namespace
void	addNotPersistedProperty(java.lang.String p) Adds a not-persisted property constraint
void	addRDFBasicContainer(java.lang.String uri) Adds the ldp:BasicContainer type to the resource
void	addRDFContainer(java.lang.String uri) Adds the ldp:Container type to the resource
void	addRDFDirectContainer(java.lang.String uri) Adds the ldp:DirectContainer type to the resource
void	addRDFIndirectContainer(java.lang.String uri) Adds the ldp:IndirectContainer type to the resource
void	addRDFSource(java.lang.String uri) Adds the ldp:RDFSource type to the resource
void	addRDFSource(java.lang.String name, java.lang.String type) Adds a specific type to the resource
void	addRDFStatement(org.eclipse.rdf4j.model.Resource s, org.eclipse.rdf4j.model.IRI p, org.eclipse.rdf4j.model.Value o) Adds a single statement to the RDF repository
void	addReadOnlyProperty(java.lang.String p) Adds a read-only property constraint
void	close() Closes the RDF repository
org.eclipse.rdf4j.model.IRI	createIRI(java.lang.String uri) Creates an IRI from a string
void	deleteMemberResourceStatement(java.lang.String name) Deletes all LDP memberResource statements related to a specific resource
void	deleteRDFBasicContainer(java.lang.String name) Deletes all statements related to a specific LDP Basic Container
void	deleteRDFDirectContainer(java.lang.String name) Deletes all statements related to a specific LDP Direct Container
void	deleteRDFSource(java.lang.String uri) Deletes all statements related to a specific LDP RDF Source
java.lang.String	getBaseURI() Return the repository base URI
java.lang.String	getconstrainedByURI() Gets the LDP constrainedBy URI
java.lang.String	getIsMemberOfRelation(java.lang.String rdf, org.eclipse.rdf4j.rio.RDFFormat format) Returns the isMemberOfRelation property contained in a set of RDF statements
java.lang.String	getJSONLDResourceGraph(java.lang.String uri) Returns the RDF graph associated to a resource in a JSON-LD serialization
java.lang.String	getMemberRelation(java.lang.String rdf, org.eclipse.rdf4j.rio.RDFFormat format) Returns the memberRelation property contained in a set of RDF statements
java.lang.String	getMemberResource(java.lang.String rdf, org.eclipse.rdf4j.rio.RDFFormat format) Returns the memberResource contained in a set of RDF statements
java.lang.String	getTurtleResourceGraph(java.lang.String uri) Returns the RDF graph associated to a resource in a Turtle serialization
java.lang.String	getTurtleResourceGraph(java.lang.String uri, java.util.List<java.lang.String> include, java.util.List<java.lang.String> omit) Returns the RDF graph associated to a resource in a Turtle serialization
boolean	isDeleted(java.lang.String uri) Verifies if a resource was previously deleted from the server
void	patchResource(java.lang.String patch) Applies PATCH request
java.lang.String	postIndirectRDFSource(java.lang.String uri, java.lang.String rdf, java.lang.String rel, org.eclipse.rdf4j.rio.RDFFormat format) Creates a new RDF Source according to an LDP-CoAP POST request on an Indirect Container
void	postRDFSource(java.lang.String uri, java.lang.String rdf, org.eclipse.rdf4j.rio.RDFFormat format) Creates a new RDF Source according to an LDP-CoAP POST request on a Basic or Direct Container
void	putRDFSource(java.lang.String name, java.lang.String rdf, org.eclipse.rdf4j.rio.RDFFormat format) Creates/modifies a new RDF Source according to an LDP-CoAP PUT request on a Container
void	removeHandledNamespace(java.lang.String prefix) Removes a well-known namespace
void	setConstrainedByURI(java.lang.String uri) Sets the LDP constrainedBy URI
void	setLDPContainsRelationship(java.lang.String resource, java.lang.String container) Adds the LDP contains statement
void	setLDPInsertedContentRelation(java.lang.String container, java.lang.String relation) Adds the LDP insertedContentRelation statement
void	setLDPInverseMemberRelation(java.lang.String container, java.lang.String relation) Adds the LDP inverseMemberRelation statement
void	setLDPMemberRelation(java.lang.String container, java.lang.String relation) Adds the LDP memberRelation statement
void	setLDPMembershipResource(java.lang.String resource, java.lang.String container) Adds the LDP membershipResource statement
void	setRDFCreated(java.lang.String uri) Adds the RDF created statement to the resource
void	setRDFDescription(java.lang.String uri, java.lang.String description) Adds the RDF description statement to the resource
void	setRDFStatement(java.lang.String s, java.lang.String p, double v) Updates a single statement of the RDF repository
void	setRDFStatement(java.lang.String s, java.lang.String p, java.lang.String o) Updates a single statement of the RDF repository
void	setRDFTitle(java.lang.String uri, java.lang.String title) Adds the RDF title statement to the resource
void	updateRDFLiteralStatement(java.lang.String subj, java.lang.String pred, java.util.Date obj) Updates a single statement of the RDF repository (object is a literal)
void	updateRDFLiteralStatement(java.lang.String subj, java.lang.String pred, java.lang.Double obj) Updates a single statement of the RDF repository (object is a literal)
void	updateRDFStatement(java.lang.String subj, java.lang.String pred, java.lang.String obj) Updates a single statement of the RDF repository

Methods inherited from class java.lang.Object

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

Constructor Detail

CoAPLDPResourceManager

public CoAPLDPResourceManager(java.lang.String baseUri)

Creates an in-memory RDF repository.

Parameters:

baseUri - the repository base URI

Method Detail

getBaseURI

public java.lang.String getBaseURI()

Return the repository base URI

Returns:

the base URI

addHandledNamespace

public void addHandledNamespace(java.lang.String prefix,
                                java.lang.String namespace)

Adds a well-known namespace

Parameters:

prefix - the namespace prefix

namespace - the namespace URI

removeHandledNamespace

public void removeHandledNamespace(java.lang.String prefix)

Removes a well-known namespace

Parameters:

prefix - the prefix of the namespace to be removed

postRDFSource

public void postRDFSource(java.lang.String uri,
                          java.lang.String rdf,
                          org.eclipse.rdf4j.rio.RDFFormat format)
                   throws org.eclipse.rdf4j.rio.RDFParseException,
                          org.eclipse.rdf4j.repository.RepositoryException,
                          java.io.IOException,
                          CoAPLDPException

Creates a new RDF Source according to an LDP-CoAP POST request on a Basic or Direct Container

Parameters:

uri - the URI of the resource to be created

rdf - the RDF text contained in the request

format - the RDF format of the request body

Throws:

org.eclipse.rdf4j.rio.RDFParseException

org.eclipse.rdf4j.repository.RepositoryException

java.io.IOException

CoAPLDPException

isDeleted

public boolean isDeleted(java.lang.String uri)

Verifies if a resource was previously deleted from the server

Parameters:

uri - the URI of the deleted resource

Returns:

true if the resource was deleted

postIndirectRDFSource

public java.lang.String postIndirectRDFSource(java.lang.String uri,
                                              java.lang.String rdf,
                                              java.lang.String rel,
                                              org.eclipse.rdf4j.rio.RDFFormat format)
                                       throws org.eclipse.rdf4j.rio.RDFParseException,
                                              org.eclipse.rdf4j.repository.RepositoryException,
                                              java.io.IOException,
                                              CoAPLDPException

Creates a new RDF Source according to an LDP-CoAP POST request on an Indirect Container

Parameters:

uri - the URI of the resource to be created

rdf - the RDF text contained in the request

rel - the insertedContentRelation property of the Indirect Container

format - the RDF format of the request body

Throws:

org.eclipse.rdf4j.rio.RDFParseException

org.eclipse.rdf4j.repository.RepositoryException

java.io.IOException

CoAPLDPException

getMemberRelation

public java.lang.String getMemberRelation(java.lang.String rdf,
                                          org.eclipse.rdf4j.rio.RDFFormat format)
                                   throws org.eclipse.rdf4j.rio.RDFParseException,
                                          org.eclipse.rdf4j.rio.UnsupportedRDFormatException,
                                          java.io.IOException

Returns the memberRelation property contained in a set of RDF statements

Parameters:

rdf - the set of RDF statements

format - the RDF format of the input set

Returns:

the memberRelation property URI (null, if not present)

Throws:

org.eclipse.rdf4j.rio.RDFParseException

org.eclipse.rdf4j.rio.UnsupportedRDFormatException

java.io.IOException

getIsMemberOfRelation

public java.lang.String getIsMemberOfRelation(java.lang.String rdf,
                                              org.eclipse.rdf4j.rio.RDFFormat format)
                                       throws org.eclipse.rdf4j.rio.RDFParseException,
                                              org.eclipse.rdf4j.rio.UnsupportedRDFormatException,
                                              java.io.IOException

Returns the isMemberOfRelation property contained in a set of RDF statements

Parameters:

rdf - the set of RDF statements

format - the RDF format of the input set

Returns:

the isMemberOfRelation property URI (null, if not present)

Throws:

org.eclipse.rdf4j.rio.RDFParseException

org.eclipse.rdf4j.rio.UnsupportedRDFormatException

java.io.IOException

getMemberResource

public java.lang.String getMemberResource(java.lang.String rdf,
                                          org.eclipse.rdf4j.rio.RDFFormat format)
                                   throws org.eclipse.rdf4j.rio.RDFParseException,
                                          org.eclipse.rdf4j.rio.UnsupportedRDFormatException,
                                          java.io.IOException

Returns the memberResource contained in a set of RDF statements

Parameters:

rdf - the set of RDF statements

format - the RDF format of the input set

Returns:

the memberResource URI (null, if not present)

Throws:

org.eclipse.rdf4j.rio.RDFParseException

org.eclipse.rdf4j.rio.UnsupportedRDFormatException

java.io.IOException

putRDFSource

public void putRDFSource(java.lang.String name,
                         java.lang.String rdf,
                         org.eclipse.rdf4j.rio.RDFFormat format)
                  throws org.eclipse.rdf4j.rio.RDFParseException,
                         org.eclipse.rdf4j.repository.RepositoryException,
                         java.io.IOException,
                         CoAPLDPException

Creates/modifies a new RDF Source according to an LDP-CoAP PUT request on a Container

Parameters:

uri - the URI of the resource to be created/modified

rdf - the RDF text contained in the request

format - the RDF format of the request body

Throws:

org.eclipse.rdf4j.rio.RDFParseException

org.eclipse.rdf4j.repository.RepositoryException

java.io.IOException

CoAPLDPException

getTurtleResourceGraph

public java.lang.String getTurtleResourceGraph(java.lang.String uri)

Returns the RDF graph associated to a resource in a Turtle serialization

Parameters:

uri - the URI of the resource

Returns:

the RDF resource graph

getTurtleResourceGraph

public java.lang.String getTurtleResourceGraph(java.lang.String uri,
                                               java.util.List<java.lang.String> include,
                                               java.util.List<java.lang.String> omit)

Returns the RDF graph associated to a resource in a Turtle serialization

Parameters:

uri - the URI of the resource

include - the list of include preference headers

omi - the list of omit preference headers

Returns:

the RDF resource graph

getJSONLDResourceGraph

public java.lang.String getJSONLDResourceGraph(java.lang.String uri)

Returns the RDF graph associated to a resource in a JSON-LD serialization

Parameters:

uri - the URI of the resource

Returns:

the RDF resource graph

addRDFStatement

public void addRDFStatement(org.eclipse.rdf4j.model.Resource s,
                            org.eclipse.rdf4j.model.IRI p,
                            org.eclipse.rdf4j.model.Value o)

Adds a single statement to the RDF repository

Parameters:

s - the statement subject

p - the statement predicate

o - the statement object

addRDFSource

public void addRDFSource(java.lang.String uri)

Adds the ldp:RDFSource type to the resource

Parameters:

uri - the URI of the resource

addRDFSource

public void addRDFSource(java.lang.String name,
                         java.lang.String type)

Adds a specific type to the resource

Parameters:

uri - the URI of the resource

type - the type of resource

close

public void close()

Closes the RDF repository

addRDFContainer

public void addRDFContainer(java.lang.String uri)

Adds the ldp:Container type to the resource

Parameters:

uri - the URI of the resource

addRDFBasicContainer

public void addRDFBasicContainer(java.lang.String uri)

Adds the ldp:BasicContainer type to the resource

Parameters:

uri - the URI of the resource

addRDFDirectContainer

public void addRDFDirectContainer(java.lang.String uri)

Adds the ldp:DirectContainer type to the resource

Parameters:

uri - the URI of the resource

addRDFIndirectContainer

public void addRDFIndirectContainer(java.lang.String uri)

Adds the ldp:IndirectContainer type to the resource

Parameters:

uri - the URI of the resource

setRDFDescription

public void setRDFDescription(java.lang.String uri,
                              java.lang.String description)

Adds the RDF description statement to the resource

Parameters:

uri - the URI of the resource

description - the resource description

setRDFTitle

public void setRDFTitle(java.lang.String uri,
                        java.lang.String title)

Adds the RDF title statement to the resource

Parameters:

uri - the URI of the resource

title - the resource title

updateRDFStatement

public void updateRDFStatement(java.lang.String subj,
                               java.lang.String pred,
                               java.lang.String obj)

Updates a single statement of the RDF repository

Parameters:

subj - the statement subject

pred - the statement predicate

obj - the statement object

updateRDFLiteralStatement

public void updateRDFLiteralStatement(java.lang.String subj,
                                      java.lang.String pred,
                                      java.lang.Double obj)

Updates a single statement of the RDF repository (object is a literal)

Parameters:

subj - the statement subject

pred - the statement predicate

obj - the statement object (a Double value)

updateRDFLiteralStatement

public void updateRDFLiteralStatement(java.lang.String subj,
                                      java.lang.String pred,
                                      java.util.Date obj)

Updates a single statement of the RDF repository (object is a literal)

Parameters:

subj - the statement subject

pred - the statement predicate

obj - the statement object (a Date value)

setRDFCreated

public void setRDFCreated(java.lang.String uri)

Adds the RDF created statement to the resource

Parameters:

uri - the URI of the resource

setLDPContainsRelationship

public void setLDPContainsRelationship(java.lang.String resource,
                                       java.lang.String container)

Adds the LDP contains statement

Parameters:

resource - the URI of the resource

container - the URI of the container

deleteRDFSource

public void deleteRDFSource(java.lang.String uri)

Deletes all statements related to a specific LDP RDF Source

Parameters:

uri - the URI of the resource

deleteRDFBasicContainer

public void deleteRDFBasicContainer(java.lang.String name)

Deletes all statements related to a specific LDP Basic Container

Parameters:

uri - the URI of the container

deleteRDFDirectContainer

public void deleteRDFDirectContainer(java.lang.String name)

Deletes all statements related to a specific LDP Direct Container

Parameters:

uri - the URI of the container

setLDPMembershipResource

public void setLDPMembershipResource(java.lang.String resource,
                                     java.lang.String container)

Adds the LDP membershipResource statement

Parameters:

resource - the URI of the resource

container - the URI of the container

setLDPMemberRelation

public void setLDPMemberRelation(java.lang.String container,
                                 java.lang.String relation)

Adds the LDP memberRelation statement

Parameters:

resource - the URI of the resource

container - the URI of the container

setLDPInverseMemberRelation

public void setLDPInverseMemberRelation(java.lang.String container,
                                        java.lang.String relation)

Adds the LDP inverseMemberRelation statement

Parameters:

resource - the URI of the resource

container - the URI of the container

setLDPInsertedContentRelation

public void setLDPInsertedContentRelation(java.lang.String container,
                                          java.lang.String relation)

Adds the LDP insertedContentRelation statement

Parameters:

resource - the URI of the resource

container - the URI of the container

setRDFStatement

public void setRDFStatement(java.lang.String s,
                            java.lang.String p,
                            java.lang.String o)

Updates a single statement of the RDF repository

Parameters:

subj - the statement subject

pred - the statement predicate

obj - the statement object

setRDFStatement

public void setRDFStatement(java.lang.String s,
                            java.lang.String p,
                            double v)

Updates a single statement of the RDF repository

Parameters:

subj - the statement subject

pred - the statement predicate

obj - the statement object (a Double value)

createIRI

public org.eclipse.rdf4j.model.IRI createIRI(java.lang.String uri)

Creates an IRI from a string

Parameters:

uri - the string URI to be converted

Returns:

the created IRI

deleteMemberResourceStatement

public void deleteMemberResourceStatement(java.lang.String name)

Deletes all LDP memberResource statements related to a specific resource

Parameters:

name - the name of the resource

addReadOnlyProperty

public void addReadOnlyProperty(java.lang.String p)

Adds a read-only property constraint

Parameters:

p - the URI of the read-only property

addNotPersistedProperty

public void addNotPersistedProperty(java.lang.String p)

Adds a not-persisted property constraint

Parameters:

p - the URI of the not-persisted property

setConstrainedByURI

public void setConstrainedByURI(java.lang.String uri)

Sets the LDP constrainedBy URI

Parameters:

uri - the URI of the LDP constrainedBy property

getconstrainedByURI

public java.lang.String getconstrainedByURI()

Gets the LDP constrainedBy URI

Returns:

the URI of the LDP constrainedBy property

patchResource

public void patchResource(java.lang.String patch)
                   throws org.eclipse.rdf4j.repository.RepositoryException,
                          org.apache.marmotta.platform.ldp.patch.parser.ParseException,
                          org.apache.marmotta.platform.ldp.patch.InvalidPatchDocumentException

Applies PATCH request

Parameters:

patch - the RDF body of the patch request

Throws:

org.eclipse.rdf4j.repository.RepositoryException

org.apache.marmotta.platform.ldp.patch.parser.ParseException

org.apache.marmotta.platform.ldp.patch.InvalidPatchDocumentException