org.archive.util.iterator

Class RegexLineIterator

java.lang.Object

org.archive.util.iterator.LookaheadIterator<Transformed>

org.archive.util.iterator.TransformingIteratorWrapper<String,String>

org.archive.util.iterator.RegexLineIterator

All Implemented Interfaces:

Iterator<String>

public class RegexLineIterator
extends TransformingIteratorWrapper<String,String>

Utility class providing an Iterator interface over line-oriented text input. By providing regexs indicating lines to ignore (such as pure whitespace or comments), lines to consider input, and what to return from the input lines (such as a whitespace-trimmed non-whitespace token with optional trailing comment), this can be configured to handle a number of formats. The public static members provide pattern configurations that will be helpful in a wide variety of contexts.

Author:

gojomo

Field Summary

Fields

Modifier and Type	Field and Description
static String	COMMENT_LINE
static String	ENTRY
protected Matcher	extractLine
protected Matcher	ignoreLine
static String	NONWHITESPACE_ENTRY_TRAILING_COMMENT
protected String	outputTemplate
static String	TRIMMED_ENTRY_TRAILING_COMMENT

Fields inherited from class org.archive.util.iterator.TransformingIteratorWrapper

inner

Fields inherited from class org.archive.util.iterator.LookaheadIterator

next

Constructor Summary

Constructors

Constructor and Description
RegexLineIterator(Iterator<String> inner, String ignore, String extract, String replace)

Method Summary

Methods

Modifier and Type	Method and Description
protected String	transform(String line) Loads next item into lookahead spot, if available.

Methods inherited from class org.archive.util.iterator.TransformingIteratorWrapper

lookahead, noteExhausted

Methods inherited from class org.archive.util.iterator.LookaheadIterator

hasNext, next, remove

Methods inherited from class java.lang.Object

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

Field Detail

COMMENT_LINE

public static final String COMMENT_LINE

See Also:

Constant Field Values

NONWHITESPACE_ENTRY_TRAILING_COMMENT

public static final String NONWHITESPACE_ENTRY_TRAILING_COMMENT

See Also:

Constant Field Values

TRIMMED_ENTRY_TRAILING_COMMENT

public static final String TRIMMED_ENTRY_TRAILING_COMMENT

See Also:

Constant Field Values

ENTRY

public static final String ENTRY

See Also:

Constant Field Values

ignoreLine

protected Matcher ignoreLine

extractLine

protected Matcher extractLine

outputTemplate

protected String outputTemplate

Constructor Detail

RegexLineIterator

public RegexLineIterator(Iterator<String> inner,
                 String ignore,
                 String extract,
                 String replace)

Method Detail

transform

protected String transform(String line)

Loads next item into lookahead spot, if available. Skips lines matching ignoreLine; extracts desired portion of lines matching extractLine; informationally reports any lines matching neither.

Specified by:

transform in class TransformingIteratorWrapper<String,String>

Parameters:

line - Object to transform.

Returns:

whether any item was loaded into next field