Qu'est-ce que Sqids ?

Sqids est une bibliothèque open source qui vous permet de générer des identifiants courts uniques à partir de nombres. Ces identifiants sont sûrs pour les URL, peuvent encoder plusieurs nombres et ne contiennent pas de mots grossiers courants. Lire la suite .

Voici à quoi ils ressemblent :

https://example.com/Lqj8a0

Exemple rapide d'encodage et de décodage :

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

Si les identifiants sont trop courts, vous pouvez les compléter jusqu'à une certaine longueur :

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

Créer des identifiants uniques en mélangeant l'alphabet :

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

La documentation complète est disponible à https://github.com/sqids/sqids-scala

Si vous recherchez l'Hashids Scala original, vous pouvez le trouver ici : https://github.com/newhoggy/hashids-scala

Cas d'utilisation

L'utilisation principale de Sqids est purement visuelle. Si vous souhaitez utiliser des identifiants au lieu de nombres dans votre projet, Sqids pourrait être un bon choix.

Bons pour

  • Encodage des clés primaires Si vous utilisez une base de données relationnelle
  • Économie de recherches dans la base de données En encodant plusieurs objets
  • Jetons de connexion temporaires Sans grossièretés et sûr pour les URL

Pas bons pour

  • Données sensibles Ce n'est pas une bibliothèque de chiffrement
  • Identifiants utilisateur Peut révéler le nombre d'utilisateurs si quelqu'un découvre l'alphabet de codage

Fonctionnalités

  • 🆔 Générer des identifiants courts à partir de nombres non négatifs
  • Encodage et décodage faciles
  • 🫣 Les identifiants générés ne contiennent pas de grossièretés courantes
  • 🎲 Support des identifiants personnalisés via un alphabet mélangé
  • 🥳 44 intégrations (75% utilisent un nouveau design)
  • 📌 Chaque version produit les mêmes identifiants
  • 🍻 Petite bibliothèque avec une licence permissive

Exemple / Espace de jeu