许多方法的Swagger ApiImplicitParams注释

Question

我正试图用swagger记录我的API。使用过滤器和标头参数处理身份验证。所以我想用@ApiImplicitParams来解释这个，但是不可能把注释放在类型上所以我需要把它放在所有方法上......非常讨厌！我在互联网上搜索但是找不到一个好的解决方案。

有没有人得到同样的问题（我猜，因为我没有做非凡的事情）你是如何实现的？有方面的任何解决方案可能吗？

环境：jee6 / jax-rs 2 / resteasy 3

Answer 1

您可以在类级别简单地声明参数：

public class PetResource {
  static PetData petData = new PetData();

  @ApiParam(value = "the authorization")
  @HeaderParam("my_auth")
  private String myAuth;

这会将参数添加到类中的所有方法。