public interface WatchableGraph extends Graph
Modifier and Type | Method and Description |
---|---|
void |
addGraphListener(GraphListener listener,
FilterTriple filter)
Adds the specified
GraphListener to the graph. |
void |
addGraphListener(GraphListener listener,
FilterTriple filter,
long delay)
Adds the specified
GraphListener to the graph. |
void |
removeGraphListener(GraphListener listener)
Removes the specified
GraphListener from the graph. |
equals, filter, getImmutableGraph, getLock
add, addAll, clear, contains, containsAll, hashCode, isEmpty, iterator, parallelStream, remove, removeAll, removeIf, retainAll, size, spliterator, stream, toArray, toArray
void addGraphListener(GraphListener listener, FilterTriple filter, long delay)
GraphListener
to the graph. This listener
will be notified, when the graph is modified and the Triple
that was part of the modifiaction matched the specified
FilterTriple
. The notification will be passed to the
listener after the specified delay time (in milli-seconds) has passed.
If more matching events occur during the delay period, then they are
passed all together at the end of the delay period. If the the listener
unregisters or the platform is stopped within the period then the already
occurred events may not be delivered.
All implementations support this method, immutable implementations will typically provide an empty implementation, they shall not throw an exception.
Implementation of which the triples change over time without add- and remove-methods being called (e.g. implementation dynamically generating their triples on invocation of the filer-method) may choose not to, or only partially propagate their changes to the listener. They should describe the behavior in the documentation of the class.
Implementations should keep weak references the listeners, so that the listener can be garbage collected if its no longer referenced by another object.
If delay is 0 notification will happen synchroneously.
listener
- The listener that will be notifiedfilter
- The triple filter with which triples are tested,
that were part of the modification.delay
- The time period afer which the listener will be notified in milliseconds.void addGraphListener(GraphListener listener, FilterTriple filter)
GraphListener
to the graph. This listener
will be notified, when the graph is modified and the Triple
that was part of the modifiaction matched the specified
FilterTriple
. The notification will be passed without delay.
Same as addGraphListener(listener, filter, 0).
listener
- The listener that will be notifiedfilter
- The triple filter with which triples are tested,
that were part of the modification.void removeGraphListener(GraphListener listener)
GraphListener
from the graph. This
listener will no longer be notified, when the graph is modified.listener
- The listener to be removed.Copyright © 2015–2022 The Apache Software Foundation. All rights reserved.