Springdoc中基于Swagger注释的自动描述生成

Question

基本上我的问题和这个一样，但是针对的是Springdoc(而不是Springfox)。

简而言之，我有一个Spring-boot应用程序，我正在使用spring-security @ preauthorization注释来保护我的一些api，目前仅基于hasAuthority。

是否有一种方法可以根据注释自动修改特定的资源swagger描述?我猜这与重写Springdoc的默认类行为(可能是OpenAPICustomiser?)有关，但我不确定如何做到这一点。

Answer 1

好了，我已经算出来了——

@Configuration
public class SpringdocPreAuthorize {
@Bean
public OperationCustomizer operationCustomizer() {
return (operation, handlerMethod) -> {
Optional<PreAuthorize> preAuthorizeAnnotation = Optional.ofNullable(handlerMethod.getMethodAnnotation(PreAuthorize.class));
StringBuilder sb = new StringBuilder();
if (preAuthorizeAnnotation.isPresent()) {
sb.append("This api requires **")
.append((preAuthorizeAnnotation.get()).value().replaceAll("hasAuthority|\(|\)|\'", ""))
.append("** permission.");
} else {
sb.append("This api is **public**");
}
sb.append("<br /><br />");
sb.append(operation.getDescription());
operation.setDescription(sb.toString());
return operation;
};
}
}