我在用Spring Boot REST OpenAPI 3
规格。在此示例中,我希望全局设置标题(Custom-Header-Version=v1
)我想在向每个端点发出请求时传递它。
现在的问题是我已经100 个 REST 端点对于每个端点我需要不断添加@Parameter(in = ParameterIn.HEADER .....
,这个配置,而不是我希望在全局范围内设置它。如果我们在OpenAPI中可以做到这一点,有什么办法吗?
有没有办法从 Spring doc ui 中删除 SmartBear 徽标?
@RestController
@RequestMapping("/api")
@Tag(name = "contact", description = "the Contact API")
public class HelloController {
@Operation(summary = "Find Contacts by name", description = "Name search by %name% format", tags = {"contact"})
@ApiResponses(value = {
@ApiResponse(responseCode = "200", description = "successful operation", content = @Content(array = @ArraySchema(schema = @Schema(implementation = PersonDTO.class))))})
@Parameter(in = ParameterIn.HEADER, description = "Custom Header To be Pass", name = "Accept-version"
, content = @Content(schema = @Schema(type = "string", defaultValue = "v1", allowableValues = {"v1"}, implementation = PersonDTO.class)))
@GetMapping(value = "/contacts", headers = {"Custom-Header-Version=v1"})
public ResponseEntity<List<PersonDTO>> findAll(
@Parameter(description = "Page number, default is 1") @RequestParam(value = "page", defaultValue = "1") int pageNumber,
@Parameter(description = "Name of the contact for search.") @RequestParam(required = false) String name) {
return null;
}
}