Discussion :

[noussa88]

Bonjour,

J'ai un projet que je dois traiter, dont le sujet est "Générateur de documentation de code Java annoté".

L’objectif est de développer un outil qui permette de générer une documentation à partir d’un code Java de classes.
Le document généré doit documenter les attributs, les méthodes et les annotations.
Comme POC il faut partir de classes d’entités JPA.

Je dois utiliser l'API Pluggable Annotations Processing sous Eclipse mais je ne sais pas comment établir la configuration.

Quelqu'un saurait-il me guider un peu ?

Merci d'avance

[Laurent.B]

Bonjour,

En cherchant ont trouve ceci http://jmdoudoux.developpez.com/cour...nnotations.php ...

[noussa88]

bonjour,

j'ai déjà suivi ce tuto mais le problème persiste. j'ai utilisé un fichier XML pour utiliser l'API Pluggable Annotations Processing avec ANT, dont le contenu est le suivant :

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
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
<project name="jpa-hibernate" default="compile" basedir=".">
 
    <!-- nom du projet et version -->
    <property name="proj.name" value="jpa-hibernate" />
    <property name="proj.shortname" value="jpa-hibernate" />
    <property name="version" value="1.0" />
 
    <!-- Propriété globales -->
    <property name="src.java.dir" value="src" />
    <property name="lib.dir" value="lib" />
    <property name="build.dir" value="bin" />
 
    <!-- le Classpath du projet -->
    <path id="project.classpath">
        <fileset dir="${lib.dir}">
            <include name="**/*.jar" />
        </fileset>
    </path>
 
    <!-- les fichiers de configuration qui doivent être dans le classpath-->
    <patternset id="conf">
        <include name="**/*.xml" />
        <include name="**/*.properties" />
    </patternset>
 
    <!-- Nettoyage projet -->
    <target name="clean" description="Nettoyer le projet">
        <delete dir="${build.dir}" />
        <mkdir dir="${build.dir}" />
    </target>
 
    <target name="compile">
        <javac srcdir="${src.java.dir}" destdir="${build.dir}" classpathref="project.classpath" />
    </target>
 
    <!-- Compilation projet -->
    <target name="javac">
        <javac srcdir="${src.java.dir}" destdir="${build.dir}" classpathref="project.classpath" fork="true">
            <compilerarg line="-processor com.jmdoudoux.tests.annotations.outils.Processor"/>
        </javac>
    </target>
    <!-- Copier les fichiers de configuration dans le classpath -->
    <target name="copyconf">
        <mkdir dir="${build.dir}" />
        <copy todir="${build.dir}">
            <fileset dir="${src.java.dir}">
                <patternset refid="conf" />
            </fileset>
        </copy>
    </target>
</project>

Parfois il lance le processeur d'annotation et me génère le fichier que je veux et parfois non.
Voila le code de mon processeur :

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
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
package com.jmdoudoux.tests.annotations.outils;
 
import java.io.IOException;
import java.io.PrintWriter;
import java.util.Set;
 
import javax.annotation.processing.AbstractProcessor;
import javax.annotation.processing.Filer;
import javax.annotation.processing.Messager;
import javax.annotation.processing.RoundEnvironment;
import javax.annotation.processing.SupportedAnnotationTypes;
import javax.annotation.processing.SupportedSourceVersion;
import javax.lang.model.SourceVersion;
import javax.lang.model.element.Element;
import javax.lang.model.element.TypeElement;
import javax.lang.model.util.Elements;
import javax.persistence.Entity;
import javax.tools.StandardLocation;
import javax.tools.Diagnostic.Kind;
 
@SupportedAnnotationTypes(value = { "javax.persistence.*" })
@SupportedSourceVersion(SourceVersion.RELEASE_6)
public class Processor extends AbstractProcessor {
 
  @Override
  public boolean process(
      Set<? extends TypeElement> annotations,
      RoundEnvironment roundEnv) {
 
    Filer filer = processingEnv.getFiler();
    Messager messager = processingEnv.getMessager();
    Elements eltUtils = processingEnv.getElementUtils();
 
    if (!roundEnv.processingOver()) {
 
      Set<? extends Element> elements = roundEnv.getElementsAnnotatedWith(Entity.class);
 
      if (!elements.isEmpty())
        try {
          messager.printMessage(Kind.NOTE, "Creation du fichier Todo");
          PrintWriter pw = new PrintWriter(filer.createResource(
              StandardLocation.SOURCE_OUTPUT, "", "Todo.txt")
              .openOutputStream());
          // .createSourceFile("Todo").openOutputStream());
 
          pw.println("Liste des todos\n");
 
          for (Element element : annotations) {
            pw.println("\nelement:" + element.getSimpleName());
            System.out.println("aa3333333");
 
          }
          pw.close();
        } catch (IOException ioe) {
          messager.printMessage(Kind.ERROR, ioe.getMessage());
        }
      else
        messager.printMessage(Kind.NOTE, "Rien a faire");
    } else
      messager.printMessage(Kind.NOTE, "Fin des traitements");
 
    return true;
  }
}

Quelqu'un peut m'aider ?
Merci d'avance