可以阐明产生,处理泛型类型的API文档?(Can Enunciate generate docs f

2019-08-17 15:24发布

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

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 ,字正腔圆不是捡的事实get()返回一个Person

  1. 人是不是在数据模型>数据类型部分列出。

  2. 下的GET部,响应体示出元素类型为“(自定义)”。

是因为使用泛型作为实体类型的这些问题? 有没有办法来暗示字正腔圆的真正类型是什么,所以可以正确生成的文件?

Answer 1:

Person标注为@XmlRootElement ? 如果是这样,它是包含在同一项目中PersonResource ? 如果没有,你导入Person类中描述阐明:多模块项目 ?



文章来源: Can Enunciate generate docs for an API that handles generic types?