什么是 Sqids?

Sqids 是一个开源库,可以从数字生成短的唯一标识符。这些标识符是 URL 安全的,可以编码多个数字,并且不包含常见的粗话。 阅读更多 .

这就是它们的样子:

https://example.com/Lqj8a0

快速编码和解码示例:

val sqids = Sqids.default
val id = sqids.encodeUnsafeString(1, 2, 3) // "86Rf07"
val numbers = sqids.decode(id) // List(1, 2, 3)

如果 ID 太短,您可以将它们填充到一定长度:

Sqids
  .withMinLength(10)
  .foreach { sqids =>
    val id = sqids.encodeUnsafeString(1, 2, 3) // "86Rf07xd4z"
    val numbers = sqids.decode(id) // List(1, 2, 3)
  }

通过洗牌字母表创建唯一的 ID:

Alphabet("k3G7QAe51FCsPW92uEOyq4Bg6Sp8YzVTmnU0liwDdHXLajZrfxNhobJIRcMvKt")
  .flatMap(Sqids.forAlphabet)
  .foreach { sqids =>
    val id = sqids.encodeUnsafeString(1, 2, 3) // "XRKUdQ"
    val numbers = sqids.decode(id) // List(1, 2, 3)
  }

完整文档位于 https://github.com/sqids/sqids-scala

如果您正在寻找原始的 Hashids Scala,您可以在这里找到: https://github.com/newhoggy/hashids-scala

用途

Sqids 的主要用途是纯视觉的。如果您想在项目中使用标识符代替数字,Sqids 可能是一个不错的选择。

适用于

  • 编码主键 如果使用关系型数据库
  • 节省数据库查询 通过编码多个对象
  • 临时登录令牌 无粗话,URL 安全

不适用于

  • 敏感数据 这不是加密库
  • 用户 ID 如果有人找到编码字母表,可以显示用户计数

特性

  • 🆔 从非负数生成短 ID
  • 轻松编码和解码
  • 🫣 自动生成的 ID 不包含常见的粗话
  • 🎲 通过洗牌字母表支持自定义 ID
  • 🥳 45 集成 (84% 使用新设计)
  • 📌 每个版本生成相同的 ID
  • 🍻 小型库,采用宽松许可证

示例 / 游乐场