org.graphstream.stream.thread

Class ThreadProxyPipeOld

java.lang.Object

org.graphstream.stream.SourceBase

org.graphstream.stream.thread.ThreadProxyPipeOld

All Implemented Interfaces:

AttributeSink, ElementSink, Pipe, ProxyPipe, Sink, Source, org.miv.mbox.MBoxListener

Deprecated.

This is the old version of ThreadProxyPipe.

@Deprecated
public class ThreadProxyPipeOld
extends SourceBase
implements ProxyPipe, org.miv.mbox.MBoxListener

Filter that allows to pass graph events between two threads without explicit synchronization.

This filter allows to register it as an output for some source of events in a source thread (hereafter called the input thread) and to register listening outputs in a destination thread (hereafter called the sink thread).

                       |
   Source ---> ThreadProxyFilter ----> Sink
  Thread 1             |              Thread 2
                       |
 

In other words, this class allows to listen in a sink thread graph events that are produced in another source thread without any explicit synchronization on the source of events.

The only restriction is that the sink thread must regularly call the pump() method to dispatch events coming from the source to all sinks registered (see the explanation in ProxyPipe).

You can register any kind of input as source of event, but if the input is a graph, then you can choose to "replay" all the content of the graph so that at the other end of the filter, all outputs receive the complete content of the graph. This is the default behavior if this filter is constructed with a graph as input.

Nested Class Summary

Nested classes/interfaces inherited from class org.graphstream.stream.SourceBase

SourceBase.ElementType

Constructor Summary

Constructors

Constructor and Description
ThreadProxyPipeOld() Deprecated. New thread proxy pipe with no input.
ThreadProxyPipeOld(Graph inputGraph) Deprecated. Listen at an input graph in a given thread and redirect all events to GraphListeners that may be in another thread.
ThreadProxyPipeOld(Graph inputGraph, boolean replayGraph) Deprecated. Like #ThreadProxyPipe(Graph) but allow to avoid replaying the graph.
ThreadProxyPipeOld(Graph inputGraph, Sink firstListener, boolean replayGraph) Deprecated. Like #ThreadProxyPipe(Graph,boolean) but allows to pass an initial listener, therefore specifying the input and output at once.
ThreadProxyPipeOld(Graph inputGraph, Sink firstListener, boolean replayGraph, org.miv.mbox.MBox sharedMBox) Deprecated. Like #ThreadProxyPipe(Graph,Sink,boolean), but allows to share the message box with another message processor.
ThreadProxyPipeOld(Source input) Deprecated. Listen at an input in a given thread and redirect all events to GraphListeners that may be in another thread.
ThreadProxyPipeOld(Source input, org.miv.mbox.MBox sharedMBox) Deprecated. Like #ThreadProxyPipe(Source), but allow to share the message box with another message processor.

Method Summary

Methods

Modifier and Type	Method and Description
void	blockingPump() Deprecated. Same as ProxyPipe.pump() but try to block until new events were available.
void	blockingPump(long timeout) Deprecated. Same as ProxyPipe.blockingPump() but including a timeout delay.
void	edgeAdded(String graphId, long timeId, String edgeId, String fromNodeId, String toNodeId, boolean directed) Deprecated. An edge was inserted in graph.
void	edgeAttributeAdded(String graphId, long timeId, String edgeId, String attribute, Object value) Deprecated. A edge attribute was added.
void	edgeAttributeChanged(String graphId, long timeId, String edgeId, String attribute, Object oldValue, Object newValue) Deprecated. A edge attribute was changed.
void	edgeAttributeRemoved(String graphId, long timeId, String edgeId, String attribute) Deprecated. A edge attribute was removed.
void	edgeRemoved(String graphId, long timeId, String edgeId) Deprecated. An edge of graph was removed.The nodes the edge connects may already have been removed from the graph.
void	graphAttributeAdded(String graphId, long timeId, String attribute, Object value) Deprecated. A graph attribute was added.
void	graphAttributeChanged(String graphId, long timeId, String attribute, Object oldValue, Object newValue) Deprecated. A graph attribute was changed.
void	graphAttributeRemoved(String graphId, long timeId, String attribute) Deprecated. A graph attribute was removed.
void	graphCleared(String graphId, long timeId) Deprecated. The whole graph was cleared.
void	nodeAdded(String graphId, long timeId, String nodeId) Deprecated. A node was inserted in the given graph.
void	nodeAttributeAdded(String graphId, long timeId, String nodeId, String attribute, Object value) Deprecated. A node attribute was added.
void	nodeAttributeChanged(String graphId, long timeId, String nodeId, String attribute, Object oldValue, Object newValue) Deprecated. A node attribute was changed.
void	nodeAttributeRemoved(String graphId, long timeId, String nodeId, String attribute) Deprecated. A node attribute was removed.
void	nodeRemoved(String graphId, long timeId, String nodeId) Deprecated. A node was removed from the graph.
void	processMessage(String from, Object[] data) Deprecated.
void	pump() Deprecated. This method must be called regularly in the output thread to check if the input source sent events.
void	stepBegins(String graphId, long timeId, double step) Deprecated. Since dynamic graphs are based on discrete event modifications, the notion of step is defined to simulate elapsed time between events.
String	toString() Deprecated.
void	unregisterFromSource() Deprecated. Ask the proxy to unregister from the event input source (stop receive events) as soon as possible (when the next event will occur in the graph).

Methods inherited from class org.graphstream.stream.SourceBase

addAttributeSink, addElementSink, addSink, attributeSinks, clearAttributeSinks, clearElementSinks, clearSinks, elementSinks, removeAttributeSink, removeElementSink, removeSink, sendAttributeChangedEvent, sendAttributeChangedEvent, sendEdgeAdded, sendEdgeAdded, sendEdgeAttributeAdded, sendEdgeAttributeAdded, sendEdgeAttributeChanged, sendEdgeAttributeChanged, sendEdgeAttributeRemoved, sendEdgeAttributeRemoved, sendEdgeRemoved, sendEdgeRemoved, sendGraphAttributeAdded, sendGraphAttributeAdded, sendGraphAttributeChanged, sendGraphAttributeChanged, sendGraphAttributeRemoved, sendGraphAttributeRemoved, sendGraphCleared, sendGraphCleared, sendNodeAdded, sendNodeAdded, sendNodeAttributeAdded, sendNodeAttributeAdded, sendNodeAttributeChanged, sendNodeAttributeChanged, sendNodeAttributeRemoved, sendNodeAttributeRemoved, sendNodeRemoved, sendNodeRemoved, sendStepBegins, sendStepBegins

Methods inherited from class java.lang.Object

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

Methods inherited from interface org.graphstream.stream.Source

addAttributeSink, addElementSink, addSink, clearAttributeSinks, clearElementSinks, clearSinks, removeAttributeSink, removeElementSink, removeSink

Constructor Detail

ThreadProxyPipeOld

public ThreadProxyPipeOld()

Deprecated.

New thread proxy pipe with no input.

ThreadProxyPipeOld

public ThreadProxyPipeOld(Source input)

Deprecated.

Listen at an input in a given thread and redirect all events to GraphListeners that may be in another thread.

Parameters:

input - The source of graph events we listen at.

ThreadProxyPipeOld

public ThreadProxyPipeOld(Source input,
                  org.miv.mbox.MBox sharedMBox)

Deprecated.

Like #ThreadProxyPipe(Source), but allow to share the message box with another message processor. This can be needed to share the same message stack, when message order is important.

Parameters:

input - The source of events we listen at.

sharedMBox - The message box used to send and receive graph messages across the thread boundary.

ThreadProxyPipeOld

public ThreadProxyPipeOld(Graph inputGraph)

Deprecated.

Listen at an input graph in a given thread and redirect all events to GraphListeners that may be in another thread. By default, if the graph already contains some elements, they are "replayed". This means that events are sent to mimic the fact they just appeared.

Parameters:

inputGraph - The graph we listen at.

ThreadProxyPipeOld

public ThreadProxyPipeOld(Graph inputGraph,
                  boolean replayGraph)

Deprecated.

Like #ThreadProxyPipe(Graph) but allow to avoid replaying the graph.

Parameters:

inputGraph - The graph we listen at.

replayGraph - If false, and if the input graph already contains element they are not replayed.

ThreadProxyPipeOld

public ThreadProxyPipeOld(Graph inputGraph,
                  Sink firstListener,
                  boolean replayGraph)

Deprecated.

Like #ThreadProxyPipe(Graph,boolean) but allows to pass an initial listener, therefore specifying the input and output at once.

Parameters:

inputGraph - The graph we listen at.

firstListener - The initial listener to register.

replayGraph - If false, and if the input graph already contains element they are not replayed.

ThreadProxyPipeOld

public ThreadProxyPipeOld(Graph inputGraph,
                  Sink firstListener,
                  boolean replayGraph,
                  org.miv.mbox.MBox sharedMBox)

Deprecated.

Like #ThreadProxyPipe(Graph,Sink,boolean), but allows to share the message box with another message processor. This can be needed to share the same message stack, when message order is important.

Parameters:

inputGraph - The graph we listen at.

replayGraph - If false, and if the input graph already contains element they are not replayed.

sharedMBox - The message box used to send and receive graph messages across the thread boundary.

Method Detail

toString

public String toString()

Deprecated.

Overrides:

toString in class Object

unregisterFromSource

public void unregisterFromSource()

Deprecated.

Ask the proxy to unregister from the event input source (stop receive events) as soon as possible (when the next event will occur in the graph).

pump

public void pump()

Deprecated.

This method must be called regularly in the output thread to check if the input source sent events. If some event occurred, the listeners will be called.

Specified by:

pump in interface ProxyPipe

blockingPump

public void blockingPump()
                  throws InterruptedException

Deprecated.

Description copied from interface: ProxyPipe

Same as ProxyPipe.pump() but try to block until new events were available. Note that this feature will not be available on all proxy pipe implementation and may throws an UnsupportedOperationException. It can throw an InterruptedException if the current thread is interrupted while proxy is waiting for events.

Specified by:

blockingPump in interface ProxyPipe

Throws:

InterruptedException

blockingPump

public void blockingPump(long timeout)
                  throws InterruptedException

Deprecated.

Description copied from interface: ProxyPipe

Same as ProxyPipe.blockingPump() but including a timeout delay.

Specified by:

blockingPump in interface ProxyPipe

Throws:

InterruptedException

edgeAttributeAdded

public void edgeAttributeAdded(String graphId,
                      long timeId,
                      String edgeId,
                      String attribute,
                      Object value)

Deprecated.

Description copied from interface: AttributeSink

A edge attribute was added.

Specified by:

edgeAttributeAdded in interface AttributeSink

Parameters:

graphId - Identifier of the graph where the change occurred.

edgeId - Identifier of the edge whose attribute changed.

attribute - The attribute name.

value - The attribute new value.

edgeAttributeChanged

public void edgeAttributeChanged(String graphId,
                        long timeId,
                        String edgeId,
                        String attribute,
                        Object oldValue,
                        Object newValue)

Deprecated.

Description copied from interface: AttributeSink

A edge attribute was changed.

Specified by:

edgeAttributeChanged in interface AttributeSink

Parameters:

graphId - Identifier of the graph where the change occurred.

edgeId - Identifier of the edge whose attribute changed.

attribute - The attribute name.

oldValue - The attribute old value.

newValue - The attribute new value.

edgeAttributeRemoved

public void edgeAttributeRemoved(String graphId,
                        long timeId,
                        String edgeId,
                        String attribute)

Deprecated.

Description copied from interface: AttributeSink

A edge attribute was removed.

Specified by:

edgeAttributeRemoved in interface AttributeSink

Parameters:

graphId - Identifier of the graph where the attribute was removed.

edgeId - Identifier of the edge whose attribute was removed.

attribute - The removed attribute name.

graphAttributeAdded

public void graphAttributeAdded(String graphId,
                       long timeId,
                       String attribute,
                       Object value)

Deprecated.

Description copied from interface: AttributeSink

A graph attribute was added.

Specified by:

graphAttributeAdded in interface AttributeSink

Parameters:

graphId - Identifier of the graph where the attribute changed.

attribute - The attribute name.

value - The attribute new value.

graphAttributeChanged

public void graphAttributeChanged(String graphId,
                         long timeId,
                         String attribute,
                         Object oldValue,
                         Object newValue)

Deprecated.

Description copied from interface: AttributeSink

A graph attribute was changed.

Specified by:

graphAttributeChanged in interface AttributeSink

Parameters:

graphId - Identifier of the graph where the attribute changed.

attribute - The attribute name.

oldValue - The attribute old value.

newValue - The attribute new value.

graphAttributeRemoved

public void graphAttributeRemoved(String graphId,
                         long timeId,
                         String attribute)

Deprecated.

Description copied from interface: AttributeSink

A graph attribute was removed.

Specified by:

graphAttributeRemoved in interface AttributeSink

Parameters:

graphId - Identifier of the graph where the attribute was removed.

attribute - The removed attribute name.

nodeAttributeAdded

public void nodeAttributeAdded(String graphId,
                      long timeId,
                      String nodeId,
                      String attribute,
                      Object value)

Deprecated.

Description copied from interface: AttributeSink

A node attribute was added.

Specified by:

nodeAttributeAdded in interface AttributeSink

Parameters:

graphId - Identifier of the graph where the change occurred.

nodeId - Identifier of the node whose attribute changed.

attribute - The attribute name.

value - The attribute new value.

nodeAttributeChanged

public void nodeAttributeChanged(String graphId,
                        long timeId,
                        String nodeId,
                        String attribute,
                        Object oldValue,
                        Object newValue)

Deprecated.

Description copied from interface: AttributeSink

A node attribute was changed.

Specified by:

nodeAttributeChanged in interface AttributeSink

Parameters:

graphId - Identifier of the graph where the change occurred.

nodeId - Identifier of the node whose attribute changed.

attribute - The attribute name.

oldValue - The attribute old value.

newValue - The attribute new value.

nodeAttributeRemoved

public void nodeAttributeRemoved(String graphId,
                        long timeId,
                        String nodeId,
                        String attribute)

Deprecated.

Description copied from interface: AttributeSink

A node attribute was removed.

Specified by:

nodeAttributeRemoved in interface AttributeSink

Parameters:

graphId - Identifier of the graph where the attribute was removed.

nodeId - Identifier of the node whose attribute was removed.

attribute - The removed attribute name.

edgeAdded

public void edgeAdded(String graphId,
             long timeId,
             String edgeId,
             String fromNodeId,
             String toNodeId,
             boolean directed)

Deprecated.

Description copied from interface: ElementSink

An edge was inserted in graph.

Specified by:

edgeAdded in interface ElementSink

Parameters:

graphId - Identifier of the graph where the edge was added.

edgeId - Identifier of the added edge.

fromNodeId - Identifier of the first node of the edge.

toNodeId - Identifier of the second node of the edge.

directed - If true, the edge is directed.

edgeRemoved

public void edgeRemoved(String graphId,
               long timeId,
               String edgeId)

Deprecated.

Description copied from interface: ElementSink

An edge of graph was removed.The nodes the edge connects may already have been removed from the graph.

Specified by:

edgeRemoved in interface ElementSink

Parameters:

graphId - The graph where the edge will be removed.

edgeId - The edge that will be removed.

graphCleared

public void graphCleared(String graphId,
                long timeId)

Deprecated.

Description copied from interface: ElementSink

The whole graph was cleared. All the nodes, edges and attributes of the graph are removed.

Specified by:

graphCleared in interface ElementSink

Parameters:

graphId - The graph cleared.

nodeAdded

public void nodeAdded(String graphId,
             long timeId,
             String nodeId)

Deprecated.

Description copied from interface: ElementSink

A node was inserted in the given graph.

Specified by:

nodeAdded in interface ElementSink

Parameters:

graphId - Identifier of the graph where the node was added.

nodeId - Identifier of the added node.

nodeRemoved

public void nodeRemoved(String graphId,
               long timeId,
               String nodeId)

Deprecated.

Description copied from interface: ElementSink

A node was removed from the graph.

Specified by:

nodeRemoved in interface ElementSink

Parameters:

graphId - Identifier of the graph where the node will be removed.

nodeId - Identifier of the removed node.

stepBegins

public void stepBegins(String graphId,
              long timeId,
              double step)

Deprecated.

Description copied from interface: ElementSink

Since dynamic graphs are based on discrete event modifications, the notion of step is defined to simulate elapsed time between events. So a step is a event that occurs in the graph, it does not modify it but it gives a kind of timestamp that allow the tracking of the progress of the graph over the time.

This kind of event is useful for dynamic algorithms that listen to the dynamic graph and need to measure the time in the graph's evolution.

Specified by:

stepBegins in interface ElementSink

Parameters:

graphId - Identifier of the graph where the step starts.

timeId - A numerical value that may give a timestamp to track the evolution of the graph over the time.

processMessage

public void processMessage(String from,
                  Object[] data)

Deprecated.

Specified by:

processMessage in interface org.miv.mbox.MBoxListener