Règles d'écriture en Java
Il n'existe plus dans la version 8 de Java de convention de codage,
comme on pouvait en trouver
dans les premières versions.
Toutefois, il est bon d'avoir des règles de codage pour faciliter la
lecture du code. Nous donnons donc ici les principales règles de
codage présentes dans les premières versions de Java et utilisées en
particulier dans le code de l'API.
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.
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 sa ligne.
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>
Les noms des paquetages sont écrits en minuscule.
Pour l'indentation avec Eclipse, on utilisera l'item "Format" du
menu "Source" (barre de menu ou clic-droit).