org.dmfs.rfc3986

Interface UriEncoded

All Superinterfaces:

java.lang.CharSequence

All Known Subinterfaces:

Fragment, Query

All Known Implementing Classes:

Encoded, FormEncoded, FormPrecoded, IdempotentEncoded, Normalized, Precoded, SimpleFragment, SimpleQuery, Text, XWwwFormUrlEncoded

public interface UriEncoded
extends java.lang.CharSequence

Interface of a percent-encoded CharSequence.

Note that two UriEncoded objects are considered equal if their encoded and normalized values are equal.

All implementations of this must also implement toString() to return a String representation of the encoded value.

Method Summary

Modifier and Type	Method and Description
java.lang.CharSequence	decoded() Returns the decoded text assuming UTF-8 encoding.
java.lang.CharSequence	decoded(java.lang.String charset) Returns the decoded text, using the given charset to decode the non-ASCII characters.
UriEncoded	normalized() Returns a normalized version of this UriEncoded.
UriEncoded	subSequence(int startIndex, int endIndex)
java.lang.String	toString()

Methods inherited from interface java.lang.CharSequence

charAt, chars, codePoints, length

Method Detail

normalized

UriEncoded normalized()

Returns a normalized version of this UriEncoded. In particular that means any percent-encoded unreserved characters are decoded and percent-encoding sequences are converted to uppercase.

Returns:

The normalized version of this UriEncoded.

decoded

java.lang.CharSequence decoded(java.lang.String charset)
                        throws java.io.UnsupportedEncodingException

Returns the decoded text, using the given charset to decode the non-ASCII characters.

Parameters:

charset - The name of the charset.

Returns:

Throws:

java.io.UnsupportedEncodingException

decoded

java.lang.CharSequence decoded()

Returns the decoded text assuming UTF-8 encoding.

Returns:

subSequence

UriEncoded subSequence(int startIndex,
                       int endIndex)

Specified by:

subSequence in interface java.lang.CharSequence

toString

java.lang.String toString()

Specified by:

toString in interface java.lang.CharSequence

Overrides:

toString in class java.lang.Object