Soprano::Util::DummyModel Class Reference

A dummy model. All its methods do nothing and always fail with a default error. More...

#include <Soprano/Util/DummyModel>

Inheritance diagram for Soprano::Util::DummyModel:

Inheritance graph
[legend]

List of all members.

Public Member Functions

 DummyModel ()
 ~DummyModel ()
Error::ErrorCode addStatement (const Statement &statement)
Error::ErrorCode addStatement (const Node &subject, const Node &predicate, const Node &object, const Node &context=Node())
Error::ErrorCode addStatements (const QList< Statement > &statements)
Error::ErrorCode removeStatement (const Statement &statement)
Error::ErrorCode removeStatement (const Node &subject, const Node &predicate, const Node &object, const Node &context=Node())
Error::ErrorCode removeAllStatements (const Statement &statement)
Error::ErrorCode removeStatements (const QList< Statement > &statements)
Error::ErrorCode removeContext (const Node &)
Error::ErrorCode removeAllStatements ()
StatementIterator listStatements (const Statement &partial) const
StatementIterator listStatements (const Node &subject, const Node &predicate, const Node &object, const Node &context=Node()) const
StatementIterator listStatements () const
StatementIterator listStatementsInContext (const Node &context) const
NodeIterator listContexts () const
QueryResultIterator executeQuery (const QString &query, Query::QueryLanguage language, const QString &userQueryLanguage=QString()) const
bool containsAnyStatement (const Statement &statement) const
bool containsAnyStatement (const Node &subject, const Node &predicate, const Node &object, const Node &context=Node()) const
bool containsStatement (const Statement &statement) const
bool containsStatement (const Node &subject, const Node &predicate, const Node &object, const Node &context=Node()) const
bool containsContext (const Node &context) const
bool isEmpty () const
int statementCount () const
Error::ErrorCode write (QTextStream &os) const
Node createBlankNode ()


Detailed Description

A dummy model. All its methods do nothing and always fail with a default error.

A dummy model might be useful in situations where a null pointer could lead to crashes if creating a real model fails.

Author:
Sebastian Trueg <trueg@kde.org>

Definition at line 42 of file dummymodel.h.


Constructor & Destructor Documentation

Soprano::Util::DummyModel::DummyModel (  ) 

Create a new dummy model.

Soprano::Util::DummyModel::~DummyModel (  ) 

destructor


Member Function Documentation

Error::ErrorCode Soprano::Util::DummyModel::addStatement ( const Statement statement  )  [virtual]

Add the Statement to the Model.

Parameters:
statement The Statement to add.

Implements Soprano::Model.

Error::ErrorCode Soprano::Util::DummyModel::addStatement ( const Node subject,
const Node predicate,
const Node object,
const Node context = Node() 
)

This is an overloaded member function, provided for convenience. It differs from the above function only in what argument(s) it accepts.

Reimplemented from Soprano::Model.

Error::ErrorCode Soprano::Util::DummyModel::addStatements ( const QList< Statement > &  statements  ) 

This is an overloaded member function, provided for convenience. It differs from the above function only in what argument(s) it accepts.

Reimplemented from Soprano::Model.

Error::ErrorCode Soprano::Util::DummyModel::removeStatement ( const Statement statement  )  [virtual]

Remove one statement. For removing statements with wildward matching see removeAllStatements().

Parameters:
statement The statement that should be removed. This has to be a valid statement.
Returns:
Error::ErrorNone on success and an error code if statement was invalid or an error occured.

Implements Soprano::Model.

Error::ErrorCode Soprano::Util::DummyModel::removeStatement ( const Node subject,
const Node predicate,
const Node object,
const Node context = Node() 
)

This is an overloaded member function, provided for convenience. It differs from the above function only in what argument(s) it accepts.

Reimplemented from Soprano::Model.

Error::ErrorCode Soprano::Util::DummyModel::removeAllStatements ( const Statement statement  )  [virtual]

Remove all statements that match the partial statement. For removing one specific statement see removeStatement().

Parameters:
statement A possible partially defined statement that serves as a filter for all statements that should be removed.

Implements Soprano::Model.

Error::ErrorCode Soprano::Util::DummyModel::removeStatements ( const QList< Statement > &  statements  ) 

Convenience method which removes all statements in statements.

Reimplemented from Soprano::Model.

Error::ErrorCode Soprano::Util::DummyModel::removeContext ( const Node  ) 

Convenience method that removes all statements in the context.

Reimplemented from Soprano::Model.

Error::ErrorCode Soprano::Util::DummyModel::removeAllStatements (  ) 

Convenience method that clear the Model of all statements

Reimplemented from Soprano::Model.

StatementIterator Soprano::Util::DummyModel::listStatements ( const Statement partial  )  const [virtual]

Return an iterator over Model Statements that "partial" match the input Statement.

Parameters:
partial The partial Statement to match.
Returns:
An iterator for all the matched Statements, on error an invalid iterator is returned.

Implements Soprano::Model.

StatementIterator Soprano::Util::DummyModel::listStatements ( const Node subject,
const Node predicate,
const Node object,
const Node context = Node() 
) const

This is an overloaded member function, provided for convenience. It differs from the above function only in what argument(s) it accepts.

Parameters:
subject The subject node to match. Can be empty as a wildcard.
predicate The predicate node to match. Can be empty as a wildcard.
object The object node to match. Can be empty as a wildcard.
context The context node to match. Can be empty as a wildcard.
Returns:
An iterator for all the matched Statements, on error an invalid iterator is returned.

Reimplemented from Soprano::Model.

StatementIterator Soprano::Util::DummyModel::listStatements (  )  const

This is an overloaded member function, provided for convenience. It differs from the above function only in what argument(s) it accepts.

Returns:
An iterator for all statements in the model, on error an invalid iterator is returned.

Reimplemented from Soprano::Model.

StatementIterator Soprano::Util::DummyModel::listStatementsInContext ( const Node context  )  const

Convenience method which lists all statements in context.

Returns:
An iterator for all the matched Statements, on error an invalid iterator is returned.

Reimplemented from Soprano::Model.

NodeIterator Soprano::Util::DummyModel::listContexts (  )  const [virtual]

List all contexts in the model, i.e. all named graphs.

Returns:
An iterator over context Nodes, on error an invalid iterator is returned.

Implements Soprano::Model.

QueryResultIterator Soprano::Util::DummyModel::executeQuery ( const QString query,
Query::QueryLanguage  language,
const QString userQueryLanguage = QString() 
) const [virtual]

Execute the given query over the Model.

This is a const read-only method. As such Model implementations should not support SPARQL extensions such as INSERT or UPDATE through this method. A future version of Soprano will provide an additional API for queries that change the Model.

Parameters:
query The query to evaluate.
language The query language used to encode query.
userQueryLanguage If language equals Query::QueryLanguageUser userQueryLanguage defines the language to use.
Returns:
An iterator over all results matching the query, on error an invalid iterator is returned.

Implements Soprano::Model.

bool Soprano::Util::DummyModel::containsAnyStatement ( const Statement statement  )  const [virtual]

Check if the model contains certain statements.

Parameters:
statement A partially defined statement that serves as a pattern.
Returns:
true if the Model contains a Statement matching the given statement pattern.

Implements Soprano::Model.

bool Soprano::Util::DummyModel::containsAnyStatement ( const Node subject,
const Node predicate,
const Node object,
const Node context = Node() 
) const

This is an overloaded member function, provided for convenience. It differs from the above function only in what argument(s) it accepts.

Parameters:
subject The subject node to match. Can be empty as a wildcard.
predicate The predicate node to match. Can be empty as a wildcard.
object The object node to match. Can be empty as a wildcard.
context The context node to match. Can be empty as a wildcard.

Reimplemented from Soprano::Model.

bool Soprano::Util::DummyModel::containsStatement ( const Statement statement  )  const [virtual]

Check if the model contains a statements.

Parameters:
statement The statement in question. This has to be a valid statement, i.e. subject, predicate, and object need to be defined. If the context node is empty the default graph is searched.
Returns:
true if the Model contains the Statement, false otherwise or is statement is invalid.

Implements Soprano::Model.

bool Soprano::Util::DummyModel::containsStatement ( const Node subject,
const Node predicate,
const Node object,
const Node context = Node() 
) const

This is an overloaded member function, provided for convenience. It differs from the above function only in what argument(s) it accepts.

Reimplemented from Soprano::Model.

bool Soprano::Util::DummyModel::containsContext ( const Node context  )  const

Convenience method which is based on containsAnyStatement

Reimplemented from Soprano::Model.

bool Soprano::Util::DummyModel::isEmpty (  )  const [virtual]

Returns:
true if the Model doesn't contains any Statement.

Implements Soprano::Model.

int Soprano::Util::DummyModel::statementCount (  )  const [virtual]

The number of statements stored in this Model.

Returns:
The size of the Model, or -1 on error.

Implements Soprano::Model.

Error::ErrorCode Soprano::Util::DummyModel::write ( QTextStream os  )  const [virtual]

Write all statements in this Model to os.

Default implementation is based on Model::listStatements

Reimplemented from Soprano::Model.

Node Soprano::Util::DummyModel::createBlankNode (  )  [virtual]

Creates a new blank node with a unique identifier.

Returns:
A blank node that can be used to create new statements.

Implements Soprano::Model.


The documentation for this class was generated from the following file:

Generated on Tue Jul 22 17:39:36 2008 for Soprano by  doxygen 1.5.6