Escolha cuidadosa de nomes de métodos:
- Nomes devem seguir convenções (Item 68).
- Priorize nomes compreensíveis e consistentes com o pacote e com o consenso geral.
- Evite nomes longos.
Não exagere em métodos de comodidade:
- Cada método deve “fazer sua parte do trabalho”.
- Muitos métodos dificultam o uso, manutenção e documentação da API.
- Ofereça métodos abreviados apenas se forem muito usados.
Evite listas longas de parâmetros:
- Limite a quatro ou menos parâmetros.
- Listas longas são difíceis de lembrar e suscetíveis a erros.
- Parâmetros do mesmo tipo em sequência podem causar confusão.
Três técnicas para reduzir listas longas de parâmetros:
- Dividir o método em vários métodos menores.
- Criar classes auxiliares para grupos de parâmetros.
- Usar o padrão Builder para métodos com muitos parâmetros, especialmente os opcionais.
Prefira interfaces a classes nos parâmetros:
- Use interfaces, como Map, em vez de classes específicas, como HashMap, para maior flexibilidade.
Prefira enums a booleanos em parâmetros:
- Enums tornam o código mais legível e facilitam futuras expansões de opções, como no exemplo do termômetro com escala de temperatura.
- Essas práticas ajudam a criar APIs mais fáceis de usar e menos suscetíveis a erros.
Top comments (0)