1. Clean Code
Alexandre Afonso
@afonsoaaf
http://pubsoft.alexandreafonso.com.br
5 Dicas Que Vão Tornar O Seu Código
Muito Mais Elegante

2. 1. Não Tenha Preguiça De Dar Nomes
Você tem que dar um nome tão bom para sua
classe, método e variável a ponto de fazer com
que o comentário (se é que ele existe) pareça
idiota.
Ao invés de:
Use:

3. 2. Atenção Aos Seus Métodos
● Com Poucas Linhas
● Cada Um Com Sua Responsabilidade
● Parâmetros
● Evite Métodos Misteriosos
● Não Se Repita (DRY – Don’t Repeat
Yourself)

4. 2. Atenção Aos Seus Métodos
2.1. Com Poucas Linhas
● Tente, no máximo, com até 20 linhas (acenda a luz de
alerta passar).
● Não tenha linhas muito grandes, procure quebra-las

5. 2. Atenção Aos Seus Métodos
2.2. Cada Um Com Sua Responsabilidade
● Métodos não devem fazer muita coisa. Quanto menos,
melhor. Busque deixar com apenas uma.

6. 2. Atenção Aos Seus Métodos
2.3. Parâmetros
● Evite usar muitos parâmetros. Se precisar, então,
considere criar um objeto que irá guardar-los para
serem encaminhados.
● Métodos que recebem parâmetros do tipo “boolean”,
provavelmente, estão fazendo mais do que deveriam.

7. 2. Atenção Aos Seus Métodos
2.4. Evite Métodos Misteriosos
● Não inclua no seu método responsabilidades que não
são dele.

8. 2. Atenção Aos Seus Métodos
2.5. Não Se Repita (DRY – Don’t Repeat
Yourself)
● Não repita código! Isole as partes que podem ser
reaproveitadas e reaproveite-as.

9. 3. Pense Mais De Uma Vez Se For Comentar
● Se o seu código tem a necessidade de estar
bem comentado, então, repense.
● Não comente coisas óbvias e não faça
comentários que dependam da análise do
código.
● Comentários não são atualizados.

10. 3. Pense Mais De Uma Vez Se For Comentar
Bons Comentários São Ótimos Sinais De Que
Seu Código Pode Ser Melhorado
Engraçado, não é? Mas, veja o exemplo:
O comentário acima é bem claro. Mas o código podia ficar melhor:
E agora, com essa alteração, o comentário passou a ser inútil.

11. 4. Formate O Seu Código
Facilite a leitura do seu código. A legibilidade
tem total influência nas evoluções/correções
que precisaram ocorrer.

12. 5. Gerencie Os Erros
● Valide a informação e prefira lançar
exceções à códigos de erro.
● Tente não retornar nulos. Prefira um special
case ou, para coleções, retorne vazio.

13. Leitura

14. Obrigado!
http://pubsoft.alexandreafonso.com.br