org.dmfs.rfc3986.encoding

Class FormEncoded

java.lang.Object

org.dmfs.rfc3986.encoding.FormEncoded

All Implemented Interfaces:

java.lang.CharSequence, UriEncoded

public final class FormEncoded
extends java.lang.Object
implements UriEncoded

A lazily encoded CharSequence. This encodes all reserved characters and delimiters. The only characters not encoded are "a"-"z", "A"-"Z", "0"-"9", "-", "_", "." and "~".

Note, in contrast to Encoded this encodes spaces as + instead of %20 and normalizes new line squences to %0D%0A.

See Also:

RFC 3986 Section 2.3

Constructor Summary

Constructors

Constructor and Description
FormEncoded(java.lang.CharSequence plain)
FormEncoded(java.lang.CharSequence plain, java.lang.String charSet)

Method Summary

Modifier and Type	Method and Description
char	charAt(int i)
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.
boolean	equals(java.lang.Object obj)
int	hashCode()
int	length()
UriEncoded	normalized() Returns a normalized version of this UriEncoded.
UriEncoded	subSequence(int startIndex, int endIndex)
java.lang.String	toString()

Methods inherited from class java.lang.Object

clone, finalize, getClass, notify, notifyAll, wait, wait, wait

Methods inherited from interface java.lang.CharSequence

chars, codePoints

Constructor Detail

FormEncoded

public FormEncoded(java.lang.CharSequence plain)

FormEncoded

public FormEncoded(java.lang.CharSequence plain,
                   java.lang.String charSet)

Method Detail

normalized

public UriEncoded normalized()

Description copied from interface: UriEncoded

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.

Specified by:

normalized in interface UriEncoded

Returns:

The normalized version of this UriEncoded.

decoded

public java.lang.CharSequence decoded(java.lang.String charset)

Description copied from interface: UriEncoded

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

Specified by:

decoded in interface UriEncoded

Parameters:

charset - The name of the charset.

Returns:

decoded

public java.lang.CharSequence decoded()

Description copied from interface: UriEncoded

Returns the decoded text assuming UTF-8 encoding.

Specified by:

decoded in interface UriEncoded

Returns:

length

public int length()

Specified by:

length in interface java.lang.CharSequence

charAt

public char charAt(int i)

Specified by:

charAt in interface java.lang.CharSequence

subSequence

public UriEncoded subSequence(int startIndex,
                              int endIndex)

Specified by:

subSequence in interface java.lang.CharSequence

Specified by:

subSequence in interface UriEncoded

hashCode

public int hashCode()

Overrides:

hashCode in class java.lang.Object

equals

public boolean equals(java.lang.Object obj)

Overrides:

equals in class java.lang.Object

toString

public java.lang.String toString()

Specified by:

toString in interface java.lang.CharSequence

Specified by:

toString in interface UriEncoded

Overrides:

toString in class java.lang.Object