com.sun.xml.messaging.saaj.packaging.mime.util
Class LineInputStream

java.lang.Object
  java.io.InputStream
      java.io.FilterInputStream
          com.sun.xml.messaging.saaj.packaging.mime.util.LineInputStream

All Implemented Interfaces:

java.io.Closeable

public final 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.

Author:

John Mani

Field Summary

Fields inherited from class java.io.FilterInputStream

in

Constructor Summary

LineInputStream(java.io.InputStream in)

Method Summary

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

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

Constructor Detail

LineInputStream

public LineInputStream(java.io.InputStream in)

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()

Throws:

java.io.IOException