BT
x Votre opinion compte ! Merci de bien vouloir répondre au sondage InfoQ concernant vos habitudes de lecture !

Les standards de codage de Google

par Bienvenido David , traduit par Nicolas Frankel le 14 févr. 2014 |

Google a récemment publié leur définition complète des standards de codage pour le code source Java. Ce sont des règles strictes qui sont facilement applicables et suivies de manière universelle au sein de Google. Elles ne couvrent pas uniquement le formatage, mais aussi d'autres types de convention et de standard de codage.

Le document est structuré en 6 sections principales : Bases, Structuration du Fichier Source, Formatage, Nommage, Pratiques de Programmation et Javadoc. La section Bases concerne les noms de fichier, l'encodage, les caractères d'espacement, et les caractères spéciaux. La section Structuration du Fichier Source concerne l'information de licence, les déclarations de package et d'import, et l'ordre des membres dans la classe. La section Formatage décrit les accolades, les indentations, la gestion du line-wrapping, les blancs, les parenthèses, les énumérations, les tableaux, les déclarations switch, les annotations, les commentaires et les modificateurs. La section Nommage concerne les identifiants (package, classe, méthode, constante, champ, variable locale, variable de type) et définit le CamelCase. La section Pratiques de Programmation parle d'@Override, des exceptions, des membres statiques et des destructeurs. Finalement, la section Javadoc décrit comment formater la Javadoc et où elle est nécessaire.

Voici quelques éléments contenus dans le guide :

  • Pas d'imports Joker
  • Les surcharges apparaissent séquentiellement
  • Les accolades sont utilisées même si le corps est vide ou contient une unique déclaration
  • Indentation de 2 espaces
  • La limite de colonne peut être de 80 ou de 100 caractères
  • Pas de déclarations de tableau à la C
  • Les modificateurs sont déclarés dans l'ordre préconisé par la Spécification du Langage Java
  • Les constantes utilisent la CASSE_CONSTANTE. Notez que toute constante est un champ statique et final, mais que tous les champs statiques et finaux ne sont pas des constantes.

Pour aller plus loin, consultez le Style Java Google. Il existe également les Conventions de Code officielles pour le Langage de Programmation Java d'Oracle. Google fournit également des guides de style pour d'autres langages comme C++, Objective-C, Python, Shell, HTML/CSS, JavaScript et Lisp.

Bonjour étranger!

Vous devez créer un compte InfoQ ou cliquez sur pour déposer des commentaires. Mais il y a bien d'autres avantages à s'enregistrer.

Tirez le meilleur d'InfoQ

Donnez-nous votre avis

Html autorisé: a,b,br,blockquote,i,li,pre,u,ul,p

M'envoyer un email pour toute réponse à l'un de mes messages dans ce sujet
Commentaires de la Communauté

Html autorisé: a,b,br,blockquote,i,li,pre,u,ul,p

M'envoyer un email pour toute réponse à l'un de mes messages dans ce sujet

Html autorisé: a,b,br,blockquote,i,li,pre,u,ul,p

M'envoyer un email pour toute réponse à l'un de mes messages dans ce sujet

Discuter

Contenu Éducatif

Rien ne serait possible sans le soutien et la confiance de nos Sponsors Fondateurs:

AppDynamics   CloudBees   Microsoft   Zenika
Feedback Général
Bugs
Publicité
Éditorial
InfoQ.com et tous les contenus sont copyright © 2006-2014 C4Media Inc. InfoQ.com est hébergé chez Contegix, le meilleur ISP avec lequel nous ayons travaillé.
Politique de confidentialité
BT