Enunciate ne génère pas de documentation

Question

J'essaie de générer une documentation enunciate à partir d'un mélange de classes, toutes annotées JAX-RS, certaines codées inn java, d'autres en clojure.

J'ai construit un projet Maven qui dépend simplement d'un fichier de guerre contenant les classes de service:

<build> 
    <plugins> 
     <plugin> 
      <groupId>org.codehaus.enunciate</groupId> 
      <artifactId>maven-enunciate-plugin</artifactId> 
      <version>1.27</version> 
      <configuration> 
       <configFile>src/conf/enunciate.xml</configFile> 
       <additionalClasspathEntries> 
        ${settings.localRepository}/com/ws/scholar/0.96-SNAPSHOT/scholar-0.96-SNAPSHOT.war 
       </additionalClasspathEntries> 
      </configuration> 
      <executions> 
       <execution> 
        <goals> 
         <goal>assemble</goal> 
        </goals> 
       </execution> 
      </executions> 
      <dependencies> 
       <dependency> 
        <groupId>com.ws</groupId> 
        <artifactId>scholar</artifactId> 
        <version>0.96-SNAPSHOT</version> 
        <type>war</type> 
       </dependency> 
       <dependency> 
        <groupId>javax.ws.rs</groupId> 
        <artifactId>javax.ws.rs-api</artifactId> 
        <version>2.0</version> 
       </dependency> 
      </dependencies> 
     </plugin> 
    </plugins> 
</build> 

Je ne peux pas obtenir toute la documentation de service pour générer.

Lors de l'exécution mvn enunciate: docs -X, je vois mes cours "Remarqué":

[DEBUG] classe Remarqué WEB-INF.classes.com.ws.scholar.resources.ClientResource dans /.m2/ référentiel/com/ws/scholar/0.96-SNAPSHOT/scholar-0.96-SNAPSHOT.war.

Quelqu'un peut-il offrir des conseils ou des corrections à ma configuration?

Answer 1

Malheureusement, vous ne pouvez pas simplement ajouter une guerre en tant que dépendance et faire en sorte que les classes qui s'y trouvent soient récupérées sur le chemin de classe. Une guerre n'est pas un pot. Au lieu de cela, vous devrez probablement utiliser le paramètre attachClasses du maven-war-plugin pour exporter vos classes en tant que pot en plus de la guerre. Ensuite, vous pouvez compter sur ce pot comme ceci:

  <dependency> 
       <groupId>com.ws</groupId> 
       <artifactId>scholar</artifactId> 
       <version>0.96-SNAPSHOT</version> 
       <classifier>classes</classifier> 
      </dependency>