apifox持续集成+java+企微机器人+xxljob定时推送

总览：

apifox做接口测试后，把用例合并组装成测试套件，然后apifox-cli通过终端命令实现把套件执行后，输出本地文件的测试报告html或json。本地解析后拿到有用的解决通过定时执行推送到企微群里。 然后把html一起推到群里。

这个html文件点击打开，就是你本地跑的那个html。

一、安装

1、安装Node.js

yum install -y nodejs

2、安装npm

yum install -y npm

3、安装Apifox CLI

npm install -g apifox-cli

Apifox CLI 是 Apifox 的命令行运行工具，主要用来做持续集成。支持实时运行在线数据和导出数据运行2 种方式。因为后续套件可能去增加用例，所以我们选择使用在线数据进行调用。

本地测试一下，测试套件中，点击持续集成后，生成命令，然后复制后，在终端命令行运行在线数据。

命令类似长这样 apifox run http://xxx/api/v1/api-test/ci-config/xxxx/detail?token=xxxx -r html,cli

但是要了解下其他伴随指令，我只列了目前需要用到的，其他的可以这里去找更多选项 apifox持续继承
https://www.apifox.cn/help/cli/#apifox-run-file-source-options

  -r, --reporters [reporters]           指定测试报告类型, 支持 cli,html,json (default: ["cli"])--out-dir <outDir>                    输出测试报告目录，默认为当前目录下的 ./apifox-reports--out-file <outFile>                  输出测试报告文件名，不需要添加后缀，默认格式为 apifox-report-{当前时间戳}--database-connection <path>          指定 [数据库配置] 的所处文件路径，使用 URL 测试的时候必须指定

4、apifox测试用例中，如果有对数据库的校验，肯定在后置里已经添加了数据库连接的信息，那么在运行时也就需要下载数据库配置文件。如果没有数据库校验则忽略。

二、Java代码部分

1、通过调用终端类执行，生成对应的json报告，报告生成默认路径为./apifox-reports，可以通过加指令指定生成的路径-out-dir /tmp/apifox-reports

String command = apifox run https://api.apifox.cn/api/v1/api-test/ci-config/359896/detail?token=xlH8c24skOlIwGWN08O-d2 -r json,cli --database-connection ./database-connections.json

2、通过调用终端类执行，生成对应的html报告,类比步骤1，因为html方便查看，会把html也发到群里。html的报告可以单独弄个文件夹，好读取区分。–out-dir /tmp/apifox-htmlReports

apifox run https://api.apifox.cn/api/v1/api-test/ci-config/359896/detail?token=xlH8c24skOlIwGWN08O-d2 -r html ,cli --database-connection ./database-connections.json

命令行执行，是在网上找到工具类方法，主要依赖方法是 process = Runtime.getRuntime().exec(command);

CmdUtil类

public static String run(String command,int waitTime) throws IOException {Scanner input = null;String result = "";Process process = null;try {process = Runtime.getRuntime().exec(command);try {// 等待命令执行完成process.waitFor(waitTime, TimeUnit.SECONDS);} catch (InterruptedException e) {e.printStackTrace();logger.info("CmdUtil- run(String,int)遇到异常1");}InputStream is = process.getInputStream();input = new Scanner(is);while (input.hasNextLine()) {result += input.nextLine() + "\n";}result = command + "\n" + result; //加上命令本身，打印出来} catch (Exception e){e.printStackTrace();logger.info("CmdUtil- run(String,int)遇到异常2");}finally {System.out.println("---finally---");if (input != null) {input.close();}if (process != null) {process.destroy();}}return result;
}

三、拿到json报告并解析

拿到报告，解析json报告字段，拿到想要的字段。例如套件名称、总请求数、失败数、失败接口的名称

为了简化拿文件的方式，我是每次新生成报告文件，读取和解析后，就删除文件。这样每次文件夹下只有1个文件。 当然也可以自定义生成文件的名称，apifox执行命令选项中也是支持的。

File reports = new File("json报告的地址");
File[] fileArray = reports.listFiles();
String reportPath = fileArray[0].getAbsolutePath();
String jsonString = new String(Files.readAllBytes(Paths.get(reportPath)));
JSONObject reportObject= JSONObject.parseObject(jsonString);
//测试套件名称
String TJName = reportObject.getJSONObject("collection").getJSONObject("info").getString("name");
logger.info("测试套件名称 = "+ TJName);

四、通过企微机器人把json解析内容和html文件发到群里

a、把json解析的内容，通过企微机器人推送消息方法推送到企微群里。 text或markdown自己选择。

b、把html文件通过企微机器人的上传文件方法推送上去，会返回一个media_id。— 注意：这里按照官方文档要求的formdata把刚才的html文件

c、根据企微机器人的推送方法，把media_id推上去，html文件就可以推送到群里了。

企微机器人的方法，不再赘述，可以去官网这里去查看。企微机器人文档
https://developer.work.weixin.qq.com/document/path/91770

五、删除生成的json报告和html。

为了方便读取文件，我是每次生成读取数据后，会去删除文件。这样保证文件夹下只有1个子文件。

//删除json文件
logger.info("执行删除json文件 ----"+reportPath + "---" + new File(reportPath).delete());
//删除html文件
logger.info("执行删除html文件 ----"+htmlFile.getAbsolutePath() + "---" + htmlFile.delete());

六、定时任务的话，就搭配xxljob负责调度调试就行了。

参考我前边写过的文档

https://blog.csdn.net/wang391752/article/details/118019722?spm=1001.2014.3001.5502

其他问题：

1、如果你需要部署到线上，那么先要看看自己线上的数据库是否可以通过数据库地址直连，如果不行，要么去掉数据库校验部分，要么就别部署到线上，部署到你数据库连接地址对应环境。(如果你直连数据库地址是qa的，你就部署到qa机器上)
2、需要部署到机器上，你就需要去机器上下载之前的依赖，可以看公司用的什么方式部署机器，把node,apifox-cli下载命令放到构建参数里即可。
3、在步骤2中，如果有数据库database-connections.json需要扔到机器上，可以用公司前端文件存储的域名，把json文件放上去，跟着构建参数下载到某个路径下去。

对于步骤2和3，我是修改了机器构建部分配置，重点看下这里
dockerfile中前几行
FROM docker.17usoft.com/base/tomcat-node:v8
#FROM docker.17usoft.com/base/tomcat:v8-jdk1.8.0_191
RUN npm install -g apifox-cli
RUN cd /tmp/ && curl -O https://xxxstatic.com/database-connections.json

4、如果机器上安装了apifox-cli，但是无法访问apifox命令(可以进到机器上运行下试试)，也可以尝试使用完整路径去运行

预期这样写

apifox run https://api.apifox.cn/api/v1/api-test/ci-config/359896/detail?token=xlH8c24skOlIwGWN08O-d2 -r json,cli --database-connection ./database-connections.json

可以找到apifox-cli的安装地址改成这样写

node /usr/local/node-v12.13.0-linux-x64/lib/node_modules/apifox-cli/bin/cli.js run https://api.apifox.cn/api/v1/api-test/ci-config/359896/detail?token=xlH8c24skOlIwGWN08O-d2 -r json,cli --database-connection ./database-connections.json

上方apifox命令 等价于 node /usr/local/node-v12.13.0-linux-x64/lib/node_modules/apifox-cli/bin/cli.js
替换后也可以运行的。