plume

Class EntryReader

java.lang.Object

java.io.Reader

java.io.BufferedReader

java.io.LineNumberReader

plume.EntryReader

All Implemented Interfaces:

java.io.Closeable, java.lang.AutoCloseable, java.lang.Iterable<java.lang.String>, java.lang.Readable, java.util.Iterator<java.lang.String>

Deprecated.

use org.plumelib.util.EntryReader

@Deprecated
public class EntryReader
extends java.io.LineNumberReader
implements java.lang.Iterable<java.lang.String>, java.util.Iterator<java.lang.String>

Class that reads records or "entries" from a file. In the simplest case, entries can be lines. It supports:

• include files,
• comments, and
• multi-line entries (paragraphs).

The syntax of each of these is customizable.

Example use:

 // EntryReader constructor args are: filename, comment regexp, include regexp
 try (EntryReader er = new EntryReader(filename, "^#.*", null)) {
   for (String line : er) {
     ...
   }
 } catch (IOException e) {
   System.err.println("Problem reading " + filename + ": " + e.getMessage());
 }
 

See Also:

and @see #set_entry_start_stop(String,String)

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static class	EntryReader.Entry Deprecated. Descriptor for an entry (record, paragraph, etc.).

Field Summary

Fields

Modifier and Type	Field and Description
java.util.regex.Pattern	entry_start_re Deprecated. Regular expression that starts a long entry.
java.util.regex.Pattern	entry_stop_re Deprecated.

Fields inherited from class java.io.Reader

lock

Constructor Summary

Constructors

Constructor and Description
EntryReader(java.io.File file) Deprecated. Create a EntryReader that does not support comments or include directives.
EntryReader(java.io.File file, java.lang.String charsetName) Deprecated. Create a EntryReader that does not support comments or include directives.
EntryReader(java.io.File file, java.lang.String comment_re, java.lang.String include_re) Deprecated. Create an EntryReader.
EntryReader(java.io.InputStream in) Deprecated. Create a EntryReader that does not support comments or include directives.
EntryReader(java.io.InputStream in, java.lang.String filename) Deprecated. Create a EntryReader that uses the default character set and does not support comments or include directives.
EntryReader(java.io.InputStream in, java.lang.String charsetName, java.lang.String filename) Deprecated. Create a EntryReader that does not support comments or include directives.
EntryReader(java.io.InputStream in, java.lang.String filename, java.lang.String comment_re_string, java.lang.String include_re_string) Deprecated. Create a EntryReader.
EntryReader(java.io.InputStream in, java.lang.String charsetName, java.lang.String filename, java.lang.String comment_re_string, java.lang.String include_re_string) Deprecated. Create a EntryReader that uses the given character set.
EntryReader(java.io.Reader reader) Deprecated. Create a EntryReader that does not support comments or include directives.
EntryReader(java.io.Reader reader, java.lang.String filename, java.lang.String comment_re_string, java.lang.String include_re_string) Deprecated. Create a EntryReader.
EntryReader(java.lang.String filename) Deprecated. Create a EntryReader that does not support comments or include directives.
EntryReader(java.lang.String filename, java.lang.String charsetName) Deprecated. Create a EntryReader that does not support comments or include directives.
EntryReader(java.lang.String filename, java.lang.String comment_re, java.lang.String include_re) Deprecated. Create a new EntryReader starting with the specified file.

Method Summary

Modifier and Type	Method and Description
EntryReader.Entry	get_entry() Deprecated. Returns the next entry (paragraph) in the file.
java.lang.String	getFileName() Deprecated. Returns the current filename.
int	getLineNumber() Deprecated. Return the current line number in the current file.
boolean	hasNext() Deprecated. Returns whether or not there is another line to read.
java.util.Iterator<java.lang.String>	iterator() Deprecated. Return a line-by-line iterator for this file.
static void	main(java.lang.String[] args) Deprecated. Simple usage example.
void	mark(int readAheadLimit) Deprecated.
java.lang.String	next() Deprecated. Return the next line in the multi-file.
void	putback(java.lang.String line) Deprecated. Puts the specified line back in the input.
int	read() Deprecated.
int	read(char[] cbuf, int off, int len) Deprecated.
java.lang.String	readLine() Deprecated. Read a line, ignoring comments and processing includes.
void	remove() Deprecated. remove() is not supported.
void	reset() Deprecated.
void	set_entry_start_stop(java.util.regex.Pattern entry_start_re, java.util.regex.Pattern entry_stop_re) Deprecated. Set the regular expressions for the start and stop of long entries (multiple lines that are read as a group by get_entry()).
void	set_entry_start_stop(java.lang.String entry_start_re, java.lang.String entry_stop_re) Deprecated. Set the regular expressions for the start and stop of long entries (multiple lines that are read as a group by get_entry()).
void	setLineNumber(int lineNumber) Deprecated. Set the current line number in the current file.
long	skip(long n) Deprecated.

Methods inherited from class java.io.BufferedReader

close, lines, markSupported, ready

Methods inherited from class java.io.Reader

read, read

Methods inherited from class java.lang.Object

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

Methods inherited from interface java.lang.Iterable

forEach, spliterator

Methods inherited from interface java.util.Iterator

forEachRemaining

Field Detail

entry_start_re

public java.util.regex.Pattern entry_start_re

Deprecated.

Regular expression that starts a long entry.

If the first line of an entry matches this regexp, then the entry is terminated by: entry_stop_re, another line that matches entry_start_re (even not following a newline), or the end of the current file.

Otherwise, the first line of an entry does NOT match this regexp (or the regexp is null), in which case the entry is terminated by a blank line or the end of the current file.

entry_stop_re

public java.util.regex.Pattern entry_stop_re

Deprecated.

See Also:

entry_start_re

Constructor Detail

EntryReader

public EntryReader(java.io.InputStream in,
                   java.lang.String charsetName,
                   java.lang.String filename,
                   java.lang.String comment_re_string,
                   java.lang.String include_re_string)
            throws java.io.UnsupportedEncodingException

Deprecated.

Create a EntryReader that uses the given character set.

Parameters:

in - source from which to read entries

charsetName - the character set to use

filename - non-null file name for stream being read

comment_re_string - regular expression that matches comments. Any text that matches comment_re is removed. A line that is entirely a comment is ignored.

include_re_string - regular expression that matches include directives. The expression should define one group that contains the include file name.

Throws:

java.io.UnsupportedEncodingException - if the charset encoding is not supported

See Also:

EntryReader(InputStream,String,String,String)

EntryReader

public EntryReader(java.io.InputStream in,
                   java.lang.String charsetName,
                   java.lang.String filename)
            throws java.io.UnsupportedEncodingException

Deprecated.

Create a EntryReader that does not support comments or include directives.

Parameters:

in - the InputStream

charsetName - the character set to use

filename - the file name

Throws:

java.io.UnsupportedEncodingException - if the charset encoding is not supported

See Also:

EntryReader(InputStream,String,String,String)

EntryReader

public EntryReader(java.io.InputStream in,
                   java.lang.String filename,
                   java.lang.String comment_re_string,
                   java.lang.String include_re_string)

Deprecated.

Create a EntryReader.

Parameters:

in - source from which to read entries

filename - non-null file name for stream being read

comment_re_string - regular expression that matches comments. Any text that matches comment_re is removed. A line that is entirely a comment is ignored.

include_re_string - regular expression that matches include directives. The expression should define one group that contains the include file name.

EntryReader

public EntryReader(java.io.InputStream in,
                   java.lang.String filename)

Deprecated.

Create a EntryReader that uses the default character set and does not support comments or include directives.

Parameters:

in - the InputStream

filename - the file name

See Also:

EntryReader(InputStream,String,String,String,String)

EntryReader

public EntryReader(java.io.InputStream in)

Deprecated.

Create a EntryReader that does not support comments or include directives.

Parameters:

in - the InputStream

See Also:

EntryReader(InputStream,String,String,String)

EntryReader

public EntryReader(java.io.Reader reader,
                   java.lang.String filename,
                   java.lang.String comment_re_string,
                   java.lang.String include_re_string)

Deprecated.

Create a EntryReader.

Parameters:

reader - source from which to read entries

filename - file name corresponding to reader, for use in error messages

comment_re_string - regular expression that matches comments. Any text that matches comment_re is removed. A line that is entirely a comment is ignored

include_re_string - regular expression that matches include directives. The expression should define one group that contains the include file name

EntryReader

public EntryReader(java.io.Reader reader)

Deprecated.

Create a EntryReader that does not support comments or include directives.

Parameters:

reader - source from which to read entries

See Also:

EntryReader(Reader,String,String,String)

EntryReader

public EntryReader(java.io.File file,
                   java.lang.String comment_re,
                   java.lang.String include_re)
            throws java.io.IOException

Deprecated.

Create an EntryReader.

Parameters:

file - initial file to read

comment_re - regular expression that matches comments. Any text that matches comment_re is removed. A line that is entirely a comment is ignored.

include_re - regular expression that matches include directives. The expression should define one group that contains the include file name.

Throws:

java.io.IOException - if there is a problem reading the file

EntryReader

public EntryReader(java.io.File file)
            throws java.io.IOException

Deprecated.

Create a EntryReader that does not support comments or include directives.

Parameters:

file - the file to read

Throws:

java.io.IOException - if there is a problem reading the file

See Also:

EntryReader(File,String,String)

EntryReader

public EntryReader(java.io.File file,
                   java.lang.String charsetName)
            throws java.io.IOException

Deprecated.

Create a EntryReader that does not support comments or include directives.

Parameters:

file - the file to read

charsetName - the character set to use

Throws:

java.io.IOException - if there is a problem reading the file

See Also:

EntryReader(File,String,String)

EntryReader

public EntryReader(java.lang.String filename,
                   java.lang.String comment_re,
                   java.lang.String include_re)
            throws java.io.IOException

Deprecated.

Create a new EntryReader starting with the specified file.

Parameters:

filename - initial file to read

comment_re - regular expression that matches comments. Any text that matches comment_re is removed. A line that is entirely a comment is ignored.

include_re - regular expression that matches include directives. The expression should define one group that contains the include file name.

Throws:

java.io.IOException - if there is a problem reading the file

See Also:

EntryReader(File,String,String)

EntryReader

public EntryReader(java.lang.String filename)
            throws java.io.IOException

Deprecated.

Create a EntryReader that does not support comments or include directives.

Parameters:

filename - source from which to read entries

Throws:

java.io.IOException - if there is a problem reading the file

See Also:

EntryReader(String,String,String)

EntryReader

public EntryReader(java.lang.String filename,
                   java.lang.String charsetName)
            throws java.io.IOException

Deprecated.

Create a EntryReader that does not support comments or include directives.

Parameters:

filename - source from which to read entries

charsetName - the character set to use

Throws:

java.io.IOException - if there is a problem reading the file

See Also:

EntryReader(String,String,String)

Method Detail

readLine

public java.lang.String readLine()
                          throws java.io.IOException

Deprecated.

Read a line, ignoring comments and processing includes. Note that a line that is completely a comment is completely ignored (and not returned as a blank line). Returns null at end of file.

Overrides:

readLine in class java.io.LineNumberReader

Returns:

the string that was read, or null at end of file

Throws:

java.io.IOException

iterator

public java.util.Iterator<java.lang.String> iterator()

Deprecated.

Return a line-by-line iterator for this file.

Warning: This does not return a fresh iterator each time. The iterator is a singleton, the same one is returned each time, and a new one can never be created after it is exhausted.

Specified by:

iterator in interface java.lang.Iterable<java.lang.String>

Returns:

a line-by-line iterator for this file

hasNext

public boolean hasNext()

Deprecated.

Returns whether or not there is another line to read. Any IOExceptions are turned into errors (because the definition of hasNext() in Iterator doesn't throw any exceptions).

Specified by:

hasNext in interface java.util.Iterator<java.lang.String>

Returns:

whether there is another line to read

next

public java.lang.String next()

Deprecated.

Return the next line in the multi-file.

Specified by:

next in interface java.util.Iterator<java.lang.String>

Returns:

the next line in the multi-file

Throws:

java.util.NoSuchElementException - at end of file

remove

public void remove()

Deprecated.

remove() is not supported.

Specified by:

remove in interface java.util.Iterator<java.lang.String>

get_entry

public EntryReader.Entry get_entry()
                            throws java.io.IOException

Deprecated.

Returns the next entry (paragraph) in the file. Entries are separated by blank lines unless the entry started with entry_start_re (see set_entry_start_stop(java.lang.String, java.lang.String)). If no more entries are available, returns null.

Returns:

the next entry (paragraph) in the file

Throws:

java.io.IOException - if there is a problem reading the file

getFileName

public java.lang.String getFileName()

Deprecated.

Returns the current filename.

Returns:

the current filename

getLineNumber

public int getLineNumber()

Deprecated.

Return the current line number in the current file.

Overrides:

getLineNumber in class java.io.LineNumberReader

Returns:

the current line number

setLineNumber

public void setLineNumber(int lineNumber)

Deprecated.

Set the current line number in the current file.

Overrides:

setLineNumber in class java.io.LineNumberReader

Parameters:

lineNumber - new line number for the current file

set_entry_start_stop

public void set_entry_start_stop(java.lang.String entry_start_re,
                                 java.lang.String entry_stop_re)

Deprecated.

Set the regular expressions for the start and stop of long entries (multiple lines that are read as a group by get_entry()).

Parameters:

entry_start_re - regular expression that starts a long entry

entry_stop_re - regular expression that ends a long entry

set_entry_start_stop

public void set_entry_start_stop(java.util.regex.Pattern entry_start_re,
                                 java.util.regex.Pattern entry_stop_re)

Deprecated.

Set the regular expressions for the start and stop of long entries (multiple lines that are read as a group by get_entry()).

Parameters:

entry_start_re - regular expression that starts a long entry

entry_stop_re - regular expression that ends a long entry

putback

public void putback(java.lang.String line)

Deprecated.

Puts the specified line back in the input. Only one line can be put back.

Parameters:

line - the line to be put back in the input

mark

public void mark(int readAheadLimit)

Deprecated.

Overrides:

mark in class java.io.LineNumberReader

read

public int read()

Deprecated.

Overrides:

read in class java.io.LineNumberReader

read

public int read(char[] cbuf,
                int off,
                int len)

Deprecated.

Overrides:

read in class java.io.LineNumberReader

reset

public void reset()

Deprecated.

Overrides:

reset in class java.io.LineNumberReader

skip

public long skip(long n)

Deprecated.

Overrides:

skip in class java.io.LineNumberReader

main

public static void main(java.lang.String[] args)
                 throws java.io.IOException

Deprecated.

Simple usage example.

Parameters:

args - command-line arguments: filename [comment_re [include_re]]

Throws:

java.io.IOException - if there is a problem reading a file