Package org.dellroad.msrp.msg

Class MsrpInputParser

java.lang.Object

org.dellroad.msrp.msg.MsrpInputParser

public class MsrpInputParser
extends Object

Stateful MSRP message parser.

Instances are configured with various size limits to avoid unbounded memory usage.

Field Summary

Fields

Modifier and Type	Field	Description
static int	DEFAULT_MAX_CONTENT_LENGTH	Default maximum content length (16777216)
static int	DEFAULT_MAX_EXTENSION_HEADERS	Default maximum number of extension headers (32)
static int	DEFAULT_MAX_LINE_LENGTH	Default maximum line length in bytes (16384)
static int	DEFAULT_MAX_MIME_HEADERS	Default maximum number of MIME headers length (16)
static int	DEFAULT_MAX_PATH_URIS	Default maximum number of URIs in To-Path or From-Path (32)

Constructor Summary

Constructors

Constructor	Description
MsrpInputParser()	Constructor.
MsrpInputParser(int maxLineLength, int maxBodySize, int maxPathUris, int maxMimeHeaders, int maxExtensionHeaders)	Primary constructor.

Method Summary

Modifier and Type	Method	Description
MsrpMessage	inputMessageByte(byte b)	Input the next byte.
boolean	isBetweenMessages()	Determine whether this instance is sitting at a message boundary.
void	reset()	Reset parse state.

Methods inherited from class java.lang.Object

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

Field Detail

DEFAULT_MAX_LINE_LENGTH

public static final int DEFAULT_MAX_LINE_LENGTH

Default maximum line length in bytes (16384)

See Also:

Constant Field Values

DEFAULT_MAX_CONTENT_LENGTH

public static final int DEFAULT_MAX_CONTENT_LENGTH

Default maximum content length (16777216)

See Also:

Constant Field Values

DEFAULT_MAX_PATH_URIS

public static final int DEFAULT_MAX_PATH_URIS

Default maximum number of URIs in To-Path or From-Path (32)

See Also:

Constant Field Values

DEFAULT_MAX_MIME_HEADERS

public static final int DEFAULT_MAX_MIME_HEADERS

Default maximum number of MIME headers length (16)

See Also:

Constant Field Values

DEFAULT_MAX_EXTENSION_HEADERS

public static final int DEFAULT_MAX_EXTENSION_HEADERS

Default maximum number of extension headers (32)

See Also:

Constant Field Values

Constructor Detail

MsrpInputParser

public MsrpInputParser()

Constructor. Uses default size limits.

MsrpInputParser

public MsrpInputParser(int maxLineLength,
                       int maxBodySize,
                       int maxPathUris,
                       int maxMimeHeaders,
                       int maxExtensionHeaders)

Primary constructor.

Parameters:

maxLineLength - maximum allowed header line length in bytes

maxBodySize - maximum allowed body size in bytes

maxPathUris - maximum number of URI's allowed in To-Path or From-Path header

maxMimeHeaders - maximum number of allowed MIME headers

maxExtensionHeaders - maximum number of allowed extension headers

Throws:

IllegalArgumentException - if input is null

Method Detail

inputMessageByte

public MsrpMessage inputMessageByte(byte b)
                             throws ProtocolException

Input the next byte.

Parameters:

b - input byte

Returns:

next complete message, or null if more bytes are needed

Throws:

ProtocolException - if a protocol violation is detected

reset

public void reset()

Reset parse state.

isBetweenMessages

public boolean isBetweenMessages()

Determine whether this instance is sitting at a message boundary.

This will be true after initial construction, an invocation of reset(), or an invocation inputMessageByte() that returned a non-null value.

Returns:

true if positioned at a message boundary