First Java Concepts – Convenção de Código Java – padrões de nomes

A Sun Microsystems, que foi adquirida pela Oracle, criou um documento chamado Java Code Conventions, a última revisão feita neste documento foi em 1999. Este documento tem como objetivo padronizar a forma de se codificar em Java para facilitar o entendimento de um código por alguém que não seja seu autor, aumentando a legibilidade, clareza e a facilidade de manutenção do mesmo.

Este post abordará padrões de nomes adotados pela convenção.

 

Classes e Interfaces

Nomes de classes e interfaces devem ter a primeira letra maiúscula, quando o nome é formado por varias palavras, a primeira letra de cada palavra deve ser maiúscula, este formato é conhecido como camelCase . É recomendado evitar o uso de abreviaturas, ao menos que esta seja mais conhecida do que a palavra inteira, ex: URL e HTML.

Para classes, os nomes devem normalmente ser substantivos e para Interfaces normalmente são utilizados adjetivos.

Exemplos:


class Product;

class Person;

class SystemOperation;

interface Runnable;

interface Serializable;

Métodos

Nos métodos, a primeira letra do nome deve ser minúscula e se for composta por outras palavras a forma camelCase deve ser utilizada também. Os nomes são formados geralmente por verbos e podem ser seguidos de substantivos.


getProduct();

changePerson();

run();

Variáveis

Como nos métodos, a primeira letra deve ser minúscula e se for composta por mais de uma palavra, o formato camelCase deve ser utilizado. É recomendado que as variáveis tenham nomes curtos e significativos e que não seja utilizado nome com apenas um carácter exceto para variáveis temporárias.


int i;

String name;

int productNumber;

Constantes

Constantes são marcadas como variáveis static e final. Elas devem ter o nome todo em letra maiúscula e quando composta de mais de uma palavra, etas devem ser separadas por underline (_).


int MAX_NUMBER;

String DEFAULT_LANGUAGE;

Referências:

Java Code Conventions

SCJP Sun® Certified Programmer for Java™ 6 Study Guide

Anúncios