rest - Swagger 和 RESTful spring hatoas 资源

Question

在我的 RESTful API 中，所有资源都扩展了 Spring 的 ResourceSupport基地，以确保设计的 hatoas 校长。例如:

public class PoolResource extends ResourceSupport {
    private String name;
    ...
}

我也在使用 Swagger，我想知道:是否可以以某种方式配置 swagger-ui，以忽略来自 ResourceSupport 的属性？



(Swagger-ui 提供了一个很好且简单的 API 前端。作为使用 Swagger 的主要好处之一，API 很容易理解，并且对于那些甚至不熟悉 REST API 的人来说也很容易使用 API。. .只要“链接”和“rels”出现在图片中。)

Answer 1

我建议放弃 Swagger ，使用像 Postman 这样的restclient . Postman 使 spring-hateoas 提供的链接可点击，因此您可以非常快速地浏览 API。如果您想提供一些额外的信息/文档，您可以将这些请求保存到 Postman 中的请求集合中，然后将其导出以进行分发。
在我尝试了几种rest apis的文档工具，包括raml、swagger、apiary以及最后结合hataos的Postman-collections之后，我发现后者是我最满意的一个。