java可以为处理泛型类型的API生成文档吗?
给定抽象的通用资源类和具体实现:
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
生成文档时,Enounciate似乎没有发现get()
返回一个Person
的事实
数据模型中未列出人员>;数据类型部分
在GET部分下,响应主体将元素类型显示为“(custom)”
这些问题是因为使用泛型作为实体类型吗?有没有一种方法可以提示说明真正的类型是什么,以便正确生成文档
# 1 楼答案
Person
是否注释为@XmlRootElement
?如果是,它是否与PersonResource
包含在同一个项目中?如果没有,您是否正在导入Enunciate: Multi-Module Projects中描述的Person
类