Package cz.cvut.kbss.ontodriver

Interface Statement

All Superinterfaces:

AutoCloseable

All Known Subinterfaces:

PreparedStatement

All Known Implementing Classes:

JenaPreparedStatement, JenaStatement, OwlapiPreparedStatement, OwlapiStatement, Rdf4jPreparedStatement, Rdf4jStatement

public interface Statement
extends AutoCloseable

This interface represents a SPARQL statement.

Nested Class Summary

Nested Classes

Modifier and Type	Interface	Description
static enum	Statement.StatementOntology	Specifies which ontology is used for statement evaluation.

Method Summary

Modifier and Type	Method	Description
void	close()	Closes this statement, releasing any resources it has hold.
void	disableInference()	Disables inference for execution of this statement.
ResultSet	executeQuery(String sparql)	Execute the specified SPARQL query.
void	executeUpdate(String sparql)	Execute the specified SPARQL update query.
Statement.StatementOntology	getStatementOntology()	Gets information about which ontology will be used to evaluate the statement.
boolean	isInferenceDisabled()	Checks whether inference is disabled for execution of this statement.
boolean	isOpen()	Whether this statement is still open.
void	useOntology(Statement.StatementOntology ontology)	Sets which ontology is used to evaluate this statement.

Method Details

executeQuery

ResultSet executeQuery(String sparql)
                throws OntoDriverException

Execute the specified SPARQL query.

Parameters:

sparql - The statement to execute

Returns:

ResultSet containing results of the query

Throws:

OntoDriverException - If an error occurs during query execution

executeUpdate

void executeUpdate(String sparql)
            throws OntoDriverException

Execute the specified SPARQL update query.

Parameters:

sparql - The statement to execute

Throws:

OntoDriverException - If an error occurs during query execution

useOntology

void useOntology(Statement.StatementOntology ontology)

Sets which ontology is used to evaluate this statement.

Statement.StatementOntology.TRANSACTIONAL ontology is the transactional version. It may contain uncommitted changes and thus the query results may differ from evaluation against Statement.StatementOntology.SHARED.

Note that implementations may ignore this setting depending on their internal transaction management mechanisms.

Parameters:

ontology - Which ontology to use

getStatementOntology

Statement.StatementOntology getStatementOntology()

Gets information about which ontology will be used to evaluate the statement.

Returns:

Which ontology will be used for evaluation

See Also:

• useOntology(StatementOntology)

isOpen

boolean isOpen()

Whether this statement is still open.

A Statement is closed if the method close() has been called on it.

Returns:

Open status

close

void close()
    throws OntoDriverException

Closes this statement, releasing any resources it has hold.

Calling the method close on a Statement object that is already closed has no effect.

Note: When a Statement object is closed, its current ResultSet object, if one exists, is also closed.

Specified by:

close in interface AutoCloseable

Throws:

OntoDriverException - If closing the statement fails

disableInference

void disableInference()

Disables inference for execution of this statement.

Note that by default, inference is enabled for execution of all statements (depending on whether the underlying storage supports inference at all). Also note that in case the underlying repository does not support disabling inference, this configuration may be silently ignored.

isInferenceDisabled

boolean isInferenceDisabled()

Checks whether inference is disabled for execution of this statement.

Returns:

Inference disabled status

See Also:

• disableInference()