本文共 1177 字，大约阅读时间需要 3 分钟。

Java哈希ID生成工具：生成短可解码唯一哈希值

功能介绍

哈希ID特性

• 唯一性：每个哈希值由盐值决定，确保绝对唯一。
• 可解码性：哈希值可以转换回原始整数。
• 多数字支持：处理单个或多个整数，适合复杂或集群环境。
• 自定义哈希长度：用户可指定最小长度，确保一致性。
• 干净哈希值：避免包含常见的英文诅咒词，适合出现在公网中的URL。
• 自定义字母：支持指定哈希字母集合，提高可读性和唯一性。

如何使用

添加依赖：在项目中添加相应的JAR文件。

导入包：使用import org.hashids;。

编码与解码示例

编码

Hashids hashids = new Hashids("这是我的盐");String hash = hashids.encode(12345L);

输出：NkK9

解码

long[] numbers = hashids.decode("NkK9");

输出：[12345]

使用不同盐值

更换盐值后，解码将失效，确保盐值保密。

编码多个数字

String hash = hashids.encode(683L, 94108L, 123L, 5L);

哈希值：aBMswoO2UB3Sj

建议哈希长度

默认长度为0，表示最短。指定长度8：

Hashids hashids = new Hashids("这是我的盐", 8);String hash = hashids.encode(1L);

哈希值：gB0NV05e

自定义字母

Hashids hashids = new Hashids("这是我的盐", 0, "0123456789abcdef");String hash = hashids.encode(1234567L);

哈希值：b332db5

哈希值示例

• 编码数字：5L, 5L, 5L, 5L

  哈希值：1Wc8cwcE

• 编码连续数字1-10：

  哈希值：kRHnurhptKcjIDTWC3sx

哈希值特性

• 无干扰性：输出不易猜测，适合随机化URL。
• 高效性：快速处理大数字，解决性能问题。

局限性

• 原生实现对大数字有限制，需符合Long范围。
• 解码时依赖盐值，确保盐值安全。

Java哈希ID工具为开发者提供了一种简单灵活的途径，确保生成短但唯一的可解码哈希值，满足URL短ening和私有化需求。