/**
* It basically returns all stored statements.
*
* @param Statement $Statement It can be either a concrete or pattern-statement.
* @param Node $graph optional Overrides target graph. If set, you will get all
* matching statements of that graph.
* @param array $options optional It contains key-value pairs and should provide additional
* introductions for the store and/or its adapter(s).
* @return StatementIterator It contains Statement instances of all matching statements of the given
* graph.
*/
public function getMatchingStatements(Statement $statement, Node $graph = null, array $options = array())
{
if (null !== $graph) {
$graphUri = $graph->getUri();
// no graph information given, use default graph
} elseif (null === $graph && null === $statement->getGraph()) {
$graphUri = 'http://saft/defaultGraph/';
// no graph given, use graph information from $statement
} elseif (null === $graph && $statement->getGraph()->isNamed()) {
$graphUri = $statement->getGraph()->getUri();
// no graph given, use graph information from $statement
} elseif (null === $graph && false == $statement->getGraph()->isNamed()) {
$graphUri = 'http://saft/defaultGraph/';
}
if (false == isset($this->statements[$graphUri])) {
$this->statements[$graphUri] = array();
}
// if not default graph was requested
if ('http://saft/defaultGraph/' != $graphUri) {
return new ArrayStatementIteratorImpl($this->statements[$graphUri]);
// if default graph was requested, return matching statements from all graphs
} else {
$_statements = array();
foreach ($this->statements as $graphUri => $statements) {
foreach ($statements as $statement) {
if ('http://saft/defaultGraph/' == $graphUri) {
$graph = null;
} else {
$graph = $this->nodeFactory->createNamedNode($graphUri);
}
$_statements[] = $this->statementFactory->createStatement($statement->getSubject(), $statement->getPredicate(), $statement->getObject(), $graph);
}
}
return new ArrayStatementIteratorImpl($_statements);
}
}
/**
* It gets all statements of a given graph which match the following conditions:
* - statement's subject is either equal to the subject of the same statement of the graph or
* it is null.
* - statement's predicate is either equal to the predicate of the same statement of the graph or
* it is null.
* - statement's object is either equal to the object of a statement of the graph or it is null.
*
* @param Statement $Statement It can be either a concrete or pattern-statement.
* @param Node $graph optional Overrides target graph. If set, you will get all
* matching statements of that graph.
* @param array $options optional It contains key-value pairs and should provide
* additional introductions for the store and/or its
* adapter(s).
* @return StatementIterator It contains Statement instances of all matching statements of the
* given graph.
* @todo check if graph URI is valid
* @todo make it possible to read graphUri from $statement, if given $graphUri is null
*/
public function getMatchingStatements(Statement $statement, Node $graph = null, array $options = array())
{
// otherwise check, if graph was set in the statement and it is a named node and use it, if so.
if (null === $graph && $statement->isQuad()) {
$graph = $statement->getGraph();
}
/*
* Build query
*/
$query = 'SELECT ?s ?p ?o { ?s ?p ?o ';
if ($graph !== null) {
$query = 'SELECT ?s ?p ?o ?g { graph ?g { ?s ?p ?o } ';
}
// create shortcuts for S, P and O
$subject = $statement->getSubject();
$predicate = $statement->getPredicate();
$object = $statement->getObject();
// add filter, if subject is a named node or literal
if (!$subject->isVariable()) {
$query .= 'FILTER (?s = ' . $subject->toNQuads() . ') ';
}
// add filter, if predicate is a named node or literal
if (!$predicate->isVariable()) {
$query .= 'FILTER (?p = ' . $predicate->toNQuads() . ') ';
}
// add filter, if object is a named node or literal
if (!$object->isVariable()) {
$query .= 'FILTER (?o = ' . $object->toNQuads() . ') ';
}
// add filter, if graph is a named node or literal
if ($graph !== null && !$graph->isVariable()) {
$query .= 'FILTER (?g = ' . $graph->toNQuads() . ') ';
}
$query .= '}';
// execute query and save result
// TODO transform getMatchingStatements into lazy loading, so a batch loading is possible
$result = $this->query($query, $options);
/*
* Transform SetResult entries to Statement instances.
*/
$statementList = array();
if ($graph !== null) {
foreach ($result as $entry) {
$statementList[] = $this->statementFactory->createStatement($entry['s'], $entry['p'], $entry['o'], $entry['g']);
}
} else {
foreach ($result as $entry) {
$statementList[] = $this->statementFactory->createStatement($entry['s'], $entry['p'], $entry['o']);
}
}
// return a StatementIterator which contains the matching statements
return $this->statementIteratorFactory->createIteratorFromArray($statementList);
}
/**
* Removes all statements from a (default-) graph which match with given statement.
*
* @param Statement $statement It can be either a concrete or pattern-statement.
* @param Node $graph optional Overrides target graph. If set, all statements will
* be delete in that graph.
* @param array $options optional Key-value pairs which provide additional introductions
* for the store and/or its adapter(s).
*/
public function deleteMatchingStatements(Statement $statement, Node $graph = null, array $options = array())
{
// given $graph forces usage of it and not the graph from the statement instance
if (null !== $graph) {
// use given $graph
// use graphUri from statement
} elseif (null === $graph && null !== $statement->getGraph()) {
$graph = $statement->getGraph();
}
// create triple statement, because we have to handle the graph extra
$tripleStatement = $this->statementFactory->createStatement($statement->getSubject(), $statement->getPredicate(), $statement->getObject());
$statementIterator = $this->statementIteratorFactory->createIteratorFromArray(array($tripleStatement));
$triple = $this->sparqlFormat($statementIterator);
$query = 'DELETE ';
if (null !== $graph) {
$query .= 'FROM <' . $graph->getUri() . '> ';
}
$query .= '{' . $triple . '} WHERE {' . $triple . '}';
$this->query($query);
}
/**
* redirects to the query method.
* Returns true or false depending on whether or not the statements pattern
* has any matches in the given graph.
*
* @param Statement $statement It can be either a concrete or pattern-statement.
* @param Node $graph optional Overrides target graph.
* @param array $options optional It contains key-value pairs and should provide additional
* introductions for the store and/or its adapter(s).
* @return boolean Returns true if at least one match was found, false otherwise.
* @todo cache ask queries
*/
public function hasMatchingStatement(Statement $statement, Node $graph = null, array $options = array())
{
// TODO migrate code to new interface
$graphUri = null;
if ($graph !== null) {
$graphUri = $graph->getUri();
}
// log it
$this->addToLog(array('method' => 'hasMatchingStatement', 'parameter' => array('statement' => $statement, 'graphUri' => $graphUri, 'options' => $options)));
/**
* build matching query and check for cache entry
*/
// create shortcuts for S, P and O
$s = $statement->getSubject();
$p = $statement->getPredicate();
$o = $statement->getObject();
$query = '';
// add filter, if subject is a named node or literal
if (true === $s->isNamed()) {
$query .= 'FILTER (str(?s) = "' . $s->getUri() . '") ';
}
// add filter, if predicate is a named node or literal
if (true === $p->isNamed()) {
$query .= 'FILTER (str(?p) = "' . $p->getUri() . '") ';
}
// add filter, if predicate is a named node or literal
if (true === $o->isNamed()) {
$query .= 'FILTER (str(?o) = "' . $o->getUri() . '") ';
}
if (true == $o->isLiteral()) {
$query .= 'FILTER (str(?o) = ' . $o->getValue() . ') ';
}
$query = 'ASK FROM <' . $graphUri . '> { ?s ?p ?o ' . $query . '}';
$queryCacheContainer = $this->cache->load($query);
// check, if there is a cache entry for this statement
if (null !== $queryCacheContainer) {
return $queryCacheContainer['result'];
// if successor is set, ask it first before run the command yourself.
} elseif ($this->successor instanceof Store) {
$result = $this->successor->hasMatchingStatement($statement, $graph, $options);
$this->saveResult($this->queryFactory->createInstanceByQueryString($query), $result);
return $result;
// dont run command by myself
} else {
throw new \Exception('QueryCache does not support has matching statement calls, only by successor.');
}
}
