org.dromara.hutool.core.codec

类 PercentCodec

java.lang.Object

org.dromara.hutool.core.codec.PercentCodec

所有已实现的接口:

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

public class PercentCodec
extends Object
implements Encoder<byte[],byte[]>, Serializable

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

百分号编码会对 URI 中不允许出现的字符或者其他特殊情况的允许的字符进行编码，对于被编码的字符，最终会转为以百分号"%“开头，后面跟着两位16进制数值的形式。 举个例子，空格符（SP）是不允许的字符，在 ASCII 码对应的二进制值是"00100000”，最终转为"%20"。

对于不同场景应遵循不同规范：

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

作者:

looly

从以下版本开始:

5.7.16

另请参阅:

序列化表格

嵌套类概要

嵌套类

限定符和类型	类和说明
static class	PercentCodec.Builder PercentCodec构建器 由于PercentCodec本身应该是只读对象，因此将此对象的构建放在Builder中

构造器概要

构造器

构造器和说明
PercentCodec() 构造 [a-zA-Z0-9]默认不被编码
PercentCodec(BitSet safeCharacters) 构造

方法概要

限定符和类型	方法和说明
byte[]	encode(byte[] bytes) 执行编码
String	encode(CharSequence path, Charset charset, char... customSafeChar) 将URL中的字符串编码为%形式
boolean	isSafe(char c) 检查给定字符是否为安全字符

从类继承的方法 java.lang.Object

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

构造器详细资料

PercentCodec

public PercentCodec()

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

PercentCodec

public PercentCodec(BitSet safeCharacters)

构造

参数:

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

方法详细资料

isSafe

public boolean isSafe(char c)

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

参数:

c - 字符

返回:

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

从以下版本开始:

6.0.0

encode

public byte[] encode(byte[] bytes)

从接口复制的说明: Encoder

执行编码

指定者:

encode 在接口中 Encoder<byte[],byte[]>

参数:

bytes - 被编码的数据

返回:

编码后的数据

encode

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

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

参数:

path - 需要编码的字符串

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

customSafeChar - 自定义安全字符

返回:

编码后的字符串