2

我正在尝试集成 Enunicate 以生成我们现有 API 的 REST 文档。

我收到警告“警告：未知工件 'docs'。工件将不会被导出。” 蚂蚁任务执行时。

我的设置中是否缺少某些内容？

enunicate.xml 是：

<?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>

相关的蚂蚁片段是：

<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>

谢谢

金星

4

2 回答 2

0

看起来您的类路径中可能没有发音库。因此，Enunciate 不会选择它的任何模块（包括提供“文档”工件的 docs 模块）。

于 2012-10-18T15:38:21.217 回答
0

artifactId 的值应该是 'war.file'

于 2014-05-06T15:20:27.580 回答