depends.org.apache.http.impl.io

类 AbstractMessageParser<T extends HttpMessage>

java.lang.Object

depends.org.apache.http.impl.io.AbstractMessageParser<T>

所有已实现的接口:

HttpMessageParser<T>

直接已知子类:

DefaultHttpRequestParser, DefaultHttpResponseParser, DefaultHttpResponseParser, DefaultResponseParser, HttpRequestParser, HttpResponseParser

@NotThreadSafe
public abstract class AbstractMessageParser<T extends HttpMessage>
extends java.lang.Object
implements HttpMessageParser<T>

Abstract base class for HTTP message parsers that obtain input from an instance of SessionInputBuffer.

从以下版本开始:

4.0

字段概要

字段

限定符和类型	字段和说明
protected LineParser	lineParser

构造器概要

构造器

构造器和说明
AbstractMessageParser(SessionInputBuffer buffer, LineParser parser, HttpParams params) 已过时。 (4.3) use AbstractMessageParser(SessionInputBuffer, LineParser, MessageConstraints)
AbstractMessageParser(SessionInputBuffer buffer, LineParser lineParser, MessageConstraints constraints) Creates new instance of AbstractMessageParser.

方法概要

方法

限定符和类型	方法和说明
T	parse() Generates an instance of HttpMessage from the underlying data source.
protected abstract T	parseHead(SessionInputBuffer sessionBuffer) Subclasses must override this method to generate an instance of HttpMessage based on the initial input from the session buffer.
static Header[]	parseHeaders(SessionInputBuffer inbuffer, int maxHeaderCount, int maxLineLen, LineParser parser) Parses HTTP headers from the data receiver stream according to the generic format as given in Section 3.1 of RFC 822, RFC-2616 Section 4 and 19.3.
static Header[]	parseHeaders(SessionInputBuffer inbuffer, int maxHeaderCount, int maxLineLen, LineParser parser, java.util.List<CharArrayBuffer> headerLines) Parses HTTP headers from the data receiver stream according to the generic format as given in Section 3.1 of RFC 822, RFC-2616 Section 4 and 19.3.

从类继承的方法 java.lang.Object

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

字段详细资料

lineParser

protected final LineParser lineParser

构造器详细资料

AbstractMessageParser

@Deprecated
public AbstractMessageParser(SessionInputBuffer buffer,
                                LineParser parser,
                                HttpParams params)

已过时。 (4.3) use AbstractMessageParser(SessionInputBuffer, LineParser, MessageConstraints)

Creates an instance of AbstractMessageParser.

参数:

buffer - the session input buffer.

parser - the line parser.

params - HTTP parameters.

AbstractMessageParser

public AbstractMessageParser(SessionInputBuffer buffer,
                     LineParser lineParser,
                     MessageConstraints constraints)

Creates new instance of AbstractMessageParser.

参数:

buffer - the session input buffer.

lineParser - the line parser. If null BasicLineParser.INSTANCE will be used.

constraints - the message constraints. If null MessageConstraints.DEFAULT will be used.

从以下版本开始:

4.3

方法详细资料

parseHeaders

public static Header[] parseHeaders(SessionInputBuffer inbuffer,
                    int maxHeaderCount,
                    int maxLineLen,
                    LineParser parser)
                             throws HttpException,
                                    java.io.IOException

Parses HTTP headers from the data receiver stream according to the generic format as given in Section 3.1 of RFC 822, RFC-2616 Section 4 and 19.3.

参数:

inbuffer - Session input buffer

maxHeaderCount - maximum number of headers allowed. If the number of headers received from the data stream exceeds maxCount value, an IOException will be thrown. Setting this parameter to a negative value or zero will disable the check.

maxLineLen - maximum number of characters for a header line, including the continuation lines. Setting this parameter to a negative value or zero will disable the check.

parser - line parser to use. Can be null, in which case the default implementation of this interface will be used.

返回:

array of HTTP headers

抛出:

java.io.IOException - in case of an I/O error

HttpException - in case of HTTP protocol violation

parseHeaders

public static Header[] parseHeaders(SessionInputBuffer inbuffer,
                    int maxHeaderCount,
                    int maxLineLen,
                    LineParser parser,
                    java.util.List<CharArrayBuffer> headerLines)
                             throws HttpException,
                                    java.io.IOException

Parses HTTP headers from the data receiver stream according to the generic format as given in Section 3.1 of RFC 822, RFC-2616 Section 4 and 19.3.

参数:

inbuffer - Session input buffer

maxHeaderCount - maximum number of headers allowed. If the number of headers received from the data stream exceeds maxCount value, an IOException will be thrown. Setting this parameter to a negative value or zero will disable the check.

maxLineLen - maximum number of characters for a header line, including the continuation lines. Setting this parameter to a negative value or zero will disable the check.

parser - line parser to use.

headerLines - List of header lines. This list will be used to store intermediate results. This makes it possible to resume parsing of headers in case of a InterruptedIOException.

返回:

array of HTTP headers

抛出:

java.io.IOException - in case of an I/O error

HttpException - in case of HTTP protocol violation

从以下版本开始:

4.1

parseHead

protected abstract T parseHead(SessionInputBuffer sessionBuffer)
                                            throws java.io.IOException,
                                                   HttpException,
                                                   ParseException

Subclasses must override this method to generate an instance of HttpMessage based on the initial input from the session buffer.

Usually this method is expected to read just the very first line or the very first valid from the data stream and based on the input generate an appropriate instance of HttpMessage.

参数:

sessionBuffer - the session input buffer.

返回:

HTTP message based on the input from the session buffer.

抛出:

java.io.IOException - in case of an I/O error.

HttpException - in case of HTTP protocol violation.

ParseException - in case of a parse error.

parse

public T parse()
                            throws java.io.IOException,
                                   HttpException

从接口复制的说明: HttpMessageParser

Generates an instance of HttpMessage from the underlying data source.

指定者:

parse 在接口中 HttpMessageParser<T extends HttpMessage>

返回:

HTTP message

抛出:

java.io.IOException - in case of an I/O error

HttpException - in case of HTTP protocol violation