ApiRule使用注解策略时，支持指定多个注解之间的关系 · Pull Request !113 · 萧明/knife4j

使用场景：
使用knife4j配置文件(knife4j.openapi)指定接口文档配置时，无法覆盖"只有类标记有 **@Api** 注解 **且** 方法标记有 **@ApiOperation** 的接口才进行注册"这一场景。

问题分析：
springfox 的RequestHandlerSelector是支持and操作的，如：
```java
Docket docket = new Docket(DocumentationType.SWAGGER_2)
        .select()
        //只有标记了@Api+@ApiOperation的方法才会暴露出给swagger
        .apis(RequestHandlerSelectors.withClassAnnotation(Api.class))
        .apis(RequestHandlerSelectors.withMethodAnnotation(ApiOperation.class))
        .paths(PathSelectors.any())
        .build();
```

迁移到knife4j后，使用配置文件(knife4j.openapi)的方式指定接口文档配置，不支持进行and，底层代码写死了是or操作：
```
knife4j:
  enable: true
  openapi:
    description: 描述信息，略。
    title: 测试项目
    version: 1.0
    group:
      WEB:
        api-rule: ANNOTATION
        api-rule-resources:
          # 这里目前是or的关系，不支持and
          - Api
          - ApiOperation
```
```
    if (annotationClassName.equalsIgnoreCase(AnnotationClassEnums.Api.getFullPath())) {
        first = first.or(RequestHandlerSelectors.withClassAnnotation(clazz));
    } else {
        first = first.or(RequestHandlerSelectors.withMethodAnnotation(clazz));
    }
```
因此，在`Knife4jDocketInfo`中添加了`apiRuleAnnoUseAnd`来标识注解是采用`and` 或 `or`进行运算，并重载了`RequestHandlerSelectorUtils#multipleAnnotations`以支持该场景。

GVP萧明/knife4j

搜索帮助

GVP 萧明/knife4j