Modifier and Type	Class and Description
private static class	UDecoder.DecodeException

Field Summary

Modifier and Type	Field and Description
private static final IOException	EXCEPTION_EOF Unexpected end of data.
private static final IOException	EXCEPTION_NOT_HEX_DIGIT %xx with not-hex digit
private static final IOException	EXCEPTION_SLASH %-encoded slash is forbidden in resource path
private static final StringManager	sm

Constructor Summary

Access	Constructor and Description
public	UDecoder()

Method Summary

Modifier and Type	Method and Description
public void	convert(ByteChunk The URL encoded bytes mb, boolean `true` if this is a query string. For a query string '+' will be decoded to ' ' query) URLDecode, will modify the source.
public void	convert(ByteChunk The URL encoded bytes mb, 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 encodedSolidusHandling) URLDecode, will modify the source.
private void	convert(ByteChunk mb, boolean query, EncodedSolidusHandling encodedSolidusHandling)
private static boolean	isHexDigit(int c)
public static String	Returns: the decoded string URLDecode(String The url-encoded string str, Charset The character encoding to use; if null, UTF-8 is used. charset) Decode and return the specified URL-encoded String.
private static int	x2c(byte b1, byte b2)
private static int	x2c(char b1, char b2)

Inherited from java.lang.Object:: clone equals finalize getClass hashCode notify notifyAll toString wait wait wait

Field Detail

EXCEPTION_EOF	back to summary
private static final IOException EXCEPTION_EOF Unexpected end of data.

EXCEPTION_NOT_HEX_DIGIT	back to summary
private static final IOException EXCEPTION_NOT_HEX_DIGIT %xx with not-hex digit

EXCEPTION_SLASH	back to summary
private static final IOException EXCEPTION_SLASH %-encoded slash is forbidden in resource path

sm	back to summary
private static final StringManager sm

Constructor Detail

UDecoder	back to summary
public UDecoder()

Method Detail

convert back to summary

convert	back to summary
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:ByteChunk The URL encoded bytes query:boolean `true` if this is a query string. For a query string '+' will be decoded to ' ' Exceptions IOException: Invalid %xx URL encoding

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:ByteChunk: The URL encoded bytes
query:boolean: true if this is a query string. For a query string '+' will be decoded to ' '

Exceptions

IOException:: Invalid %xx URL encoding

convert	back to summary
public void convert(ByteChunk mb, EncodedSolidusHandling encodedSolidusHandling) throws IOException URLDecode, will modify the source. Assumes source bytes are encoded using a superset of US-ASCII as per RFC 7230. Parameters mb:ByteChunk The URL encoded bytes encodedSolidusHandling: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 Exceptions IOException: Invalid %xx URL encoding

convert

back to summary

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

URLDecode, will modify the source. Assumes source bytes are encoded using a superset of US-ASCII as per RFC 7230.

Parameters

mb:ByteChunk: The URL encoded bytes
encodedSolidusHandling: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

Exceptions

IOException:: Invalid %xx URL encoding

convert	back to summary
private void convert(ByteChunk mb, boolean query, EncodedSolidusHandling encodedSolidusHandling) throws IOException

isHexDigit	back to summary
private static boolean isHexDigit(int c)

URLDecode	back to summary
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:String The url-encoded string charset:Charset The character encoding to use; if null, UTF-8 is used. Returns:String the decoded string Exceptions IllegalArgumentException: if a '%' character is not followed by a valid 2-digit hexadecimal number

URLDecode

back to summary

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:String: The url-encoded string
charset:Charset: The character encoding to use; if null, UTF-8 is used.

Returns:String

the decoded string

Exceptions

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

x2c	back to summary
private static int x2c(byte b1, byte b2)

x2c	back to summary
private static int x2c(char b1, char b2)

org.apache.tomcat.util.buf back to summary

private Class UDecoder.DecodeException

Class Inheritance

extends CharConversionException

java.lang.Object
java.lang.Throwable
java.lang.Exception
java.io.IOException
java.io.CharConversionException
org.apache.tomcat.util.buf.UDecoder.DecodeException

Field Summary

Modifier and Type	Field and Description
private static final long	serialVersionUID Hides java.io.CharConversionException.serialVersionUID.

Constructor Summary

Access	Constructor and Description
pack-priv	DecodeException(String s)

Method Summary

Modifier and Type	Method and Description
public synchronized Throwable	fillInStackTrace() Overrides java.lang.Throwable.fillInStackTrace. Fills in the execution stack trace.

Field Detail

serialVersionUID	back to summary
private static final long serialVersionUID Hides java.io.CharConversionException.serialVersionUID.

Constructor Detail

DecodeException	back to summary
pack-priv DecodeException(String s)

Method Detail

fillInStackTrace back to summary

fillInStackTrace	back to summary
public synchronized Throwable fillInStackTrace() Overrides java.lang.Throwable.fillInStackTrace. Doc from java.lang.Throwable.fillInStackTrace. Fills in the execution stack trace. This method records within this `Throwable` object information about the current state of the stack frames for the current thread. If the stack trace of this `Throwable` is not writable, calling this method has no effect. Returns:Throwable a reference to this `Throwable` instance. Annotations @Override

public synchronized Throwable fillInStackTrace()

Overrides java.lang.Throwable.fillInStackTrace.

Doc from java.lang.Throwable.fillInStackTrace.

Fills in the execution stack trace. This method records within this Throwable object information about the current state of the stack frames for the current thread.

If the stack trace of this Throwable is not writable, calling this method has no effect.

Returns:Throwable

a reference to this Throwable instance.

Annotations

@Override

public final Class UDecoder

Nested and Inner Type Summary

Field Summary

Constructor Summary

Method Summary

Field Detail

Constructor Detail

Method Detail

private Class UDecoder.DecodeException

Field Summary

Constructor Summary

Method Summary

Field Detail

Constructor Detail

Method Detail