Validatore UUID

Il validatore del formato UUID controlla che un valore rispetti la rappresentazione UUID standard di 36 caratteri con trattini e spiega con precisione perché un dato non valido viene rifiutato. Se il controllo riesce, restituisce la forma canonica normalizzata in minuscolo, la variante codificata nei bit della sequenza di clock e la versione registrata nell’UUID. Accetta lettere esadecimali maiuscole e minuscole, senza tollerare automaticamente parentesi graffe, stringhe compatte, separatori fuori posizione o caratteri non esadecimali.

Che cosa controlla questo validatore UUID

Un UUID contiene 128 bit, ma persone e sistemi normalmente lo scambiano come 36 caratteri visibili organizzati in cinque gruppi: otto caratteri esadecimali, poi quattro, quattro, quattro e dodici, separati da trattini. Questo validatore controlla esattamente tale rappresentazione. Verifica la lunghezza complessiva, conferma che ogni separatore si trovi nella posizione corretta e rifiuta qualsiasi carattere diverso da una cifra esadecimale o un trattino.

Le lettere esadecimali possono essere maiuscole o minuscole, perché il tipo di carattere non modifica i bit sottostanti. Spazi, parentesi graffe, prefissi URN, valori compatti di 32 caratteri e punteggiatura finale non vengono rimossi di nascosto. La convalida è deterministica: non consulta registri esterni, non genera un sostituto e non afferma che l’UUID esista in altri sistemi.

Come vengono decodificate variante e versione

I metadati di un UUID sono codificati nell’identificatore stesso e non vengono cercati altrove. La versione è la cifra esadecimale all’inizio del terzo gruppo: il validatore la converte in un numero intero da 0 a 15 e la restituisce direttamente. Tra le versioni assegnate più comuni vi sono la versione 1 basata sul tempo, le versioni 3 e 5 basate sul nome, la versione 4 casuale, la versione 6 con tempo riordinato, la versione 7 con tempo Unix e la versione 8 personalizzata.

La variante deriva dai bit iniziali del quarto gruppo. Descrivere i bit è diverso dall’imporre un profilo applicativo. Un UUID strutturalmente corretto può contenere una versione riservata o una variante storica.

Lo strumento descrive quindi ciò che il valore codifica, senza sostenere che ogni UUID ben formato debba appartenere alla versione 4. La Sua applicazione potrà poi applicare la propria politica ai campi restituiti.

Canonizzazione, errori e impiego pratico

La canonizzazione modifica soltanto maiuscole e minuscole delle lettere esadecimali: i cinque gruppi e tutte le cifre restano intatti, mentre le lettere da A a F diventano minuscole. Due grafie accettate dello stesso valore a 128 bit producono così la medesima stringa canonica. Il validatore non elimina gli spazi e non corregge un valore quasi valido, perché una pulizia automatica potrebbe nascondere un confine di serializzazione difettoso.

Un valore vuoto, un dato che non sia una stringa, un numero errato di caratteri, trattini spostati o caratteri vietati generano invece messaggi esplicativi distinti. Controlla soltanto sintassi e metadati incorporati; non determina unicità, proprietà, presenza nel database, qualità di generazione o idoneità a uno specifico protocollo.