Documentation développeur
Java
Mis à jour le 19 septembre 2026

Générer et manipuler des GUID en Java

Générez, analysez, formatez et validez des valeurs GUID/UUID en Java.

GUID est le terme couramment utilisé dans l’écosystème Microsoft pour un identifiant global unique de 128 bits. Sa forme textuelle canonique est compatible avec le format UUID, même si certaines plateformes proposent des formats GUID supplémentaires.

Démarrage rapide#

L’exemple suivant utilise l’API standard de Java ou une bibliothèque couramment utilisée pour cette tâche.

Exemple#

Java
1import java.util.UUID;23UUID id = UUID.randomUUID();4System.out.println(id);

Opérations courantes#

Ce second exemple couvre une opération fréquente en production ou une manière plus sûre de traiter des entrées réelles.

Variante courante#

Java
1try {2    UUID parsed = UUID.fromString(input);3    System.out.println(parsed.toString());4} catch (IllegalArgumentException ex) {5    System.out.println("Invalid GUID/UUID");6}

Points importants#

Validez les identifiants reçus de l’extérieur et utilisez la forme canonique avec tirets pour l’interopérabilité entre plateformes.

Bonnes pratiques#

  1. Considérez toute entrée externe comme non fiable et gérez explicitement les erreurs d’analyse ou de validation.
  2. Rendez explicites l’encodage, les unités, les formats et les conventions propres aux bibliothèques aux frontières du système.
  3. Ajoutez des tests couvrant l’entrée vide, le texte Unicode, les entrées invalides et des données représentatives de la production.

Références#

Implémenter GUID dans d'autres langages :