Les identificateurs, à l'exception des identificateurs de constantes,
sont composés de mots séparés à l'aide de majuscules,
par exemple voiture,
voitureAvecChauffeur. Les identificateurs
de constantes sont tout en majuscule, les mots étant séparés
par des soulignés, par exemple
PI, VITESSE_LUMIERE.
Les identificateurs de variables et de méthodes commencent par
une minuscule, comme voiture, voitureAvecChauffeur, kilometrage().
Les identificateurs de classes commencent par une majuscule : Voiture,
FormeGeometrique.
Les noms des paquetages sont écrits en minuscule.
Une instruction élémentaire commence et termine sa ligne.
Une déclaration commence et termine sa ligne.
Les accolades ouvrantes sont placées en fin de ligne, sans retour
à la ligne préalable. Les accolades fermantes sont seules
sur leur ligne. sauf avant un catch ou un else.
La clause throws débute et termine sa ligne, l'accolade
débutant la méthode concernée étant seule sur
sa ligne.
Les éléments d'une classe sont donnés dans l'ordre
suivant :
-
Documentation sur la classe : commentaires de la forme /** ... */
pour javadoc destinés au client.
-
Entête de la classe : public class NomClasse {
-
Commentaires sur l'implémentation : commentaires de la forme /*
... */ destinés à la maintenance.
-
Variables de classe statiques.
-
Variables d'instance.
-
Constructeurs.
-
Méthodes
Les différents éléments seront en outre classés
par ordre d'accessibilité décroissant (de public
à private), sauf pour les méthodes pour lesquelles
un regroupement par sujet doit être privilégié.
Les mots-clé devant une variable ou une méthode doivent
toujours apparaître dans le même ordre. L'ordre conseillé
est :
<contrôle d'accès> <static> <final>
<native><synchronized> <type>