Convenções de escrita de programas em Java

Embora a linguagem Java tenha uma sintaxe e semântica bem definidas, decisões há que restrigem aqueles aspectos com o fim de melhorar a escrita de programas e, assim, a sua compreensão por um eventual leitor humano. Estas decisões são relativas a convenções de escrita, especialmente no que respeita a nomes de entidades que figuram num program. São as denominadas convenções de codificação e são inteiramente para consumo humano, já que para a máquina (i.e., para o compilador) são meros adornos, completamente irrelevantes do ponto de vista funcional.

As conveções dizem respeito a vários aspectos. São aqui resumidos os utilizados para:

• Constantes: todas as letras em maiúsculas; palavras separadas por "sublinhados" (underscores);
  • Exemplos: MASSA_DO_ELECTRÃO, CONSTANTE_DE_PLANK
• Variáveis: há dois grupos a considerar: o primeiro corresponde a variáveis que são atributos de objectos, enquanto o segundo corresponde a variáveis locais a métodos. Apenas diferem na convenção por as primeiras serem precedidas por um "sublinhado". A convenção é que os nomes sejam iniciados por uma letra minúscula, sendo cada nova palavra do identificador marcada pelo uso de uma maiúscula:
  • Exemplos de atributos de um objectos: _numeroDeDentes, _ratómetro
  • Exemplos de variáveis locais e argumentos de métodos: numeroDeSérie, i (o uso de variáveis com nomes curtos deve ser limitado, tendo-se como boa utilização a utilização como contadores de iteração)
• Classes: os nomes diferem dos das variáveis apenas por começarem por letra maiúscula.
  • Exemplos: RefeiçãoComSopa, LeãoDaMontanha