io.netty.util

Class CharsetUtil

java.lang.Object

io.netty.util.CharsetUtil

public final class CharsetUtil
extends Object

A utility class that provides various common operations and constants related with Charset and its relevant classes.

Field Summary

Fields

Modifier and Type	Field and Description
static Charset	ISO_8859_1 ISO Latin Alphabet No. 1, as known as ISO-LATIN-1
static Charset	US_ASCII 7-bit ASCII, as known as ISO646-US or the Basic Latin block of the Unicode character set
static Charset	UTF_16 16-bit UTF (UCS Transformation Format) whose byte order is identified by an optional byte-order mark
static Charset	UTF_16BE 16-bit UTF (UCS Transformation Format) whose byte order is big-endian
static Charset	UTF_16LE 16-bit UTF (UCS Transformation Format) whose byte order is little-endian
static Charset	UTF_8 8-bit UTF (UCS Transformation Format)

Method Summary

Modifier and Type	Method and Description
static CharsetDecoder	decoder(Charset charset) Returns a cached thread-local CharsetDecoder for the specified Charset.
static CharsetDecoder	decoder(Charset charset, CodingErrorAction codingErrorAction) Returns a new CharsetDecoder for the Charset with the specified error action.
static CharsetDecoder	decoder(Charset charset, CodingErrorAction malformedInputAction, CodingErrorAction unmappableCharacterAction) Returns a new CharsetDecoder for the Charset with specified error actions.
static CharsetEncoder	encoder(Charset charset) Returns a cached thread-local CharsetEncoder for the specified Charset.
static CharsetEncoder	encoder(Charset charset, CodingErrorAction codingErrorAction) Returns a new CharsetEncoder for the Charset with the specified error action.
static CharsetEncoder	encoder(Charset charset, CodingErrorAction malformedInputAction, CodingErrorAction unmappableCharacterAction) Returns a new CharsetEncoder for the Charset with specified error actions.
static CharsetDecoder	getDecoder(Charset charset) Deprecated. Use decoder(Charset).
static CharsetEncoder	getEncoder(Charset charset) Deprecated. Use encoder(Charset).
static Charset[]	values()

Methods inherited from class java.lang.Object

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

Field Detail

UTF_16

public static final Charset UTF_16

16-bit UTF (UCS Transformation Format) whose byte order is identified by an optional byte-order mark

UTF_16BE

public static final Charset UTF_16BE

16-bit UTF (UCS Transformation Format) whose byte order is big-endian

UTF_16LE

public static final Charset UTF_16LE

16-bit UTF (UCS Transformation Format) whose byte order is little-endian

UTF_8

public static final Charset UTF_8

8-bit UTF (UCS Transformation Format)

ISO_8859_1

public static final Charset ISO_8859_1

ISO Latin Alphabet No. 1, as known as ISO-LATIN-1

US_ASCII

public static final Charset US_ASCII

7-bit ASCII, as known as ISO646-US or the Basic Latin block of the Unicode character set

Method Detail

values

public static Charset[] values()

getEncoder

@Deprecated
public static CharsetEncoder getEncoder(Charset charset)

Deprecated. Use encoder(Charset).

encoder

public static CharsetEncoder encoder(Charset charset,
                                     CodingErrorAction malformedInputAction,
                                     CodingErrorAction unmappableCharacterAction)

Returns a new CharsetEncoder for the Charset with specified error actions.

Parameters:

charset - The specified charset

malformedInputAction - The encoder's action for malformed-input errors

unmappableCharacterAction - The encoder's action for unmappable-character errors

Returns:

The encoder for the specified charset

encoder

public static CharsetEncoder encoder(Charset charset,
                                     CodingErrorAction codingErrorAction)

Returns a new CharsetEncoder for the Charset with the specified error action.

Parameters:

charset - The specified charset

codingErrorAction - The encoder's action for malformed-input and unmappable-character errors

Returns:

The encoder for the specified charset

encoder

public static CharsetEncoder encoder(Charset charset)

Returns a cached thread-local CharsetEncoder for the specified Charset.

Parameters:

charset - The specified charset

Returns:

The encoder for the specified charset

getDecoder

@Deprecated
public static CharsetDecoder getDecoder(Charset charset)

Deprecated. Use decoder(Charset).

decoder

public static CharsetDecoder decoder(Charset charset,
                                     CodingErrorAction malformedInputAction,
                                     CodingErrorAction unmappableCharacterAction)

Returns a new CharsetDecoder for the Charset with specified error actions.

Parameters:

charset - The specified charset

malformedInputAction - The decoder's action for malformed-input errors

unmappableCharacterAction - The decoder's action for unmappable-character errors

Returns:

The decoder for the specified charset

decoder

public static CharsetDecoder decoder(Charset charset,
                                     CodingErrorAction codingErrorAction)

Returns a new CharsetDecoder for the Charset with the specified error action.

Parameters:

charset - The specified charset

codingErrorAction - The decoder's action for malformed-input and unmappable-character errors

Returns:

The decoder for the specified charset

decoder

public static CharsetDecoder decoder(Charset charset)

Returns a cached thread-local CharsetDecoder for the specified Charset.

Parameters:

charset - The specified charset

Returns:

The decoder for the specified charset