org.graphstream.stream

Class SourceBase

java.lang.Object

org.graphstream.stream.SourceBase

All Implemented Interfaces:

Source

Direct Known Subclasses:

BarnesHutLayout, ByteProxy, FileSourceBase, FileSourceParser, FileSourceXML, GraphListeners, GraphReplay, NetStreamDecoder, PipeBase, ThreadProxyPipe, ViewerPipe

public abstract class SourceBase
extends java.lang.Object
implements Source

Base implementation of an input that provide basic sink handling.

This implementation can register a set of graph sinks (or separate sets of attributes or elements sinks) and provides protected methods to easily broadcast events to all the sinks (beginning with "send").

Each time you want to produce an event toward all registered sinks, you call one of the "send*" methods with correct parameters. The parameters of the "send*" methods maps to the usual GraphStream events.

This class is "reentrant". This means that if a send*() method is called during the execution of another or the same send*() method, the event is deferred until the first send*() method is finished. This avoid recursive loops if a sink modifies the input during event handling.

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static class	SourceBase.ElementType

Method Summary

Modifier and Type	Method and Description
void	addAttributeSink(AttributeSink sink) Add a sink for attribute events only.
void	addElementSink(ElementSink sink) Add a sink for elements events only.
void	addSink(Sink sink) Add a sink for all graph events (attributes and graph elements) coming from this source.
java.lang.Iterable<AttributeSink>	attributeSinks()
void	clearAttributeSinks() Remove all listener attribute sinks.
void	clearElementSinks() Remove all listener element sinks.
void	clearSinks() Remove all listener sinks.
java.lang.Iterable<ElementSink>	elementSinks()
void	removeAttributeSink(AttributeSink sink) Remove an attribute sink.
void	removeElementSink(ElementSink sink) Remove an element sink.
void	removeSink(Sink sink) Remove a sink.
void	sendAttributeChangedEvent(java.lang.String sourceId, long timeId, java.lang.String eltId, SourceBase.ElementType eltType, java.lang.String attribute, AbstractElement.AttributeChangeEvent event, java.lang.Object oldValue, java.lang.Object newValue)
void	sendAttributeChangedEvent(java.lang.String sourceId, java.lang.String eltId, SourceBase.ElementType eltType, java.lang.String attribute, AbstractElement.AttributeChangeEvent event, java.lang.Object oldValue, java.lang.Object newValue) Send a add/change/remove attribute event on an element.
void	sendEdgeAdded(java.lang.String sourceId, long timeId, java.lang.String edgeId, java.lang.String fromNodeId, java.lang.String toNodeId, boolean directed) Send an "edge added" event to all element sinks.
void	sendEdgeAdded(java.lang.String sourceId, java.lang.String edgeId, java.lang.String fromNodeId, java.lang.String toNodeId, boolean directed) Send an "edge added" event to all element sinks.
void	sendEdgeAttributeAdded(java.lang.String sourceId, long timeId, java.lang.String edgeId, java.lang.String attribute, java.lang.Object value) Send a "edge attribute added" event to all attribute sinks.
void	sendEdgeAttributeAdded(java.lang.String sourceId, java.lang.String edgeId, java.lang.String attribute, java.lang.Object value) Send a "edge attribute added" event to all attribute sinks.
void	sendEdgeAttributeChanged(java.lang.String sourceId, long timeId, java.lang.String edgeId, java.lang.String attribute, java.lang.Object oldValue, java.lang.Object newValue) Send a "edge attribute changed" event to all attribute sinks.
void	sendEdgeAttributeChanged(java.lang.String sourceId, java.lang.String edgeId, java.lang.String attribute, java.lang.Object oldValue, java.lang.Object newValue) Send a "edge attribute changed" event to all attribute sinks.
void	sendEdgeAttributeRemoved(java.lang.String sourceId, long timeId, java.lang.String edgeId, java.lang.String attribute) Send a "edge attribute removed" event to all attribute sinks.
void	sendEdgeAttributeRemoved(java.lang.String sourceId, java.lang.String edgeId, java.lang.String attribute) Send a "edge attribute removed" event to all attribute sinks.
void	sendEdgeRemoved(java.lang.String sourceId, long timeId, java.lang.String edgeId) Send a "edge removed" event to all element sinks.
void	sendEdgeRemoved(java.lang.String sourceId, java.lang.String edgeId) Send a "edge removed" event to all element sinks.
void	sendGraphAttributeAdded(java.lang.String sourceId, long timeId, java.lang.String attribute, java.lang.Object value) Send a "graph attribute added" event to all attribute sinks.
void	sendGraphAttributeAdded(java.lang.String sourceId, java.lang.String attribute, java.lang.Object value) Send a "graph attribute added" event to all attribute sinks.
void	sendGraphAttributeChanged(java.lang.String sourceId, long timeId, java.lang.String attribute, java.lang.Object oldValue, java.lang.Object newValue) Send a "graph attribute changed" event to all attribute sinks.
void	sendGraphAttributeChanged(java.lang.String sourceId, java.lang.String attribute, java.lang.Object oldValue, java.lang.Object newValue) Send a "graph attribute changed" event to all attribute sinks.
void	sendGraphAttributeRemoved(java.lang.String sourceId, long timeId, java.lang.String attribute) Send a "graph attribute removed" event to all attribute sinks.
void	sendGraphAttributeRemoved(java.lang.String sourceId, java.lang.String attribute) Send a "graph attribute removed" event to all attribute sinks.
void	sendGraphCleared(java.lang.String sourceId) Send a "graph cleared" event to all element sinks.
void	sendGraphCleared(java.lang.String sourceId, long timeId) Send a "graph cleared" event to all element sinks.
void	sendNodeAdded(java.lang.String sourceId, long timeId, java.lang.String nodeId) Send a "node added" event to all element sinks.
void	sendNodeAdded(java.lang.String sourceId, java.lang.String nodeId) Send a "node added" event to all element sinks.
void	sendNodeAttributeAdded(java.lang.String sourceId, long timeId, java.lang.String nodeId, java.lang.String attribute, java.lang.Object value) Send a "node attribute added" event to all attribute sinks.
void	sendNodeAttributeAdded(java.lang.String sourceId, java.lang.String nodeId, java.lang.String attribute, java.lang.Object value) Send a "node attribute added" event to all attribute sinks.
void	sendNodeAttributeChanged(java.lang.String sourceId, long timeId, java.lang.String nodeId, java.lang.String attribute, java.lang.Object oldValue, java.lang.Object newValue) Send a "node attribute changed" event to all attribute sinks.
void	sendNodeAttributeChanged(java.lang.String sourceId, java.lang.String nodeId, java.lang.String attribute, java.lang.Object oldValue, java.lang.Object newValue) Send a "node attribute changed" event to all attribute sinks.
void	sendNodeAttributeRemoved(java.lang.String sourceId, long timeId, java.lang.String nodeId, java.lang.String attribute) Send a "node attribute removed" event to all attribute sinks.
void	sendNodeAttributeRemoved(java.lang.String sourceId, java.lang.String nodeId, java.lang.String attribute) Send a "node attribute removed" event to all attribute sinks.
void	sendNodeRemoved(java.lang.String sourceId, long timeId, java.lang.String nodeId) Send a "node removed" event to all element sinks.
void	sendNodeRemoved(java.lang.String sourceId, java.lang.String nodeId) Send a "node removed" event to all element sinks.
void	sendStepBegins(java.lang.String sourceId, double step) Send a "step begins" event to all element sinks.
void	sendStepBegins(java.lang.String sourceId, long timeId, double step) Send a "step begins" event to all element sinks.

Methods inherited from class java.lang.Object

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

Method Detail

attributeSinks

public java.lang.Iterable<AttributeSink> attributeSinks()

elementSinks

public java.lang.Iterable<ElementSink> elementSinks()

addSink

public void addSink(Sink sink)

Description copied from interface: Source

Add a sink for all graph events (attributes and graph elements) coming from this source. This is similar to registering a sink for attributes an another for elements.

Specified by:

addSink in interface Source

Parameters:

sink - The sink to register.

addAttributeSink

public void addAttributeSink(AttributeSink sink)

Description copied from interface: Source

Add a sink for attribute events only. Attribute events include attribute addition change and removal.

Specified by:

addAttributeSink in interface Source

Parameters:

sink - The sink to register.

addElementSink

public void addElementSink(ElementSink sink)

Description copied from interface: Source

Add a sink for elements events only. Elements events include, addition and removal of nodes and edges, as well as step events.

Specified by:

addElementSink in interface Source

Parameters:

sink - The sink to register.

clearSinks

public void clearSinks()

Description copied from interface: Source

Remove all listener sinks.

Specified by:

clearSinks in interface Source

clearElementSinks

public void clearElementSinks()

Description copied from interface: Source

Remove all listener element sinks.

Specified by:

clearElementSinks in interface Source

clearAttributeSinks

public void clearAttributeSinks()

Description copied from interface: Source

Remove all listener attribute sinks.

Specified by:

clearAttributeSinks in interface Source

removeSink

public void removeSink(Sink sink)

Description copied from interface: Source

Remove a sink.

Specified by:

removeSink in interface Source

Parameters:

sink - The sink to remove, if it does not exist, this is ignored silently.

removeAttributeSink

public void removeAttributeSink(AttributeSink sink)

Description copied from interface: Source

Remove an attribute sink.

Specified by:

removeAttributeSink in interface Source

Parameters:

sink - The sink to remove, if it does not exist, this is ignored silently.

removeElementSink

public void removeElementSink(ElementSink sink)

Description copied from interface: Source

Remove an element sink.

Specified by:

removeElementSink in interface Source

Parameters:

sink - The sink to remove, if it does not exist, this is ignored silently.

sendGraphCleared

public void sendGraphCleared(java.lang.String sourceId)

Send a "graph cleared" event to all element sinks.

Parameters:

sourceId - The source identifier.

sendGraphCleared

public void sendGraphCleared(java.lang.String sourceId,
                             long timeId)

Send a "graph cleared" event to all element sinks.

Parameters:

sourceId - The source identifier.

timeId -

sendStepBegins

public void sendStepBegins(java.lang.String sourceId,
                           double step)

Send a "step begins" event to all element sinks.

Parameters:

sourceId - The graph identifier.

step - The step time stamp.

sendStepBegins

public void sendStepBegins(java.lang.String sourceId,
                           long timeId,
                           double step)

Send a "step begins" event to all element sinks.

Parameters:

sourceId - The graph identifier.

timeId -

step - The step time stamp.

sendNodeAdded

public void sendNodeAdded(java.lang.String sourceId,
                          java.lang.String nodeId)

Send a "node added" event to all element sinks.

Parameters:

sourceId - The source identifier.

nodeId - The node identifier.

sendNodeAdded

public void sendNodeAdded(java.lang.String sourceId,
                          long timeId,
                          java.lang.String nodeId)

Send a "node added" event to all element sinks.

Parameters:

sourceId - The source identifier.

timeId -

nodeId - The node identifier.

sendNodeRemoved

public void sendNodeRemoved(java.lang.String sourceId,
                            java.lang.String nodeId)

Send a "node removed" event to all element sinks.

Parameters:

sourceId - The graph identifier.

nodeId - The node identifier.

sendNodeRemoved

public void sendNodeRemoved(java.lang.String sourceId,
                            long timeId,
                            java.lang.String nodeId)

Send a "node removed" event to all element sinks.

Parameters:

sourceId - The graph identifier.

timeId -

nodeId - The node identifier.

sendEdgeAdded

public void sendEdgeAdded(java.lang.String sourceId,
                          java.lang.String edgeId,
                          java.lang.String fromNodeId,
                          java.lang.String toNodeId,
                          boolean directed)

Send an "edge added" event to all element sinks.

Parameters:

sourceId - The source identifier.

edgeId - The edge identifier.

fromNodeId - The edge start node.

toNodeId - The edge end node.

directed - Is the edge directed?.

sendEdgeAdded

public void sendEdgeAdded(java.lang.String sourceId,
                          long timeId,
                          java.lang.String edgeId,
                          java.lang.String fromNodeId,
                          java.lang.String toNodeId,
                          boolean directed)

Send an "edge added" event to all element sinks.

Parameters:

sourceId - The source identifier.

timeId -

edgeId - The edge identifier.

fromNodeId - The edge start node.

toNodeId - The edge end node.

directed - Is the edge directed?.

sendEdgeRemoved

public void sendEdgeRemoved(java.lang.String sourceId,
                            java.lang.String edgeId)

Send a "edge removed" event to all element sinks.

Parameters:

sourceId - The source identifier.

edgeId - The edge identifier.

sendEdgeRemoved

public void sendEdgeRemoved(java.lang.String sourceId,
                            long timeId,
                            java.lang.String edgeId)

Send a "edge removed" event to all element sinks.

Parameters:

sourceId - The source identifier.

timeId -

edgeId - The edge identifier.

sendEdgeAttributeAdded

public void sendEdgeAttributeAdded(java.lang.String sourceId,
                                   java.lang.String edgeId,
                                   java.lang.String attribute,
                                   java.lang.Object value)

Send a "edge attribute added" event to all attribute sinks.

Parameters:

sourceId - The source identifier.

edgeId - The edge identifier.

attribute - The attribute name.

value - The attribute value.

sendEdgeAttributeAdded

public void sendEdgeAttributeAdded(java.lang.String sourceId,
                                   long timeId,
                                   java.lang.String edgeId,
                                   java.lang.String attribute,
                                   java.lang.Object value)

Send a "edge attribute added" event to all attribute sinks.

Parameters:

sourceId - The source identifier.

timeId -

edgeId - The edge identifier.

attribute - The attribute name.

value - The attribute value.

sendEdgeAttributeChanged

public void sendEdgeAttributeChanged(java.lang.String sourceId,
                                     java.lang.String edgeId,
                                     java.lang.String attribute,
                                     java.lang.Object oldValue,
                                     java.lang.Object newValue)

Send a "edge attribute changed" event to all attribute sinks.

Parameters:

sourceId - The source identifier.

edgeId - The edge identifier.

attribute - The attribute name.

oldValue - The old attribute value.

newValue - The new attribute value.

sendEdgeAttributeChanged

public void sendEdgeAttributeChanged(java.lang.String sourceId,
                                     long timeId,
                                     java.lang.String edgeId,
                                     java.lang.String attribute,
                                     java.lang.Object oldValue,
                                     java.lang.Object newValue)

Send a "edge attribute changed" event to all attribute sinks.

Parameters:

sourceId - The source identifier.

timeId -

edgeId - The edge identifier.

attribute - The attribute name.

oldValue - The old attribute value.

newValue - The new attribute value.

sendEdgeAttributeRemoved

public void sendEdgeAttributeRemoved(java.lang.String sourceId,
                                     java.lang.String edgeId,
                                     java.lang.String attribute)

Send a "edge attribute removed" event to all attribute sinks.

Parameters:

sourceId - The source identifier.

edgeId - The edge identifier.

attribute - The attribute name.

sendEdgeAttributeRemoved

public void sendEdgeAttributeRemoved(java.lang.String sourceId,
                                     long timeId,
                                     java.lang.String edgeId,
                                     java.lang.String attribute)

Send a "edge attribute removed" event to all attribute sinks.

Parameters:

sourceId - The source identifier.

timeId -

edgeId - The edge identifier.

attribute - The attribute name.

sendGraphAttributeAdded

public void sendGraphAttributeAdded(java.lang.String sourceId,
                                    java.lang.String attribute,
                                    java.lang.Object value)

Send a "graph attribute added" event to all attribute sinks.

Parameters:

sourceId - The source identifier.

attribute - The attribute name.

value - The attribute value.

sendGraphAttributeAdded

public void sendGraphAttributeAdded(java.lang.String sourceId,
                                    long timeId,
                                    java.lang.String attribute,
                                    java.lang.Object value)

Send a "graph attribute added" event to all attribute sinks.

Parameters:

sourceId - The source identifier.

timeId -

attribute - The attribute name.

value - The attribute value.

sendGraphAttributeChanged

public void sendGraphAttributeChanged(java.lang.String sourceId,
                                      java.lang.String attribute,
                                      java.lang.Object oldValue,
                                      java.lang.Object newValue)

Send a "graph attribute changed" event to all attribute sinks.

Parameters:

sourceId - The source identifier.

attribute - The attribute name.

oldValue - The attribute old value.

newValue - The attribute new value.

sendGraphAttributeChanged

public void sendGraphAttributeChanged(java.lang.String sourceId,
                                      long timeId,
                                      java.lang.String attribute,
                                      java.lang.Object oldValue,
                                      java.lang.Object newValue)

Send a "graph attribute changed" event to all attribute sinks.

Parameters:

sourceId - The source identifier.

timeId -

attribute - The attribute name.

oldValue - The attribute old value.

newValue - The attribute new value.

sendGraphAttributeRemoved

public void sendGraphAttributeRemoved(java.lang.String sourceId,
                                      java.lang.String attribute)

Send a "graph attribute removed" event to all attribute sinks.

Parameters:

sourceId - The source identifier.

attribute - The attribute name.

sendGraphAttributeRemoved

public void sendGraphAttributeRemoved(java.lang.String sourceId,
                                      long timeId,
                                      java.lang.String attribute)

Send a "graph attribute removed" event to all attribute sinks.

Parameters:

sourceId - The source identifier.

timeId -

attribute - The attribute name.

sendNodeAttributeAdded

public void sendNodeAttributeAdded(java.lang.String sourceId,
                                   java.lang.String nodeId,
                                   java.lang.String attribute,
                                   java.lang.Object value)

Send a "node attribute added" event to all attribute sinks.

Parameters:

sourceId - The source identifier.

nodeId - The node identifier.

attribute - The attribute name.

value - The attribute value.

sendNodeAttributeAdded

public void sendNodeAttributeAdded(java.lang.String sourceId,
                                   long timeId,
                                   java.lang.String nodeId,
                                   java.lang.String attribute,
                                   java.lang.Object value)

Send a "node attribute added" event to all attribute sinks.

Parameters:

sourceId - The source identifier.

timeId -

nodeId - The node identifier.

attribute - The attribute name.

value - The attribute value.

sendNodeAttributeChanged

public void sendNodeAttributeChanged(java.lang.String sourceId,
                                     java.lang.String nodeId,
                                     java.lang.String attribute,
                                     java.lang.Object oldValue,
                                     java.lang.Object newValue)

Send a "node attribute changed" event to all attribute sinks.

Parameters:

sourceId - The source identifier.

nodeId - The node identifier.

attribute - The attribute name.

oldValue - The attribute old value.

newValue - The attribute new value.

sendNodeAttributeChanged

public void sendNodeAttributeChanged(java.lang.String sourceId,
                                     long timeId,
                                     java.lang.String nodeId,
                                     java.lang.String attribute,
                                     java.lang.Object oldValue,
                                     java.lang.Object newValue)

Send a "node attribute changed" event to all attribute sinks.

Parameters:

sourceId - The source identifier.

timeId -

nodeId - The node identifier.

attribute - The attribute name.

oldValue - The attribute old value.

newValue - The attribute new value.

sendNodeAttributeRemoved

public void sendNodeAttributeRemoved(java.lang.String sourceId,
                                     java.lang.String nodeId,
                                     java.lang.String attribute)

Send a "node attribute removed" event to all attribute sinks.

Parameters:

sourceId - The source identifier.

nodeId - The node identifier.

attribute - The attribute name.

sendNodeAttributeRemoved

public void sendNodeAttributeRemoved(java.lang.String sourceId,
                                     long timeId,
                                     java.lang.String nodeId,
                                     java.lang.String attribute)

Send a "node attribute removed" event to all attribute sinks.

Parameters:

sourceId - The source identifier.

timeId -

nodeId - The node identifier.

attribute - The attribute name.

sendAttributeChangedEvent

public void sendAttributeChangedEvent(java.lang.String sourceId,
                                      java.lang.String eltId,
                                      SourceBase.ElementType eltType,
                                      java.lang.String attribute,
                                      AbstractElement.AttributeChangeEvent event,
                                      java.lang.Object oldValue,
                                      java.lang.Object newValue)

Send a add/change/remove attribute event on an element. This method is a generic way of notifying of an attribute change and is equivalent to individual send*Attribute*() methods.

Parameters:

sourceId - The source identifier.

eltId - The changed element identifier.

eltType - The changed element type.

attribute - The changed attribute.

event - The add/change/remove action.

oldValue - The old attribute value (null if the attribute is removed or added).

newValue - The new attribute value (null if removed).

sendAttributeChangedEvent

public void sendAttributeChangedEvent(java.lang.String sourceId,
                                      long timeId,
                                      java.lang.String eltId,
                                      SourceBase.ElementType eltType,
                                      java.lang.String attribute,
                                      AbstractElement.AttributeChangeEvent event,
                                      java.lang.Object oldValue,
                                      java.lang.Object newValue)