在多模块Maven项目中使用发音

Question

我正在使用Enunciate为多模块Maven项目中的RestEasy服务生成文档。在试图获取响应对象属性的描述时，我在文档生成方面遇到了一些问题。

例如，如果我的服务定义为：

@GET
@Path("access/account")
@Produces({ MediaType.APPLICATION_JSON, MediaType.APPLICATION_XML })
Account getAccount(@Context HttpServletRequest hsr, @Context UriInfo info) throws RestApiException;

当生成留档时，不生成属性描述。

name                type    description
idProfile           int     (no documentation provided)
idLanguage          int     (no documentation provided)
idRegion            int     (no documentation provided)
userType            string  (no documentation provided) 

在我只得到的所有响应对象中（未提供文档）。一个重要的想法是，所有响应类都位于服务所在的不同 Maven 模块中。响应类位于 UTIL 模块中。这些服务位于 EJB 模块中。

问题的原因肯定是多模块Maven项目，因为如果我定义一个响应对象，该类也在EJB模块中，文档是完美的(也生成了描述)。

原因和解决方案如下所述：https://github.com/stoicflame/enunciate/wiki/Multi-模块-项目-（版本-1）

尽管如此，我仍然不知道到底要做什么，以及在不同的POM(EJB和UTIL)中设置什么来解决我的问题。

感谢任何帮助。

Answer 1

问题已解决!!!

我不得不:

< li >如Ryan所说导入类 < li >在所有响应对象所在的UTIL类的pom.xml中添加maven-source-plugin < li >添加描述以获取引用类中的方法

结果是：

JSON
property    type    description
idProfile   int     Description B.
idLanguage  int     Description A.
idRegion    int     Description E.
userType    string  Description D.

Answer 2

那么，您是否尝试过按照多模块项目中的说明“导入”帐户类？

<enunciate ...>
  <api-import pattern="com.mycompany.Account" />
  <api-import pattern="com.mycompany.*" />
  ...
</enunciate>