Validador UUID Regex Java

O que é um UUID?

Um UUID (ou GUID) é um identificador de 128 bits usado para rotular dados de forma única. Aparece como uma string de 36 caracteres neste formato:

xxxxxxxx-xxxx-Mxxx-Nxxx-xxxxxxxxxxxx

• M: Indica a versão do UUID (1 a 5)

• N: Indica a variante (tipicamente 8, 9, A ou B em hexadecimal)

UUIDs são essenciais para identificação única em APIs, sistemas distribuídos, bancos de dados e marcação de recursos.

Padrão Regex Java para UUID

Para corresponder UUIDs padrão (versões 1 a 5):

"^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-5][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}$"

Detalhamento do Padrão:

• [0-9a-fA-F]{8} -- Primeiro grupo (8 dígitos hexadecimais)

• [0-9a-fA-F]{4} -- Segundo grupo (4 dígitos hexadecimais)

• [1-5][0-9a-fA-F]{3} -- Versão (1 a 5)

• [89abAB][0-9a-fA-F]{3} -- Variante

• [0-9a-fA-F]{12} -- Grupo final (12 dígitos hexadecimais)

Para validar estritamente UUIDs versão 4:

"[a-fA-F0-9]{8}-[a-fA-F0-9]{4}-4[a-fA-F0-9]{3}-[89abAB][a-fA-F0-9]{3}-[a-fA-F0-9]{12}"

Detalhamento do Padrão UUID Versão 4

• Primeiro grupo (8 dígitos hexadecimais)

• Segundo grupo (4 dígitos hexadecimais)

• Terceiro grupo: o '4' inicial identifica especificamente a versão 4

• Quarto grupo (variante: deve começar com 8, 9, a ou b)

• Grupo final (12 dígitos hexadecimais)

Exemplo de Código Java

import java.util.regex.Pattern;
import java.util.regex.Matcher;
public class UUIDValidator {
public static void main(String[] args) {
String uuid = "550e8400-e29b-41d4-a716-446655440000";
String regex = "^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-5][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}$";
    Pattern pattern = Pattern.compile(regex);
    Matcher matcher = pattern.matcher(uuid);

    if (matcher.matches()) {
        System.out.println("Valid UUID");
    } else {
        System.out.println("Invalid UUID");
    }
}

}

Padrões Java Reutilizáveis para UUID

// Generic UUID (any version)
public static final String UUID_STRING = "[a-fA-F0-9]{8}-[a-fA-F0-9]{4}-[a-fA-F0-9]{4}-[a-fA-F0-9]{4}-[a-fA-F0-9]{12}";
public static final Pattern UUID = Pattern.compile(UUID_STRING, Pattern.CASE_INSENSITIVE);
// Version 4 UUID only
public static final String UUID_V4_STRING = "[a-fA-F0-9]{8}-[a-fA-F0-9]{4}-4[a-fA-F0-9]{3}-[89abAB][a-fA-F0-9]{3}-[a-fA-F0-9]{12}";
public static final Pattern UUID_V4 = Pattern.compile(UUID_V4_STRING, Pattern.CASE_INSENSITIVE);

Exemplos de UUID Válidos

• 123e4567-e89b-12d3-a456-426614174000

• 550e8400-e29b-41d4-a716-446655440000

Exemplos de UUID Inválidos

• 123e4567e89b12d3a456426614174000 (hifens ausentes)

• zzzzzzzz-zzzz-zzzz-zzzz-zzzzzzzzzzzz (caracteres não hexadecimais)

• 123e4567-e89b-62d3-a456-426614174000 (versão inválida)

Casos de Uso Comuns

• Chaves de Banco de Dados: Use UUIDs como chaves primárias não sequenciais

• Microsserviços: Evite colisões de chave em sistemas distribuídos

• Recursos de API: Identifique endpoints e recursos REST

• IDs de Usuário: Gere identificadores de usuário anônimos e seguros

Dicas Profissionais

• Prefira UUID Versão 4: Use UUID versão 4 (gerado aleatoriamente) para segurança e simplicidade.

• Valide em Todo Lugar: Valide o formato do UUID tanto no frontend quanto no backend para evitar entradas malformadas.

• Normalize para Consistência: Normalize UUIDs convertendo para minúsculas antes de comparar ou armazenar.

• Seja Específico Quando Necessário: Se você espera apenas certas versões (ex.: v4), refine o regex para corresponder apenas a elas usando o padrão específico de versão acima.

Ao aproveitar esses padrões e entender as diferenças sutis entre o regex UUID geral e o específico por versão, você garante que suas aplicações Java lidem com a validação de identificadores de forma robusta e eficiente.

Ferramentas Relacionadas para Combinar

• Testador Regex Java: Modifique e teste variações de regex para UUID

• Gerador de Token: Gere tokens alfanuméricos seguros

• Codificador Base64: Codifique UUIDs para transmissão

• Gerador de UUID: Crie UUIDs instantaneamente para testes

• Validador Email Regex Java: Valide formatos de email

• Validador Senha Regex Java: Teste padrões de senha forte