@ApiParam@RequestHeader

@ApiParam 是Spring MVC RESTful API开发中常用的一个注解，它主要用于定义API的方法参数的描述和约束信息。当与 @RequestHeader 结合使用时，它可以帮助你在HTTP头信息中添加元数据，这些元数据通常用于客户端向服务器发送附加信息。

`@ApiParam @RequestHeader` 的使用示例如下：

@ApiOperation(value = "获取带自定义header的资源", notes = "返回特定header信息的资源")
@GetMapping("/headers")
public ResponseEntity<String> getHeaders(
    @ApiParam(name = "Authorization", value = "认证令牌", required = true)
    @RequestHeader(value = "Authorization", required = true)
    String authorization,
    @ApiParam(name = "User-Agent", description = "用户代理")
    @RequestHeader(name = "User-Agent")
    String userAgent
){
    // 实现获取资源逻辑并返回响应
}

在这个例子中，`@ApiParam` 定义了两个`@RequestHeader` 参数：一个是必填的`Authorization`，另一个是非必填的`User-Agent`。当你调用这个GET方法时，需要提供这两个header字段。