Field Detail

• UTF8

  private static final java.nio.charset.Charset UTF8

• decoder

  private final java.nio.charset.CharsetDecoder decoder

• stringBuilder

  @CheckForNull
  private java.lang.StringBuilder stringBuilder

Constructor Detail

• UriDecoder

  public UriDecoder()

  Constructs a new URI decoder which uses the UTF-8 character set to decode non-US-ASCII characters.

• UriDecoder

  public UriDecoder(java.nio.charset.Charset charset)

  Constructs a new URI decoder which uses the given character set to decode non-US-ASCII characters.

  Parameters:

  charset - the character set to use for decoding non-US-ASCII characters. Note that using any other character set than UTF-8 should void interoperability with most applications!

Method Detail

• dequote

  private static int dequote(java.nio.CharBuffer eC)

• dequote

  private static int dequote(char ec)

• decode

  public java.lang.String decode(java.lang.String eS)

  Decodes all escape sequences in the string eS, that is, each occurence of "%XX", where X is a hexadecimal digit, gets substituted with the corresponding single byte and the resulting string gets decoded using the character set provided to the constructor.

  Parameters:

  eS - the encoded string to decode.

  Returns:

  The decoded string.

  Throws:

  java.lang.IllegalArgumentException - on any decoding error with a URISyntaxException as its cause.

• decode

  @CheckForNull
  public java.lang.StringBuilder decode(java.lang.String eS,
                                            @CheckForNull
                                            java.lang.StringBuilder dS)
                                 throws java.net.URISyntaxException

  Decodes all escape sequences in the string eS, that is, each occurence of "%XX", where X is a hexadecimal digit, gets substituted with the corresponding single byte and the resulting string gets decoded to the string builder dS using the character set provided to the constructor.

  Parameters:

  eS - the encoded string to decode.

  dS - the string builder to which all decoded characters shall get appended.

  Returns:

  If eS contains no escape sequences, then null gets returned. Otherwise, if dS is not null, then it gets returned with all decoded characters appended to it. Otherwise, a temporary string builder gets returned which solely contains all decoded characters. This temporary string builder may get cleared and reused upon the next call to any method of this object.

  Throws:

  java.net.URISyntaxException - on any decoding error. This exception will leave eS in an undefined state.