org.archive.util

Class LaxHttpParser

java.lang.Object

org.archive.util.LaxHttpParser

public class LaxHttpParser
extends java.lang.Object

A Modified version of HttpParser which doesn't throw exceptions on bad header lines A utility class for parsing http header values according to RFC-2616 Section 4 and 19.3.

Since:

2.0beta1

Author:

Michael Becke, Oleg Kalnichevski

Constructor Summary

Constructors

Modifier	Constructor and Description
protected	LaxHttpParser() Constructor for LaxHttpParser.

Method Summary

Modifier and Type	Method and Description
static org.apache.commons.httpclient.Header[]	parseHeaders(java.io.InputStream is) Deprecated. use #parseHeaders(InputStream, String)
static org.apache.commons.httpclient.Header[]	parseHeaders(java.io.InputStream is, java.lang.String charset) Parses headers from the given stream.
static java.lang.String	readLine(java.io.InputStream inputStream) Deprecated. use #readLine(InputStream, String)
static java.lang.String	readLine(java.io.InputStream inputStream, java.lang.String charset) Read up to "\n" from an (unchunked) input stream.
static byte[]	readRawLine(java.io.InputStream inputStream) Return byte array from an (unchunked) input stream.

Methods inherited from class java.lang.Object

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

Constructor Detail

LaxHttpParser

protected LaxHttpParser()

Constructor for LaxHttpParser.

Method Detail

readRawLine

public static byte[] readRawLine(java.io.InputStream inputStream)
                          throws java.io.IOException

Return byte array from an (unchunked) input stream. Stop reading when "\n" terminator encountered If the stream ends before the line terminator is found, the last part of the string will still be returned. If no input data available, null is returned.

Parameters:

inputStream - the stream to read from

Returns:

a byte array from the stream

Throws:

java.io.IOException - if an I/O problem occurs

readLine

public static java.lang.String readLine(java.io.InputStream inputStream,
                                        java.lang.String charset)
                                 throws java.io.IOException

Read up to "\n" from an (unchunked) input stream. If the stream ends before the line terminator is found, the last part of the string will still be returned. If no input data available, null is returned.

Parameters:

inputStream - the stream to read from

charset - charset of HTTP protocol elements

Returns:

a line from the stream

Throws:

java.io.IOException - if an I/O problem occurs

Since:

3.0

readLine

public static java.lang.String readLine(java.io.InputStream inputStream)
                                 throws java.io.IOException

Deprecated. use #readLine(InputStream, String)

Read up to "\n" from an (unchunked) input stream. If the stream ends before the line terminator is found, the last part of the string will still be returned. If no input data available, null is returned

Parameters:

inputStream - the stream to read from

Returns:

a line from the stream

Throws:

java.io.IOException - if an I/O problem occurs

parseHeaders

public static org.apache.commons.httpclient.Header[] parseHeaders(java.io.InputStream is,
                                                                  java.lang.String charset)
                                                           throws java.io.IOException,
                                                                  org.apache.commons.httpclient.HttpException

Parses headers from the given stream. Headers with the same name are not combined.

Parameters:

is - the stream to read headers from

charset - the charset to use for reading the data

Returns:

an array of headers in the order in which they were parsed

Throws:

java.io.IOException - if an IO error occurs while reading from the stream

org.apache.commons.httpclient.HttpException - if there is an error parsing a header value

Since:

3.0

parseHeaders

public static org.apache.commons.httpclient.Header[] parseHeaders(java.io.InputStream is)
                                                           throws java.io.IOException,
                                                                  org.apache.commons.httpclient.HttpException

Deprecated. use #parseHeaders(InputStream, String)

Parses headers from the given stream. Headers with the same name are not combined.

Parameters:

is - the stream to read headers from

Returns:

an array of headers in the order in which they were parsed

Throws:

java.io.IOException - if an IO error occurs while reading from the stream

org.apache.commons.httpclient.HttpException - if there is an error parsing a header value