如何测试我的Swagger文档有效？

Question

Swagger注释很容易偏离实际代码。

例如

我可以将返回值从Response.ok更改为Response.created，并且很容易忘记将注释从200更新为201。

或者我可以将有效值更改为null或not null，即使最终用户的有效负载与文档中的内容完全匹配，最终用户也将获得令人困惑的拒绝消息。

我如何测试我的招摇文档与我的代码在做什么？

• 使用硒和phantomjs解析swagger-ui网页的测试吗？
• 反思解析注解？
• 获取生成的swagger.json并解析吗？
• 还有什么？

不幸的是，我无法切换到Spring REST Docs。

Answer 1

您可以检查following library，其中包含几个涉及API验证的项目。我认为您正在寻找的那个称为“ swagger-request-validator-mockmvc”，但是您可能会发现其他库也很有用。 祝你好运。