如何使用enunciate来忽略重复的REST路径？

Question

我们在spring REST API中有几种方法，用于处理完全符合我们API的请求，或者允许使用尾部斜杠。我们使用这个注释：

@RequestMapping(value = {"", "/"}, produces = {"application/json"}, method = RequestMethod.POST)
@ResponseBody
public ClassName ...

当生成enunciate / swagger文档时，它们会生成两个项目（＆＃34; domain.com/api"以及＆＃34; domain.com/api /＆＃34;），我想知道是否有一种方法可以告诉enunciate只显示一个吗？

Answer 1

考虑在更深层次上处理“/ api”和“/ api /”映射的选项，而不是在Java类中定义两个端点。我确信有很多方法可以将这些映射为别名，例如在web.xml中。

Enunciate能够使用ignore注释忽略整个类但这需要你重构你的类定义（以漂亮和可重用的方式），所以两个端点由不同的类处理，然后你可以注释一个与@Ignore一起。