跳到主要内容

项目内配置

  • 【推荐】尽量在项目根目录下创建配置文件来管理配置。
  • 【可选】在模块根目录下创建配置文件 .apifox-helper.properties
  • 【可选】在模块 resources 目录下创建 application.{yml|yaml|properties} 。除非特殊的多模块项目有明显的接入区别,需要区分注释风格和识别策略,否则都不推荐使用。

配置文件的类型

文件类型版本
.apifox-helper.propertiesproperties1.1.11+
.apifox-uploader.configproperties<= 1.1.10

properties 类型配置(推荐)

格式说明

一般的配置是:key=value,简单的多行配置,以\结尾:

key=value\
aaaa\
bbb
key2=value2

复杂的多行配置,以```结尾开启多行配置,以单独一行```表示结束:

key=groovy:```
if(condition){
//some script
}
```

filter的配置:

key[filter]=value

注意key[filter]=value有可能解析错误,可以尝试切换成

key=groovy:if(filter)value

以下三条配置等价:

# 单行配置
http.call.before=groovy:logger.info("call:"+request.url())
# 以 \ 接新行
http.call.before=groovy:\
logger.info("call:"+request.url())
# 以```包裹多行
http.call.before=groovy:```
logger.info("call:"+request.url())
```

加载额外配置 properties.additional

在配置文件中可以使用properties.additional来加载额外的配置文件:

properties.additional=$additional_properties_file_path$

多层级配置示例

假设配置后的目录结构如下:

project-root
├── java(module1)
│   ├── common.iml
│   ├── pom.xml
│   ├── src
│   │   ├── main
│   │   │   ├── java
│   │   │   │   └── com
│   │   │   │   └── **
│   │   │   │   └── **
│   │   │   │   └── **
│   │   │   │   └── **.java
│   │   │   └── resources
│   │   └── test
│   │   └── java
│ └────.apifox-helper.properties①
├── kotlin(module2)
│   ├── kotlin-demo.iml
│   ├── pom.xml
│   ├── src
│   │   ├── main
│   │   │   ├── kotlin
│   │   │   │   └── com
│   │   │   │   └── **
│   │   │   │   └── **
│   │   │   │   └── **
│   │   │   │   └── **
│   │   │   │   └── **.kt
│   │   │   └── resources
│   │   │   ├── application.yaml②
│   │  │   ├── static
│   │  │   └── templates
│   │  └── test
│   │  └── kotlin
│ └────.apifox-helper.yml③
├── springboot-demo(module3)
│   ├── pom.xml
│   ├── springboot-demo.iml
│   └── src
│      ├── main
│      │   ├── java
│      │   │   └── com
│      │   │   └── **
│      │   │   └── **
│      │   │   └── **
│      │   │   └── **
│      │   │   └── **
│      │   │   └── **.java
│      │   └── resources
│      │   ├── application.properties④
│      │   ├── static
│      │   └── templates
│      └── test
├── springboot-webflux-demo(module4)
│   ├── pom.xml
│   ├── springboot-webflux-demo.iml
│   └── src
│       ├── main
│       │   ├── java
│       │   │   └── **
│       │   │   └── **
│       │   │   └── **
│       │   │   └── **
│       │   │   └── **
│       │   │   └── **.java
│       │   └── resources
│       │   └── application.yml⑤
│       └── test
└────.apifox-helper.properties⑥

上述结构中:

  • ①: 只对java(module1)生效
  • ②: 如果开启了默认推荐配置的话,默认会加载,所以其中的参数可以在③中通过{property}来使用
  • ③: 只对kotlin(module2)生效
  • ④/⑤: 与②一样application.properties/application.yml/application.yaml都可以被加载
  • ⑥: 对java(module1)/kotlin(module2)/springboot-demo(module3)/springboot-webflux-demo(module4)都生效
  • ①/③/④/⑤/⑥均为可选配置.