(→Ver Também) |
(→Cuidados na representação gráfica) |
||
Line 13: | Line 13: | ||
* 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: | * 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: | ** Exemplos de atributos de um objectos: | ||
− | *** <font color="green">bons</font>: <code> | + | *** <font color="green">bons</font>: <code>numeroDeDentes</code>, <code>ratómetro</code> |
*** <font color="red">maus</font>: <code>MARIA</code>, <code>CoisaEstranha</code> | *** <font color="red">maus</font>: <code>MARIA</code>, <code>CoisaEstranha</code> | ||
** Exemplos de variáveis locais e argumentos de métodos: | ** Exemplos de variáveis locais e argumentos de métodos: |
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 programa. 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.
Além da boa escolha de um nome, é necessário algum cuidado na sua representação gráfica.
MASSA_DO_ELECTRÃO
, CONSTANTE_DE_PLANCK
i
, MinhaConstante
, _outra_constante
numeroDeDentes
, ratómetro
MARIA
, CoisaEstranha
numeroDeSérie
, i
(o uso de variáveis com nomes curtos deve ser limitado, tendo-se como boa a utilização como contadores de iteração)VARIÁVEL_LOCAL
, número_de_série
, número_De_Série
RefeiçãoComSopa
, LeãoDaMontanha
A boa representação gráfica não desculpa más escolhas de nomenclatura.
MASSA_DO_ELECTRÃO
é um bom nome para uma constante que represente a massa do electrão, mas é um mau nome para uma constante que represente a Constante de Planck.De um modo geral, as regras de indentação utilizadas para linguagens com sintaxe semelhante (C/C++, etc.) são aceitáveis. Ver documentação abaixo.