【云原生】前后端分离项目下 如何优雅的联调程序?

文章目录

  • 一、什么是ApiFox?
  • 二、ApiFox的好处
  • 三、ApiFox 在企业中的应用 前后端分离开发利器
    • ⛅需求分析
    • ⛄设计接口 编写代码
    • ⚡生成接口文档
  • 四、ApiFox 更多功能
    • ⏳导入文档
    • ⌛导出文档
  • 五、在线生成代码提高效率
    • ♻️在线生成项目源代码,直呼 YYDS!
    • ♨️接口请求代码 一应俱全
  • 六、源码下载
  • ⛵小结

一、什么是ApiFox?

Apifox 是 API 文档、API 调试、API Mock、API 自动化测试一体化协作平台,定位 Postman + Swagger + Mock + JMeter。通过一套系统、一份数据,解决多个系统之间的数据同步问题。只要定义好 API 文档,API 调试、API 数据 Mock、API 自动化测试就可以直接使用,无需再次定义;API 文档和 API 开发调试使用同一个工具,API 调试完成后即可保证和 API 文档定义完全一致。高效、及时、准确!

一句话概括:ApiFox =Postman + Swagger + Mock + JMeter,开发利器!

二、ApiFox的好处

Apifox的优势在于它能自动对Api进行更新和维护,使得项目接口的新增和变更能同步到项目所有成员中,避免数据不同步和沟通不及时带来的麻烦;使得测试人员无须重建新项目或手动导入更新部分,减少了不必要的工作量

API 文档设计

  • 可视化 API 文档管理,零学习成本。

  • 支持数据模型,接口之间可以复用相同数据结构。

  • 接口文档完全遵循 OpenAPI(Swagger) 规范。

  • 支持在线分享 API 文档,方便与外部团队协作。

API 调试

  • Postman 有的功能 Apifox 都有(如环境变量、前置/后置脚本、Cookie/Session 全局共享等),并且比 Postman 更高效好用。
  • 自动校验数据结构:校验返回的数据结构是否符合文档定义,自动发现接口数据异常。
  • 可视化的断言、提取变量、数据库(SQL)操作等功能。
  • 支持接口用例功能(一个接口多个用例)。

更多ApiFox的优势,移步官网查看 ApiFox 官网

PostMan 对比 国产化测试工具 Apifox

导入数据

  • PostMan 不支持导入数据
  • ApiFox 支持导入PostMan数据、等多种格式数据

测试接口

  • PostMan 测试接口,有时可能会出现延迟情况,打不开软件,文档难以维护
  • ApiFox 一体化测试 ,速度快,效率高,可一键导出接口文档,利于后期的开发维护

三、ApiFox 在企业中的应用 前后端分离开发利器

⛅需求分析

需求:使用SpringBoot + Swagger 完成接口开发,具体要求如下:

  • 完成信息接口的开发
  • 导出文档,提供接口文档
  • 采用ApiFox 完成需求开发

项目环境 为 微服务项目,后续我会提供相关项目

项目结构如下:

【云原生】前后端分离项目下 如何优雅的联调程序?_第1张图片

⛄设计接口 编写代码

ApiFoxController

package com.chen.controller;

import com.chen.common.ResultBean;
import io.jsonwebtoken.impl.crypto.MacProvider;
import org.springframework.web.bind.annotation.CrossOrigin;
import org.springframework.web.bind.annotation.PostMapping;
import org.springframework.web.bind.annotation.RequestMapping;
import org.springframework.web.bind.annotation.RestController;

import java.util.HashMap;
import java.util.Map;

@RestController
@CrossOrigin
@RequestMapping("/apifox")
public class ApiFoxController {

    @PostMapping("/test")
    public ResultBean<Map<String, Object>> test() {
        Map<String, Object> map = new HashMap<>();
        map.put("ApiFox", "YYDS!!!");
        return ResultBean.create(0, "success", map);
    }

}

接口编写完毕,接下来我们对接口进行测试

测试接口

下载[ApiFox]http://apifox.cn/a1csdbbug)

【云原生】前后端分离项目下 如何优雅的联调程序?_第2张图片

下载桌面版本64位即可,具体情况根据电脑来下载

【云原生】前后端分离项目下 如何优雅的联调程序?_第3张图片

清新的UI界面,很舒服~

新建项目

【云原生】前后端分离项目下 如何优雅的联调程序?_第4张图片

进入项目

【云原生】前后端分离项目下 如何优雅的联调程序?_第5张图片

整体项目工作台

【云原生】前后端分离项目下 如何优雅的联调程序?_第6张图片

管理环境

【云原生】前后端分离项目下 如何优雅的联调程序?_第7张图片

下面我们新建一个快捷请求,请求刚刚编写的接口,看看返回的结果
【云原生】前后端分离项目下 如何优雅的联调程序?_第8张图片

⚡生成接口文档

点击右上保存接口

【云原生】前后端分离项目下 如何优雅的联调程序?_第9张图片

填写接口相关信息

【云原生】前后端分离项目下 如何优雅的联调程序?_第10张图片

成功生成接口
【云原生】前后端分离项目下 如何优雅的联调程序?_第11张图片

生成接口如此方便~ 真香!

四、ApiFox 更多功能

⏳导入文档

项目设置 – > 导入数据 --> 选择URL导入 --> 输入 url --> 点击提交即可

【云原生】前后端分离项目下 如何优雅的联调程序?_第12张图片

提交后如下界面

【云原生】前后端分离项目下 如何优雅的联调程序?_第13张图片

导入成功

【云原生】前后端分离项目下 如何优雅的联调程序?_第14张图片

查看主页接口已导入成功

【云原生】前后端分离项目下 如何优雅的联调程序?_第15张图片

导入成功~ 如此快捷!

⌛导出文档

点击接口后的 … ,等待下拉菜单出现 点击导出

【云原生】前后端分离项目下 如何优雅的联调程序?_第16张图片

选择想要的格式,导出

【云原生】前后端分离项目下 如何优雅的联调程序?_第17张图片

五、在线生成代码提高效率

♻️在线生成项目源代码,直呼 YYDS!

功能说明

根据接口模型定义,自动生成各种语言/框架(如 TypeScript、Java、Go、Swift、ObjectiveC、Kotlin、Dart、C++、C#、Rust 等 130 种语言及框架)的业务代码(如 Model、Controller、单元测试代码等)和接口请求代码。目前 Apifox 支持 130 种语言及框架的代码自动生成。

更重要的是:你可以通过自定义代码模板来生成符合自己团队的架构规范的代码,满足各种个性化的需求。

安装插件

打开生成代码面板,点击安装插件即可自动下载并安装。

安装Java环境

运行代码生成插件需要 Java 环境。请查看 安装 Java 环境

生成代码

获取apifox接口生成代码

【云原生】前后端分离项目下 如何优雅的联调程序?_第18张图片

打开后,炫酷的生成页面迎面而来
【云原生】前后端分离项目下 如何优雅的联调程序?_第19张图片

点击按钮 下载代码生成插件

【云原生】前后端分离项目下 如何优雅的联调程序?_第20张图片

生成Spring代码即可

【云原生】前后端分离项目下 如何优雅的联调程序?_第21张图片

生成项目目录

【云原生】前后端分离项目下 如何优雅的联调程序?_第22张图片

♨️接口请求代码 一应俱全

查看接口请求代码,无需手写,直接复制即可调用接口

【云原生】前后端分离项目下 如何优雅的联调程序?_第23张图片

该页面包含了大部分的网络接口请求,真的很香~

可见ApiFox如此优秀,功能如此强大,速来上手 ApiFox 吧~

六、源码下载

GitEE开源地址: GitEE源码

源码下载:ApiFox前后端分离项目联调

⛵小结

以上就是【Bug 终结者】对 【云原生】前后端分离项目下 如何优雅的联调程序? 的简单介绍,ApiFox是一款如此强大的测试工具,集成所有在一体,这样的测试工具,太强了,简直就是开发者必备高效率工具!

如果这篇【文章】有帮助到你,希望可以给【Bug 终结者】点个赞,创作不易,如果有对【后端技术】、【前端领域】感兴趣的小可爱,也欢迎关注❤️❤️❤️ 【Bug 终结者】❤️❤️❤️,我将会给你带来巨大的【收获与惊喜】!

你可能感兴趣的:(精通云原生,云原生,测试工具,微服务,阿里云,postman)