Module org.eclipse.jetty.util

Package org.eclipse.jetty.util

Interface CharsetStringBuilder

All Known Implementing Classes:

CharsetStringBuilder.DecoderStringBuilder, CharsetStringBuilder.Iso88591StringBuilder, CharsetStringBuilder.ReportingUtf8StringBuilder, CharsetStringBuilder.UsAsciiStringBuilder, Utf8StringBuilder

public interface CharsetStringBuilder

Build a string from a sequence of bytes.

Implementations of this interface are optimized for processing a mix of calls to already decoded character based appends (e.g. append(char) and calls to undecoded byte methods (e.g. append(byte). This is particularly useful for decoding % encoded strings that are mostly already decoded but may contain escaped byte sequences that are not decoded. The standard CharsetDecoder API is not well suited for this use-case.

Any coding errors in the string will be reported by a CharacterCodingException thrown from the build() method.

See Also:

• for UTF-8 decoding with replacement of coding errors and/or fast fail behaviour.
• for decoding arbitrary Charsets with control over CodingErrorAction.

Nested Class Summary

Nested Classes

Modifier and Type	Interface	Description
static class	CharsetStringBuilder.DecoderStringBuilder
static class	CharsetStringBuilder.Iso88591StringBuilder
static class	CharsetStringBuilder.ReportingUtf8StringBuilder	Extended Utf8StringBuilder that mimics CodingErrorAction.REPORT behaviour for CharsetStringBuilder methods.
static class	CharsetStringBuilder.UsAsciiStringBuilder

Method Summary

Modifier and Type	Method	Description
void	append(byte b)
default void	append(byte[] bytes)
default void	append(byte[] b, int offset, int length)
void	append(char c)
default void	append(CharSequence chars, int offset, int length)
default void	append(ByteBuffer buf)
String	build()	Build the completed string and reset the buffer.
static CharsetStringBuilder	forCharset(Charset charset)
void	reset()

Method Details

append

void append(byte b)

append

void append(char c)

append

default void append(byte[] bytes)

append

default void append(byte[] b,
 int offset,
 int length)

append

default void append(CharSequence chars,
 int offset,
 int length)

append

default void append(ByteBuffer buf)

build

String build()
      throws CharacterCodingException

Build the completed string and reset the buffer.

Returns:

The decoded built string which must be complete in regard to any multibyte sequences.

Throws:

CharacterCodingException - If the bytes cannot be correctly decoded or a multibyte sequence is incomplete.

reset

void reset()

forCharset

static CharsetStringBuilder forCharset(Charset charset)