常见问题记录

为什么生成的 Response 结果不在 JavaBean 中出现的字段解析不出来？

JApiDocs 是基于源码文件进行解析的，而且只对 JavaBean的成员变量进行了遍历，对于动态设置的内容，比如 map 里面的内容是没法解析到的。

出现 stackoverflow

由于 JApiDoc 是基于源代码进行静态解析的，参数对象和返回对象类不能支持循环引用，请检查JavaBean对象是否出现循环引用。

class UserVO{
    BookVO book;
}

class BookKVO{
    UserVO user;
}

cannot find java file 是怎么回事？

试着检查你 JavaBean 中的成员变量是否出现了非下面的类型：

• 基本数据类型(int, Integer...)。
• java.lang.String, java.lang.BigInteger, java.lang.BigDecimal
• java.util.Date, java.util.ZonedDateTime。
• 实现了 Collection 接口的列表类型，并且带了具体的泛型信息。
• 引用都是在源码中自己声明的 JavaBean，而并非是 jar 包里面的。

目标接口没有生成怎么回事？

JApiDocs 只对加了 @ApiDoc 注解的方法生成接口，请检查你是否在相应方法添加了这个注解。

Note: 该注解可以自己在工程里面添加，不需要引入jar包，当然引入jar包也是可以的。