Discussion :

[router_]

Bonjour,

je voudrais généré la javadoc pour plusieurs classes, pour ce faire j'ai défini
une classe:

Code :

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

1
2
3
4
5
6
7
8
9
10
11
12
13
 
import java.lang.annotation.Documented;
 
@Documented
public @interface PointAnnotation {
 
	String author();
	String date();
	int currentRevision() default 1;
	String lastModified() default "N/A"; 
	String lstModifiedby() default "N/A";
	String[] Reviewers();
}

et dans les classes ou je veux générer le code, j'ai ajouté avant le début de la classe et après la partie des importations:

Code :

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

1
2
3
4
5
6
7
@PointAnnotation(
		author = "Moaad El Amrani", 
		date = "04/08/2010",
		Reviewers = { "Moaad El Amrani", "Moaad Moaad" }
	) 
 
public class Point {

je m'attendais à trouver un résultat similaire à celui de
/**
*@author xxx
*@version 1.2
*
*/
mais voila ce que je retrouve dans ma doc

Code :

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

1
2
3
4
@PointAnnotation(author="sssi",
                 date="04/08/2010",
                 Reviewers={"cc","www "})
public class Pointextends java.lang.Object

il réécrit la même chose !!! alors que je m'attendais à ça

Code :

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

1
2
3
4
author
            XXX
date
            02/04/2010

est ce que c'est normal ou que j'ai mal réalisé ma doc

En vous remerciant par avance

[thelvin]

C'est normal, Java ne va pas deviner ce que tu veux en faire, de cette annotation.

Il est peut-être possible de fournir un annotation processor à javadoc pour qu'il reconnaisse ces annotations et décrive à javadoc ce qu'il doit en faire. Peut-être, parce que je n'ai pas vu ce cas d'utilisation précis.

Si quelqu'un connaît ?

[tchize_]

tout ce que fait @Documented c'est afficher ton annotation telle quelle dans la javadoc. Il existe des système de doclets et taglets pour la javadoc de manière à customizer le rendu. tu pourrait fournir un doclet basé sur le standard et qui gère ton annotation, mais ce n'est pas certains.

http://download.oracle.com/javase/1..../overview.html

[router_]

merci beaucoup , c'est plus claire maintenant