接口测试工具Postman接口测试图文教程

时间 2019-12-07

标签接口测试工具 postman 图文教程繁體版

原文原文链接

Postman接口测试工具使用前端

1、前言

在先后端分离开发时，后端工做人员完成系统接口开发后，须要与前端人员对接，测试调试接口，验证接口的正确性可用性。而这要求前端开发进度和后端进度保持基本一致，任何一方的进度跟不上，都没法及时完成功能模块的测试。

作为后端开发人员，要求独立开发完成某个接口后，开发人员本身须要先测试经过后再提交给测试人员进行测试，不然会出现到测试人员哪里业务流程根本就走不通，或者BUG会过多的状况等。

市场上有不少优秀的，完善的接口测试工具，好比SoapUI，Postman等，可以高效的帮助后端开发人员独立进行接口测试。这里使用Postman接口测试工具，此处以请求方式为POST的userLogin登陆接口为例。

2、Postman安装和使用

一、这个直接去官网下载便可，咱们使用免费版便可知足基本接口测试，根据我的或者公司的项目实际状况考虑是否须要专业版或者其余。

免费版官网连接： https://www.getpostman.com/postman

下载好的安装程序Postman-Win64-xxx-Setup.exe，双击安装便可。建议安装在非系统盘，即C盘在外的其余盘，另建议使用全英文路径，避免使用中文路径。

二、打开Postman以下图2-1，能够关闭该页面跳过注册帐户，非登录状态下该工具能够直接使用。接下来出现引导页面，相似IDEA，Android Studio等开发工具的引导页。此处关闭便可。

图2-1注册帐户图

图2-2项目建立引导图

三、进入Postman主页面并建立项目接口集合java

这里是我以前用过，因此左侧文件栏存在几个已有的文件夹。

选择功能菜单New下的Collection建立项目接口集合。新建一个亿的项目A hundred million，可在Description部分写一下项目描述。

图2-3Postman主页面

图2-4新建项目接口集合图

四、建立项目模块文件夹json

通常项目会分多个管理模块或者功能模块进行开发。这里可根据项目具体状况建立子文件夹方便接口管理。此处在A hundred million项目右键建立资产管理assets文件夹、user用户管理文件夹。可将测试的接口实例保存在对于管理模块下。后端

图2-5新建资产管理文件夹

五、后台登陆接口演示浏览器

开发完成后台接口，编写正确严谨的逻辑代码处理前端请求。此处登陆接口代码以下，运行后台开发项目，使该接口可以访问。接口请求路径为：http://localhost:8080/manage/app/user/login服务器

@Controller
@RequestMapping("/manage/app/")
@Scope("prototype")
public class AppUserController {

   /**
    * 日志
    */
public static Logger customFile = LoggerFactory.getLogger("manageCustomFile");

@Resource
private AppUserService appUserService;

    /**
     * 用户登陆
     * @param baseResult
     * @return
     */
    @RequestMapping(value = "user/login" , produces = "application/json;charset=UTF-8", method = RequestMethod.POST)
    @ResponseBody
    public BaseResult loginUser(@RequestBody BaseResult baseResult) {
        customFile.info("appId:"+ baseResult.getTreasureID()+ "用户登录访问:" + baseResult.toString());
        return appUserService.loginUser(baseResult);
    }
}

六、新建接口测试app

在Postman主页面Content部分点击'+'按钮，新增一个接口测试。在图2-6所示第一部分填写接口请求路径，左侧下拉列表可选择请求方式，此处选择POST请求方式。接口请求路径为http://localhost:8080/manage/app/user/login。第二部分是请求体，即包含接口所需请求参数的Body，此处选择原始数据RAW，数据类型使用JSON数据做为请求数据。点击蓝色Send按钮发送请求，后台项目接口接收请求并响应返回执行结果。此处后台处理数据返回结果还是JSON数据，这个看实际项目而定，此处仅作演示。第三部分是接口响应体，即接口响应请求处理并返回的数据。点击Pretty自动匹配接口返回的数据格式并对数据美化显示，使数据看起来更加直观。若是接口测试出现异常，则能够经过PreView视图查看浏览器响应接口的页面信息，也能够经过Header了解请求状态等参数。通常出现异常仍是直接去后台看控制台的异常信息及项目日志来处理解决异常，再进行接口测试。前后端分离

图2-6接口测试图

接口测试经过后，可Ctrl+S保存接口测试实例，填写接口测试名称和接口描述信息，选择要保存的路径，此处保存在user用户管理模块文件夹。当项目的接口所有测试经过后，可在A hundred million项目右键Export导出接口文档，保存为JSON接口测试文件，该文件可经过Postman导入查看。工具

3、请求方式

对于后台开发的接口，请求方式确定不止POST一种，Postman也支持多种请求方式。在新建接口测试实例时可选择接口的请求方式，如图3-1。post

图3-1接口请求方式图

请求类型能够模拟Form表单文本提交，Form表单文件提交，raw原始数据提交，二进制文件提交。对于原始数据类型raw还支持不一样文件格式，包括JSON，TXT，HTML等多种文件格式。

图3-2数据请求类型图

4、资金记录接口实例演示

后台开发接口以下，服务器部署运行后台项目。接口请求路径为：http://localhost:8080/manage/app/user/asset/withdrawRecord

@Controller
@RequestMapping("/manage/app/")
@Scope("prototype")
public class AppUserAssetController {
 
    /**
     *日志
     */
    public static Logger customFile = LoggerFactory.getLogger("manageCustomFile");

    @Resource
    private AppUserAssetService appUserAssetService;

    /**
     * 获取提现记录
     * 即个人页面中的资金记录
     * @param baseResult
     * @return
     */
    @RequestMapping(value = "user/asset/withdrawRecord" , produces = "application/json;charset=UTF-8", method = RequestMethod.POST)
    @ResponseBody
    public BaseResult getUserWithdrawRecord(@RequestBody BaseResult baseResult){
        customFile.info( "appId:"+ baseResult.getTreasureID() + "用户提现记录获取"+baseResult.toString());
        return appUserAssetService.getUserWithdrawRecord(baseResult);
    }
}

新建资金接口测试

请求方式为POST，

请求URL为http://localhost:8080/manage/app/user/asset/withdrawRecord

请求体为JSON类型的原始数据

点击Send请求接口，接口响应请求处理返回结果如图3-3所示

图3-3资金记录接口测试图