org.aoju.bus.core.codec

Class Percent

java.lang.Object

org.aoju.bus.core.codec.Percent

All Implemented Interfaces:

Serializable

public class Percent
extends Object
implements Serializable

百分号编码(Percent-encoding), 也称作URL编码(URL encoding) 百分号编码可用于URI的编码，也可以用于"application/x-www-form-urlencoded"的MIME准备数据

• URI：遵循RFC 3986保留字规范
• application/x-www-form-urlencoded，遵循W3C HTML Form content types规范，如空格须转+

Since:

JDK 1.8+

Version:

6.3.5

Author:

Kimi Liu

See Also:

Serialized Form

Constructor Summary

Constructors

Constructor and Description
Percent() 构造 [a-zA-Z0-9]默认不被编码
Percent(BitSet safeCharacters) 构造

Method Summary

Modifier and Type	Method and Description
Percent	addSafe(char c) 增加安全字符 安全字符不被编码
String	encode(CharSequence path, Charset charset) 将URL中的字符串编码为%形式
static Percent	of(CharSequence chars) 创建Percent，使用指定字符串中的字符作为安全字符
static Percent	of(Percent codec) 从已知Percent创建Percent，会复制给定Percent的安全字符
Percent	or(Percent codec) 增加安全字符到挡墙的Percent
Percent	orNew(Percent codec) 组合当前Percent和指定Percent为一个新的Percent，安全字符为并集
Percent	removeSafe(char c) 移除安全字符 安全字符不被编码
Percent	setEncodeSpaceAsPlus(boolean encodeSpaceAsPlus) 是否将空格编码为+

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

Percent

public Percent()

构造 [a-zA-Z0-9]默认不被编码

Percent

public Percent(BitSet safeCharacters)

构造

Parameters:

safeCharacters - 安全字符，安全字符不被编码

Method Detail

of

public static Percent of(Percent codec)

从已知Percent创建Percent，会复制给定Percent的安全字符

Parameters:

codec - Percent

Returns:

this

of

public static Percent of(CharSequence chars)

创建Percent，使用指定字符串中的字符作为安全字符

Parameters:

chars - 安全字符合集

Returns:

this

addSafe

public Percent addSafe(char c)

增加安全字符 安全字符不被编码

Parameters:

c - 字符

Returns:

this

removeSafe

public Percent removeSafe(char c)

移除安全字符 安全字符不被编码

Parameters:

c - 字符

Returns:

this

or

public Percent or(Percent codec)

增加安全字符到挡墙的Percent

Parameters:

codec - Percent

Returns:

this

orNew

public Percent orNew(Percent codec)

组合当前Percent和指定Percent为一个新的Percent，安全字符为并集

Parameters:

codec - Percent

Returns:

this

setEncodeSpaceAsPlus

public Percent setEncodeSpaceAsPlus(boolean encodeSpaceAsPlus)

是否将空格编码为+

Parameters:

encodeSpaceAsPlus - 是否将空格编码为+

Returns:

this

encode

public String encode(CharSequence path,
                     Charset charset)

将URL中的字符串编码为%形式

Parameters:

path - 需要编码的字符串

charset - 编码, null返回原字符串，表示不编码

Returns:

编码后的字符串