com.sun.mail.util

Class LineInputStream

java.lang.Object

java.io.InputStream

java.io.FilterInputStream

com.sun.mail.util.LineInputStream

All Implemented Interfaces:

java.io.Closeable, java.lang.AutoCloseable

public class LineInputStream
extends java.io.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 and Description
LineInputStream(java.io.InputStream in)
LineInputStream(java.io.InputStream in, boolean allowutf8)

Method Summary

Modifier and Type	Method and Description
java.lang.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.lang.Object

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

Constructor Detail

LineInputStream

public LineInputStream(java.io.InputStream in)

LineInputStream

public LineInputStream(java.io.InputStream in,
                       boolean allowutf8)

Parameters:

in - the InputStream

allowutf8 - allow UTF-8 characters?

Since:

JavaMail 1.6

Method Detail

readLine

public java.lang.String readLine()
                          throws java.io.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:

java.io.IOException - for I/O errors