Maison Java Javacommencer Introduction à la spécification javadoc

Introduction à la spécification javadoc

Jan 25, 2021 am 09:49 AM
javadoc 规范

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识别
	 */
Copier après la connexion

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 :

Introduction à la spécification javadoc

Introduction à la spécification javadoc

Introduction à la spécification javadoc

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;
	}

}
Copier après la connexion

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

<🎜. >Comment faire la distinction entre le résumé de la méthode et les détails de la méthode ?

/**
	 * main()方法简述(后面这个dot必不可少).
	 * <p>这就是为了测试注释<br>
	 * 没什么好说明的,只为了说明能出现在这里
	 * @param args 就是系统配的,没啥说的
	 * 
	 */
	public static void main(String[] args) {
//		 TODO Auto-generated method stub
		System.out.println("hello");	

	}
Copier après la connexion
Vous avez dû constater qu'il y a beaucoup de commentaires sur les méthodes Comment extraire le résumé de javadoc ? C'est vrai, comptez simplement sur un point (.), observez le point mentionné dans mon commentaire, c'est la clé pour extraire le résumé. Le point est précédé du résumé, et tout est une introduction détaillée (l'introduction détaillée inclut le résumé. )

Comment contrôler la composition des commentaires dans les documents générés

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.

Description du paramètre @param 1 (notez le format)

@description de la valeur de retour (notez le format)

É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

En fait, écrire des commentaires de classe et des commentaires de méthode est très simple. Tapez simplement /** devant la classe et la méthode. , puis appuyez sur Entrée, le système l'ajoutera automatiquement et nous pourrons modifier la façon dont le système l'ajoute

Comment modifier le contenu qui apparaît lors de la création d'un nouveau fichier, comment faire les commentaires d'auto-complétion sous notre contrôle (à faire)

Nous voyons cela dans le fichier de classe standard :

Introduction à la spécification javadoc

Nous savons tous que out est un attribut (champ) du Classe système, qui est de type PrintStream. Il existe de nombreuses méthodes définies dans la classe PrintStream. Ce sont naturellement des méthodes out, donc lors de la définition de out , il y a beaucoup de @see dans les commentaires devant. pour utiliser l'annotation @see Nous recommandons que lors de la définition des champs d'une classe, si le champ est un type composite (en particulier un type composite personnalisé), alors notez @see devant, cela présente deux avantages, veuillez voir l'image :

Introduction à la spécification javadoc

Introduction à la spécification javadoc

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!

Déclaration de ce site Web
Le contenu de cet article est volontairement contribué par les internautes et les droits d'auteur appartiennent à l'auteur original. Ce site n'assume aucune responsabilité légale correspondante. Si vous trouvez un contenu suspecté de plagiat ou de contrefaçon, veuillez contacter admin@php.cn

Outils d'IA chauds

Undresser.AI Undress

Undresser.AI Undress

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

AI Clothes Remover

AI Clothes Remover

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

Undress AI Tool

Undress AI Tool

Images de déshabillage gratuites

Clothoff.io

Clothoff.io

Dissolvant de vêtements AI

AI Hentai Generator

AI Hentai Generator

Générez AI Hentai gratuitement.

Article chaud

R.E.P.O. Crystals d'énergie expliqués et ce qu'ils font (cristal jaune)
2 Il y a quelques semaines By 尊渡假赌尊渡假赌尊渡假赌
Repo: Comment relancer ses coéquipiers
1 Il y a quelques mois By 尊渡假赌尊渡假赌尊渡假赌
Hello Kitty Island Adventure: Comment obtenir des graines géantes
4 Il y a quelques semaines By 尊渡假赌尊渡假赌尊渡假赌
Combien de temps faut-il pour battre Split Fiction?
3 Il y a quelques semaines By DDD

Outils chauds

Bloc-notes++7.3.1

Bloc-notes++7.3.1

Éditeur de code facile à utiliser et gratuit

SublimeText3 version chinoise

SublimeText3 version chinoise

Version chinoise, très simple à utiliser

Envoyer Studio 13.0.1

Envoyer Studio 13.0.1

Puissant environnement de développement intégré PHP

Dreamweaver CS6

Dreamweaver CS6

Outils de développement Web visuel

SublimeText3 version Mac

SublimeText3 version Mac

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

Conventions de dénomination des variables requises dans l'apprentissage Python Conventions de dénomination des variables requises dans l'apprentissage Python Jan 20, 2024 am 09:03 AM

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 ? 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 ? Sep 05, 2023 pm 02:46 PM

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.

Analyse des touches de raccourci de formatage PyCharm : comment unifier rapidement le style de code Analyse des touches de raccourci de formatage PyCharm : comment unifier rapidement le style de code Jan 27, 2024 am 10:38 AM

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

Comment résoudre le problème de l'utilisation irrégulière des espaces indentés dans le code Python ? Comment résoudre le problème de l'utilisation irrégulière des espaces indentés dans le code Python ? Jun 24, 2023 pm 09:03 PM

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

Normes d'écriture PHP et pratique du travail d'équipe : améliorer l'efficacité du développement de projets Normes d'écriture PHP et pratique du travail d'équipe : améliorer l'efficacité du développement de projets Aug 25, 2023 pm 11:27 PM

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,

Conseils de développement C++ : Comment améliorer la qualité et les performances de votre code C++ Conseils de développement C++ : Comment améliorer la qualité et les performances de votre code C++ Nov 22, 2023 pm 04:31 PM

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

Pratiques et normes de codage courantes en langage Go Pratiques et normes de codage courantes en langage Go Jun 01, 2023 am 09:51 AM

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

Comment résoudre l'erreur d'irrégularité d'utilisation de la bibliothèque dans le code Python ? Comment résoudre l'erreur d'irrégularité d'utilisation de la bibliothèque dans le code Python ? Jun 24, 2023 am 11:55 AM

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

See all articles