什么是 Sqids?

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

这就是它们的样子:

https://example.com/Lqj8a0

快速编码和解码示例:

val sqids = Sqids()
val id = sqids.encode(listOf<Long>(1, 2, 3)) // "86Rf07"
val numbers = sqids.decode(id) // [1, 2, 3]

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

val sqids = Sqids(minLength = 10)
val id = sqids.encode(listOf<Long>(1, 2, 3)) // "86Rf07xd4z"
val numbers = sqids.decode(id) // [1, 2, 3]

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

val sqids = Sqids(alphabet = "k3G7QAe51FCsPW92uEOyq4Bg6Sp8YzVTmnU0liwDdHXLajZrfxNhobJIRcMvKt")
val id = sqids.encode(listOf<Long>(1, 2, 3)) // "XRKUdQ"
val numbers = sqids.decode(id) // [1, 2, 3]

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

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

用途

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

适用于

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

不适用于

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

特性

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

示例 / 游乐场