normes de codage et des conventions pour les langages de programmation tels que Java sont conçues pour améliorer la qualité et la fiabilité des applications développées en utilisant ces langues. Projets Java sont souvent de grande taille , avec des composants différents a travaillé sur un certain nombre de différents développeurs. Avoir un ensemble commun de pratiques signifie que les développeurs peuvent travailler avec le code de chacun de manière plus efficace , car le code est plus clair et plus facile à lire . Nommer
conventions Java dicter certaines règles pour nommer les éléments du programme tels que les variables , des classes, des objets, des forfaits et des interfaces entre autres. ChatMot est utilisé dans la plupart des cas, comme dans les exemples suivants :
//noms de classe commencent majuscules
Classées MyClass
//les variables commencent minuscules
objet anObject
En général, utiliser des noms significatifs , par exemple "compteur" au lieu de "c" pour que les gens (vous y compris ) la lecture de votre code ne peuvent comprendre plus facilement.
en retrait
indentation est l'un des éléments clés de la programmation qui rend le code plus facile à lire . Indentation doit généralement refléter les structures logiques dans un programme, et permet d'identifier les informations à un coup d'œil , par exemple , la portée des variables . Conventions Java dictent aussi où les pauses doivent avoir lieu dans les lignes enroulées de code, avec les sauts de ligne préférés survenant après des virgules et avant opérateurs , comme suit :
aMethod ( parameterOne , parameterTwo , AB
parameterThree ) ; Photos
int answer = itemOne + itemTwo
+ itemThree ; .
Les deuxièmes lignes dans ces cas devraient idéalement venir après huit espaces
commentaires
L'utilisation des commentaires fait tout le code plus facile à travailler , en particulier si les algorithmes longs ou complexes sont impliqués. Les commentaires de code selon les conventions Java devraient être inclus avant les déclarations de variables clés , les méthodes , les classes et les structures longues , ainsi que dans tous ces aspects. Utilisez les deux commentaires simples et multi- ligne , se produisant sur leurs propres lignes ou à la fin des lignes de code:
/*
* Ceci est un commentaire dans un bloc
* /
//Ceci est une ligne unique commentaire
int compteur = 0; //Ce sont des informations supplémentaires sur la ligne de code
Documentation < br > Photos
Vous créez documentation Java en utilisant principalement l'installation de Javadoc, qui génère des documents HTML ressources Java plus standards et l'utilisation des applications , y compris la langue elle-même . Vous créez du contenu de Javadoc dans le code source en utilisant les commentaires Javadoc :
/**
* Ceci est un commentaire Javadoc
* - notez la double astérisque pour commencer
< p> * /
Lorsque les développeurs travaillent avec le code qui a été développé par quelqu'un d'autre , leur premier point de référence est souvent le Javadoc, car il donne un aperçu de la ressource sans avoir à réellement lire le code lui-même.
Programme design