Class Ascii85Util

java.lang.Object
com.sure.tool.codec.Ascii85Util

public final class Ascii85Util extends Object
Ascii85(Base85)编解码工具,参考 Apache Commons Codec 的 Ascii85 设计。

4 字节编码为 5 个 ASCII 字符(范围 !~u,即 33–117), 4 个连续零字节压缩为单个 z;解码容忍 <~ / ~> 包裹符。

典型场景:PostScript / Adobe 二进制嵌入、紧凑文本传输。

Since:
1.19.0
Author:
suretool
  • Method Details

    • encode

      public static String encode(byte[] data)
      编码为 Ascii85 字符串(不带 <~ / ~> 包裹)。

      示例:Ascii85Util.encode("hello".getBytes(UTF_8)) 为紧凑 Ascii85。

      Parameters:
      data - 待编码字节,可为 null
      Returns:
      Ascii85 字符串;null 返回 null
    • encode

      public static String encode(String text, Charset charset)
      字符串按指定字符集编码为 Ascii85。
      Parameters:
      text - 字符串,可为 null
      charset - 字符集
      Returns:
      Ascii85 字符串;null 返回 null
    • decode

      public static byte[] decode(String ascii85)
      解码 Ascii85 字符串(容忍 <~ / ~> 包裹与 z 零块压缩)。

      示例:Ascii85Util.decode("<~...~>") 返回原始字节。

      Parameters:
      ascii85 - Ascii85 字符串,可为 null
      Returns:
      解码字节数组;null 返回 null
      Throws:
      IllegalArgumentException - 含非法字符或长度无效
    • isAscii85

      public static boolean isAscii85(String ascii85)
      校验字符串是否为合法 Ascii85(仅字符 33–117 与 z,可带 <~ / ~> 包裹)。

      示例:Ascii85Util.isAscii85("<~87cURD_*#TDfTZ)+T~>") -> true。

      Parameters:
      ascii85 - 字符串,可为 null
      Returns:
      合法返回 true;null 或空串返回 false
    • decodeToString

      public static String decodeToString(String ascii85)
      解码 Ascii85 字符串为字符串(UTF-8)。

      示例:Ascii85Util.decodeToString(...)。

      Parameters:
      ascii85 - Ascii85 字符串,可为 null
      Returns:
      解码字符串;null 返回 null
    • decodeToString

      public static String decodeToString(String ascii85, Charset charset)
      解码 Ascii85 字符串为字符串(指定字符集)。
      Parameters:
      ascii85 - Ascii85 字符串,可为 null
      charset - 字符集
      Returns:
      解码字符串;null 返回 null