Lamiae
200 Cours langage et programmation orientés objets opérateurs et expressions, tutoriel exercices JAVA sur les opérateurs document PDF.
PROGRAMME JAVA
Style de programmation
Il est largement admis que le respect de la syntaxe et un programme qui fonctionne ne sont pas des critères de qualité suffisants pour un programme. L’expérience de la programmation a ainsi conduit à établir des recommandations de style. Les respecter n’est pas techniquement obligatoire mais contribue à améliorer la lisibilité des programmes. Ces conventions visent en fait une finalité économique : contribuer à produire des programmes plus facilement maintenables pendant toute leur durée de vie.
Dans les chapitres suivants, les exemples respectent les conventions de style préconisées par java.sun.com
Identificateurs
Quelques règles et recommandations pour nommer les identificateurs :
♦ Le caractère minuscule-majuscule des caractères est discriminant (règle du langage Java)
♦ Les identificateurs d’objets, de champs et de méthodes commencent toujours par une minuscule (par convention)
♦ Les identificateurs de classe (et d’interface) commencent toujours par une majuscule (par convention)
♦ Les identificateurs de constantes sont tout en majuscules (par convention)
♦ Les identificateurs de méthode commencent par un verbe (recommandation)
Commentaires
Commentaires de documentation
Les commentaires de documentation visent à décrire la spécification du code, sans considération d’implémentation. Ils sont destinés à des développeurs et utilisateurs qui n’auraient pas nécessairement les codes sources sous la main.
Ces commentaires peuvent être automatiquement extraits par l’utilitaire java doc pour en constituer un fichier de documentation en HTML.
La documentation d’une classe devrait inclure a minima :
– le nom de la classe, sa fonctionnalité et ses grandes caractéristiques, son auteur, sa version
– une documentation pour chaque constructeur et chaque méthode
La documentation d’une méthode devrait inclure a minima :
– le nom de la méthode, sa fonctionnalité, une description de chaque paramètre et de la valeur retournée, les exceptions susceptibles d’être lancées par cette méthode Syntaxe :
/**
* commentaires
*/
/** commentaire */
Principales balises de commentaires prédéfinies :
@author
@version
@param
@return
@see
@throws
Commentaires d’implémentation
Les commentaires d’implémentation visent à expliciter (sans paraphraser) le code et les choix d’implémentation. Le choix des identificateurs et la clarté de la programmation devrait permettre de minimiser le nombre de tels commentaires.
Syntaxe :
/*
* commentaires
*/
/* commentaire */
// commentaire
Fichier JAVA
Nom et contenu d’un fichier java
♦ Chaque fichier source java contient une seule classe publique. L’organisation recommandée est la suivante :
1) Les commentaires de début. C’est un commentaire de documentation comprenant typiquement : l’intitulé de la classe et un descriptif sommaire de sa fonction, l’auteur, la version
2) Les instructions de paquetage
3) Les instructions d’import
4) Les déclarations des classes
♦ Un fichier devrait contenir moins de 2000 lignes et des lignes de moins de 80 caractères, voire 70 pour les commentaires de documentation (recommandation)
♦ Un fichier Java porte le nom de la classe publique qu’il contient ; les fichiers source Java ont pour suffixe .java ; les fichiers Java compilés ont pour suffixe .class (par convention). Les suffixes .java et .class sont imposés par les outils.
……
Si le lien ne fonctionne pas correctement, veuillez nous contacter (mentionner le lien dans votre message)Langage et programmation orientés objets opérateurs et expressions (564 KO) (Cours PDF)
