Table des matières:

Où mettre les commentaires Javadoc ?
Où mettre les commentaires Javadoc ?

Vidéo: Où mettre les commentaires Javadoc ?

Vidéo: Où mettre les commentaires Javadoc ?
Vidéo: Java POO : Javadoc 2024, Avril
Anonim

Les javadoc l'utilitaire vous permet mettre ton commentaires juste à côté de votre code, à l'intérieur de votre fichier ". Java " fichiers sources. Lorsque vous êtes satisfait de votre code et commentaires , vous exécutez simplement le javadoc commande et votre style HTML Documentation est automatiquement créé pour vous.

Alors, comment ajouter des commentaires à un Javadoc ?

Gardez ce qui suit à l'esprit lorsque vous utilisez Ajouter un commentaire Javadoc (Alt+Maj+J): pour ajouter une commenter à un champ, positionnez le curseur sur la déclaration du champ. À ajouter une commenter à une méthode, positionnez le curseur n'importe où dans la méthode ou sur sa déclaration.

à quoi servent les commentaires Javadoc ? Javadoc est un outil qui vient avec JDK et c'est utilisé pour générer Java documentation du code au format HTML de Java code source, qui nécessite une documentation dans un format prédéfini. Voici un exemple simple où les lignes à l'intérieur de /*…. */ sommes Java multiligne commentaires.

De celui-ci, où dois-je mettre Javadoc ?

Vous pouvez placer des commentaires JavaDoc dans l'un des trois emplacements différents d'un fichier source:

  1. Immédiatement avant la déclaration d'une classe publique.
  2. Immédiatement avant la déclaration d'un domaine public.
  3. Immédiatement avant la déclaration d'une méthode ou d'un constructeur public.

Comment rédiger des commentaires Javadoc dans Intellij ?

3 réponses. Taper /** + puis appuyer sur Entrée au-dessus d'une signature de méthode créera Javadoc talons pour vous. Vous pouvez utilisation l'action 'Réparer la doc commenter '. Il n'a pas de raccourci par défaut, mais vous pouvez lui attribuer le raccourci Alt + Shift + J dans le Keymap, car ce raccourci n'est utilisé pour rien d'autre.

Conseillé: