用 Java Restful Web 服务阐明文档生成问题

【问题标题】：Enunciate doc generation issue with Java Restful webservices用 Java Restful Web 服务阐明文档生成问题
【发布时间】：2014-11-29 15:33:14
【问题描述】：

我正在尝试使用 enunciate 插件为我的 JAVA RESTful Web 服务项目生成 REST 文档。每当我使用 Maven 构建运行 POM.xml 时。我收到以下警告，并且根本没有生成文档..

[警告] [docs] 未找到启动包 com.layer.rest.service.interfaces。不包含初始文档。

有什么线索吗？

【问题讨论】：

你能在你的问题中加入一些代码吗？像 pom.xml 和 web.xml（如果有的话）。

标签： enunciate

【解决方案1】：

Enunciate 尝试使用您在 enunciate.xml 中定义的包中 package-info.java 中的 JavaDoc，如下所示：

<enunciate label="Foo" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
<modules>
    <docs title="My Foo API"
        splashPackage="org.foo"  />

基于此配置，发音将查找org.foo.package-info.java。如果找不到，它会显示您收到的警告。

有关更多详细信息，请参阅此处的docs 模块文档：https://github.com/stoicflame/enunciate/wiki/Module-Docs

【讨论】：