Outils pour utilisateurs

Outils du site


java:bp

Différences

Ci-dessous, les différences entre deux révisions de la page.

Lien vers cette vue comparative

Les deux révisions précédentesRévision précédente
Prochaine révision
Révision précédente
java:bp [2012/10/09 20:25] brunojava:bp [2018/11/13 16:25] (Version actuelle) – [En programmant] bruno
Ligne 82: Ligne 82:
 Ils se placent avant l'élément qu'ils décrivent. Dans l'idéal, ils devraient être écrit en français. Ils se placent avant l'élément qu'ils décrivent. Dans l'idéal, ils devraient être écrit en français.
  
-//Petite anecdote: lorsque j'ai commencé le projet [[http://natabraille.free.fr|natbraille]], j'ai commenté tout mon code en français, vu que j'étais pratiquement le seul programmeur. Aujourd'hui que le projet a une portée internationale, les autres développeurs non francophones réclament des commentaires en anglais. Il va y en avoir pour pratiquement un mois temps rien qu'avec les commentaires, et un autre au moins pour les noms de classes et de variables du code... en français//+//Petite anecdote: lorsque j'ai commencé le projet [[http://natbraille.org|natbraille]], j'ai commenté tout mon code en français, vu que j'étais pratiquement le seul programmeur. Aujourd'hui que le projet a une portée internationale, les autres développeurs non francophones réclament des commentaires en anglais. Il va y en avoir pour pratiquement un mois temps rien qu'avec les commentaires, et un autre au moins pour les noms de classes et de variables du code... en français//
  
 Voici par exemple le code de la classe {{:java:object.java|Object}} de java: Voici par exemple le code de la classe {{:java:object.java|Object}} de java:
Ligne 96: Ligne 96:
    
 Vous constaterez au passage que **la plupart du code, c'est de la documentation!** (bien que simple, la classe Object est utilisée par tout le monde en java, il est important de fournir une documentation la plus exhaustive possible pour les programmeurs). Vous constaterez au passage que **la plupart du code, c'est de la documentation!** (bien que simple, la classe Object est utilisée par tout le monde en java, il est important de fournir une documentation la plus exhaustive possible pour les programmeurs).
 +
 +==== Quelques outils et liens ====
 +  * [[http://www.oracle.com/technetwork/java/codeconvtoc-136057.html|La syntaxe recommandée par sun/oracle]]
 +  * [[http://checkstyle.sourceforge.net/|Checkstyle]]: Un outil pour vérifier automatique son style
  
 ===== Bonnes habitudes pour la programmation ===== ===== Bonnes habitudes pour la programmation =====
Ligne 103: Ligne 107:
   - ... et dans l'idéal en anglais!   - ... et dans l'idéal en anglais!
   - déclarez toujours dans le même ordre vos attributs, constructeurs, méthodes (éventuellement vos types de méthodes: accesseurs, puis méthodes implémentées, etc.);   - déclarez toujours dans le même ordre vos attributs, constructeurs, méthodes (éventuellement vos types de méthodes: accesseurs, puis méthodes implémentées, etc.);
-  - initialisez TOUJOURS un attributs, une variable;+  - initialisez TOUJOURS un attribut, une variable... soit lors de sa déclaration, soit par l'intermédiaire du constructeur pour les attributs. 
 +  - ... ou faites-le systématiquement dans le constructeur;
   - dès que vous ouvrez un bloc avec {, fermez-le immédiatement avec }:<code java>   - dès que vous ouvrez un bloc avec {, fermez-le immédiatement avec }:<code java>
 for (int i=0;i<2;i++){ for (int i=0;i<2;i++){
java/bp.1349814309.txt.gz · Dernière modification : 2012/10/09 20:25 de bruno