| java.lang.Object
 org.openrdf.model.util.GraphUtil
| GraphUtil | | public class GraphUtil (Code) | | Utility methods for working with
Graph objects.
author:
Arjohn Kampman |
| Method Summary | |
| public static Iterator<Value> | getObjectIterator(Graph graph, Resource subj, URI pred, Resource... contexts)
Gets the objects of the statements with the specified subject, predicate
and (optionally) contexts from the supplied graph. | | public static Set<Value> | getObjects(Graph graph, Resource subj, URI pred, Resource... contexts)
Gets the objects of the statements with the specified subject, predicate
and (optionally) contexts from the supplied graph. | | public static Value | getOptionalObject(Graph graph, Resource subj, URI pred, Resource... contexts)
Gets the object of the statement(s) with the specified subject and
predicate from the specified contexts in the supplied graph. | | public static Literal | getOptionalObjectLiteral(Graph graph, Resource subj, URI pred)
Utility method that casts the return value of
GraphUtil.getOptionalObject(Graph,Resource,URI,Resource[]) to a Literal,
or throws a GraphUtilException if that value is not a Literal. | | public static Resource | getOptionalObjectResource(Graph graph, Resource subj, URI pred)
Utility method that casts the return value of
GraphUtil.getOptionalObject(Graph,Resource,URI,Resource[]) to a
Resource, or throws a GraphUtilException if that value is not a Resource. | | public static URI | getOptionalObjectURI(Graph graph, Resource subj, URI pred)
Utility method that casts the return value of
GraphUtil.getOptionalObject(Graph,Resource,URI,Resource[]) to a URI, or
throws a GraphUtilException if that value is not a URI. | | public static Resource | getOptionalSubject(Graph graph, URI pred, Value obj, Resource... contexts)
Gets the subject of the statement(s) with the specified predicate and
object from the specified contexts in the supplied graph. | | public static URI | getOptionalSubjectURI(Graph graph, URI pred, Value obj, Resource... contexts)
Utility method that casts the return value of
GraphUtil.getOptionalSubject(Graph,URI,Value,Resource[]) to a URI, or
throws a GraphUtilException if that value is not a URI. | | public static Iterator<Resource> | getSubjectIterator(Graph graph, URI pred, Value obj, Resource... contexts)
Gets the subject of the statements with the specified predicate, object
and (optionally) contexts from the supplied graph. | | public static Set<Resource> | getSubjects(Graph graph, URI pred, Value obj, Resource... contexts)
Gets the subject of the statements with the specified predicate, object
and (optionally) contexts from the supplied graph. | | public static Value | getUniqueObject(Graph graph, Resource subj, URI pred, Resource... contexts)
Gets the object of the statement(s) with the specified subject and
predicate from the specified contexts in the supplied graph. | | public static Literal | getUniqueObjectLiteral(Graph graph, Resource subj, URI pred)
Utility method that casts the return value of
GraphUtil.getUniqueObject(Graph,Resource,URI,Resource[]) to a Literal,
or throws a GraphUtilException if that value is not a Literal. | | public static Resource | getUniqueObjectResource(Graph graph, Resource subj, URI pred)
Utility method that casts the return value of
GraphUtil.getUniqueObject(Graph,Resource,URI,Resource[]) to a Resource,
or throws a GraphUtilException if that value is not a Resource. | | public static URI | getUniqueObjectURI(Graph graph, Resource subj, URI pred)
Utility method that casts the return value of
GraphUtil.getUniqueObject(Graph,Resource,URI,Resource[]) to a URI, or
throws a GraphUtilException if that value is not a URI. | | public static Resource | getUniqueSubject(Graph graph, URI pred, Value obj, Resource... contexts)
Gets the subject of the statement(s) with the specified predicate and
object from the specified contexts in the supplied graph. | | public static URI | getUniqueSubjectURI(Graph graph, URI pred, Value obj, Resource... contexts)
Utility method that casts the return value of
GraphUtil.getUniqueSubject(Graph,URI,Value,Resource[]) to a URI, or
throws a GraphUtilException if that value is not a URI. | | public static void | remove(Graph graph, Resource subj, URI pred, Value obj, Resource... contexts)
Utility method that removes all statements matching the specified criteria
from a graph.
Parameters:
graph - The graph to remove the statements from.
Parameters:
subj - The subject of the statements to match, null to matchstatements with any subject.
Parameters:
pred - The predicate of the statements to match, null to matchstatements with any predicate.
Parameters:
obj - The object of the statements to match, null to matchstatements with any object.
Parameters:
contexts - The contexts of the statements to match. | | public static void | setUniqueObject(Graph graph, Resource subj, URI pred, Value obj, Resource... contexts)
Adds the specified statement and makes sure that no other statements are
present in the Graph with the same subject and predicate. |
| getObjectIterator | | public static Iterator<Value> getObjectIterator(Graph graph, Resource subj, URI pred, Resource... contexts)(Code) | | Gets the objects of the statements with the specified subject, predicate
and (optionally) contexts from the supplied graph. Calling this method is
equivalent to calling graph.match(subj, pred, null, contexts)
and extracting the objects of the matching statements from the returned
iterator. See
Graph.match(ResourceURIValueResource[]) for a
description of the parameter values.
|
| getObjects | | public static Set<Value> getObjects(Graph graph, Resource subj, URI pred, Resource... contexts)(Code) | | Gets the objects of the statements with the specified subject, predicate
and (optionally) contexts from the supplied graph. Calling this method is
equivalent to calling graph.match(subj, pred, null, contexts)
and adding the objects of the matching statements to a set. See
Graph.match(ResourceURIValueResource[]) for a description of
the parameter values.
|
| getOptionalObject | | public static Value getOptionalObject(Graph graph, Resource subj, URI pred, Resource... contexts) throws GraphUtilException(Code) | | Gets the object of the statement(s) with the specified subject and
predicate from the specified contexts in the supplied graph. If the
combination of subject, predicate and contexts matches one or more
statements, all these statements should have the same object. A
RepositoryConfigException is thrown if this is not the case. See
Graph.match(ResourceURIValueResource[]) for a description of
the parameter values.
The object of the matched statement(s), or null if nomatching statements were found.
throws:
GraphUtilException - If the statements matched by the specified parameters have morethan one unique object. |
| getOptionalObjectLiteral | | public static Literal getOptionalObjectLiteral(Graph graph, Resource subj, URI pred) throws GraphUtilException(Code) | | Utility method that casts the return value of
GraphUtil.getOptionalObject(Graph,Resource,URI,Resource[]) to a Literal,
or throws a GraphUtilException if that value is not a Literal.
The object of the matched statement(s), or null if nomatching statements were found.
throws:
GraphUtilException - If such an exception is thrown byGraphUtil.getOptionalObject(Graph,Resource,URI,Resource[]) or ifits return value is not a Literal. |
| getOptionalObjectResource | | public static Resource getOptionalObjectResource(Graph graph, Resource subj, URI pred) throws GraphUtilException(Code) | | Utility method that casts the return value of
GraphUtil.getOptionalObject(Graph,Resource,URI,Resource[]) to a
Resource, or throws a GraphUtilException if that value is not a Resource.
The object of the matched statement(s), or null if nomatching statements were found.
throws:
GraphUtilException - If such an exception is thrown byGraphUtil.getOptionalObject(Graph,Resource,URI,Resource[]) or ifits return value is not a Resource. |
| getOptionalObjectURI | | public static URI getOptionalObjectURI(Graph graph, Resource subj, URI pred) throws GraphUtilException(Code) | | Utility method that casts the return value of
GraphUtil.getOptionalObject(Graph,Resource,URI,Resource[]) to a URI, or
throws a GraphUtilException if that value is not a URI.
The object of the matched statement(s), or null if nomatching statements were found.
throws:
GraphUtilException - If such an exception is thrown byGraphUtil.getOptionalObject(Graph,Resource,URI,Resource[]) or ifits return value is not a URI. |
| getOptionalSubject | | public static Resource getOptionalSubject(Graph graph, URI pred, Value obj, Resource... contexts) throws GraphUtilException(Code) | | Gets the subject of the statement(s) with the specified predicate and
object from the specified contexts in the supplied graph. If the
combination of predicate, object and contexts matches one or more
statements, all these statements should have the same subject. A
RepositoryConfigException is thrown if this is not the case. See
Graph.match(ResourceURIValueResource[]) for a description of
the parameter values.
The subject of the matched statement(s), or null if nomatching statements were found.
throws:
GraphUtilException - If the statements matched by the specified parameters have morethan one unique subject. |
| getOptionalSubjectURI | | public static URI getOptionalSubjectURI(Graph graph, URI pred, Value obj, Resource... contexts) throws GraphUtilException(Code) | | Utility method that casts the return value of
GraphUtil.getOptionalSubject(Graph,URI,Value,Resource[]) to a URI, or
throws a GraphUtilException if that value is not a URI.
The subject of the matched statement(s), or null if nomatching statements were found.
throws:
GraphUtilException - If such an exception is thrown byGraphUtil.getOptionalSubject(Graph,URI,Value,Resource[]) or ifits return value is not a URI. |
| getSubjectIterator | | public static Iterator<Resource> getSubjectIterator(Graph graph, URI pred, Value obj, Resource... contexts)(Code) | | Gets the subject of the statements with the specified predicate, object
and (optionally) contexts from the supplied graph. Calling this method is
equivalent to calling graph.match(null, pred, obj, contexts)
and extracting the subjects of the matching statements from the returned
iterator. See
Graph.match(ResourceURIValueResource[]) for a
description of the parameter values.
|
| getSubjects | | public static Set<Resource> getSubjects(Graph graph, URI pred, Value obj, Resource... contexts)(Code) | | Gets the subject of the statements with the specified predicate, object
and (optionally) contexts from the supplied graph. Calling this method is
equivalent to calling graph.match(null, pred, obj, contexts)
and adding the subjects of the matching statements to a set. See
Graph.match(ResourceURIValueResource[]) for a description of
the parameter values.
|
| getUniqueObject | | public static Value getUniqueObject(Graph graph, Resource subj, URI pred, Resource... contexts) throws GraphUtilException(Code) | | Gets the object of the statement(s) with the specified subject and
predicate from the specified contexts in the supplied graph. The
combination of subject, predicate and contexts must match at least one
statement. In case more than one statement matches -- for example
statements from multiple contexts -- all these statements should have the
same object. A
GraphUtilException is thrown if these conditions
are not met. See
Graph.match(ResourceURIValueResource[]) for
a description of the parameter values.
The object of the matched statement(s).
throws:
GraphUtilException - If the statements matched by the specified parameters do not haveexactly one unique object. |
| getUniqueSubject | | public static Resource getUniqueSubject(Graph graph, URI pred, Value obj, Resource... contexts) throws GraphUtilException(Code) | | Gets the subject of the statement(s) with the specified predicate and
object from the specified contexts in the supplied graph. The combination
of predicate, object and contexts must match at least one statement. In
case more than one statement matches -- for example statements from
multiple contexts -- all these statements should have the same subject. A
GraphUtilException is thrown if these conditions are not met. See
Graph.match(ResourceURIValueResource[]) for a description of
the parameter values.
The subject of the matched statement(s).
throws:
GraphUtilException - If the statements matched by the specified parameters do not haveexactly one unique subject. |
| getUniqueSubjectURI | | public static URI getUniqueSubjectURI(Graph graph, URI pred, Value obj, Resource... contexts) throws GraphUtilException(Code) | | Utility method that casts the return value of
GraphUtil.getUniqueSubject(Graph,URI,Value,Resource[]) to a URI, or
throws a GraphUtilException if that value is not a URI.
The subject of the matched statement(s).
throws:
GraphUtilException - If such an exception is thrown byGraphUtil.getUniqueSubject(Graph,URI,Value,Resource[]) or if itsreturn value is not a URI. |
| remove | | public static void remove(Graph graph, Resource subj, URI pred, Value obj, Resource... contexts)(Code) | | Utility method that removes all statements matching the specified criteria
from a graph.
Parameters:
graph - The graph to remove the statements from.
Parameters:
subj - The subject of the statements to match, null to matchstatements with any subject.
Parameters:
pred - The predicate of the statements to match, null to matchstatements with any predicate.
Parameters:
obj - The object of the statements to match, null to matchstatements with any object.
Parameters:
contexts - The contexts of the statements to match. If no contexts arespecified, statements will match disregarding their context. If oneor more contexts are specified, statements with a context matchingone of these will match.
throws:
IllegalArgumentException - If a null-array is specified as the value forcontexts. SeeOpenRDFUtil.verifyContextNotNull(Resource[]) for moreinfo. |
| setUniqueObject | | public static void setUniqueObject(Graph graph, Resource subj, URI pred, Value obj, Resource... contexts)(Code) | | Adds the specified statement and makes sure that no other statements are
present in the Graph with the same subject and predicate. When contexts
are specified, the (subj, pred) pair will occur exactly once in each
context, else the (subj, pred) pair will occur exactly once in the entire
Graph.
|
|
|