Discussion :

[javaSudOuest]

Bonjour,
Je vais probablement me faire assassiner, mais je cherche une norme/des règles de programmation Java claires et complètes.
J'ai bien trouvé des normes à droite et à gauche, mais rien de bien satisfaisant pour l'instant...
En fait, je cherche quelque chose qui me dise clairement par exemple que pour la variables locales, il faut les préfixer par l_xxx, pour les paramètres en entrée, les préfixer par i_xx, en sortie o_xxx

voilà, merci pour les liens et les infos

[KiLVaiDeN]

Salut,

Il y a en effet une sorte de "norme" qui existe, voila les règles que je connais ou que j'applique dans mes projets :

- Les noms de classes commencent toujours par une majuscule, et pour chaque mot de la classe, une majuscule aussi, par exemple :

Code :

Sélectionner tout - Visualiser dans une fenêtre à part

1
2
3
class ThisIsAStringClassClone {
  // codeuh
}

- Les noms de variables constantes sont en majuscules :

Code :

Sélectionner tout - Visualiser dans une fenêtre à part

String JESUISUNECONSTANTE = "Hello, world.";

- les noms de variables ou de méthodes, commencent par une lettre minuscule, et pour chaque mot, utilise une majuscule :

Code :

Sélectionner tout - Visualiser dans une fenêtre à part

1
2
3
4
5
int monEntier;
 
public static String maSuperFonction(int unEntier) {
  // ici code :P
}

- ensuite il y a le placement des accolades, chacun sa technique, mais la meilleure méthode c'est la mienne.

Après, je vois pas trop, au niveau des paramètres et autres, je ne connais pas de normes, j'essaie en général d'utiliser des noms de variables parlants, et après le fait qu'elle soit local, paramètrée, ou autre, se déduit du contexte.

[lunatix]

tu as http://java.sun.com/docs/codeconv/ mais bon, ca ne couvre pas ce que tu veux. Tres peu de personnes utilisent des prefixes de variables en java.

[KiLVaiDeN]

Ah et puis ensuite, mis à part une "norme générale" pour chaque "format de fichier", tu auras des spécificités, cherche par exemple des infos sur les POJO, tu verras que les noms de méthodes getteurs par exemple sont getMaVariable() si ta variable s'appelle maVariable

[adiGuba]

Salut,


Tu peux déjà lire les conventions de codage : http://cyberzoide.developpez.com/java/javastyle/

En fait, je cherche quelque chose qui me dise clairement par exemple que pour la variables locales, il faut les préfixer par l_xxx, pour les paramètres en entrée, les préfixer par i_xx, en sortie o_xxx

Mais il n'y a pas vraiment de norme en ce domaine, sauf que le underscore ne devrait pas être utilisé dans les nom de variable mais seulement pour les noms des constantes voir des valeurs du type enum. Mais il est vrai qu'il est souvent utilisé pour les noms des attributs des classes...

Comme l'a dit lunatix le préfixage n'est pas souvent utilisé (moins qu'en C++ par exemple ou le préfixage peut aussi contenir le type de la variable), mais il y en a deux principaux que je vois (afin de les différencier des attributs de la classe) :
p pour les paramètres d'une méthode (exemple value -> pValue)
l pour les variables locales (exemple value -> lValue)

a++

[javaSudOuest]

tu as http://java.sun.com/docs/codeconv/ mais bon, ca ne couvre pas ce que tu veux. Tres peu de personnes utilisent des prefixes de variables en java.

Bon, merci, c'est déjà ce que je faisais, mais il me semblait que des règles plus précises/pointues existaient.

En C, il y a la norme ANSI par exemple...