Class Base32Util

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

public final class Base32Util extends Object
Base32 编解码工具,参考 Apache Commons Codec 的 Base32 设计。

标准 Base32 字母表 A-Z 2-7,每 5 字节编码为 8 字符,默认带 = 填充;解码容忍缺失填充与空白字符。

典型场景:TOTP 密钥、短链接、无歧义编码(无 0/O/1/I/l)。

Since:
1.19.0
Author:
suretool
  • Method Details

    • encode

      public static String encode(byte[] data)
      编码为标准 Base32 字符串(带 = 填充)。

      示例:Base32Util.encode("hello".getBytes(UTF_8)) -> "NBSWY3DP"

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

      public static String encode(byte[] data, boolean padding)
      编码为 Base32 字符串,可选择是否保留 = 填充。

      示例:Base32Util.encode(bytes, false) 尾部无填充。

      Parameters:
      data - 待编码字节,可为 null
      padding - 是否保留 = 填充
      Returns:
      Base32 字符串;null 返回 null
    • encode

      public static String encode(String text, Charset charset)
      字符串按指定字符集编码为 Base32。

      示例:Base32Util.encode("hello", StandardCharsets.UTF_8) -> "NBSWY3DP"

      Parameters:
      text - 字符串,可为 null
      charset - 字符集
      Returns:
      Base32 字符串;null 返回 null
    • decode

      public static byte[] decode(String base32)
      解码 Base32 字符串为字节数组(容忍缺失填充与空白字符)。

      示例:Base32Util.decode("NBSWY3DP") -> "hello" 的 UTF-8 字节

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

      public static boolean isBase32(String base32)
      校验字符串是否为合法 Base32(仅字母 A-Z、数字 2-7 与尾部 = 填充)。

      示例:Base32Util.isBase32("NBSWY3DP") -> true。

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

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

      示例:Base32Util.decodeToString("NBSWY3DP") -> "hello"。

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

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