Package org.graphstream.stream.file

Class FileSourceParser

java.lang.Object

org.graphstream.stream.SourceBase

org.graphstream.stream.file.FileSourceParser

All Implemented Interfaces:

FileSource, Source

Direct Known Subclasses:

FileSourceDGS, FileSourceDOT, FileSourceGML, FileSourcePajek, FileSourceTLP

public abstract class FileSourceParser
extends SourceBase
implements FileSource

This defines source using a Parser object to parse a stream and generate graph events.

Nested Class Summary

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

SourceBase.ElementType

Method Summary

Modifier and Type	Method	Description
void	begin(InputStream stream)	Begin reading the file stopping as soon as possible.
void	begin(Reader reader)	Begin reading the file stopping as soon as possible.
void	begin(String fileName)	Begin reading the file stopping as soon as possible.
void	begin(URL url)	Begin reading the file stopping as soon as possible.
void	end()	Finish the reading process (even if FileSource.nextEvents() or FileSource.nextStep() did not returned false).
abstract ParserFactory	getNewParserFactory()	Get a new parser factory.
boolean	nextEvents()	Try to process one graph event, or as few as possible, if more must be read at once.
boolean	nextStep()	Since there is no step in DOT, this does the same action than nextEvents().
void	readAll(InputStream stream)	Read the whole file in one big non-interruptible operation.
void	readAll(Reader reader)	Read the whole file in one big non-interruptible operation.
void	readAll(String fileName)	Read the whole file in one big non-interruptible operation.
void	readAll(URL url)	Read the whole file in one big non-interruptible operation.

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, toString, wait, wait, wait

Methods inherited from interface org.graphstream.stream.Source

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

Method Details

getNewParserFactory

public abstract ParserFactory getNewParserFactory()

Get a new parser factory.

Returns:

a parser factory

readAll

public void readAll(String fileName) throws IOException

Description copied from interface: FileSource

Read the whole file in one big non-interruptible operation.

Specified by:

readAll in interface FileSource

Parameters:

fileName - Name of the file to read.

Throws:

IOException - If an I/O error occurs while reading.

readAll

public void readAll(URL url) throws IOException

Description copied from interface: FileSource

Read the whole file in one big non-interruptible operation.

Specified by:

readAll in interface FileSource

Parameters:

url - The URL of the file to read.

Throws:

IOException - If an I/O error occurs while reading.

readAll

public void readAll(InputStream stream) throws IOException

Description copied from interface: FileSource

Read the whole file in one big non-interruptible operation.

Specified by:

readAll in interface FileSource

Parameters:

stream - The input stream to use for reading.

Throws:

IOException - If an I/O error occurs while reading.

readAll

public void readAll(Reader reader) throws IOException

Description copied from interface: FileSource

Read the whole file in one big non-interruptible operation.

Specified by:

readAll in interface FileSource

Parameters:

reader - The reader to use.

Throws:

IOException - If an I/O error occurs while reading.

begin

public void begin(String fileName) throws IOException

Description copied from interface: FileSource

Begin reading the file stopping as soon as possible. Next graph events stored in the file will be sent by calling FileSource.nextEvents() or FileSource.nextStep(). Once begin() has been called, you must finish the reading process using FileSource.end(). You cannot call begin() twice without having called FileSource.end() in between.

Specified by:

begin in interface FileSource

Parameters:

fileName - Name of the file to read.

Throws:

IOException - If an I/O error occurs while reading.

begin

public void begin(URL url) throws IOException

Description copied from interface: FileSource

Begin reading the file stopping as soon as possible. Next graph events stored in the file will be sent by calling FileSource.nextEvents() or FileSource.nextStep(). Once begin() has been called, you must finish the reading process using FileSource.end(). You cannot call begin() twice without having called FileSource.end() in between.

Specified by:

begin in interface FileSource

Parameters:

url - The URL of the file to read.

Throws:

IOException - If an I/O error occurs while reading.

begin

public void begin(InputStream stream) throws IOException

Description copied from interface: FileSource

Begin reading the file stopping as soon as possible. Next graph events stored in the file will be sent by calling FileSource.nextEvents() or FileSource.nextStep(). Once begin() has been called, you must finish the reading process using FileSource.end(). You cannot call begin() twice without having called FileSource.end() in between.

Specified by:

begin in interface FileSource

Parameters:

stream - The input stream to use for reading.

Throws:

IOException - If an I/O error occurs while reading.

begin

public void begin(Reader reader) throws IOException

Description copied from interface: FileSource

Begin reading the file stopping as soon as possible. Next graph events stored in the file will be sent by calling FileSource.nextEvents() or FileSource.nextStep(). Once begin() has been called, you must finish the reading process using FileSource.end(). You cannot call begin() twice without having called FileSource.end() in between.

Specified by:

begin in interface FileSource

Parameters:

reader - The file reader to use.

Throws:

IOException - If an I/O error occurs while reading.

nextEvents

public boolean nextEvents() throws IOException

Description copied from interface: FileSource

Try to process one graph event, or as few as possible, if more must be read at once. For this method to work, you must have called FileSource.begin(InputStream) or FileSource.begin(String) before. This method return true while there are still events to read.

Specified by:

nextEvents in interface FileSource

Returns:

true if there are still events to read, false as soon as the file is finished.

Throws:

IOException - If an I/O error occurs while reading.

nextStep

public boolean nextStep() throws IOException

Since there is no step in DOT, this does the same action than nextEvents().

Specified by:

nextStep in interface FileSource

Returns:

true if there are still events to read, false as soon as the file is finished.

Throws:

IOException - If an I/O error occurs while reading.

end

public void end() throws IOException

Description copied from interface: FileSource

Finish the reading process (even if FileSource.nextEvents() or FileSource.nextStep() did not returned false). You must call this method after reading.

Specified by:

end in interface FileSource

Throws:

IOException - If an I/O error occurs while closing the file.