BT

Les standards de codage de Google

| par Bienvenido David , traduit par Nicolas Frankel le 14 févr. 2014. Durée de lecture estimée: 1 minute |

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.

Evaluer cet article

Pertinence
Style

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

Se connecter à InfoQ pour interagir sur ce qui vous importe le plus.


Récupérer votre mot de passe

Follow

Suivre vos sujets et éditeurs favoris

Bref aperçu des points saillants de lindustrie et sur le site.

Like

More signal, less noise

Créez votre propre flux en choisissant les sujets que vous souhaitez lire et les éditeurs dont vous désirez suivre les nouvelles.

Notifications

Restez à jour

Paramétrez vos notifications et ne ratez pas le contenu qui vous importe

BT