NewIntroducing QODEX QA Services — platform-powered QA for API-driven teams.Learn more →
Validador Regex de GUID em Java

Validador Regex de GUID em Java

O Validador Regex de GUID em Java ajuda desenvolvedores a confirmar se um GUID (Globally Unique Identifier) segue a sintaxe correta usando regex Java. É especialmente útil em sistemas onde IDs únicos de objetos, tokens de sessão ou chaves de API estão envolvidos.

Explore ferramentas Java relacionadas para validação e codificação de dados:


Validador Regex de GUID em Java - Documentação

O que é um GUID em Java?

Um GUID (ou UUID) é um número de 128 bits usado para identificar dados de forma única em sistemas. É tipicamente formatado como:

xxxxxxxx-xxxx-Mxxx-Nxxx-xxxxxxxxxxxx


Onde:

  • x é um dígito hexadecimal

  • M indica a versão

  • N indica a variante

Um GUID garante unicidade global em sistemas distribuídos, bancos de dados ou transações de API.

Padrão Regex Java para GUID

O padrão regex comumente usado para validar GUIDs:

^[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}$

O que ele corresponde:

  • 8 dígitos hexadecimais

  • Um hífen

  • 4 dígitos hexadecimais

  • Um hífen

  • 4 dígitos hexadecimais começando com versão 1 a 5

  • Um hífen

  • 4 dígitos hexadecimais começando com 8, 9, A ou B (variante)

  • Um hífen

  • 12 dígitos hexadecimais

O que é um Validador Regex e o que ele faz?

Um Validador Regex é uma ferramenta prática para verificar se um determinado valor corresponde a um ou mais padrões de expressão regular. Pense nele como um porteiro: só deixa entrar os dados que se encaixam nos seus critérios predefinidos. Ao fornecer um padrão, você pode verificar se strings de texto são válidas de acordo com suas regras.

Este validador é flexível: você pode configurá-lo para ser rígido com maiúsculas e minúsculas (sensível a maiúsculas) ou tratá-las como iguais (insensível a maiúsculas). Alguns casos de uso comuns incluem:

  • Verificar se um endereço de email está formatado corretamente

  • Verificar GUIDs ou UUIDs

  • Garantir que a entrada do usuário atenda a certos requisitos

Exemplo de Código Java

import java.util.regex.Pattern;
import java.util.regex.Matcher;

public class GUIDValidator { public static void main(String[] args) { String input = "3f2504e0-4f89-11d3-9a0c-0305e82c3301";

    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(input);

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

}

Parâmetros para Construtores do Validador Regex

Ao criar um Validador Regex em Java, você tem algumas opções de construtor:

  • Regex único (sensível a maiúsculas): Aceita uma única string de expressão regular.

  • Múltiplos padrões regex (sensível a maiúsculas): Aceita um array de strings de expressão regular, permitindo correspondência com qualquer um deles.

  • Regex único com sensibilidade a maiúsculas personalizada: Recebe uma string de expressão regular e um flag booleano. O booleano especifica se a correspondência deve ser sensível a maiúsculas (true) ou não (false).

  • Múltiplos padrões regex com sensibilidade a maiúsculas personalizada: Aceita um array de strings regex e um booleano para sensibilidade a maiúsculas.

Entradas de Amostra

GUIDs Válidos:

  • 3f2504e0-4f89-11d3-9a0c-0305e82c3301

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

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

GUIDs Inválidos:

  • 3f2504e0-4f89-11d3-9a0c0305e82c3301 (hífen ausente)

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

  • 12345 (muito curto)

Dicas Profissionais

  • Sempre valide GUIDs antes de armazená-los ou usá-los em APIs ou sessões.

  • GUIDs são insensíveis a maiúsculas. Seu regex deve permitir letras maiúsculas e minúsculas (use a-fA-F).

  • Remova espaços em branco ou caracteres invisíveis antes de executar verificações de regex.

  • Se estiver gerando GUIDs em Java, use UUID.randomUUID() para garantir conformidade de formato.

  • Para validação mais rigorosa, crie padrões específicos de versão (por exemplo, apenas UUIDs v4).

  • Nunca exponha GUIDs internos ou sensíveis diretamente. Hash ou codifique-os com um gerador de hash ou um Codificador Base64.

Casos de Uso

  • Validação de Chave de API: Garanta que os tokens passados sigam a estrutura GUID.

  • Chaves de Banco de Dados: Confirme o formato de chaves primárias ou estrangeiras.

  • Sistemas de Log: Limpe e valide identificadores de log baseados em UUID.

  • Envios de Formulários: Aceite apenas GUIDs devidamente formatados em campos de front-end.

Combine com Estas Ferramentas

Frequently Asked Questions

GUIDs e UUIDs são a mesma coisa?

Sim, eles são frequentemente usados de forma intercambiável. GUID é mais comum em sistemas Microsoft; UUID é o termo oficial conforme o RFC 4122.

Este regex verifica se um GUID é único?

Não. Ele verifica apenas o formato. A unicidade deve ser tratada na lógica da sua aplicação.

Posso validar GUIDs em maiúsculas ou minúsculas?

Sim. O regex permite tanto a-f quanto A-F.

Isso funciona para GUIDs versão 4?

Sim, e você pode ajustar o dígito de versão (13º caractere) se quiser impor versões específicas.

E se meus GUIDs forem gerados sem hífens?

Você precisará de um padrão regex diferente. O padrão padrão requer hífens.

Teste suas APIs hoje!

Escreva em português simples, o Qodex transforma em testes seguros e prontos para execução.