org.apache.commons.httpclient

Class HttpParser

public class HttpParser extends Object

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

Method Summary
static Header[]parseHeaders(InputStream is, String charset)
Parses headers from the given stream.
static Header[]parseHeaders(InputStream is)
Parses headers from the given stream.
static StringreadLine(InputStream inputStream, String charset)
Read up to "\n" from an (unchunked) input stream.
static StringreadLine(InputStream inputStream)
Read up to "\n" from an (unchunked) input stream.
static byte[]readRawLine(InputStream inputStream)
Return byte array from an (unchunked) input stream.

Method Detail

parseHeaders

public static Header[] parseHeaders(InputStream is, String charset)
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: IOException if an IO error occurs while reading from the stream HttpException if there is an error parsing a header value

Since: 3.0

parseHeaders

public static Header[] parseHeaders(InputStream is)

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: IOException if an IO error occurs while reading from the stream HttpException if there is an error parsing a header value

readLine

public static String readLine(InputStream inputStream, String charset)
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: IOException if an I/O problem occurs

Since: 3.0

readLine

public static String readLine(InputStream inputStream)

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: IOException if an I/O problem occurs

readRawLine

public static byte[] readRawLine(InputStream inputStream)
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: IOException if an I/O problem occurs

Copyright (c) 1999-2005 - Apache Software Foundation