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

Jer*_*oss 5 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> { }
Run Code Online (Sandbox Code Playgroud)

看来,在生成文档时PersonResource,Enunciate没有拿起get()返回a 的事实Person.

  1. Person未列在"数据模型">"数据类型"部分中.

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

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

在此输入图像描述

小智 0

注释Person@XmlRootElement?如果是,它是否包含在同一个项目中PersonResource?如果没有,您是否按照阐明:多模块项目Person中所述导入类?