Enunciate génération de doc API REST en utilisant ant

Question

J'essaie d'intégrer Enunicate pour générer la documentation REST de nos API existantes. Je reçois un avertissement "AVERTISSEMENT: documents d'artefacts inconnus" L'artefact ne sera pas exporté. " lorsque la tâche Ant est exécutée.

Y a-t-il quelque chose qui manque dans ma configuration?

Le enunicate.xml est:

<?xml version="1.0"?> 
<enunciate label="Empath REST api" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:noNamespaceSchemaLocation="http://enunciate.codehaus.org/schemas/enunciate-1.23.xsd"> 
<modules> 
    <!-- Docs --> 
    <docs splashPackage="com.parc.perceptum.common" title="Empath REST API" 
     copyright="PARC">  <download name="License" file="LICENSE.txt" description="The license file governing the use of this API." /> 
    </docs> 
</modules> 
</enunciate> 

et le fragment de fourmi est pertinent:

<path id="enunciate.classpath"> 
    <fileset refid="project.libs"/> 
    <fileset dir="${java.home}"> 
      <include name="lib/tools.jar"/> 
    </fileset> 
    <pathelement path="${servlet-lib}" /> 
    <pathelement path="${mysql-lib}" /> 
</path> 

<taskdef name="enunciate" classname="org.codehaus.enunciate.main.EnunciateTask"> 
    <classpath refid="enunciate.classpath"/> 
</taskdef> 

<target name="new-rest-api-doc"> 
    <enunciate basedir="src/com/parc/perceptum/"> 
     <include name="**/*.java"/> 
     <classpath refid="enunciate.classpath"/> 
     <export artifactId="docs" destination="restapi"/> 
    </enunciate> 
</target> 

Merci

Venu

Answer 1

On dirait que vous pourriez ne pas avoir les bibliothèques Énoncer sur votre chemin de classe. Donc Enunciate ne prend aucun de ses modules (y compris le module docs, qui fournit l'artefact 'docs').

Answer 2

La valeur de artefactId doit être 'war.file'