Introduction à la spécification javadoc
Introduction :
Nous savons que javadoc est intégré dans le JDK, donc suivre la spécification javadoc est définitivement l'orthodoxie de l'annotation java. Avec l'aide de javadoc, c'est. est nécessaire pour générer la documentation API Très pratique.
(Partage de vidéos d'apprentissage : tutoriel vidéo Java)
1. Que sont les commentaires
Les commentaires sont à faire ? coder plus Il est lisible et réduit le coût de communication du travail d'équipe. Dans une équipe, si votre code est plus clair, plus lisible et plus standardisé, alors la promotion et l'augmentation de salaire seront définitivement les vôtres, car vous pourrez être compatible avec plus de personnes.
J'ai entendu un dicton il y a quelque temps : si vous êtes le seul à pouvoir comprendre votre code, alors vous êtes la personne indispensable. La personne qui a dit cela est stupide. Lui seul peut comprendre le code qu'il écrit. Personne ne veut le voir. Il vit comme un petit-fils.
2. Touches de raccourci de commentaire couramment utilisées
Commenter une ligne : //Je suis le contenu de la ligne
Touche de raccourci : ctrl+/ Opération inverse : ctrl+/Commenter un bloc : / *Je suis le contenu du bloc* /
Touche de raccourci : ctrl+shift+/ Opération inverse : ctrl+shift+javadoc Commentaires reconnaissables :
/** * 我是注释 * 我也是注释 * 我还是注释,我们都能被javadoc识别 */
3. Spécification Javadoc
Suivez la spécification javadoc, nous pouvons utiliser la commande javadoc pour générer des documents API très intuitifs et faciles à lire, ce qui est très pratique.
Les commentaires que nous apparaissons dans le programme peuvent être consciemment divisés en deux types, l'un est constitué de commentaires simples, pour notre propre lecture, et l'autre est constitué de commentaires conformes à la spécification javadoc, dans le but de générer des commentaires faciles à lire. documents.
Lisez attentivement le document API généré. Il y a trois parties que nous devons expliquer, comme le montre la figure :
Le contenu dans la case rouge ci-dessus est les commentaires que j'ai ajoutés. C'est un simple cours Hello. Le code source est le suivant. Si vous êtes intéressé, vous pouvez l'essayer vous-même :
./** * @author XXXX * @version 创建时间:2021年1月21日 下午3:22:01 * */ public class Hello { /** * main()方法简述(后面这个dot必不可少). * <p>这就是为了测试注释<br> * 没什么好说明的,只为了说明能出现在这里 * @param args 就是系统配的,没啥说的 * */ public static void main(String[] args) { // TODO Auto-generated method stub System.out.println("hello"); } /** * havaReturn方法就是为了测试javadoc注释规范的. * <p>我发现只有有返回值的方法才可以使用return标签<br> * 没有return硬是要用,只会在javadoc时候报错 * @param a 输入的第一个int类型的参数 * @param b 输入的第二个int类型的参数 * @return add 两个数的和运算结果 */ public int haveReturn(int a,int b){ int add=0; add=a+b; return add; } }
Il y a plusieurs points à souligner :
Si vous souhaitez que l'auteur et la version apparaissent dans le document API, vous ne devez pas seulement ajouter @author et @version dans les commentaires du programme ( il est à noter que l'annotation de @author à plusieurs endroits dans le programme ne sera affichée qu'une seule fois dans le document final (je recommande de ne commenter qu'une seule fois), et de le signaler également dans la commande dos lors de la compilation :
dossier javadoc -d. -version -author Hello.java
où -d dossier signifie que vous placez le document API généré (en fait de nombreuses pages Web composées) est placé dans un dossier dossier Bien sûr, le dossier peut également être un chemin
/** * main()方法简述(后面这个dot必不可少). * <p>这就是为了测试注释<br> * 没什么好说明的,只为了说明能出现在这里 * @param args 就是系统配的,没啥说的 * */ public static void main(String[] args) { // TODO Auto-generated method stub System.out.println("hello"); }
Ce que nous pouvons contrôler dans le programme, c'est la composition des commentaires, mais cette composition n'est pas reconnue par Javadoc qui trouve une ligne de commentaires et uniquement. supprime * et les espaces. , je viens de le passer et j'ai remarqué que le document généré est de type HTML, donc tant que vous commentez la syntaxe HTML dans le programme, vous pouvez modifier le format du document API. trop difficile, car nous utilisons simplement une syntaxe HTML simple, comme les paragraphes
, la nouvelle ligne
, cela suffit, après tout, les commentaires ne seront pas très longs.
Écrivez-la s'il y a une valeur de retour S'il n'y a pas de valeur de retour. , vous n'avez pas besoin de l'écrire. Si vous l'écrivez, ce sera le cas. Signalement des erreurs
Je pense que vous connaissez ces deux images. La première est une invite qui peut apparaître lorsque le curseur reste lors de l'écriture d'un programme. Si vous écrivez des commentaires selon la spécification javadoc, alors vous l'avez écrit vous-même. Le programme apparaît également avec ces invites extrêmement utiles. La seconde est la description détaillée du champ out dans la classe String dans le document API Java8. C'est également le mérite de @see. Vous avez écrit @see, et il existe une telle annotation dans votre propre document API de projet.
Recommandations associées : Tutoriel d'introduction à Java
Ce qui précède est le contenu détaillé de. pour plus d'informations, suivez d'autres articles connexes sur le site Web de PHP en chinois!

Outils d'IA chauds

Undresser.AI Undress
Application basée sur l'IA pour créer des photos de nu réalistes

AI Clothes Remover
Outil d'IA en ligne pour supprimer les vêtements des photos.

Undress AI Tool
Images de déshabillage gratuites

Clothoff.io
Dissolvant de vêtements AI

AI Hentai Generator
Générez AI Hentai gratuitement.

Article chaud

Outils chauds

Bloc-notes++7.3.1
Éditeur de code facile à utiliser et gratuit

SublimeText3 version chinoise
Version chinoise, très simple à utiliser

Envoyer Studio 13.0.1
Puissant environnement de développement intégré PHP

Dreamweaver CS6
Outils de développement Web visuel

SublimeText3 version Mac
Logiciel d'édition de code au niveau de Dieu (SublimeText3)

Sujets chauds

Conventions de dénomination des variables que vous devez connaître lors de l'apprentissage de Python Un aspect important lors de l'apprentissage du langage de programmation Python est d'apprendre à nommer et à utiliser correctement les variables. Les variables sont des identifiants utilisés pour stocker et représenter des données. De bonnes conventions de dénomination des variables améliorent non seulement la lisibilité de votre code, mais réduisent également le risque d'erreurs. Cet article présentera certaines conventions de dénomination de variables couramment utilisées et donnera des exemples de code correspondants. Utilisez des noms significatifs Les noms de variables doivent avoir une signification claire et pouvoir décrire les données stockées dans la variable. Utiliser des noms significatifs lui permet de

Comment pouvez-vous comprendre les principes et les objectifs de conception derrière la dernière spécification de code PHP en lisant son code source ? Introduction : lors de l'écriture de code PHP de haute qualité, il est très important de suivre certaines normes de codage. Grâce aux spécifications du code, la lisibilité, la maintenabilité et l’évolutivité du code peuvent être améliorées. Pour le langage PHP, il existe une spécification de code largement adoptée, à savoir PSR (PHPStandardsRecommendations). Cet article explique comment lire le code source de la dernière spécification de code PHP.

Standardisez rapidement le style de code : la lisibilité et la cohérence du code d'analyse des touches de raccourci formaté PyCharm sont très importantes pour les programmeurs. Sous réserve du respect de certaines spécifications de style de codage, l’écriture de code propre peut rendre le projet plus facile à maintenir et à comprendre. En tant qu'environnement de développement intégré puissant, PyCharm fournit des touches de raccourci pour nous aider à formater rapidement le code. Cet article présentera plusieurs touches de raccourci couramment utilisées dans PyCharm, ainsi que leur utilisation et leurs effets spécifiques. 1. Coder l'indentation automatique (Ctrl

Python est un langage de programmation très populaire. Il est privilégié par de plus en plus de personnes en raison de sa simplicité, de sa facilité de compréhension et de sa facilité d'apprentissage. En Python, l'indentation et le format du code sont très importants s'ils sont utilisés de manière irrégulière, ils affecteront grandement la lisibilité et la maintenabilité du code. Cet article vise à présenter plusieurs méthodes pour résoudre le problème des espaces d'indentation irréguliers dans le code Python. Utilisation d'outils automatisés Dans la programmation Python, il est très important de respecter les normes de codage. Chaque indentation dans le code doit utiliser le même nombre d'espaces. Si vous modifiez manuellement ligne par ligne

La pratique de la rédaction de spécifications PHP et la coopération en équipe : améliorer l'efficacité du développement de projets Dans le développement de projets, la rédaction de spécifications est une pratique nécessaire. De bonnes normes d'écriture peuvent améliorer la lisibilité et la maintenabilité du code, éviter les erreurs de bas niveau et permettre aux membres de l'équipe de mieux collaborer. Cet article présentera quelques pratiques d'écriture de spécifications en PHP et explorera comment appliquer ces spécifications dans le travail d'équipe pour améliorer l'efficacité du développement de projets. Utilisation du standard PSR-2 PSR-2 est un standard de spécifications de code PHP. Il établit un ensemble de formats de code, de commentaires,

C++ est un langage de programmation puissant largement utilisé dans des domaines tels que le développement au niveau système, le développement de jeux et le calcul haute performance. Cependant, le C++ nécessite également une qualité de code et des performances supérieures en raison de sa complexité et de sa flexibilité. Cet article explorera quelques suggestions sur la façon d’améliorer la qualité et les performances du code C++. Comprendre la gestion de la mémoire : C++ est un langage de bas niveau qui peut manipuler directement la mémoire. Par conséquent, il est crucial de comprendre comment gérer correctement la mémoire. Il est indispensable d’éviter les fuites de mémoire et les pointeurs suspendus. Utilisez des pointeurs intelligents et RAII (l'acquisition des ressources est initiale

Avec la vulgarisation et l'application progressives du langage Go, les pratiques de codage et les spécifications du langage Go ont également reçu de plus en plus d'attention et d'attention. Cet article présentera les pratiques et spécifications de codage courantes dans le langage Go pour aider les développeurs à écrire du code Go de haute qualité. Formatage du code Le formatage du code en langage Go est une spécification et une pratique très importantes. Le langage Go fournit un outil officiel de formatage de code - goimports, qui peut ajuster automatiquement l'indentation, les espaces, les guillemets, etc. du code, et peut également importer automatiquement des packages non importés. Utiliser goimpo

Python est un langage de programmation très flexible, facile à apprendre et à utiliser. Un grand nombre de bibliothèques et de modules tiers rendent Python puissant. Cependant, en raison de la diversité et de la flexibilité des bibliothèques, les développeurs Python commettent souvent des erreurs lors de l'utilisation de bibliothèques qui ne sont pas standardisées. Une gestion correcte de ces erreurs peut améliorer la qualité du code, augmenter la lisibilité du code et éviter la génération d'erreurs et de vulnérabilités de programme. Cet article explique comment résoudre les erreurs d'utilisation irrégulière de la bibliothèque dans le code Python. Manque de déclaration de bibliothèque en Python si vous le souhaitez
