Validatore UUID

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. Questa delimitazione rigorosa è utile quando Lei verifica il contratto di un’API o di un campo del database: il dato corrisponde alla forma UUID documentata oppure riceve una motivazione che individua il problema strutturale. Una risposta positiva contiene valid impostato su vero e fornisce un valore canonico in minuscolo, utilizzabile per confronti stabili, chiavi della cache, fixture e registri. 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. Un bit iniziale zero viene indicato come ncs; lo schema 10 come rfc_4122, la famiglia utilizzata dai moderni formati UUID; 110 come microsoft; e 111 come future. 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. Questo comportamento rende la capacità adatta a controlli di importazione, diagnostica dei moduli, fixture di test e strumenti di assistenza nei quali la causa conta quanto l’esito positivo o negativo. Invii il valore candidato nel campo text; per comodità di integrazione sono accettati anche gli alias uuid e value. L’operazione costa $0.002 per elemento tramite API e funziona senza rete, casualità, orologio, modello o archiviazione persistente. Controlla soltanto sintassi e metadati incorporati; non determina unicità, proprietà, presenza nel database, qualità di generazione o idoneità a uno specifico protocollo.