com.univocity.parsers.fixed
Class FixedWidthParser

java.lang.Object
  com.univocity.parsers.common.AbstractParser<FixedWidthParserSettings>
      com.univocity.parsers.fixed.FixedWidthParser

public class FixedWidthParser
extends AbstractParser<FixedWidthParserSettings>

A fast and flexible fixed-with parser implementation.

Author:

uniVocity Software Pty Ltd - parsers@univocity.com

See Also:

FixedWidthFormat, FixedWidthFields, FixedWidthParserSettings, FixedWidthWriter, AbstractParser

Field Summary

Fields inherited from class com.univocity.parsers.common.AbstractParser

ch, comments, context, input, lastComment, output, processor, recordFactory, settings, whitespaceRangeStart

Constructor Summary

FixedWidthParser(FixedWidthParserSettings settings)
The FixedWidthParser supports all settings provided by FixedWidthParserSettings, and requires this configuration to be properly initialized.

Method Summary

protected void

parseRecord() Parser-specific implementation for reading a single record from the input.

Methods inherited from class com.univocity.parsers.common.AbstractParser

beginParsing, beginParsing, beginParsing, beginParsing, beginParsing, beginParsing, beginParsing, consumeValueOnEOF, createParsingContext, getContext, getInputAnalysisProcess, getRecordMetadata, inComment, initialize, iterate, iterate, iterate, iterate, iterate, iterate, iterate, iterateRecords, iterateRecords, iterateRecords, iterateRecords, iterateRecords, iterateRecords, iterateRecords, parse, parse, parse, parse, parse, parse, parse, parseAll, parseAll, parseAll, parseAll, parseAll, parseAll, parseAll, parseAll, parseAll, parseAll, parseAll, parseAll, parseAll, parseAll, parseAllRecords, parseAllRecords, parseAllRecords, parseAllRecords, parseAllRecords, parseAllRecords, parseAllRecords, parseAllRecords, parseAllRecords, parseAllRecords, parseAllRecords, parseAllRecords, parseAllRecords, parseAllRecords, parseLine, parseNext, parseNextRecord, parseRecord, processComment, reloadHeaders, stopParsing

Methods inherited from class java.lang.Object

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

Constructor Detail

FixedWidthParser

public FixedWidthParser(FixedWidthParserSettings settings)

The FixedWidthParser supports all settings provided by FixedWidthParserSettings, and requires this configuration to be properly initialized.

Parameters:

settings - the parser configuration

Method Detail

parseRecord

protected void parseRecord()

Description copied from class: AbstractParser

Parser-specific implementation for reading a single record from the input.

The AbstractParser handles the initialization and processing of the input until it is ready to be parsed.

It then delegates the input to the parser-specific implementation defined by AbstractParser.parseRecord(). In general, an implementation of AbstractParser.parseRecord() will perform the following steps:

• Test the character stored in ch and take some action on it (e.g. is while (ch != '\n'){doSomething()})
• Request more characters by calling ch = input.nextChar();
• Append the desired characters to the output by executing, for example, output.appender.append(ch)
• Notify a value of the record has been fully read by executing output.valueParsed(). This will clear the output appender (CharAppender) so the next call to output.appender.append(ch) will be store the character of the next parsed value
• Rinse and repeat until all values of the record are parsed

Once the AbstractParser.parseRecord() returns, the AbstractParser takes over and handles the information (generally, reorganizing it and passing it on to a RowProcessor).

After the record processing, the AbstractParser reads the next characters from the input, delegating control again to the parseRecord() implementation for processing of the next record.

This cycle repeats until the reading process is stopped by the user, the input is exhausted, or an error happens.

In case of errors, the unchecked exception TextParsingException will be thrown and all resources in use will be closed automatically. The exception should contain the cause and more information about where in the input the error happened.

Specified by:

parseRecord in class AbstractParser<FixedWidthParserSettings>

See Also:

CharInputReader, CharAppender, ParserOutput, TextParsingException, RowProcessor