Class RegexLineIterator

java.lang.Object

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

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	Description
static final String	COMMENT_LINE
static final String	ENTRY
protected Matcher	extractLine
protected Matcher	ignoreLine
static final String	NONWHITESPACE_ENTRY_TRAILING_COMMENT
protected String	outputTemplate
static final 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	Description
RegexLineIterator(Iterator<String> inner, String ignore, String extract, String replace)

Method Summary

Modifier and Type	Method	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

Methods inherited from interface java.util.Iterator

forEachRemaining

Field Details

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 Details

RegexLineIterator

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

Method Details

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