Example 4: Statement matching¶
The getStatements()
method of the connection object provides a
simple way to perform unsophisticated queries. This method lets you
enter a mix of required values and wildcards, and retrieve all
matching triples. (If you need to perform sophisticated tests and
comparisons you should use a SPARQL query instead.)
Below, we illustrate two kinds of getStatements()
calls. The
first mimics traditional RDF4J syntax, and returns a Statement
object at each iteration. We will reuse data from in previous
examples to create a connection object and populate the repository
with four triples describing Bob and Alice. We’re going to search for
triples that mention Alice, so we have to create an “Alice” URI to use
in the search pattern:
from franz.openrdf.connect import ag_connect
conn = ag_connect('python-tutorial', create=True, clear=True)
conn.addData("""
@base <http://example.org/> .
<people/alice> a <ontology/Person> ;
<ontology/name> "Alice" .
<people/bob> a <ontology/Person> ;
<ontology/name> "Bob" .
""")
alice = conn.createURI("http://example.org/people/alice")
Now we search for triples with Alice’s URI in the subject
position. The None
values are wildcards for the predicate and
object positions of the triple.
statements = conn.getStatements(alice, None, None)
The getStatements()
method returns a RepositoryResult
object
(bound to the variable statements
in this case). This object can
be iterated over, exposing one result statement at a time. It is
sometimes desirable to screen the results for duplicates, using the
enableDuplicateFilter()
method. Note, however, that duplicate
filtering can be expensive. Our example does not contain any
duplicates, but it is possible for them to occur.
with statements:
statements.enableDuplicateFilter()
for statement in statements:
print(statement)
This prints out the two matching triples for “Alice.”
(<http://example.org/people/alice>, <http://www.w3.org/1999/02/22-rdf-syntax-ns#type>, <http://example.org/ontology/Person>)
(<http://example.org/people/alice>, <http://example.org/ontology/name>, "Alice")
Notice how we used the with
keyword to ensure that the
RepositoryResult
object is closed after the results are
fetched. This is necessary to release resources used during result
retrieval. The same goal could be accomplished by calling the
RepositoryResult.close()
method (preferably in a finally
block to ensure exception safety).