Package org.eclipse.jetty.util

Class Utf8LineParser

java.lang.Object

org.eclipse.jetty.util.Utf8LineParser

public class Utf8LineParser
extends java.lang.Object

Stateful parser for lines of UTF8 formatted text, looking for "\n" as a line termination character.

For use with new IO framework that is based on ByteBuffer parsing.

Constructor Summary

Constructors

Constructor	Description
Utf8LineParser()

Method Summary

Modifier and Type	Method	Description
java.lang.String	parse(java.nio.ByteBuffer buf)	Parse a ByteBuffer (could be a partial buffer), and return once a complete line of UTF8 parsed text has been reached.

Methods inherited from class java.lang.Object

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

Constructor Detail

Utf8LineParser

public Utf8LineParser()

Method Detail

parse

public java.lang.String parse(java.nio.ByteBuffer buf)

Parse a ByteBuffer (could be a partial buffer), and return once a complete line of UTF8 parsed text has been reached.

Parameters:

buf - the buffer to parse (could be an incomplete buffer)

Returns:

the line of UTF8 parsed text, or null if no line end termination has been reached within the remaining bytes of the provided ByteBuffer. (In the case of a null, a subsequent ByteBuffer with a line end termination should be provided)

Throws:

Utf8Appendable.NotUtf8Exception - if the input buffer has bytes that do not conform to UTF8 validation (validation performed by Utf8StringBuilder