Package net.sf.basedb.util.bfs
Class DataParser
java.lang.Object
net.sf.basedb.util.bfs.DataParser
- All Implemented Interfaces:
AutoCloseable
,BfsParser
Parser implementation that parses BFS data files. Before parsing
is started the stream to parse must be specified by calling
setInputStream(InputStream)
. The actual parsing can be done
in two different ways:
- "Manual" parsing, using the
parseToBof()
andnextData()
methods. - Event-based parsing using the
parse(EventHandler)
method. This parser issues the following events:DATA_EVENT
: For each data line that is parsed.END_OF_FILE_EVENT
: When the end of the file has been reached.
MatrixModel
class implements a simple event handler that collects the information from the data file and provides methods for accessing it, though it is recommended only for small files.
This class may be subclassed to provide customized behaviour.
- Version:
- 2.15
- Author:
- Nicklas
- Last modified
- $Date: 2010-04-20 10:02:16 +0200 (ti, 20 apr 2010) $
-
Field Summary
Modifier and TypeFieldDescriptionEvent type that is issued for each data line.private final EncoderDecoder
Event type that is issued when the end-of-file had been reached.private FlatFileParser
private String
private long
private InputStream
private int
-
Constructor Summary
-
Method Summary
Modifier and TypeMethodDescriptionvoid
close()
Close the parser and relase underlying system resources that are associated with it.static DataParser
Utility method for creating a data parser for a file in the local file system.static DataParser
create
(InputStream in, String filename, long fileSize) Utility method for creating a data parser when you have an input stream.static DataParser
Utility method for creating a data parser for a file in the BASE file system.protected FlatFileParser
Create a new flat file parser that can parse BFS annotation files.decodeValue
(String value) Decode an encoded value.int
Get the current line number.Get the file name that this parser is reading from.long
Get the size in bytes of the file that this parser is reading from.long
Get the number of parsed bytes so far.protected void
handleData
(EventHandler handler, String[] data) Handle the data event.protected void
handleEndOfFile
(EventHandler handler) Handle the end-of-file event.String[]
nextData()
Get the next data line in the file.void
parse
(EventHandler handler) Parse the input stream and notify the specified event handler with events.void
Initialize parsing of the data file.void
setFilename
(String filename) Set the file name that this parser is reading from.void
setFileSize
(long fileSize) Set the size of the file or -1 if not known.void
Set the input stream that should be parsed.void
setNumColumns
(int numColumns) Set the number of data columns that are expected to be found in this file.
-
Field Details
-
DATA_EVENT
Event type that is issued for each data line. The event data is a string array with that data. -
END_OF_FILE_EVENT
Event type that is issued when the end-of-file had been reached. No event data is submitted. -
decoder
-
in
-
filename
-
fileSize
private long fileSize -
ffp
-
numColumns
private int numColumns
-
-
Constructor Details
-
DataParser
public DataParser()Create a new data parser.
-
-
Method Details
-
create
Utility method for creating a data parser when you have an input stream.- Parameters:
in
- The input stream the parser should read fromfilename
- Optional, the name of the file the input stream is reading from
-
create
Utility method for creating a data parser for a file in the BASE file system.- Parameters:
file
- The file in the BASE file system
-
create
Utility method for creating a data parser for a file in the local file system.- Parameters:
file
- The file in the local file system- Throws:
IOException
-
decodeValue
Decode an encoded value. Values are encoded/decoded with aTabCrLfEncoderDecoder
.- Parameters:
value
- The encoded value- Returns:
- The decoded value
-
getFilename
Get the file name that this parser is reading from.- Specified by:
getFilename
in interfaceBfsParser
- Returns:
- The file name or null if not known
-
setFilename
Set the file name that this parser is reading from. -
getFileSize
public long getFileSize()Get the size in bytes of the file that this parser is reading from.- Specified by:
getFileSize
in interfaceBfsParser
- Returns:
- The size or -1 if not known
-
setFileSize
public void setFileSize(long fileSize) Set the size of the file or -1 if not known. -
close
public void close()Description copied from interface:BfsParser
Close the parser and relase underlying system resources that are associated with it.- Specified by:
close
in interfaceAutoCloseable
- Specified by:
close
in interfaceBfsParser
-
setInputStream
Set the input stream that should be parsed. This will also reset the parser. All information from a previously parsed file is lost.- Parameters:
in
- The stream to parse (in UTF-8 format)
-
setNumColumns
public void setNumColumns(int numColumns) Set the number of data columns that are expected to be found in this file.- Parameters:
numColumns
- The number of columns or -1 to let the parser automatically detect this on the first data line
-
parse
Parse the input stream and notify the specified event handler with events. The event handler is responsible for keeping track of and storing the data of interest.- Parameters:
handler
- An event handler- Throws:
IOException
- If there is an error reading the stream dataNullPointerException
- If the stream or event handler is null
-
parseToBof
Initialize parsing of the data file. This method can only be called once on a given input stream. To parse a second file, callsetInputStream(InputStream)
again to reset the parser.- Throws:
IOException
- If the header line is not found or if there is any other IO errorIllegalStateException
- If the parsing has already startedNullPointerException
- If no input stream has been specified
-
nextData
Get the next data line in the file.- Returns:
- An array with the data, or null if no more data is found
- Throws:
IOException
- If there is an IO error or if the data is invalidIllegalStateException
- If notparseToBof()
has been called
-
getCurrentLine
public int getCurrentLine()Description copied from interface:BfsParser
Get the current line number.- Specified by:
getCurrentLine
in interfaceBfsParser
- Returns:
- The line number, starting at 1 for the first line in the file, or -1 if not known
-
getParsedBytes
public long getParsedBytes()Description copied from interface:BfsParser
Get the number of parsed bytes so far.- Specified by:
getParsedBytes
in interfaceBfsParser
- Returns:
- The number of bytes that has been parsed, or -1 if not known
-
createFlatFileParser
Create a new flat file parser that can parse BFS annotation files. This method should set all regular expressions that are needed to parse the stream (assumed to be UTF-8). -
handleData
Handle the data event. The default implemention sends aDATA_EVENT
to the event handler- Parameters:
handler
- The event handler from theparse(EventHandler)
methoddata
- An array with the data
-
handleEndOfFile
Handle the end-of-file event. The default implementation sends anEND_OF_FILE_EVENT
notification to the event handler.- Parameters:
handler
- The event handler from theparse(EventHandler)
method
-