复用CharsetEncoder实例、预估缓冲区大小、配置错误策略并避免新建对象是高性能编码的关键:使用ThreadLocal缓存编码器,按maxBytesPerChar()预分配ByteBuffer,用CharBuffer.wrap()零拷贝,设置CodingErrorAction容错。

用 CharsetEncoder 实现变量字符串的高性能编码,关键在于复用编码器实例、预估缓冲区大小、合理配置错误策略,并避免每次编码都新建对象。
复用编码器而非每次都 newEncoder()
CharsetEncoder 不是线程安全的,但可以在单线程中重复使用。频繁调用 charset.newEncoder() 会带来对象创建开销和 GC 压力。建议初始化一次并复用:
- 将 encoder 声明为局部常量或线程内缓存对象(如 ThreadLocal)
- 调用 onMalformedInput() 和 onUnmappableCharacter() 配置策略后,不再重新构造
- 注意:encoder 状态不可重入,每次 encode 前需确保输入 CharBuffer 已 flip(),且 ByteBuffer 可写
预分配合适容量的 ByteBuffer
避免 ByteBuffer 扩容带来的内存拷贝。可通过 encoder.maxBytesPerChar() 估算上限:
- 对 UTF-8:maxBytesPerChar() = 4,所以 capacity ≈ input.length() × 4
- 对 ISO-8859-1:maxBytesPerChar() = 1,可直接用 input.length()
- 更精确的做法是调用 encoder.encode(CharBuffer, ByteBuffer, boolean) 的返回值 CoderResult 判断是否溢出,再扩容重试(适用于长度不确定场景)
控制异常行为,避免中断流程
默认策略可能抛出 CharacterCodingException,影响吞吐。按需设置容错机制:
- CodingErrorAction.REPLACE:替换非法字符(如用 '_' 或 '?')
- CodingErrorAction.IGNORE:跳过无法处理的字符
- CodingErrorAction.REPORT:仅报告错误,需手动处理 CoderResult
- 搭配 replaceWith(new byte[]{(byte)'_'}) 可自定义替换字节序列
配合 CharBuffer.wrap() 减少内存复制
对已知字符串做编码时,优先用 CharBuffer.wrap(str) 而非 allocate + put:
- wrap 是零拷贝视图,不额外分配 char[] 数组
- 若字符串后续还会复用,该方式更省内存
- 注意 wrap 后仍需调用 flip() 设置 limit,否则 encode 可能读不到内容











