com.palominolabs.http.url

Class PercentDecoder

java.lang.Object

com.palominolabs.http.url.PercentDecoder

@NotThreadSafe
public final class PercentDecoder
extends java.lang.Object

Decodes percent-encoded (%XX) Unicode text.

Constructor Summary

Constructors

Constructor and Description
PercentDecoder(java.nio.charset.CharsetDecoder charsetDecoder) Construct a new PercentDecoder with default buffer sizes.
PercentDecoder(java.nio.charset.CharsetDecoder charsetDecoder, int initialEncodedByteBufSize, int decodedCharBufSize)

Method Summary

Modifier and Type	Method and Description
java.lang.String	decode(java.lang.CharSequence input)

Methods inherited from class java.lang.Object

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

Constructor Detail

PercentDecoder

public PercentDecoder(@Nonnull
                      java.nio.charset.CharsetDecoder charsetDecoder)

Construct a new PercentDecoder with default buffer sizes.

Parameters:

charsetDecoder - Charset to decode bytes into chars with

See Also:

PercentDecoder(CharsetDecoder, int, int)

PercentDecoder

public PercentDecoder(@Nonnull
                      java.nio.charset.CharsetDecoder charsetDecoder,
                      int initialEncodedByteBufSize,
                      int decodedCharBufSize)

Parameters:

charsetDecoder - Charset to decode bytes into chars with

initialEncodedByteBufSize - Initial size of buffer that holds encoded bytes

decodedCharBufSize - Size of buffer that encoded bytes are decoded into

Method Detail

decode

@Nonnull
public java.lang.String decode(@Nonnull
                                        java.lang.CharSequence input)
                                 throws java.nio.charset.MalformedInputException,
                                        java.nio.charset.UnmappableCharacterException

Parameters:

input - Input with %-encoded representation of characters in this instance's configured character set, e.g. "%20" for a space character

Returns:

Corresponding string with %-encoded data decoded and converted to their corresponding characters

Throws:

java.nio.charset.MalformedInputException - if decoder is configured to report errors and malformed input is detected

java.nio.charset.UnmappableCharacterException - if decoder is configured to report errors and an unmappable character is detected