org.eclipse.rdf4j.model.impl

Class AbstractModel

java.lang.Object

java.util.AbstractCollection<E>

java.util.AbstractSet<Statement>

org.eclipse.rdf4j.model.impl.AbstractModel

All Implemented Interfaces:

Serializable, Iterable<Statement>, Collection<Statement>, Set<Statement>, Graph, Model

Direct Known Subclasses:

EmptyModel, FilteredModel, LinkedHashModel, TreeModel

public abstract class AbstractModel
extends AbstractSet<Statement>
implements Model

Provides basic operations that are common to all Models.

See Also:

Serialized Form

Constructor Summary

Constructors

Constructor and Description
AbstractModel()

Method Summary

Modifier and Type	Method and Description
boolean	add(Resource subj, URI pred, Value obj, Resource... contexts) Deprecated.
boolean	add(Statement st)
boolean	addAll(Collection<? extends Statement> c)
void	clear()
boolean	clear(Resource... contexts) Removes statements with the specified context exist in this model.
protected void	closeIterator(Iterator<?> iter) Cleans up any resources used by this iterator.
boolean	contains(Object o)
boolean	contains(Resource subj, URI pred, Value obj, Resource... contexts) Deprecated.
boolean	containsAll(Collection<?> c)
Set<Resource>	contexts() Returns a Set view of the contexts contained in this model.
boolean	equals(Object o)
Model	filter(Resource subj, URI pred, Value obj, Resource... contexts) Deprecated.
Namespace	getNamespace(String prefix) Gets the namespace that is associated with the specified prefix, if any.
ValueFactory	getValueFactory() Deprecated.
int	hashCode()
boolean	isEmpty()
Iterator<Statement>	match(Resource subj, IRI pred, Value obj, Resource... contexts) Deprecated.
Literal	objectLiteral() Deprecated.
Resource	objectResource() Deprecated.
Set<Value>	objects() Returns a Set view of the objects contained in this model.
String	objectString() Deprecated.
URI	objectURI() Deprecated.
Value	objectValue() Deprecated.
Set<IRI>	predicates() Returns a Set view of the predicates contained in this model.
boolean	remove(Object o)
boolean	remove(Resource subj, URI pred, Value obj, Resource... contexts) Deprecated.
boolean	removeAll(Collection<?> c)
abstract void	removeTermIteration(Iterator<Statement> iter, Resource subj, IRI pred, Value obj, Resource... contexts) Called by aggregate sets when a term has been removed from a term iterator.
boolean	retainAll(Collection<?> c)
Namespace	setNamespace(String prefix, String name) Sets the prefix for a namespace.
BNode	subjectBNode() Utility method that casts the return value of Model.subjectResource() to a BNode, or throws a ModelException if that value is not a BNode.
Resource	subjectResource() Deprecated.
Set<Resource>	subjects() Returns a Set view of the subjects contained in this model.
URI	subjectURI() Provided for backward-compatibility purposes only, this method executes #subjectIRI instead.
Object[]	toArray()
<T> T[]	toArray(T[] a)
Model	unmodifiable() Returns an unmodifiable view of this model.

Methods inherited from class java.util.AbstractCollection

iterator, size, toString

Methods inherited from class java.lang.Object

clone, finalize, getClass, notify, notifyAll, wait, wait, wait

Methods inherited from interface org.eclipse.rdf4j.model.Model

add, contains, filter, getNamespaces, remove, removeNamespace, setNamespace

Methods inherited from interface java.util.Set

iterator, size, spliterator

Methods inherited from interface java.util.Collection

parallelStream, removeIf, stream

Methods inherited from interface java.lang.Iterable

forEach

Constructor Detail

AbstractModel

public AbstractModel()

Method Detail

unmodifiable

public Model unmodifiable()

Description copied from interface: Model

Returns an unmodifiable view of this model. This method provides "read-only" access to this model. Query operations on the returned model "read through" to this model, and attempts to modify the returned model, whether direct or via its iterator, result in an UnsupportedOperationException.

Specified by:

unmodifiable in interface Model

Returns:

an unmodifiable view of the specified set.

getNamespace

public Namespace getNamespace(String prefix)

Description copied from interface: Model

Gets the namespace that is associated with the specified prefix, if any.

Specified by:

getNamespace in interface Model

Parameters:

prefix - A namespace prefix.

Returns:

The namespace name that is associated with the specified prefix, or null if there is no such namespace.

setNamespace

public Namespace setNamespace(String prefix,
                              String name)

Description copied from interface: Model

Sets the prefix for a namespace. This will replace any existing namespace associated to the prefix.

Specified by:

setNamespace in interface Model

Parameters:

prefix - The new prefix.

name - The namespace name that the prefix maps to.

Returns:

The Namespace object for the given namespace.

add

@Deprecated
public boolean add(Resource subj,
                               URI pred,
                               Value obj,
                               Resource... contexts)

Deprecated.

Specified by:

add in interface Model

remove

@Deprecated
public boolean remove(Resource subj,
                                  URI pred,
                                  Value obj,
                                  Resource... contexts)

Deprecated.

Specified by:

remove in interface Model

filter

@Deprecated
public Model filter(Resource subj,
                                URI pred,
                                Value obj,
                                Resource... contexts)

Deprecated.

Specified by:

filter in interface Model

subjectResource

@Deprecated
public Resource subjectResource()
                                     throws ModelException

Deprecated.

Description copied from interface: Model

Gets the subject of the statement(s). If the model contains one or more statements, all these statements should have the same subject. A ModelException is thrown if this is not the case.

Specified by:

subjectResource in interface Model

Returns:

The subject of the matched statement(s), or Optional#empty() if no matching statements were found.

Throws:

ModelException - If the statements matched by the specified parameters have more than one unique subject.

subjectURI

public URI subjectURI()
               throws ModelException

Description copied from interface: Model

Provided for backward-compatibility purposes only, this method executes #subjectIRI instead.

Specified by:

subjectURI in interface Model

Throws:

ModelException

subjectBNode

public BNode subjectBNode()
                   throws ModelException

Description copied from interface: Model

Utility method that casts the return value of Model.subjectResource() to a BNode, or throws a ModelException if that value is not a BNode.

Specified by:

subjectBNode in interface Model

Returns:

The subject of the matched statement(s), or null if no matching statements were found.

Throws:

ModelException - If such an exception is thrown by Model.subjectResource() or if its return value is not a BNode.

add

public boolean add(Statement st)

Specified by:

add in interface Collection<Statement>

Specified by:

add in interface Set<Statement>

Overrides:

add in class AbstractCollection<Statement>

isEmpty

public boolean isEmpty()

Specified by:

isEmpty in interface Collection<Statement>

Specified by:

isEmpty in interface Set<Statement>

Overrides:

isEmpty in class AbstractCollection<Statement>

containsAll

public boolean containsAll(Collection<?> c)

Specified by:

containsAll in interface Collection<Statement>

Specified by:

containsAll in interface Set<Statement>

Overrides:

containsAll in class AbstractCollection<Statement>

removeAll

public boolean removeAll(Collection<?> c)

Specified by:

removeAll in interface Collection<Statement>

Specified by:

removeAll in interface Set<Statement>

Overrides:

removeAll in class AbstractSet<Statement>

toArray

public Object[] toArray()

Specified by:

toArray in interface Collection<Statement>

Specified by:

toArray in interface Set<Statement>

Overrides:

toArray in class AbstractCollection<Statement>

toArray

public <T> T[] toArray(T[] a)

Specified by:

toArray in interface Collection<Statement>

Specified by:

toArray in interface Set<Statement>

Overrides:

toArray in class AbstractCollection<Statement>

addAll

public boolean addAll(Collection<? extends Statement> c)

Specified by:

addAll in interface Collection<Statement>

Specified by:

addAll in interface Set<Statement>

Overrides:

addAll in class AbstractCollection<Statement>

retainAll

public boolean retainAll(Collection<?> c)

Specified by:

retainAll in interface Collection<Statement>

Specified by:

retainAll in interface Set<Statement>

Overrides:

retainAll in class AbstractCollection<Statement>

clear

public void clear()

Specified by:

clear in interface Collection<Statement>

Specified by:

clear in interface Set<Statement>

Overrides:

clear in class AbstractCollection<Statement>

clear

public boolean clear(Resource... contexts)

Description copied from interface: Model

Removes statements with the specified context exist in this model.

Specified by:

clear in interface Model

Parameters:

contexts - The context of the statements to remove.

Returns:

true if one or more statements have been removed.

remove

public boolean remove(Object o)

Specified by:

remove in interface Collection<Statement>

Specified by:

remove in interface Set<Statement>

Overrides:

remove in class AbstractCollection<Statement>

contains

@Deprecated
public boolean contains(Resource subj,
                                    URI pred,
                                    Value obj,
                                    Resource... contexts)

Deprecated.

Specified by:

contains in interface Model

contains

public boolean contains(Object o)

Specified by:

contains in interface Collection<Statement>

Specified by:

contains in interface Set<Statement>

Overrides:

contains in class AbstractCollection<Statement>

hashCode

public int hashCode()

Specified by:

hashCode in interface Collection<Statement>

Specified by:

hashCode in interface Set<Statement>

Overrides:

hashCode in class AbstractSet<Statement>

equals

public boolean equals(Object o)

Specified by:

equals in interface Collection<Statement>

Specified by:

equals in interface Set<Statement>

Overrides:

equals in class AbstractSet<Statement>

subjects

public Set<Resource> subjects()

Description copied from interface: Model

Returns a Set view of the subjects contained in this model. The set is backed by the model, so changes to the model are reflected in the set, and vice-versa. If the model is modified while an iteration over the set is in progress (except through the iterator's own remove operation), the results of the iteration are undefined. The set supports element removal, which removes all statements from the model for which that element is a subject value, via the Iterator.remove, Set.remove, removeAll, retainAll, and clear operations. It does not support the add or addAll operations if the parameters pred or obj are null.

Specified by:

subjects in interface Model

Returns:

a set view of the subjects contained in this model

predicates

public Set<IRI> predicates()

Description copied from interface: Model

Returns a Set view of the predicates contained in this model. The set is backed by the model, so changes to the model are reflected in the set, and vice-versa. If the model is modified while an iteration over the set is in progress (except through the iterator's own remove operation), the results of the iteration are undefined. The set supports element removal, which removes all statements from the model for which that element is a predicate value, via the Iterator.remove, Set.remove, removeAll, retainAll, and clear operations. It does not support the add or addAll operations if the parameters subj or obj are null.

Specified by:

predicates in interface Model

Returns:

a set view of the predicates contained in this model

objects

public Set<Value> objects()

Description copied from interface: Model

Returns a Set view of the objects contained in this model. The set is backed by the model, so changes to the model are reflected in the set, and vice-versa. If the model is modified while an iteration over the set is in progress (except through the iterator's own remove operation), the results of the iteration are undefined. The set supports element removal, which removes all statements from the model for which that element is an object value, via the Iterator.remove, Set.remove, removeAll, retainAll, and clear operations. It does not support the add or addAll operations if the parameters subj or pred are null.

Specified by:

objects in interface Model

Returns:

a set view of the objects contained in this model

contexts

public Set<Resource> contexts()

Description copied from interface: Model

Returns a Set view of the contexts contained in this model. The set is backed by the model, so changes to the model are reflected in the set, and vice-versa. If the model is modified while an iteration over the set is in progress (except through the iterator's own remove operation), the results of the iteration are undefined. The set supports element removal, which removes all statements from the model for which that element is a context value, via the Iterator.remove, Set.remove, removeAll, retainAll, and clear operations. It does not support the add or addAll operations if the parameters subj , pred or obj are null.

Specified by:

contexts in interface Model

Returns:

a set view of the contexts contained in this model

objectValue

@Deprecated
public Value objectValue()
                              throws ModelException

Deprecated.

Description copied from interface: Model

Gets the object of the statement(s). If the model contains one or more statements, all these statements should have the same object. A ModelException is thrown if this is not the case.

Specified by:

objectValue in interface Model

Returns:

The object of the matched statement(s), or Optional#empty() if no matching statements were found.

Throws:

ModelException - If the statements matched by the specified parameters have more than one unique object.

objectLiteral

@Deprecated
public Literal objectLiteral()
                                  throws ModelException

Deprecated.

Description copied from interface: Model

Utility method that casts the return value of Model.objectValue() to a Literal, or throws a ModelUtilException if that value is not a Literal.

Specified by:

objectLiteral in interface Model

Returns:

The object of the matched statement(s), or Optional#empty() if no matching statements were found.

Throws:

ModelException - If such an exception is thrown by Model.objectValue() or if its return value is not a Literal.

objectResource

@Deprecated
public Resource objectResource()
                                    throws ModelException

Deprecated.

Description copied from interface: Model

Utility method that casts the return value of Model.objectValue() to a Resource, or throws a ModelUtilException if that value is not a Resource.

Specified by:

objectResource in interface Model

Returns:

The object of the matched statement(s), or Optional#empty() if no matching statements were found.

Throws:

ModelException - If such an exception is thrown by Model.objectValue() or if its return value is not a Resource.

objectURI

@Deprecated
public URI objectURI()
                          throws ModelException

Deprecated.

Description copied from interface: Model

Utility method that casts the return value of Model.objectValue() to an IRI, or throws a ModelUtilException if that value is not an IRI.

Specified by:

objectURI in interface Model

Returns:

The object of the matched statement(s), or Optional#empty() if no matching statements were found.

Throws:

ModelException - If such an exception is thrown by Model.objectValue() or if its return value is not an IRI.

objectString

@Deprecated
public String objectString()
                                throws ModelException

Deprecated.

Description copied from interface: Model

Utility method that returns the string value of Model.objectValue().

Specified by:

objectString in interface Model

Returns:

The object string value of the matched statement(s), or Optional#empty() if no matching statements were found.

Throws:

ModelException - If the statements matched by the specified parameters have more than one unique object.

removeTermIteration

public abstract void removeTermIteration(Iterator<Statement> iter,
                                         Resource subj,
                                         IRI pred,
                                         Value obj,
                                         Resource... contexts)

Called by aggregate sets when a term has been removed from a term iterator. Exactly one of the last four terms will be non-empty.

Parameters:

iter - The iterator used to navigate the live set (never null)

subj - the subject term to be removed or null

pred - the predicate term to be removed or null

obj - the object term to be removed or null

contexts - an array of one context term to be removed or an empty array

closeIterator

protected void closeIterator(Iterator<?> iter)

Cleans up any resources used by this iterator. After this call the given iterator should not be used.

Parameters:

iter - Iterator to clean up

match

@Deprecated
public Iterator<Statement> match(Resource subj,
                                             IRI pred,
                                             Value obj,
                                             Resource... contexts)

Deprecated.

Description copied from interface: Graph

Gets the statements with the specified subject, predicate, object and (optionally) context. The subject, predicate and object parameters can be null to indicate wildcards. The contexts parameter is a wildcard and accepts zero or more values. If no contexts are specified, statements will match disregarding their context. If one or more contexts are specified, statements with a context matching one of these will match. Note: to match statements without an associated context, specify the value null and explicitly cast it to type Resource.

Examples: graph.match(s1, null, null) matches all statements that have subject s1,
graph.match(null, null, null, c1) matches all statements that have context c1,
graph.match(null, null, null, (Resource)null) matches all statements that have no associated context,
graph.match(null, null, null, c1, c2, c3) matches all statements that have context c1 , c2 or c3.

Specified by:

match in interface Graph

Parameters:

subj - The subject of the statements to match, null to match statements with any subject.

pred - The predicate of the statements to match, null to match statements with any predicate.

obj - The object of the statements to match, null to match statements with any object.

contexts - The contexts of the statements to match. If no contexts are specified, statements will match disregarding their context. If one or more contexts are specified, statements with a context matching one of these will match.

Returns:

The statements that match the specified pattern.

getValueFactory

@Deprecated
public ValueFactory getValueFactory()

Deprecated.

Description copied from interface: Graph

Gets the value factory for this graph.

Specified by:

getValueFactory in interface Graph