org.apache.clerezza

Interface Graph

All Superinterfaces:

Collection<Triple>, Iterable<Triple>

All Known Subinterfaces:

ImmutableGraph, WatchableGraph

All Known Implementing Classes:

AbstractGraph, AbstractImmutableGraph, LockableMGraphWrapperForTesting, PrivilegedGraphWrapper, PrivilegedImmuatbleGraphWrapper, RandomGraph, SecuredGraph, SimpleGraph, SimpleImmutableGraph, UnionGraph, UnionWatchableGraph, UriMutatingGraph, WatchableGraphWrapper, WriteBlockedGraph

public interface Graph
extends Collection<Triple>

A set of triples (as it doesn't allow duplicates), it does however not extend Set as it doesn't inherit its specification for hashCode() and equals. It is possible to add GraphListener to listen for modifications in the triples.

Author:

reto

Method Summary

Modifier and Type	Method and Description
boolean	equals(Object other) Returns true if other describes the same graph and will always describe the same graph as this instance, false otherwise.
Iterator<Triple>	filter(BlankNodeOrIRI subject, IRI predicate, RDFTerm object) Filters triples given a pattern.
ImmutableGraph	getImmutableGraph() Returns an ImutableGraph describing the graph at the current point in time.
ReadWriteLock	getLock() The lock provided by this methods allows to create read- and write-locks that span multiple method calls.

Methods inherited from interface java.util.Collection

add, addAll, clear, contains, containsAll, hashCode, isEmpty, iterator, parallelStream, remove, removeAll, removeIf, retainAll, size, spliterator, stream, toArray, toArray

Methods inherited from interface java.lang.Iterable

forEach

Method Detail

filter

Iterator<Triple> filter(BlankNodeOrIRI subject,
                        IRI predicate,
                        RDFTerm object)

Filters triples given a pattern. filter(null, null, null) returns the same as iterator()

Parameters:

subject -

predicate -

object -

Returns:

Iterator

equals

boolean equals(Object other)

Returns true if other describes the same graph and will always describe the same graph as this instance, false otherwise. It returns true if this == other or if it is otherwise guaranteed that changes to one of the instances are immediately reflected in the other or if both graphs are immutable.

Specified by:

equals in interface Collection<Triple>

Overrides:

equals in class Object

Parameters:

other -

Returns:

true if other == this

getImmutableGraph

ImmutableGraph getImmutableGraph()

Returns an ImutableGraph describing the graph at the current point in time. if this is an instance of ImmutableGraph this can safely return this.

Returns:

the current time slice of the possibly mutable graph represented by the instance.

getLock

ReadWriteLock getLock()

The lock provided by this methods allows to create read- and write-locks that span multiple method calls. Having a read locks prevents other threads from writing to this Graph, having a write-lock prevents other threads from reading and writing. Implementations would typically return a java.util.concurrent.locks.ReentrantReadWriteLock. Immutable instances (such as instances of ImmutableGraph) or instances used in transaction where concurrent acces of the same instance is not an issue may return a no-op ReadWriteLock (i.e. one which returned ReadLock and WriteLock instances of which the methods do not do anything)

Returns:

the lock of this Graph