org.openrdf.model.util

Class Models

java.lang.Object

org.openrdf.model.util.Models

Direct Known Subclasses:

ModelUtil

public class Models
extends Object

Utility functions for working with Models and other Statement collections.

Since:

2.8.0

Author:

Jeen Broekstra, Arjohn Kampman

See Also:

Model

Constructor Summary

Constructors

Modifier	Constructor and Description
protected	Models()

Method Summary

Modifier and Type	Method and Description
static Value	anyObject(Model m) Retrieves any object value from the given model.
static Literal	anyObjectLiteral(Model m) Retrieves any object Literal value from the given model.
static Resource	anyObjectResource(Model m) Retrieves any object Resource value from the given model.
static URI	anyObjectURI(Model m) Retrieves any object URI value from the given model.
static URI	anyPredicate(Model m) Retrieves any predicate from the given model.
static Resource	anySubject(Model m) Retrieves any subject from the given model.
static BNode	anySubjectBNode(Model m) Retrieves any subject BNode from the given model.
static URI	anySubjectURI(Model m) Retrieves any subject URI from the given model.
static boolean	equals(Iterable<? extends Statement> model1, Iterable<? extends Statement> model2) Deprecated. since 2.8.0. Use isomorphic(Iterable, Iterable) instead.
static boolean	isomorphic(Iterable<? extends Statement> model1, Iterable<? extends Statement> model2) Compares two RDF models, and returns true if they contain isomorphic graphs.
static boolean	isSubset(Iterable<? extends Statement> model1, Iterable<? extends Statement> model2) Compares two RDF models, and returns true if the first model is a subset of the second model, using graph isomorphism to map statements between models.
static boolean	isSubset(Set<? extends Statement> model1, Set<? extends Statement> model2) Compares two RDF models, and returns true if the first model is a subset of the second model, using graph isomorphism to map statements between models.
static Model	setProperty(Model m, Resource subject, URI property, Value value, Resource... contexts) Sets the property value for the given subject to the given object value, replacing any existing value(s) for the subject's property.

Methods inherited from class java.lang.Object

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

Constructor Detail

Models

protected Models()

Method Detail

anyObject

public static Value anyObject(Model m)

Retrieves any object value from the given model. If more than one possible value exists, any one value is picked and returned.

Parameters:

m - the model from which to retrieve an object value.

Returns:

an object value from the given model, or null if no such value exists.

See Also:

Model.objectValue()

anyObjectLiteral

public static Literal anyObjectLiteral(Model m)

Retrieves any object Literal value from the given model. If more than one possible value exists, any one value is picked and returned.

Parameters:

m - the model from which to retrieve an object Literal value.

Returns:

an object Literal value from the given model, or null if no such value exists.

See Also:

Model.objectLiteral()

anyObjectResource

public static Resource anyObjectResource(Model m)

Retrieves any object Resource value from the given model. If more than one possible value exists, any one value is picked and returned.

Parameters:

m - the model from which to retrieve an object Resource value.

Returns:

an object Resource value from the given model, or null if no such value exists.

See Also:

Model.objectResource()

anyObjectURI

public static URI anyObjectURI(Model m)

Retrieves any object URI value from the given model. If more than one possible value exists, any one value is picked and returned.

Parameters:

m - the model from which to retrieve an object URI value.

Returns:

an object URI value from the given model, or null if no such value exists.

See Also:

Model.objectURI()

anySubject

public static Resource anySubject(Model m)

Retrieves any subject from the given model. If more than one possible value exists, any one value is picked and returned.

Parameters:

m - the model from which to retrieve a subject value.

Returns:

an subject value from the given model, or null if no such value exists.

See Also:

Model.subjectResource()

anySubjectURI

public static URI anySubjectURI(Model m)

Retrieves any subject URI from the given model. If more than one possible value exists, any one value is picked and returned.

Parameters:

m - the model from which to retrieve a subject URI value.

Returns:

an subject URI value from the given model, or null if no such value exists.

See Also:

Model.subjectURI()

anySubjectBNode

public static BNode anySubjectBNode(Model m)

Retrieves any subject BNode from the given model. If more than one possible value exists, any one value is picked and returned.

Parameters:

m - the model from which to retrieve a subject BNode value.

Returns:

a subject BNode value from the given model, or null if no such value exists.

See Also:

Model.subjectBNode()

anyPredicate

public static URI anyPredicate(Model m)

Retrieves any predicate from the given model. If more than one possible value exists, any one value is picked and returned.

Parameters:

m - the model from which to retrieve a predicate value.

Returns:

a predicate value from the given model, or null if no such value exists.

setProperty

public static Model setProperty(Model m,
                                Resource subject,
                                URI property,
                                Value value,
                                Resource... contexts)

Sets the property value for the given subject to the given object value, replacing any existing value(s) for the subject's property. This method updates the original input Model and then returns that same Model object.

Parameters:

m - the model in which to set the property value. May not be null.

subject - the subject for which to set/replace the property value. May not be null.

property - the property for which to set/replace the value. May not be null.

value - the value to set for the given subject and property. May not be null.

contexts - the context(s) in which to set/replace the property value. Optional vararg argument. If not specified the operations works on the entire Model.

Returns:

the Model object, containing the updated property value.

Since:

2.8.0

isomorphic

public static boolean isomorphic(Iterable<? extends Statement> model1,
                                 Iterable<? extends Statement> model2)

Compares two RDF models, and returns true if they contain isomorphic graphs. RDF models are isomorphic graphs if statements from one model can be mapped 1:1 on to statements in the other model. In this mapping, blank nodes are not considered mapped when having an identical internal id, but are mapped from one model to the other by looking at the statements in which the blank nodes occur.

Since:

2.8.0

See Also:

RDF Concepts & Abstract Syntax, section 3.6 (Graph Comparison)

equals

@Deprecated
public static boolean equals(Iterable<? extends Statement> model1,
                                         Iterable<? extends Statement> model2)

Deprecated. since 2.8.0. Use isomorphic(Iterable, Iterable) instead.

Compares two RDF models, defined by two statement collections, and returns true if they are equal. Models are equal if they contain the same set of statements. Blank node IDs are not relevant for model equality, they are mapped from one model to the other by using the attached properties.

isSubset

public static boolean isSubset(Iterable<? extends Statement> model1,
                               Iterable<? extends Statement> model2)

Compares two RDF models, and returns true if the first model is a subset of the second model, using graph isomorphism to map statements between models.

isSubset

public static boolean isSubset(Set<? extends Statement> model1,
                               Set<? extends Statement> model2)

Compares two RDF models, and returns true if the first model is a subset of the second model, using graph isomorphism to map statements between models.