1

我的第一个工作任务是进行清晰的构建以生成 Rest API 文档。我正在使用 Ant 构建工具。我正在我们的一个名为 xmbo 的模块上应用发音。我遇到一个错误：

java.util.zip.ZipException: ZIP 文件在构建过程中必须至少有一个条目。

我已经根据http://enunciate.codehaus.org/executables.html#ant为发音任务定义了以下类路径（我在下面的代码中注释掉了 spring 模块，因为它是可选的）

<path id="enunciate.base.classpath">
  <fileset dir="${enunciate.home}/lib">    
    <include name="*.jar"/>
    <exclude name="enunciate-jersey-1.28.jars"/>
    <exclude name="enunciate-jersey-rt-1.28.jar"/>
    <exclude name="enunciate-xml-1.28.jar"/>
    <exclude name="enunciate-java-client-1.28.jar"/>
    <exclude name="enunciate-jaxws-ri-1.28.jar"/>
    <exclude name="enunciate-jaxws-support-1.28.jar"/>
    <exclude name="enunciate-jaxws-support-1.28.jar"/>
   </fileset>

     <!--include (optional) spring module-->
    <!--<fileset dir="${enunciate.home}/lib/modules/spring">-->
      <!--<include name="*.jar"/>-->
    <!--</fileset>-->
</path>

阐明目标：

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

<target name="generate_api_doc" depends="compile_xmbo"> 
  <delete dir="${enunciate.src.dir}"/> 
  <mkdir dir="${enunciate.src.dir}"/> 
  <delete dir="${xmbo.build.dir}/stage/xmbo/webservices/war/docs"/> 
  <mkdir dir="${xmbo.build.dir}/stage/xmbo/webservices/war/docs"/> 
   <copy todir="${enunciate.src.dir}"> 
     <fileset dir="${xmbo.src.dir}"> 
       <include name="com/../webservice/**"/> 
       <include name="com/../wso/**"/> 
       <include name="com/../constants/**"/> 
       <exclude name="com/../**"/> 
       <exclude name="com/../**"/> 
     </fileset> 
   </copy> 

 <enunciate basedir="${enunciate.src.dir}" configFile="${config.dir}/properties/enunciate.xml"> 

    <include name="**/*.java"/> 
    <exclude name="**/client/**,**/xdm/**"/> 
    <classpath refid="enunciate.full.classpath"/> 

    <export artifactId="docs" destination="${xmbo.build.dir}/stage/xmbo/webservices/war/docs"/> 
    <javacArgument argument="-g"/> 
  </enunciate> 
 </target>

（在复制任务下包含和排除，我没有在这个页面中给出完整的名称，但在我的 xml 文件中它是正确的）。目标 generate_api_doc 依赖于目标 compile_xmbo，它编译并创建需要“阐明”的 jar。

发音.xml：

<?xml version="1.0" encoding="UTF-8"?>
  <enunciate>
    <api-classes>
  <exclude pattern="**/xdm/**/*.java"/>
  <exclude pattern="com.xactly.xdm.*"/>
  <exclude pattern="com.xactly.xbpm.****"/>
    </api-classes>
    <deployment protocol="http" host="http://.../xmbo/xmbows" context="/api"/>
    <webapp doCompile="false" doLibCopy="false"/>
  </enunciate>

（主机是我们的服务器地址）

一旦我通过命令行调用模块目标 deploy_api_doc 运行构建，它就会给出 java.util.zip.ZipException: ZIP 文件必须至少有一个条目。

我做错什么了吗？

4

0 回答 0