org.apache.http.impl.nio.codecs

Class AbstractMessageParser<T extends HttpMessage>

java.lang.Object

org.apache.http.impl.nio.codecs.AbstractMessageParser<T>

All Implemented Interfaces:

NHttpMessageParser<T>

Direct Known Subclasses:

DefaultHttpRequestParser, DefaultHttpResponseParser, HttpRequestParser, HttpResponseParser

public abstract class AbstractMessageParser<T extends HttpMessage>
extends java.lang.Object
implements NHttpMessageParser<T>

Abstract NHttpMessageParser that serves as a base for all message parser implementations.

Since:

4.0

Field Summary

Fields

Modifier and Type	Field and Description
private static int	COMPLETED
private MessageConstraints	constraints
private boolean	endOfStream
private java.util.List<CharArrayBuffer>	headerBufs
private CharArrayBuffer	lineBuf
protected LineParser	lineParser
private T	message
private static int	READ_HEAD_LINE
private static int	READ_HEADERS
private SessionInputBuffer	sessionBuffer
private int	state

Constructor Summary

Constructors

Constructor and Description
AbstractMessageParser(SessionInputBuffer buffer, LineParser lineParser, HttpParams params) Deprecated. (4.3) use AbstractMessageParser(SessionInputBuffer, LineParser, MessageConstraints)
AbstractMessageParser(SessionInputBuffer buffer, LineParser lineParser, MessageConstraints constraints) Creates an instance of AbstractMessageParser.

Method Summary

Modifier and Type	Method and Description
protected abstract T	createMessage(CharArrayBuffer buffer) Creates HttpMessage instance based on the content of the input buffer containing the first line of the incoming HTTP message.
int	fillBuffer(java.nio.channels.ReadableByteChannel channel) Fills the internal buffer of the parser with input data from the given ReadableByteChannel.
T	parse() Attempts to parse a complete message head from the content of the internal buffer.
private void	parseHeader()
private void	parseHeadLine()
void	reset() Resets the parser.

Methods inherited from class java.lang.Object

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

Field Detail

sessionBuffer

private final SessionInputBuffer sessionBuffer

READ_HEAD_LINE

private static final int READ_HEAD_LINE

See Also:

Constant Field Values

READ_HEADERS

private static final int READ_HEADERS

See Also:

Constant Field Values

COMPLETED

private static final int COMPLETED

See Also:

Constant Field Values

state

private int state

endOfStream

private boolean endOfStream

message

private T extends HttpMessage message

lineBuf

private CharArrayBuffer lineBuf

headerBufs

private final java.util.List<CharArrayBuffer> headerBufs

lineParser

protected final LineParser lineParser

constraints

private final MessageConstraints constraints

Constructor Detail

AbstractMessageParser

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

Deprecated. (4.3) use AbstractMessageParser(SessionInputBuffer, LineParser, MessageConstraints)

Creates an instance of this class.

Parameters:

buffer - the session input buffer.

lineParser - the line parser.

params - HTTP parameters.

AbstractMessageParser

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

Creates an instance of AbstractMessageParser.

Parameters:

buffer - the session input buffer.

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

constraints - Message constraints. If null MessageConstraints.DEFAULT will be used.

Since:

4.3

Method Detail

reset

public void reset()

Description copied from interface: NHttpMessageParser

Resets the parser. The parser will be ready to start parsing another HTTP message.

Specified by:

reset in interface NHttpMessageParser<T extends HttpMessage>

fillBuffer

public int fillBuffer(java.nio.channels.ReadableByteChannel channel)
               throws java.io.IOException

Description copied from interface: NHttpMessageParser

Fills the internal buffer of the parser with input data from the given ReadableByteChannel.

Specified by:

fillBuffer in interface NHttpMessageParser<T extends HttpMessage>

Parameters:

channel - the input channel

Returns:

number of bytes read.

Throws:

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

createMessage

protected abstract T createMessage(CharArrayBuffer buffer)
                            throws HttpException,
                                   ParseException

Creates HttpMessage instance based on the content of the input buffer containing the first line of the incoming HTTP message.

Parameters:

buffer - the line buffer.

Returns:

HTTP message.

Throws:

HttpException - in case of HTTP protocol violation

ParseException - in case of a parse error.

parseHeadLine

private void parseHeadLine()
                    throws HttpException,
                           ParseException

Throws:

HttpException

ParseException

parseHeader

private void parseHeader()
                  throws java.io.IOException

Throws:

java.io.IOException

parse

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

Description copied from interface: NHttpMessageParser

Attempts to parse a complete message head from the content of the internal buffer. If the message in the input buffer is incomplete this method will return null.

Specified by:

parse in interface NHttpMessageParser<T extends HttpMessage>

Returns:

HTTP message head, if available, null otherwise.

Throws:

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

HttpException - in case the HTTP message is malformed or violates the HTTP protocol.