Package org.aoju.bus.core.codec

Class Percent

java.lang.Object

org.aoju.bus.core.codec.Percent

All Implemented Interfaces:

Serializable, Encoder<byte[],byte[]>

public class Percent
extends Object
implements Encoder<byte[],byte[]>, 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:

Java 17+

Author:

Kimi Liu

See Also:

• Serialized Form

Nested Class Summary

Nested Classes

Modifier and Type	Class	Description
static class	Percent.Builder	Percent构建器 由于Percent本身应该是只读对象，因此将此对象的构建放在Builder中

Constructor Summary

Constructors

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

Method Summary

Modifier and Type	Method	Description
byte[]	encode(byte[] bytes)	执行编码
String	encode(CharSequence path, Charset charset, char... customSafeChar)	将URL中的字符串编码为%形式
boolean	isSafe(char c)	检查给定字符是否为安全字符

Methods inherited from class java.lang.Object

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

Constructor Details

Percent

public Percent()

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

Percent

public Percent(BitSet safeCharacters)

构造

Parameters:

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

Method Details

isSafe

public boolean isSafe(char c)

检查给定字符是否为安全字符

Parameters:

c - 字符

Returns:

true表示安全，否则非安全字符

encode

public byte[] encode(byte[] bytes)

Description copied from interface: Encoder

执行编码

Specified by:

encode in interface Encoder<byte[],byte[]>

Parameters:

bytes - 被编码的数据

Returns:

编码后的数据

encode

public String encode(CharSequence path,
 Charset charset,
 char... customSafeChar)

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

Parameters:

path - 需要编码的字符串

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

customSafeChar - 自定义安全字符

Returns:

编码后的字符串