Java code conventions

Meu primeiro post é sobre um tópico não muito valorizado e pouco discutido, pelo menos nas equipes no qual trabalhei, que é sobre convenção do código Java.

Acho que todo desenvolvedor Java, antes mesmo de começar a escrever uma linha de código, deveria ler esta documentação de padronização. O documento em PDF pode ser acessado por http://www.oracle.com/technetwork/java/codeconventions-150003.pdf . e é a convenção que o pessoal da SUN, criadores do Java,  seguiam e recomendavam. Abrange nomes de arquivos, organização de arquivos, recuo, comentários, declarações, espaço em branco, convenções de nomenclatura, as práticas de programação. Além de um exemplo de código.

Como mesmo diz no próprio site da Oracle que fala sobre estes padrões http://www.oracle.com/technetwork/java/codeconv-138413.html ,

– 80% do custo do tempo de vida de uma peça de software vai para manutenção.

– Dificilmente qualquer software é mantido por toda a sua vida pelo autor original.

– Convenções de código melhoram a legibilidade do software, facilitando o entendimento para os desenvolvedores no novo código. Ou seja,  um entendimento mais rápido e completo.

Portanto, não é difícil conhecer estas convenções, pode ser um pouco chato no início, mas com certeza vale a pena. Depois que acostumar a ler um código nesses padrões, quando você encontrar um código que esta fora das convenções você vai achar ele muito bagunçado e até mesmo um pouco sujo. Além do que, o documento esta bem escrito e abrange praticamente todas as situações possíveis e com um exemplo bem completo de código no final do documento.

 

abraços,

Tadeu Gois

 

 

 

 

Comments are closed.