Discussion :

[k-koo]

Salut a tous !
Je voulais savoir s'il existe un générateur de squellette de "commentaire pour javadoc". Mon code est tout tapé et ce que je souhaiterais cest que ca ajoute tout seul un bloc commentaire devant chaque prototype de chacune des methode / classe à l'interieur de mes fichiers java.
Je precise que je suis sous windows (parce qu'il me semble que y'a des truc qui existe mais qui tourne sous unix).

Merci

[dinobogan]

Salut,

Juste pour assouvir ma curiosité : ça sert à quoi d'ajouter les squelettes de commentaires s'ils ne sont pas remplis ?

[k-koo]

cest pour eviter de taper (et meme copier-coller) 50 fois ce genre de truc simplement

Code :

Sélectionner tout - Visualiser dans une fenêtre à part

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
/**
 * 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
 */

C'est un peu un lourd comme tache je trouve.
Vous voyez un truc qui me demanderai quel genre de champs je veux mettre par defaut, sur quel prototype je veux l'ajouter. Un peu comme pour la vria Javadoc (la generation du HTML) mais juste pour la partie commentaire !

[JPDMJC]

Salut,
avec quel(s) logiciel(s) travailles-tu ?
Il y a notamment NetBeans qui est capable de te préparer les commentaires Javadoc, du moins avec la version 6 (les autres je ne sais plus).
C'est vrai que ça soulage ^^.

[CyberChouan]

Eclipse fait la même chose... Il prépare le bloc javadoc en mettant les balises @param, @return, @throws, etc. et le squelette est paramétrable dans la configuration de l'IDE.

Par contre, il ne génèrera qu'un squelette... Je n'ai pas connaissance d'IDE qui soit capable de deviner à quoi sert une méthode, ses arguments, etc. (sémantiquement).

[bouye]

JBuilder version X, 2005, 2006 et 2007/Eclipse fait pareil. Il suffit de taper /** suivit d'un retour chariot pour creer un squelette de documentation.

[Bezout]

Sous Eclipse on a aussi le raccourci ALT+SHIFT+J avec le curseur positionné dans la méthode.

[Dirty Henry]

Tu peux aussi utiliser l'outil de formattage de code Jalopy.

Une fois installé, dans Eclipse, clic droit + format sur Jalopy et le squelette de toute ta javadoc se fait.

[k-koo]

Eh bien merci pour toutes ces precisions.
Je le saurais pour la prochaine fois !