Validando CPF com Java através do Stella

Ah não, assim não dá, eu já me perdi na terceira regra. Validar CPF é algo muito complexo.

Parando para pensar, fazer esse tipo de validação deve ser uma tarefa comum para programadores, pois muitos sistemas necessitam dessa funcionalidade, logo, será que já não tem algo pronto?

Caelum Stella

Vendo esse tipo de funcionalidade sendo bastante requisitada por empresas e, consequentemente, pelos seus desenvolvedores, a Caelum decidiu criar o Stella, uma API que já traz todas as ferramentas necessárias para que possamos concluir nossa tarefa, ou seja, validar um cpf, de forma fácil e rápida.

O primeiro passo é instalar o Stella no nosso projeto. Para esse post, usaremos apenas o Stella Core, que já traz as funcionalidades principais dessa API.

Para instalar o Stella temos duas opções:

Podemos importar a dependência dele, caso o projeto use maven:

Ou apenas fazer o download do caelum-stella-core e importar o jar para o projeto.

Validando o CPF

Pronto, agora que acabamos de instalar só precisamos usar suas classes.

Bom, precisamos validar um CPF, certo? Então, primeiro vamos criar um método que nos devolve um boolean. Caso o CPF seja válido, nosso método irá retornar true, caso contrário, false. Vamos meter a mão na massa:

Agora, precisamos instanciar a classe do Stella que cuida da validação do CPF. A classe que faz isso é a CPFValidator. Ficando assim:

Boa, agora só precisamos usar o objeto criado e chamar seu método assertValid(), que recebe como parâmetro um CPF para ser validado:

Para conseguir o CPF que o método valida() requer, precisamos usar o getPessoaCpf() que nos devolve o CPF da pessoa que está se cadastrando. Com isso temos o seguinte código:

Boa, mas perceba que nosso método valida()está gerando um erro. No caso, ele está reclamando a falta de um retorno para esse método, pois declaramos que nosso método retorna um boolean e, por enquanto, não retornamos nada. E agora?

Poderíamos tentar retornar o método assertValid() mas olha o resultado:

Esse método retorna um void, ou seja, não retorna nada. Então como saber se nosso CPF é válido ou não? Se pegarmos a documentação do Stella a respeito desse método temos a seguinte implementação:

Vamos entender esse método. Ele recebe um CPF, e o manda para esse método getInvalidValues() que, por sua vez, vê se o CPF tem erros e no final adiciona todos os erros encontrados em uma lista e a retorna. Se a lista não estiver vazia, ou seja, conter algum erro, uma exceção é lançada.

Então caso tenha erro na lista, o método lança uma exceção. Logo, vamos envolver nosso código em um try/catch, se não tiver erro retornaremos true, caso tenha, false. Vamos lá:

Para testar, ao invés de mandar o CPF retornado do método getCpfProduto vamos criar uma variável do tipo String e colocar nós mesmos valores para o CPF, assim:

Esse CPF é válido, logo nossa implementação, em teoria, tem que nos retornar true. Além disso, vamos imprimir o boolean resultante do método para ver se nossa implementação está funcionando adequadamente:

Agora vamos testar:

Muito bom, por enquanto tudo certo, mas e se o CPF fosse falso? Como seria? Vamos trocar alguns números e ver o que acontece:

Eita! Além de retornar false, ele lançou uma Exception. Se traduzirmos, basicamente ela diz: "Dígitos verificados inválidos", mas o programa continuou funcionando perfeitamente.

O problema é que usar um try/catch nesse caso é algo inapropriado, devemos usar try/catch para tratar erros que não estamos esperando, para que, assim, possamos nos recuperar do erro obtido e, também, jogar regra de negócio dentro do bloco catch, não é nada legal.

O que seria o ideal? O ideal seria apenas retornarmos true caso não tenha erros e false caso tenha. Para isso vamos usar outro método do Stella.

Vocês se lembram do invalidMessagesFor? Que verifica se o CPF possui erros e devolve uma lista contendo esses erros, caso exista. Ele se adequa bem as nossas necessidades.

Se ele devolve uma lista vazia caso não tenha erros então vamos fazer uma condição que, caso a lista esteja vazia, retornará true,ou seja, cpf válido, caso não esteja, false, inválido.

Primeiro, vamos substituir todo o nosso try/catch por esse método e atribuí-lo a uma lista, assim:

Nos resta criar nossa condição que verifica se a lista possui erros:

Pronto, para dar um toque final, além de retornar false, vamos imprimir os erros que aquele CPF possui, desse jeito:

Ainda usando um CPF inválido vamos rodar esse código para ver o que acontece:

Boa, não temos mais aquela exception lançada na nossa cara. Além disso, deixamos de utilizar o try/catch, muito bom! Para finalizar vamos só arrumar o código que estamos usando para migrar dos testes para os métodos reais que nosso programa utiliza:

Parabéns, conseguimos completar nossa missão! Validamos o CPF de forma fácil e rápida, agora quero ver os engraçadinhos tentarem comprar algum produto nosso passando um CPF falso.

Conclusão

Atualmente existem milhares de features prontas que resolvem muitos problemas encontrados por nós, programadores. Imaginem só se tivéssemos que escrever esse código de validação na mão? Pensa no trabalho que ia dar.

Antes de começar a programar coisas desse tipo, ou seja, funcionalidades comuns, pesquise na internet se já existe alguma que se encaixe com a sua necessidade, com certeza você vai ser muito mais produtivo.

Para saber mais

O Stella é muito maior do que apenas validação de CPF, com ele podemos gerar boletos customizados, calcular frete, formatar CPF e CNPJ e mais outras funcionalidades bem interessantes.

Na Alura temos o curso Java Brasil. Nele, outras funcionalidades muito úteis do Stella, como as citadas acima, são apresentadas. Para quem tem interesse em saber mais sobre essa linda API, vale a pena dar uma conferida.

E se você não programa em Java, existe, também, o Stella para C#. Na Alura, temos o curso C# Brasil. Neste curso você pode aprender diversas funcionalidades do Stella, usando a linguagem de programação C#.