Package com.sun.mail.util

Class LineInputStream

java.lang.Object

java.io.InputStream

java.io.FilterInputStream

com.sun.mail.util.LineInputStream

All Implemented Interfaces:

Closeable, AutoCloseable

public class LineInputStream
extends FilterInputStream

This class is to support reading CRLF terminated lines that contain only US-ASCII characters from an input stream. Provides functionality that is similar to the deprecated DataInputStream.readLine(). Expected use is to read lines as String objects from a RFC822 stream. It is implemented as a FilterInputStream, so one can just wrap this class around any input stream and read bytes from this filter.

Constructor Summary

Constructors

Constructor	Description
LineInputStream(InputStream in)
LineInputStream(InputStream in, boolean allowutf8)

Method Summary

Modifier and Type	Method	Description
String	readLine()	Read a line containing only ASCII characters from the input stream.

Methods inherited from class java.io.FilterInputStream

available, close, mark, markSupported, read, read, read, reset, skip

Methods inherited from class java.io.InputStream

nullInputStream, readAllBytes, readNBytes, readNBytes, transferTo

Methods inherited from class java.lang.Object

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

Constructor Detail

LineInputStream

public LineInputStream(InputStream in)

LineInputStream

public LineInputStream(InputStream in,
                       boolean allowutf8)

Parameters:

in - the InputStream

allowutf8 - allow UTF-8 characters?

Since:

JavaMail 1.6

Method Detail

readLine

public String readLine()
                throws IOException

Read a line containing only ASCII characters from the input stream. A line is terminated by a CR or NL or CR-NL sequence. A common error is a CR-CR-NL sequence, which will also terminate a line. The line terminator is not returned as part of the returned String. Returns null if no data is available.

This class is similar to the deprecated DataInputStream.readLine()

Returns:

the line

Throws:

IOException - for I/O errors