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

Video Face Swap

Video Face Swap

Échangez les visages dans n'importe quelle vidéo sans effort grâce à notre outil d'échange de visage AI entièrement gratuit !

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.

Quelle est la norme pour l'interface API ? Quelle est la norme pour l'interface API ? Feb 23, 2024 pm 08:15 PM

La spécification d'interface API (Application Programming Interface) fait référence à une série de directives et de spécifications qui définissent et spécifient les interfaces API dans le développement de logiciels. Le but de la spécification de l'interface API est d'assurer l'interopérabilité et la cohérence entre les différents composants logiciels. Cet article présentera plusieurs aspects importants des spécifications de l'interface API. Convention de dénomination de l'interface Le nom d'une interface API doit être clair, concis et cohérent, et pouvoir exprimer avec précision sa fonction et son objectif. Les conventions de dénomination doivent suivre les pratiques du secteur et les conventions internes de l'équipe de développement, et éviter d'utiliser des termes vagues et prêtant à confusion. ce

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

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

Explication détaillée des exemples d'amarrage entre le langage Go et l'interface Tencent Cloud Explication détaillée des exemples d'amarrage entre le langage Go et l'interface Tencent Cloud Jul 06, 2023 pm 05:06 PM

Explication détaillée des exemples d'amarrage entre le langage Go et l'interface Tencent Cloud Ces dernières années, avec le développement de la technologie cloud computing, les fournisseurs de services cloud sont devenus le premier choix de nombreuses entreprises et développeurs. En tant que principal fournisseur de services cloud en Chine, Tencent Cloud fournit une série d'interfaces API que les développeurs peuvent appeler afin de faciliter l'utilisation par les développeurs de ses riches fonctions de service cloud. Langage de programmation simple et efficace, le langage Go est de plus en plus plébiscité par les développeurs. Cet article présentera en détail comment utiliser le langage Go pour se connecter à l'interface Tencent Cloud et donnera un exemple de code spécifique. 1. Stade précoce

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,

See all articles