org.openrdf.sail.inferencer.fc

Class CustomGraphQueryInferencer

java.lang.Object

org.openrdf.sail.helpers.SailWrapper

org.openrdf.sail.helpers.NotifyingSailWrapper

org.openrdf.sail.inferencer.fc.CustomGraphQueryInferencer

All Implemented Interfaces:

NotifyingSail, Sail, StackableSail

public class CustomGraphQueryInferencer
extends NotifyingSailWrapper

A forward-chaining inferencer that infers new statements using a SPARQL or SeRQL graph query.

Author:

Dale Visser

Field Summary

Fields

Modifier and Type	Field and Description
protected org.slf4j.Logger	logger

Constructor Summary

Constructors

Constructor and Description
CustomGraphQueryInferencer()
CustomGraphQueryInferencer(NotifyingSail baseSail, QueryLanguage language, String queryText, String matcherText) Create a new custom inferencer.
CustomGraphQueryInferencer(QueryLanguage language, String queryText, String matcherText) Create a new custom inferencer.

Method Summary

Methods

Modifier and Type	Method and Description
InferencerConnection	getConnection()
Collection<Value>	getWatchObjects() Exposed for test purposes.
Collection<Value>	getWatchPredicates() Exposed for test purposes.
Collection<Value>	getWatchSubjects() Exposed for test purposes.
void	initialize()
void	setFields(QueryLanguage language, String queryText, String matcherText) Called in order to set all the fields needed for the inferencer to function.

Methods inherited from class org.openrdf.sail.helpers.NotifyingSailWrapper

addSailChangedListener, getBaseSail, removeSailChangedListener, setBaseSail

Methods inherited from class org.openrdf.sail.helpers.SailWrapper

getDataDir, getValueFactory, isWritable, setDataDir, shutDown, verifyBaseSailSet

Methods inherited from class java.lang.Object

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

Methods inherited from interface org.openrdf.sail.Sail

getDataDir, getValueFactory, isWritable, setDataDir, shutDown

Field Detail

logger

protected final org.slf4j.Logger logger

Constructor Detail

CustomGraphQueryInferencer

public CustomGraphQueryInferencer()

CustomGraphQueryInferencer

public CustomGraphQueryInferencer(QueryLanguage language,
                          String queryText,
                          String matcherText)
                           throws MalformedQueryException,
                                  UnsupportedQueryLanguageException,
                                  SailException

Create a new custom inferencer.

Parameters:

language - language that queryText and matcherText are expressed in

queryText - a query that returns an RDF graph of inferred statements to be added to the underlying Sail

matcherText - a query that returns an RDF graph of existing inferred statements already added previously

Throws:

MalformedQueryException - if there is a problem parsing either of the given queries

UnsupportedQueryLanguageException - if an unsupported query language is specified

SailException - if a problem occurs interpreting the rule pattern

CustomGraphQueryInferencer

public CustomGraphQueryInferencer(NotifyingSail baseSail,
                          QueryLanguage language,
                          String queryText,
                          String matcherText)
                           throws MalformedQueryException,
                                  UnsupportedQueryLanguageException,
                                  SailException

Create a new custom inferencer.

Parameters:

baseSail - an underlying Sail, such as another inferencer or a SailRepository

language - language that queryText and matcherText are expressed in

queryText - a query that returns an RDF graph of inferred statements to be added to the underlying Sail

matcherText - a query that returns an RDF graph of existing inferred statements already added previously

Throws:

MalformedQueryException - if there is a problem parsing either of the given queries

UnsupportedQueryLanguageException

SailException - if a problem occurs interpreting the rule pattern

Method Detail

setFields

public final void setFields(QueryLanguage language,
             String queryText,
             String matcherText)
                     throws MalformedQueryException,
                            SailException

Called in order to set all the fields needed for the inferencer to function.

Parameters:

language - language that queryText and matcherText are expressed in

queryText - a query that returns an RDF graph of inferred statements to be added to the underlying Sail

matcherText - a query that returns an RDF graph of existing inferred statements already added previously

Throws:

MalformedQueryException - if there is a problem parsing either of the given queries

SailException - if a problem occurs interpreting the rule pattern

getConnection

public InferencerConnection getConnection()
                                   throws SailException

Specified by:

getConnection in interface NotifyingSail

Specified by:

getConnection in interface Sail

Overrides:

getConnection in class NotifyingSailWrapper

Throws:

SailException

initialize

public void initialize()
                throws SailException

Specified by:

initialize in interface Sail

Overrides:

initialize in class SailWrapper

Throws:

SailException

getWatchSubjects

public Collection<Value> getWatchSubjects()

Exposed for test purposes.

Returns:

a computed collection of the statement subjects that, when added or removed, trigger an update of inferred statements

getWatchPredicates

public Collection<Value> getWatchPredicates()

Exposed for test purposes.

Returns:

a computed collection of the statement predicates that, when added or removed, trigger an update of inferred statements

getWatchObjects

public Collection<Value> getWatchObjects()

Exposed for test purposes.

Returns:

a computed collection of the statement objects that, when added or removed, trigger an update of inferred statements