Nomeação de preferência: getSupportModes () vs suportedModes ()?
-
22-09-2019 - |
Pergunta
Estou tendo dificuldade em decidir qual nome escolher para o meu método. Eu acho que os dois são praticamente auto-explicativos, mas o último é mais rápido de digitar, então, minha preferência atual é suportada Modes (). O que você acha?
Solução
Para mim, getSupportedModes
implica uma recuperação simples, enquanto se houver alguma lógica real envolvida para resolvê -las, algo como determineSupportedModes
ou calculateSupportedModes
talvez melhor. O nome deve descrever o que a função faz. A brevidade não é uma consideração importante com os IDEs modernos com alguma forma de preenchimento automático.
Diferentes idiomas também têm suas próprias convenções. Por exemplo, uma função chamada calculateSupportedModes
em Java normalmente seria chamado CalculateSupportedModes
em C# ou VB.
Outras dicas
Eu preferiria o mais explícito, que é o ModEdModes. Você não quer que outros desenvolvedores adivinhem o que o método faz.
As funções que agem em mais do que apenas seus argumentos aprovados devem ser nomeados como ações.