/**
* 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.
*/
public function hasMatchingStatement(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/';
}
// use hash to differenciate between statements (no doublings allowed)
$statementHash = hash('sha256', json_encode($statement));
// check it
return isset($this->statements[$graphUri][$statementHash]);
}
/**
* 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);
}
/**
* 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.
*/
public function hasMatchingStatement(Statement $statement, Node $graph = null, array $options = array())
{
// if $graph was given, but its not a named node, set it to null.
if (null !== $graph && false === $graph->isNamed()) {
$graph = null;
}
// otherwise check, if graph was set in the statement and it is a named node and use it, if so.
if (null === $graph && null !== $statement->getGraph() && true === $statement->getGraph()->isNamed()) {
$graph = $statement->getGraph();
}
$statementIterator = $this->statementIteratorFactory->createIteratorFromArray(array($statement));
$result = $this->query('ASK { ' . $this->sparqlFormat($statementIterator, $graph) . '}', $options);
if (true === is_object($result)) {
return $result->getValue();
} else {
return $result;
}
}
/**
* 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 && null == $statement->getGraph()) {
throw new \Exception('Virtuoso is a quad store and therefore needs to know the graph to delete statements.');
}
parent::deleteMatchingStatements($statement, $graph, $options);
}
/**
* 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.');
}
}
