Enunciate能为处理通用类型的API生成文档吗？

Question

给定一个抽象的、通用的资源类和一个具体的实现：

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”未列在“数据模型>Data Types”部分中。

2. 在GET部分下，响应主体显示元素类型为“(custom)”。

可能是由于使用泛型作为实体类型而导致的问题。是否有办法提示Enunciate真实类型以便正确生成文档？

- Jeremy Ross

Answer 1

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

- Ryan Heaton