java - Enunciate 能否为处理泛型类型的 API 生成文档？

Question

给定一个抽象的、通用的 Resource 类和一个具体的实现:

public abstract class AbstractResource<T> {

    @Autowired
    private SomeService<T> service;

    @Path("/{id}")
    @GET
    public T get(@PathParam("id") String id) {
        return service.get(id);
    }
}

@Path("/people")
public class PersonResource extends AbstractResource<Person> { }

似乎在为 PersonResource 生成文档时，Enunciate 没有发现 get() 返回一个 Person 这一事实。

1. Person 未列在“数据模型”>“数据类型”部分中。

2. 在 GET 部分下，Response Body 将元素类型显示为“(自定义)”。

这些问题是因为使用泛型作为实体类型吗？有没有一种方法可以提示阐明真正的类型是什么，以便可以正确生成文档？

Answer 1

Person 是否被注释为@XmlRootElement？如果是，它是否包含在与 PersonResource 相同的项目中？如果不是，您是否按照 Enunciate: Multi-Module Projects 中的描述导入 Person 类？ ？