248 votes

Comment générer des commentaires javadoc dans Android Studio

Puis-je utiliser des raccourcis clavier dans Android studio pour générer des commentaires javadoc ?

Sinon, quel est le moyen le plus simple de générer des commentaires javadoc ?

434voto

DouO Points 4059

Je ne trouve pas de raccourci pour générer des commentaires javadoc. Mais si vous tapez /** avant la déclaration de la méthode et appuyez sur Entrée, le bloc de commentaires javadoc sera généré automatiquement.

Lire este pour plus d'informations.

124voto

Amey Haldankar Points 61

Pour générer des commentaires, tapez /** avant la déclaration de la méthode et appuyez sur Enter . Il générera des commentaires javadoc.

Exemple :

/**
* @param a
* @param b
*/

public void add(int a, int b) {
    //code here
}

Pour plus d'informations, consultez le lien suivant https://www.jetbrains.com/idea/features/javadoc.html

45voto

Suragch Points 197

Voici un exemple de commentaire JavaDoc d'Oracle :

/**
 * Returns an Image object that can then be painted on the screen. 
 * The url argument must specify an absolute {@link URL}. The name
 * argument is a specifier that is relative to the url argument. 
 * <p>
 * This method always returns immediately, whether or not the 
 * image exists. When this applet attempts to draw the image on
 * the screen, the data will be loaded. The graphics primitives 
 * that draw the image will incrementally paint on the screen. 
 *
 * @param  url  an absolute URL giving the base location of the image
 * @param  name the location of the image, relative to the url argument
 * @return      the image at the specified URL
 * @see         Image
 */
 public Image getImage(URL url, String name) {
        try {
            return getImage(new URL(url, name));
        } catch (MalformedURLException e) {
            return null;
        }
 }

Le format de base peut être généré automatiquement de l'une des manières suivantes :

  • Positionnez le curseur au-dessus de la méthode et tapez /** + Enter
  • Positionnez le curseur sur le nom de la méthode et appuyez sur Alt + Enter > cliquez sur Ajouter un JavaDoc enter image description here

18voto

darwin Points 980

Vous pouvez installer le plugin JavaDoc à partir de Settings->Plugin->Browse repositories.

obtenir la documentation du plugin à partir du lien ci-dessous

Document du plugin JavaDoc

enter image description here

12voto

kuldeep kumar Points 121

Les commentaires Javadoc peuvent être ajoutés automatiquement en utilisant la fonction de complétion automatique de votre IDE. Essayez de taper /** et en frappant Enter pour générer un exemple de commentaire Javadoc.

 /**
 *
 * @param action          The action to execute.
 * @param args            The exec() arguments.
 * @param callbackContext The callback context used when calling back into JavaScript.
 * @return
 * @throws JSONException
 */

Prograide.com

Prograide est une communauté de développeurs qui cherche à élargir la connaissance de la programmation au-delà de l'anglais.
Pour cela nous avons les plus grands doutes résolus en français et vous pouvez aussi poser vos propres questions ou résoudre celles des autres.

Powered by:

X