Validate: o que é, validação de campos de entrada e implementação no Android

O que é validação de campo no Android?

A validação de campo é a verificação de um único valor inserido pelo usuário de acordo com as regras especificadas. Cada campo tem seu próprio tipo de dados: email, número, telefone, senha, texto. Cada tipo tem seus próprios critérios: formato, comprimento, intervalo de valores, obrigatoriedade. A validação de campo responde à pergunta: a entrada neste campo está correta?

A diferença entre validação de campo e validação de formulário é que um campo é verificado independentemente dos outros campos. O email é validado contra um padrão de email, o telefone contra um padrão de telefone. Se um campo é inválido, o usuário vê um erro para esse campo específico. O formulário pode permanecer não enviado mesmo se um campo falhar na validação. A validação de campo é o bloco de construção para a validação completa do formulário.

De acordo com pesquisas de UX, os usuários esperam ver um erro de validação no máximo 1-2 segundos após concluir a entrada. Um atraso de mais de 3 segundos é percebido como um problema do aplicativo. É por isso que a validação em tempo real via TextWatcher é preferível a verificar apenas quando o botão de envio é pressionado.

Principais métodos de validação de campos

Existem três abordagens principais para validação de campos no Android. A primeira é a verificação manual através de operadores condicionais (if, when). O desenvolvedor escreve uma função que recebe uma string e retorna um Boolean ou uma mensagem de erro. Essa abordagem dá controle total sobre a lógica, mas requer escrever código para cada campo e cada condição.

A segunda abordagem é usar classes integradas do Android. Por exemplo, Patterns.EMAIL_ADDRESS.matcher(email).matches() valida um email contra um padrão padrão. Patterns.PHONE.matcher(phone).matches() valida um número de telefone. TextUtils.isEmpty() verifica se está vazio. Esses métodos cobrem cenários básicos sem adicionar dependências externas.

A terceira abordagem são bibliotecas de validação. Bibliotecas como InputValidator, AndroidValidator ou Commons Validator fornecem anotações prontas e cadeias de validação. O desenvolvedor descreve as regras declarativamente: @Email, @NotEmpty, @MinLength(6). A própria biblioteca realiza a validação e retorna uma lista de erros. Isso acelera o desenvolvimento, mas adiciona uma dependência.

Validação de email, telefone e senha

Para email, a validação padrão inclui verificar a presença do símbolo @, uma parte de domínio e a ausência de espaços e caracteres cirílicos. O Android fornece Patterns.EMAIL_ADDRESS, que cobre a maioria dos endereços de email legítimos. No entanto, se for necessária uma validação específica (por exemplo, apenas domínios corporativos), uma regex personalizada deve ser escrita. O email é validado após a conclusão da entrada, não após cada caractere.

O número de telefone é validado contra uma máscara de país ou região. Para números internacionais, o formato E.164 é usado: +código do país, código da operadora, número. A biblioteca libphonenumber do Google é o padrão da indústria para validação de telefones. Ela determina o país pelo código, verifica o comprimento e o formato do número. No Android, PhoneNumberUtils.isGlobalPhoneNumber pode ser usado para validação básica.

A senha tem vários critérios de complexidade: comprimento mínimo, presença de letras maiúsculas e minúsculas, dígitos, caracteres especiais. O Android não tem uma classe integrada para validação de senha — cada projeto define seus próprios requisitos. Normalmente, uma senha é validada através de uma expressão regular ou um conjunto de condições. É importante não revelar requisitos exatos na mensagem de erro: “A senha é muito simples” é melhor do que “É necessária uma letra maiúscula e um dígito”.

data class ValidationResult(
    val isValid: Boolean,
    val errorMessage: String? = null
)

fun validatePassword(password: String): ValidationResult {
    if (password.length < 6)
        return ValidationResult(false, "Minimum 6 characters")
    if (!password.any { it.isUpperCase() })
        return ValidationResult(false, "Uppercase letter required")
    return ValidationResult(true)
}

No exemplo, validatePassword retorna um ValidationResult com um campo isValid e uma mensagem de erro opcional. Esta abordagem é conveniente para composição: várias verificações são executadas sequencialmente e o primeiro erro encontrado é retornado. A validação de email e telefone segue o mesmo princípio — cada uma retorna um resultado com uma mensagem ou sucesso.

Quando realizar a validação?

O momento da validação afeta criticamente a UX. Existem três estratégias: validação após cada caractere (instantânea), após perder o foco (onFocusLost) e no envio do formulário (onSubmit). Cada estratégia é adequada para diferentes cenários. A validação instantânea é boa para campos com restrições estritas — número de telefone, código PIN. OnFocusLost funciona para email e nome. OnSubmit funciona para campos obrigatórios.

De acordo com as Material Design Guidelines, é recomendado combinar estratégias: um campo deve ser validado ao perder o foco e também ao enviar o formulário. A validação instantânea é apropriada quando a restrição é óbvia — por exemplo, comprimento máximo do campo. Se um erro for mostrado após cada caractere para email, o usuário verá uma mensagem antes de terminar a entrada. Isso é irritante e reduz a conversão.

A regra do primeiro erro: ao enviar um formulário, mostre um erro apenas para o primeiro campo inválido. Não sobrecarregue o usuário com uma lista de 10 erros. Após corrigir o primeiro erro, o próximo pode ser mostrado. Esta orientação passo a passo reduz a carga cognitiva e ajuda o usuário a preencher o formulário mais rapidamente.

Ferramentas e bibliotecas para validação

O SDK do Android fornece ferramentas básicas para Validate: Patterns para email e telefone, TextUtils para verificar vazio, expressões regulares para padrões arbitrários. Para projetos com 1-3 campos, isso é suficiente. No entanto, em formulários com 10+ campos, a validação manual se torna difícil de manter — cada novo campo requer uma função separada e lógica de envio atualizada.

Bibliotecas de validação populares: Android Saripaar (anotações @Email, @NotEmpty, @Password), Apache Commons Validator (validação de email, URL, número de cartão de crédito), RxBinding + RxJava para validação reativa. Saripaar permite colocar anotações diretamente nos campos de entrada e chamar a validação com uma linha: validator.validate(). A biblioteca mostra automaticamente os erros através de setError.

O Google recomenda usar Material Design Components com TextInputLayout. A validação integrada através de setError, setHelperText e setCounterEnabled cobre cenários básicos sem bibliotecas de terceiros. Para projetos complexos (fintech, saúde), é melhor usar uma combinação: Material Components + validação personalizada com padrões da camada de domínio da Clean Architecture.

Erros comuns na validação de campos

O primeiro erro é mostrar um erro antes do início da entrada. Se um campo é obrigatório mas o usuário não começou a preenchê-lo, não mostre “Campo obrigatório”. Isso cria uma falsa sensação de problema. Um erro deve aparecer apenas depois que o usuário interagiu com o campo: começou a digitar, saiu do campo, tentou enviar o formulário.

O segundo erro é uma mensagem de erro pouco clara. A mensagem deve ser específica e sugerir como corrigir o problema. “Email inválido” é ruim. “O email deve conter @ e um domínio, por exemplo user@example.com” é bom. O usuário deve entender exatamente o que está errado e como corrigir sem consultar a documentação.

O terceiro erro é bloquear o envio sem explicação. Se o botão de envio estiver inativo devido a erros de validação, o usuário deve ver quais campos são inválidos. Um botão cinza sem mensagens é um beco sem saída para o usuário. Sempre destaque os campos com erros e mostre o texto do erro ao lado de cada campo inválido.