Field Detail

• ALLOW_ENCODED_SLASH

  @Deprecated
  public static final boolean ALLOW_ENCODED_SLASH

  Deprecated. 

Constructor Detail

• UDecoder

  public UDecoder()

Method Detail

• convert

  public void convert(ByteChunk mb,
             boolean query)
               throws IOException

  URLDecode, will modify the source. Assumes source bytes are encoded using a superset of US-ASCII as per RFC 7230. "%2f" will be rejected unless the input is a query string.

  Parameters:

  mb - The URL encoded bytes

  query - true if this is a query string. For a query string '+' will be decoded to ' '

  Throws:

  IOException - Invalid %xx URL encoding

• convert

  @Deprecated
  public void convert(ByteChunk mb)
               throws IOException

  Deprecated. Unused. Will be removed in Tomcat 8.0.x onwards.
  URLDecode, will modify the source. Assumes source bytes are encoded using a superset of US-ASCII as per RFC 7230.

  Parameters:

  mb - The URL encoded bytes

  Throws:

  IOException - Invalid %xx URL encoding

• convert

  public void convert(ByteChunk mb,
             EncodedSolidusHandling encodedSolidusHandling)
               throws IOException

  Parameters:

  mb - The URL encoded bytes

  encodedSolidusHandling - How should the %2f sequence handled by the decoder? For query strings this parameter will be ignored and the %2f sequence will be decoded

  Throws:

  IOException - Invalid %xx URL encoding

• convert

  @Deprecated
  public void convert(CharChunk mb)
               throws IOException

  Deprecated. Unused. Will be removed in Tomcat 8.0.x onwards.
  In-buffer processing - the buffer will be modified.

  WARNING: This method assumes US-ASCII encoding.

  Parameters:

  mb - The URL encoded chars

  Throws:

  IOException - Invalid %xx URL encoding

• convert

  @Deprecated
  public void convert(CharChunk mb,
                        boolean query)
               throws IOException

  Deprecated. Unused. Will be removed in Tomcat 10
  In-buffer processing - the buffer will be modified.

  Parameters:

  mb - The URL encoded chars

  query - true if this is a query string

  Throws:

  IOException - Invalid %xx URL encoding

• convert

  @Deprecated
  public void convert(MessageBytes mb)
               throws IOException

  Deprecated. Unused. Will be removed in Tomcat 8.0.x onwards.
  URLDecode, will modify the source Includes converting '+' to ' '.

  Parameters:

  mb - The URL encoded String, bytes or chars

  Throws:

  IOException - Invalid %xx URL encoding

• convert

  @Deprecated
  public void convert(MessageBytes mb,
                        boolean query)
               throws IOException

  Deprecated. Unused. Will be removed in Tomcat 10
  URLDecode, will modify the source

  WARNING: This method assumes US-ASCII encoding.

  Parameters:

  mb - The URL encoded String, bytes or chars

  query - true if this is a query string

  Throws:

  IOException - Invalid %xx URL encoding

• convert

  @Deprecated
  public final String convert(String str)

  Deprecated. Unused. Will be removed in Tomcat 8.0.x onwards.
  %xx decoding of a query string. FIXME: this is inefficient.

  Parameters:

  str - The URL encoded string

  Returns:

  the decoded string

• convert

  @Deprecated
  public final String convert(String str,
                          boolean query)

  Deprecated. Will be removed in Tomcat 10
  %xx decoding of a string.

  WARNING: This method assumes US-ASCII encoding.

  FIXME: this is inefficient.

  Parameters:

  str - The URL encoded string

  query - true if this is a query string

  Returns:

  the decoded string

• URLDecode

  @Deprecated
  public static String URLDecode(String str)

  Deprecated. Unused. This will be removed in Tomcat 10 onwards
  Decode and return the specified URL-encoded String. When the byte array is converted to a string, UTF-8 is used. This may be different than some other servers. It is assumed the string is not a query string.

  Parameters:

  str - The url-encoded string

  Returns:

  the decoded string

  Throws:

  IllegalArgumentException - if a '%' character is not followed by a valid 2-digit hexadecimal number

• URLDecode

  public static String URLDecode(String str,
                 Charset charset)

  Decode and return the specified URL-encoded String. It is assumed the string is not a query string.

  Parameters:

  str - The url-encoded string

  charset - The character encoding to use; if null, UTF-8 is used.

  Returns:

  the decoded string

  Throws:

  IllegalArgumentException - if a '%' character is not followed by a valid 2-digit hexadecimal number