Package org.eclipse.jetty.util

Class 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

      All Methods Instance Methods Concrete Methods 
      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