Question

我有多个Maven模块，可以为我的服务公开各种REST。最重要的是，我有一个（几乎是空的）模块，称为project-docs，我想使用它并生成一个聚合的Enunciate api文档。不幸的是，Enunciate确实希望在执行它的模块中找到一些（如果不是全部）REST。

我试过这个https://github.com/stoicflame/enunciate/wiki/Multi-Module-Projects-%28Version-1%29，但似乎没有用。此外，我还没有找到任何关于 org.codehaus.enunciate：maven-enunciate-plugin 的教程/描述。

查看上面的链接，我已经明确地从其中一个模块中公开了源代码，并将其复制到target/enunciate-scratch目录。但是，我想我缺少一些配置选项。

有人可以帮忙吗？

Answer 1

您是否尝试在project-docs模块中添加依赖项？看起来像enunciate要求类文件应该在类路径中可用，并且还要在enunciate xml文件中导入。

Answer 2

您可以尝试使用api-import

代替api-classes

 <!--<api-classes>
    <include pattern="com.example.**"/>    
  </api-classes> -->

  <api-import pattern="com.example.**"/>

Answer 3

我不确定“似乎不起作用”的含义，但如果在应用了enunciate的项目中没有REST端点，则可能必须明确“包含”这些端点：

<enunciate>
  <api-classes>
    <include pattern="org.mycompany.**"/>
  </api-classes>
</enunciate>