org.ontoware.rdf2go.util

Class LoggingModelSet

java.lang.Object

org.ontoware.rdf2go.util.LoggingModelSet

All Implemented Interfaces:

Serializable, Iterable<Statement>, ClosableIterable<Statement>, Commitable, FindableModelSet, Lockable, ModelSet, ModelSetAddRemove, ModelSetIO, ModelValueFactory, NamespaceSupport, ReificationSupport, Sparqlable

public class LoggingModelSet
extends Object
implements ModelSet

A Model that delegates to another Model and logs all calls to a SLF4j logger. Ideal for performance analysis.

Author:

voelkel

See Also:

Serialized Form

Constructor Summary

Constructors

Constructor and Description
LoggingModelSet(ModelSet modelset)

Method Summary

Modifier and Type	Method and Description
void	addAll(Iterator<? extends Statement> statement) For each statement in the iterator, this method creates a Model named statement.getContextURI if needed.
boolean	addModel(Model model) Adds a model to this ModelSet.
void	addModel(Model model, URI contextURI) Adds a complete Model to the given contextURI.
void	addModelSet(ModelSet modelSet) Adds a complete ModelSet to this ModelSet.
BlankNode	addReificationOf(Statement statement) A convenience function for addReficationOf( createBlankNode(), statement );
Resource	addReificationOf(Statement statement, Resource resource) Reifies the statement, whether the statement was present in the model or not.
void	addStatement(Statement statement) This method creates a Model named statement.getContextURI if needed.
void	addStatement(URI contextURI, Resource subject, URI predicate, Node object) This method creates a Model named 'contextURI' if needed.
void	close() Close connection of the underlying implementation
void	commit() Deprecated.
boolean	contains(Statement s)
boolean	containsModel(URI contextURI)
boolean	containsStatements(UriOrVariable contextURI, ResourceOrVariable subject, UriOrVariable predicate, NodeOrVariable object)
long	countStatements(QuadPattern pattern)
BlankNode	createBlankNode() Create (but do not add) a new blank node
BlankNode	createBlankNode(String internalID) Create a new blank node with the given internal ID.
DatatypeLiteral	createDatatypeLiteral(String literal, URI datatypeURI)
LanguageTagLiteral	createLanguageTagLiteral(String literal, String langugeTag)
PlainLiteral	createPlainLiteral(String literal) Create a new plain literal
QuadPattern	createQuadPattern(UriOrVariable context, ResourceOrVariable subject, UriOrVariable predicate, NodeOrVariable object)
Statement	createStatement(Resource subject, URI predicate, Node object) Create a new statement - but DOES NOT add it to the model
Statement	createStatement(URI context, Resource subject, URI predicate, Node object) Creates a statement with a context URI.
URI	createURI(String uriString) Creates an RDF2Go URI.
void	deleteReification(Resource reificationResource) Delete reifications made by this resource.
void	dump() Print the whole content of this ModelSet to System.out.
ClosableIterator<Statement>	findStatements(QuadPattern pattern) Search across all existing models
ClosableIterator<Statement>	findStatements(UriOrVariable contextURI, ResourceOrVariable subject, UriOrVariable predicate, NodeOrVariable object) Search across all existing models
Collection<Resource>	getAllReificationsOf(Statement statement)
Model	getDefaultModel() The default model is used when the ModelSet is loaded from a serialisation that has no context.
Model	getModel(URI contextURI) Get the Model with the passed URI.
ClosableIterator<Model>	getModels()
ClosableIterator<URI>	getModelURIs()
String	getNamespace(String prefix)
Map<String,String>	getNamespaces() Get all namespaces as a map of prefix to namespace.
Object	getUnderlyingModelSetImplementation()
boolean	hasReifications(Statement stmt)
boolean	isEmpty()
boolean	isLocked()
boolean	isOpen()
boolean	isValidURI(String uriString) CHecks URI for syntax errors.
ClosableIterator<Statement>	iterator() Returns an iterator over a set of elements of type T.
void	lock() Tries to obtain a lock.
URI	newRandomUniqueURI() Implementations are free to choose if their semantics are unique within the this model, the ModelSet, or unique in the universe
ModelSet	open() Open connection to the underlying implementation
ClosableIterable<Statement>	queryConstruct(String query, String querylanguage)
QueryResultTable	querySelect(String query, String querylanguage) returns results for queries in other query languages as a QueryResultTable as supported by underlying implementation.
void	readFrom(InputStream in) Read from InputStream assuming to read an TRiX stream.
void	readFrom(InputStream reader, Syntax syntax) Reads assuming the given syntax.
void	readFrom(InputStream reader, Syntax syntax, String baseURI) Reads assuming the given syntax.
void	readFrom(Reader in) Read from Reader assuming to read a TRiX stream in UTF8 encoding.
void	readFrom(Reader in, Syntax syntax) Reads assuming the given syntax.
void	readFrom(Reader in, Syntax syntax, String baseURI) Reads assuming the given syntax.
void	removeAll() Removes all models, which is not the same as removing all statements from all models in this ModelSet.
void	removeAll(Iterator<? extends Statement> statement) For each statement in the iterator, the statement is removed form the model named statement.getContext(); If the model named statement.getContext() becomes empty, it remains in the ModelSet.
boolean	removeModel(URI contextURI) Removes the Model (NamedGraph) denoted by contextURI from this modelset.
void	removeNamespace(String prefix) Throws no exception if the prefix was not present.
void	removeStatement(Statement statement) Removes the statement (s,p,o) from a model named statement.getContext().
void	removeStatement(URI contextURI, Resource subject, URI predicate, Node object) Removes the statement (s,p,o) from a model named contextURI.
void	removeStatements(QuadPattern quadPattern) Find all models matching the context of the pattern and remove all matching triple patterms from them
void	removeStatements(UriOrVariable context, ResourceOrVariable subject, UriOrVariable predicate, NodeOrVariable object) Find all models matching the context, and remove all (subject, property ,object)-statements from these model
String	serialize(Syntax syntax) Convenience method to export a ModelSet to a String in a given syntax.
void	setAutocommit(boolean autocommit) Deprecated.
void	setNamespace(String prefix, String namespaceURI)
long	size() The number of explicit statements.
boolean	sparqlAsk(String query) SPARQL ask queries
ClosableIterable<Statement>	sparqlConstruct(String query)
ClosableIterable<Statement>	sparqlDescribe(String query) Iterator must be auto-close, i.e.
QueryResultTable	sparqlSelect(String queryString) returns results for SPARQL Select queries, as supported by underlying implementation.
void	unlock() Removes a lock.
void	update(DiffReader diff) Apply the changes given by this diff in one atomic operation Implementations must check that all statements to be removed are still in the Model.
void	writeTo(OutputStream out) Writing a TRiX stream in UTF8 encoding For more info on TRiX read: http://www.hpl.hp.com/techreports/2003/HPL-2003-268.html
void	writeTo(OutputStream out, Syntax syntax) Write the model to the passed writer, using the passed syntax.
void	writeTo(Writer out) Write to writer in UTF8 and TRiX.
void	writeTo(Writer out, Syntax syntax) Write the model to the passed writer, using the passed syntax.

Methods inherited from class java.lang.Object

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

Methods inherited from interface java.lang.Iterable

forEach, spliterator

Constructor Detail

LoggingModelSet

public LoggingModelSet(ModelSet modelset)

Method Detail

addAll

public void addAll(Iterator<? extends Statement> statement)
            throws ModelRuntimeException

Description copied from interface: ModelSetAddRemove

For each statement in the iterator, this method creates a Model named statement.getContextURI if needed. Then the statement (s,p,o) is inserted into that model.

Specified by:

addAll in interface ModelSetAddRemove

Throws:

ModelRuntimeException - if any internal (I/O related) exception occurs

addModel

public void addModel(Model model,
                     URI contextURI)
              throws ModelRuntimeException

Description copied from interface: ModelSet

Adds a complete Model to the given contextURI. The context URI of the model is ignored.

Specified by:

addModel in interface ModelSet

Throws:

ModelRuntimeException - if any internal (I/O related) exception occurs

addModel

public boolean addModel(Model model)

Description copied from interface: ModelSet

Adds a model to this ModelSet. Creating the named-graph if needed, adding the triples to it if not. Same semantics as: ModelSet.getModel(model.getContextUri).add(model). Note: This method might be much quicker than addAll(model.iterator()) depending on the implementation.

Specified by:

addModel in interface ModelSet

Returns:

true if successful

addModelSet

public void addModelSet(ModelSet modelSet)
                 throws ModelRuntimeException

Description copied from interface: ModelSet

Adds a complete ModelSet to this ModelSet. Context URIs in the Statements of the modelSet are respected.

Specified by:

addModelSet in interface ModelSet

Throws:

ModelRuntimeException - if any internal (I/O related) exception occurs

addReificationOf

public Resource addReificationOf(Statement statement,
                                 Resource resource)

Description copied from interface: ReificationSupport

Reifies the statement, whether the statement was present in the model or not. The statement itself is never added to the model, but it might have been in the model before this method call. This method creates only triples like (resource )rdf:subject s; rdf:predicate p; rdf:object o. Where s,p, and o are taken from the given statement. Adds the following statements, as defined in @see http://www.w3.org/TR/rdf-mt/#Reif

 (resource) rdf:type       rdf:Statement .
 (resource) rdf:subject   (statement.getSubject()) .
 (resource) rdf:predicate (statement.getPredicate()) .
 (resource) rdf:object    (statement.getObject()) .
 

Specified by:

addReificationOf in interface ReificationSupport

Parameters:

statement - which will be reified

resource - used to represent the reified statement

Returns:

the given resource

addReificationOf

public BlankNode addReificationOf(Statement statement)

Description copied from interface: ReificationSupport

A convenience function for addReficationOf( createBlankNode(), statement );

Specified by:

addReificationOf in interface ReificationSupport

Returns:

a new BlankNode which holds the reification of the given statement.

addStatement

public void addStatement(Statement statement)
                  throws ModelRuntimeException

Description copied from interface: ModelSetAddRemove

This method creates a Model named statement.getContextURI if needed. Then the statement (s,p,o) is inserted into that model.

Specified by:

addStatement in interface ModelSetAddRemove

Throws:

ModelRuntimeException - if any internal (I/O related) exception occurs

addStatement

public void addStatement(URI contextURI,
                         Resource subject,
                         URI predicate,
                         Node object)
                  throws ModelRuntimeException

Description copied from interface: ModelSetAddRemove

This method creates a Model named 'contextURI' if needed. Then the statement (s,p,o) is inserted into that model.

Specified by:

addStatement in interface ModelSetAddRemove

Parameters:

contextURI - a URI or null

subject - a Resource (URI or BlankNode)

object - a Node

Throws:

ModelRuntimeException - if any internal (I/O related) exception occurs

close

public void close()

Description copied from interface: ModelSet

Close connection of the underlying implementation

Specified by:

close in interface ModelSet

commit

@Deprecated
public void commit()
                        throws ModelRuntimeException

Deprecated.

Description copied from interface: Commitable

Writes all changes to underlying persistence layer - if such a layer is used by the implementation. Otherwise nothing happens.

Specified by:

commit in interface Commitable

Throws:

ModelRuntimeException - if the commit could not be executed

contains

public boolean contains(Statement s)
                 throws ModelRuntimeException

Specified by:

contains in interface FindableModelSet

Parameters:

s - a Statement

Returns:

true if the modelset contains a model with context s.getContext() which contains the statement s. If the context is null, the default graph is checked.

Throws:

ModelRuntimeException

containsModel

public boolean containsModel(URI contextURI)

Specified by:

containsModel in interface ModelSet

Returns:

true if a Model (NamedGraph) named 'contextURI' is known. The model might be empty. Some implementations don't manage models explicitly, here empty models can never exist.

containsStatements

public boolean containsStatements(UriOrVariable contextURI,
                                  ResourceOrVariable subject,
                                  UriOrVariable predicate,
                                  NodeOrVariable object)
                           throws ModelRuntimeException

Specified by:

containsStatements in interface FindableModelSet

Returns:

true, if a Model named 'contextURI' contains the statement (s,p,o)

Throws:

ModelRuntimeException

countStatements

public long countStatements(QuadPattern pattern)
                     throws ModelRuntimeException

Specified by:

countStatements in interface FindableModelSet

Returns:

the number of statements matchingthe pattern. This is for all graphs matching the context of the pattern (this is none, one or all graphs). In matching graphs the number of matching statements is accumulated and returned.

Throws:

ModelRuntimeException

createBlankNode

public BlankNode createBlankNode()

Description copied from interface: ModelValueFactory

Create (but do not add) a new blank node

Specified by:

createBlankNode in interface ModelValueFactory

Returns:

a new blank node

createBlankNode

public BlankNode createBlankNode(String internalID)

Description copied from interface: ModelValueFactory

Create a new blank node with the given internal ID. The id should be one returned from BlankNode.getInternalID().

Specified by:

createBlankNode in interface ModelValueFactory

Returns:

a BlankNode with the given internal ID.

createDatatypeLiteral

public DatatypeLiteral createDatatypeLiteral(String literal,
                                             URI datatypeURI)
                                      throws ModelRuntimeException

Specified by:

createDatatypeLiteral in interface ModelValueFactory

Returns:

a DatatypeLiteral

Throws:

ModelRuntimeException - e.g. if the datatype URI causes problems

createLanguageTagLiteral

public LanguageTagLiteral createLanguageTagLiteral(String literal,
                                                   String langugeTag)
                                            throws ModelRuntimeException

Specified by:

createLanguageTagLiteral in interface ModelValueFactory

Returns:

a LanguageTagLiteral

Throws:

ModelRuntimeException - e.g. if the language tag is malformed

createPlainLiteral

public PlainLiteral createPlainLiteral(String literal)

Description copied from interface: ModelValueFactory

Create a new plain literal

Specified by:

createPlainLiteral in interface ModelValueFactory

Returns:

a PlainLiteral

createQuadPattern

public QuadPattern createQuadPattern(UriOrVariable context,
                                     ResourceOrVariable subject,
                                     UriOrVariable predicate,
                                     NodeOrVariable object)

Specified by:

createQuadPattern in interface FindableModelSet

Returns:

a QuadPattern

createStatement

public Statement createStatement(Resource subject,
                                 URI predicate,
                                 Node object)

Description copied from interface: ModelValueFactory

Create a new statement - but DOES NOT add it to the model

Specified by:

createStatement in interface ModelValueFactory

Returns:

a Statement

createStatement

public Statement createStatement(URI context,
                                 Resource subject,
                                 URI predicate,
                                 Node object)

Description copied from interface: ModelSet

Creates a statement with a context URI.

Specified by:

createStatement in interface ModelSet

Returns:

the newly created statement (quad), which is not yet added to any model

createURI

public URI createURI(String uriString)
              throws ModelRuntimeException

Description copied from interface: ModelSet

Creates an RDF2Go URI. This allows a user to create a model via 'getModel( URI )'.

Specified by:

createURI in interface ModelSet

Specified by:

createURI in interface ModelValueFactory

Returns:

an RDF2Go URI

Throws:

ModelRuntimeException - if URI has not a valid URI format - according to the adapter

deleteReification

public void deleteReification(Resource reificationResource)

Description copied from interface: ReificationSupport

Delete reifications made by this resource. More technically, this method will remove the following patterns:

 (reificationResource) rdf:type      rdf:Statement . 
 (reificationResource) rdf:subject   * .
 (reificationResource) rdf:predicate * .
 (reificationResource) rdf:object    * .
 

Note that one resource might have been used in several reifications. Although semantic nonsense, this can happen. This method cleans up also these cases. Note that this method deletes the reification from all contexts.

Specified by:

deleteReification in interface ReificationSupport

dump

public void dump()

Description copied from interface: ModelSet

Print the whole content of this ModelSet to System.out.

Specified by:

dump in interface ModelSet

findStatements

public ClosableIterator<Statement> findStatements(QuadPattern pattern)
                                           throws ModelRuntimeException

Description copied from interface: FindableModelSet

Search across all existing models

Specified by:

findStatements in interface FindableModelSet

Returns:

all statements matching the quad pattern

Throws:

ModelRuntimeException

findStatements

public ClosableIterator<Statement> findStatements(UriOrVariable contextURI,
                                                  ResourceOrVariable subject,
                                                  UriOrVariable predicate,
                                                  NodeOrVariable object)
                                           throws ModelRuntimeException

Description copied from interface: FindableModelSet

Search across all existing models

Specified by:

findStatements in interface FindableModelSet

Returns:

all matching statements in all models

Throws:

ModelRuntimeException

getAllReificationsOf

public Collection<Resource> getAllReificationsOf(Statement statement)

Specified by:

getAllReificationsOf in interface ReificationSupport

Returns:

a collection which contains all resources that are a reification of the given statement.

getDefaultModel

public Model getDefaultModel()

Description copied from interface: ModelSet

The default model is used when the ModelSet is loaded from a serialisation that has no context. The default model has a context of 'null'

Specified by:

getDefaultModel in interface ModelSet

Returns:

the default model. It has to be isOpen() == true.

getModel

public Model getModel(URI contextURI)

Description copied from interface: ModelSet

Get the Model with the passed URI. If the model does not exist yet, an empty model will be created and returned. This method will throw an Exception when ModelSet.isOpen() is false. Note that the returned model is tied to this ModelSet. Any changes in the model will be reflected here, closing this ModelSet will close the returned Model. To avoid side-effects, closing the returned Model will NOT close this ModelSet. Closing the returned model will not affect objects returned by previous calls to this method, hence this method should always return a new copy of the Model object to allow callers to close() a returned model.

Specified by:

getModel in interface ModelSet

Parameters:

contextURI - the URI of the context. This is the same as the name of the named graph.

Returns:

the model identified by this context. May have a size of 0, if no data was added to it yet. Never returns null. The returned model has isOpen() == true. Closing the returned model will not close this dataset and is optional.

getModels

public ClosableIterator<Model> getModels()

Specified by:

getModels in interface ModelSet

Returns:

an Interator over all models within this ModelSet. Some models might be empty. Since 4.4.10: Each model has to be isOpen() == true. For some implementations: While you read the iterator you may not WRITE to the models.

getModelURIs

public ClosableIterator<URI> getModelURIs()

Specified by:

getModelURIs in interface ModelSet

Returns:

an iterator over all URIs used as model URIs. For some implementations: While you read the iterator you may not WRITE to the models.

getNamespace

public String getNamespace(String prefix)

Specified by:

getNamespace in interface NamespaceSupport

Returns:

the namespace that is associated with the specified prefix, if any. Null otherwise.

getNamespaces

public Map<String,String> getNamespaces()

Description copied from interface: NamespaceSupport

Get all namespaces as a map of prefix to namespace.

Specified by:

getNamespaces in interface NamespaceSupport

Returns:

An unmodifiable view on the namespaces. (compare to Collections.unmodifiableMap()). Never returns null.

getUnderlyingModelSetImplementation

public Object getUnderlyingModelSetImplementation()

Specified by:

getUnderlyingModelSetImplementation in interface ModelSet

Returns:

the native implementation (e.g. a Jena Model). Using this method breaks strict triple store independence, but exposes the full power and reduces API dependence. This method is part of the main API.

hasReifications

public boolean hasReifications(Statement stmt)

Specified by:

hasReifications in interface ReificationSupport

Returns:

true if the model contains results to the query

 ?reificationResource rdf:type      rdf:Statement . 
 ?reificationResource rdf:subject   ?s .
 ?reificationResource rdf:predicate ?p .
 ?reificationResource rdf:object    ?o .
 

isEmpty

public boolean isEmpty()

Specified by:

isEmpty in interface ModelSet

Returns:

true if all models in this ModelSet contain zero statements. This method might be faster than calling size() == 0 on each model. Note: This method can return isEmpty == true, even if the ModelSet contains a number of models.

isLocked

public boolean isLocked()

Specified by:

isLocked in interface Lockable

Returns:

true if a lock is active

isOpen

public boolean isOpen()

Specified by:

isOpen in interface ModelSet

Returns:

true if ModelSet is open

isValidURI

public boolean isValidURI(String uriString)

Description copied from interface: ModelValueFactory

CHecks URI for syntax errors.

Specified by:

isValidURI in interface ModelValueFactory

Returns:

true if the URI is valid for the given implementation

iterator

public ClosableIterator<Statement> iterator()

Description copied from interface: ClosableIterable

Returns an iterator over a set of elements of type T.

Specified by:

iterator in interface Iterable<Statement>

Specified by:

iterator in interface ClosableIterable<Statement>

Returns:

an Iterator.

lock

public void lock()
          throws LockException

Description copied from interface: Lockable

Tries to obtain a lock.

Specified by:

lock in interface Lockable

Throws:

LockException - if already locked

newRandomUniqueURI

public URI newRandomUniqueURI()

Description copied from interface: ModelValueFactory

Implementations are free to choose if their semantics are unique within the this model, the ModelSet, or unique in the universe

Specified by:

newRandomUniqueURI in interface ModelValueFactory

Returns:

a new, unique URI

open

public ModelSet open()

Description copied from interface: ModelSet

Open connection to the underlying implementation

Specified by:

open in interface ModelSet

Returns:

the modelSet itself (now open) ready for further operations

queryConstruct

public ClosableIterable<Statement> queryConstruct(String query,
                                                  String querylanguage)
                                           throws QueryLanguageNotSupportedException,
                                                  MalformedQueryException,
                                                  ModelRuntimeException

Specified by:

queryConstruct in interface Sparqlable

Returns:

results for other construct-like queries, as supported by underlying implementation. Iterator is auto-close, i.e. when last element is fetched, the implementation must call close().

Throws:

QueryLanguageNotSupportedException - if the adapter can't understand the given query language

MalformedQueryException - if the query is not a valid construct query in the given query language

ModelRuntimeException - if the execution throws an exception

querySelect

public QueryResultTable querySelect(String query,
                                    String querylanguage)
                             throws QueryLanguageNotSupportedException,
                                    MalformedQueryException,
                                    ModelRuntimeException

Description copied from interface: Sparqlable

returns results for queries in other query languages as a QueryResultTable as supported by underlying implementation. For some implementations (Sesame) it is urgently necessary to iterate over all statements of the returned iterator in order to close resources properly. Iterator must be auto-close, i.e. when last element is fetched, the implementation must call close().

Specified by:

querySelect in interface Sparqlable

Returns:

a QueryResultTable

Throws:

QueryLanguageNotSupportedException - if the given query langauge is not supported

MalformedQueryException - if the query is not a valid query in the given query language

ModelRuntimeException - if the execution throws an exception

readFrom

public void readFrom(InputStream reader,
                     Syntax syntax,
                     String baseURI)
              throws IOException,
                     ModelRuntimeException,
                     SyntaxNotSupportedException

Description copied from interface: ModelSetIO

Reads assuming the given syntax. Encoding defaults to UTF8.

Specified by:

readFrom in interface ModelSetIO

syntax - syntax to use

baseURI - base URI to use

Throws:

IOException - on IOErrors

ModelRuntimeException - on RDF serialisation errors or model errors

SyntaxNotSupportedException - if adapter can't handle the given syntax

readFrom

public void readFrom(InputStream reader,
                     Syntax syntax)
              throws IOException,
                     ModelRuntimeException,
                     SyntaxNotSupportedException

Description copied from interface: ModelSetIO

Reads assuming the given syntax. Encoding defaults to UTF8.

Specified by:

readFrom in interface ModelSetIO

syntax - syntax to use

Throws:

IOException - on IOErrors

ModelRuntimeException - on RDF serialisation errors or model errors

SyntaxNotSupportedException - if adapter can't handle the given syntax

readFrom

public void readFrom(InputStream in)
              throws IOException,
                     ModelRuntimeException

Description copied from interface: ModelSetIO

Read from InputStream assuming to read an TRiX stream. All Models are created with the corresponding names as defined in the TRiX stream as needed. For more info on TRiX read: http://www.hpl.hp.com/techreports/2003/HPL-2003-268.html

Specified by:

readFrom in interface ModelSetIO

Parameters:

in - the input to read

Throws:

IOException - on IOErrors

ModelRuntimeException - on RDF serialisation errors or model errors

readFrom

public void readFrom(Reader in,
                     Syntax syntax,
                     String baseURI)
              throws IOException,
                     ModelRuntimeException,
                     SyntaxNotSupportedException

Description copied from interface: ModelSetIO

Reads assuming the given syntax. Encoding defaults to UTF8.

Specified by:

readFrom in interface ModelSetIO

Parameters:

in - the input to read

syntax - syntax to use

baseURI - baseURI to use

Throws:

IOException - on IOErrors

ModelRuntimeException - on RDF serialisation errors or model errors

SyntaxNotSupportedException - if adapter can't handle the given syntax

readFrom

public void readFrom(Reader in,
                     Syntax syntax)
              throws IOException,
                     ModelRuntimeException,
                     SyntaxNotSupportedException

Description copied from interface: ModelSetIO

Reads assuming the given syntax. Encoding defaults to UTF8.

Specified by:

readFrom in interface ModelSetIO

Parameters:

in - the input to read

syntax - syntax to use

Throws:

IOException - on IOErrors

ModelRuntimeException - on RDF serialisation errors or model errors

SyntaxNotSupportedException - if adapter can't handle the given syntax

readFrom

public void readFrom(Reader in)
              throws IOException,
                     ModelRuntimeException

Description copied from interface: ModelSetIO

Read from Reader assuming to read a TRiX stream in UTF8 encoding. All Models are created with the corresponding names as defined in the TRiX stream as needed. For more info on TRiX read: http://www.hpl.hp.com/techreports/2003/HPL-2003-268.html

Specified by:

readFrom in interface ModelSetIO

Parameters:

in - the input to read

Throws:

IOException - on IOErrors

ModelRuntimeException - on RDF serialization errors or model errors

removeAll

public void removeAll()
               throws ModelRuntimeException

Description copied from interface: ModelSet

Removes all models, which is not the same as removing all statements from all models in this ModelSet.

Specified by:

removeAll in interface ModelSet

Throws:

ModelRuntimeException

removeAll

public void removeAll(Iterator<? extends Statement> statement)
               throws ModelRuntimeException

Description copied from interface: ModelSetAddRemove

For each statement in the iterator, the statement is removed form the model named statement.getContext(); If the model named statement.getContext() becomes empty, it remains in the ModelSet.

Specified by:

removeAll in interface ModelSetAddRemove

Throws:

ModelRuntimeException - if any internal (I/O related) exception occurs

removeModel

public boolean removeModel(URI contextURI)

Description copied from interface: ModelSet

Removes the Model (NamedGraph) denoted by contextURI from this modelset. If the model contains statements, they are deleted.

Specified by:

removeModel in interface ModelSet

Returns:

true if successful

removeNamespace

public void removeNamespace(String prefix)

Description copied from interface: NamespaceSupport

Throws no exception if the prefix was not present.

Specified by:

removeNamespace in interface NamespaceSupport

removeStatement

public void removeStatement(Statement statement)
                     throws ModelRuntimeException

Description copied from interface: ModelSetAddRemove

Removes the statement (s,p,o) from a model named statement.getContext(). If the model named statement.getContext() becomes empty, it remains in the ModelSet.

Specified by:

removeStatement in interface ModelSetAddRemove

Parameters:

statement - a Statement

Throws:

ModelRuntimeException - if any internal (I/O related) exception occurs

removeStatement

public void removeStatement(URI contextURI,
                            Resource subject,
                            URI predicate,
                            Node object)
                     throws ModelRuntimeException

Description copied from interface: ModelSetAddRemove

Removes the statement (s,p,o) from a model named contextURI. If the model named 'contextURI' becomes empty, it remains in the ModelSet.

Specified by:

removeStatement in interface ModelSetAddRemove

subject - a Resource (URI or BlankNode)

object - a Node

Throws:

ModelRuntimeException - if any internal (I/O related) exception occurs

removeStatements

public void removeStatements(QuadPattern quadPattern)
                      throws ModelRuntimeException

Description copied from interface: ModelSetAddRemove

Find all models matching the context of the pattern and remove all matching triple patterms from them

Specified by:

removeStatements in interface ModelSetAddRemove

Throws:

ModelRuntimeException

removeStatements

public void removeStatements(UriOrVariable context,
                             ResourceOrVariable subject,
                             UriOrVariable predicate,
                             NodeOrVariable object)
                      throws ModelRuntimeException

Description copied from interface: ModelSetAddRemove

Find all models matching the context, and remove all (subject, property ,object)-statements from these model

Specified by:

removeStatements in interface ModelSetAddRemove

Throws:

ModelRuntimeException

serialize

public String serialize(Syntax syntax)
                 throws SyntaxNotSupportedException

Description copied from interface: ModelSetIO

Convenience method to export a ModelSet to a String in a given syntax.

Specified by:

serialize in interface ModelSetIO

Returns:

a String, containing the ModelSet content in the given syntax.

Throws:

SyntaxNotSupportedException - if the syntax is not supported

setAutocommit

@Deprecated
public void setAutocommit(boolean autocommit)

Deprecated.

Description copied from interface: Commitable

The default value is true.

Specified by:

setAutocommit in interface Commitable

Parameters:

autocommit - If true, all changes are immediately written to the underlying persistence layer, if any is used.

setNamespace

public void setNamespace(String prefix,
                         String namespaceURI)
                  throws IllegalArgumentException

Specified by:

setNamespace in interface NamespaceSupport

Throws:

IllegalArgumentException - if the given namespaceURI is not a valid URI in this environment.

size

public long size()
          throws ModelRuntimeException

Description copied from interface: ModelSet

The number of explicit statements. Statements that are inferred e.g. using backward-chaining are per definition not in this number, and also some inferred statements may or may be not part of this size, depending on the implementation of the model. If a new triple is added to the model, the size must increase.

Specified by:

size in interface ModelSet

Returns:

the number of statements in this ModelSet.

Throws:

ModelRuntimeException

sparqlAsk

public boolean sparqlAsk(String query)
                  throws ModelRuntimeException,
                         MalformedQueryException

Description copied from interface: Sparqlable

SPARQL ask queries

Specified by:

sparqlAsk in interface Sparqlable

Parameters:

query - a SPARQL AKS query

Returns:

the query result as true or false

Throws:

ModelRuntimeException - if the execution throws an exception

MalformedQueryException - if the query is not a valid SPARQL ASK query

sparqlConstruct

public ClosableIterable<Statement> sparqlConstruct(String query)
                                            throws ModelRuntimeException,
                                                   MalformedQueryException

Specified by:

sparqlConstruct in interface Sparqlable

Returns:

results for SPARQL Construct queries, as supported by underlying implementation. Iterator is auto-close, i.e. when last element is fetched, the implementation must call close().

Throws:

ModelRuntimeException - if the execution throws an exception

MalformedQueryException - if the query is not a valid SPARQL CONSTRUCT query

sparqlDescribe

public ClosableIterable<Statement> sparqlDescribe(String query)
                                           throws ModelRuntimeException

Description copied from interface: Sparqlable

Iterator must be auto-close, i.e. when last element is fetched, the implementation must call close(). This means a regular user can call this method without calling close(), if all elements are consumed.

Specified by:

sparqlDescribe in interface Sparqlable

Returns:

a ClosableIterable over all statements returned by this query

Throws:

ModelRuntimeException - if the execution throws an exception

MalformedQueryException - if the query is not a valid SPARQL DESCRIBE query

sparqlSelect

public QueryResultTable sparqlSelect(String queryString)
                              throws MalformedQueryException,
                                     ModelRuntimeException

Description copied from interface: Sparqlable

returns results for SPARQL Select queries, as supported by underlying implementation. For some implementations (Sesame) it is urgently necessary to iterate over all statements of the returned iterator in order to close resources properly. Iterator must be auto-close, i.e. when last element is fetched, the implementation must call close().

Specified by:

sparqlSelect in interface Sparqlable

Parameters:

queryString - The SPARQL select query string

Returns:

a QueryResultTable

Throws:

MalformedQueryException - if the query is not a valid SPARQL SELECT query

ModelRuntimeException - if an error happens when executing the query

unlock

public void unlock()

Description copied from interface: Lockable

Removes a lock. If no lock was set, nothing happens.

Specified by:

unlock in interface Lockable

update

public void update(DiffReader diff)
            throws ModelRuntimeException

Description copied from interface: ModelSetAddRemove

Apply the changes given by this diff in one atomic operation Implementations must check that all statements to be removed are still in the Model. Otherwise an exception is thrown. First all triples to be removed are removed, then triples to be added are added. In this modelset, this means (s,p,o) is removed from the graph named c, for all statements (c,s,p,o). Note: Models becoming empty are not removed.

Specified by:

update in interface ModelSetAddRemove

Throws:

ModelRuntimeException - if a model or statement in a model to be removed does not exist.

writeTo

public void writeTo(OutputStream out,
                    Syntax syntax)
             throws IOException,
                    ModelRuntimeException,
                    SyntaxNotSupportedException

Description copied from interface: ModelSetIO

Write the model to the passed writer, using the passed syntax.

Specified by:

writeTo in interface ModelSetIO

Parameters:

out - the output to write to

syntax - syntax to use

Throws:

IOException - on IOErrors

ModelRuntimeException - on RDF serialization errors or model errors

SyntaxNotSupportedException - if adapter can't handle the given syntax

writeTo

public void writeTo(OutputStream out)
             throws IOException,
                    ModelRuntimeException

Description copied from interface: ModelSetIO

Writing a TRiX stream in UTF8 encoding For more info on TRiX read: http://www.hpl.hp.com/techreports/2003/HPL-2003-268.html

Specified by:

writeTo in interface ModelSetIO

Parameters:

out - the output to write to

Throws:

IOException - on IOErrors

ModelRuntimeException - on RDF serialization errors or model errors

writeTo

public void writeTo(Writer out,
                    Syntax syntax)
             throws IOException,
                    ModelRuntimeException,
                    SyntaxNotSupportedException

Description copied from interface: ModelSetIO

Write the model to the passed writer, using the passed syntax.

Specified by:

writeTo in interface ModelSetIO

Parameters:

out - the output to write to

syntax - syntax to use

Throws:

IOException - on IOErrors

ModelRuntimeException - on RDF serialization errors or model errors

SyntaxNotSupportedException - if adapter can't handle the given syntax

writeTo

public void writeTo(Writer out)
             throws IOException,
                    ModelRuntimeException

Description copied from interface: ModelSetIO

Write to writer in UTF8 and TRiX. For more info on TRiX read: http://www.hpl.hp.com/techreports/2003/HPL-2003-268.html

Specified by:

writeTo in interface ModelSetIO

Parameters:

out - the output to write to

Throws:

IOException - on IOErrors

ModelRuntimeException - on RDF serialization errors or model errors