Usando convenções de nomenclatura Java

Mosqueteiro/Visão Digital/Imagens Getty

Uma convenção de nomenclatura é uma regra a seguir quando você decide como nomear seu identificadores (por exemplo, classe, pacote, variável, método, etc.).

Por que usar convenções de nomenclatura?

Diferente programadores Java podem ter diferentes estilos e abordagens para a forma como eles programam. Ao usar as convenções de nomenclatura padrão do Java, eles tornam seu código mais fácil de ler para eles mesmos e para outros programadores. A legibilidade do código Java é importante porque significa que menos tempo é gasto tentando descobrir o que o código faz, deixando mais tempo para corrigi-lo ou modificá-lo.

Para ilustrar o ponto, vale a pena mencionar que a maioria das empresas de software terá um documento que descreve as convenções de nomenclatura que eles desejam que seus programadores sigam. Um novo programador que se familiarizar com essas regras será capaz de entender o código escrito por um programador que pode ter deixado a empresa muitos anos antes.

Escolhendo um nome para seu identificador

Ao escolher um nome para um identificador, certifique-se de que seja significativo. Por exemplo, se o seu programa lida com contas de clientes, escolha nomes que façam sentido para lidar com clientes e suas contas (por exemplo, customerName, accountDetails). Não se preocupe com o comprimento do nome. Um nome mais longo que resuma o identificador perfeitamente é preferível a um nome mais curto que pode ser rápido de digitar, mas ambíguo.

Algumas palavras sobre casos

Usando a letra certa caso é a chave para seguir uma convenção de nomenclatura:

Minúsculasé onde todas as letras de uma palavra são escritas sem qualquer capitalização (por exemplo, while, if, mypackage).Maiúsculasé onde todas as letras de uma palavra são escritas em maiúsculas. Quando houver mais de duas palavras no nome, use sublinhados para separá-las (por exemplo, MAX_HOURS, FIRST_DAY_OF_WEEK).CamelCase(também conhecido como Upper CamelCase) é onde cada nova palavra começa com uma letra maiúscula (por exemplo, CamelCase, CustomerAccount, PlayingCard).Caso misto(também conhecido como Lower CamelCase) é o mesmo que CamelCase, exceto que a primeira letra do nome está em minúscula (por exemplo, hasChildren, customerFirstName, customerLastName).

Convenções de nomenclatura Java padrão

A lista abaixo descreve as convenções de nomenclatura Java padrão para cada tipo de identificador:

Pacotes:Os nomes devem estar em minúsculas. Com projetos pequenos que possuem apenas alguns pacotes, não há problema em dar a eles nomes simples (mas significativos!): |_+_| Em empresas de software e grandes projetos onde os pacotes podem ser importados para outras classes, os nomes normalmente serão subdivididos. Normalmente, isso começará com o domínio da empresa antes de ser dividido em camadas ou recursos: |_+_|Aulas:Os nomes devem estar em CamelCase. Tente usar substantivos porque uma classe normalmente representa algo no mundo real: |_+_|Interfaces:Os nomes devem estar em CamelCase. Eles tendem a ter um nome que descreve uma operação que uma classe pode fazer: |_+_| Observe que alguns programadores gostam de distinguir interfaces começando o nome com um 'I': |_+_|Métodos:Os nomes devem estar em maiúsculas e minúsculas. Use verbos para descrever o que o método faz: |_+_|Variáveis:Os nomes devem estar em maiúsculas e minúsculas. Os nomes devem representar o que o valor da variável representa: |_+_| Use apenas nomes muito curtos quando as variáveis ​​são de curta duração, como em loops for: |_+_|Constantes:Os nomes devem estar em maiúsculas. |_+_|