Can Enunciate为处理泛型类型的API生成文档?

时间:2013-03-15 03:59:47

标签: java rest jax-rs enunciate

给出一个抽象的,通用的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. 人员未在数据模型中列出&gt;数据类型部分。

  2. 在GET部分下,Response Body将元素类型显示为“(custom)”。

  3. 这些问题是因为使用泛型作为实体类型吗?有没有办法提示发音真实类型是什么,以便正确生成文档?

    enter image description here

1 个答案:

答案 0 :(得分:0)

Person是否注明为@XmlRootElement?如果是,它是否包含在与PersonResource相同的项目中?如果没有,您是否按Enunciate: Multi-Module Projects

中所述导入Person课程