SpringMVC系列第3篇：接口测试利器

star2017 1年前 ⋅ 402 阅读

SpringMVC系列或者是SpringBoot系列中都会有大量的案例，这些案例都需要运行来验证效果，所以急需一款高效的接口测试工具。

可能大家用的比较多的是swagger或者postman，这2个确实不错，不过今天今天给大家推荐一种更简单的接口测试工具。

这款工具就是idea中的自带的：HTTP Client，这款工具特别好用，主要的优点：

1、若想测试一个接口，只需要几行代码

2、运行特别容易

3、方便切换各种环境

1、创建一个springboot项目

idea中创建一个springboot项目，来个controller，内容如下，模拟了5种常见的情况，基本上包含了我们开发中所有的场景

  1. @RestController
  2. public class IndexController {
  3.     //get请求
  4.     @RequestMapping("/get")
  5.     public String get() {
  6.         return "get";
  7.     }
  9.     //post请求，模拟表单提交
  10.     @PostMapping("/post")
  11.     public Map<String, String[]> post(HttpServletRequest request) {
  12.         return request.getParameterMap();
  13.     }
  15.     //post请求json数据
  16.     @PostMapping("/body")
  17.     public List<Integer> body(@RequestBody List<Integer> list) {
  18.         return list;
  19.     }
  21.     //put请求
  22.     @PutMapping("/put")
  23.     public String put() {
  24.         return "put";
  25.     }
  27.     //模拟多文件上传，顺便带上表单数据
  28.     @PostMapping("/upload")
  29.     public Map<String, Object> upload(@RequestParam("file1") MultipartFile file1,
  30.                                       @RequestParam("file2") MultipartFile file2,
  31.                                       User user,
  32.                                       HttpServletRequest request) {
  33.         Map<String, Object> result = new HashMap<>();
  34.         result.put("file1.size", file1.getSize());
  35.         result.put("file1.name", file1.getName());
  36.         result.put("file2.originalFilename", file1.getOriginalFilename());
  37.         result.put("file2.size", file2.getSize());
  38.         result.put("file2.name", file2.getName());
  39.         result.put("file2.originalFilename", file2.getOriginalFilename());
  40.         result.put("params", request.getParameterMap());
  41.         result.put("user", user);
  42.         return result;
  43.     }
  45.     static class User {
  46.         private String userName;
  47.         private int age;
  49.         public String getUserName() {
  50.             return userName;
  51.         }
  53.         public void setUserName(String userName) {
  54.             this.userName = userName;
  55.         }
  57.         public int getAge() {
  58.             return age;
  59.         }
  61.         public void setAge(int age) {
  62.             this.age = age;
  63.         }
  64.     }
  65. }

项目结构如下图

启动项目，下面我们来对这几个接口进行测试。

2、测试上面5个接口

下面我们通过HTTP Client工具来对上面几个接口进测试。

2.1、创建http后缀的文件

文件必须以http为后缀，这种文件会自动被HTTP Client插件识别，效果如下

2.2、将下面内容丢到创建好的文件中

  1. ### get 请求
  2. GET http://localhost:8080/get
  4. ### post 提交表单
  5. POST http://localhost:8080/post
  6. Content-Type: application/x-www-form-urlencoded
  8. name=张三&age=23
  10. ### body 中传递json数据
  11. POST http://localhost:8080/body
  12. Content-Type: application/json
  14. [3,10,40]
  16. ### put请求
  17. PUT http://localhost:8080/put
  20. ### 多文件上传文件接口测试
  21. POST http://localhost:8080/upload
  22. Content-Type: multipart/form-data; boundary=WebAppBoundary
  24. --WebAppBoundary
  25. Content-Disposition: form-data; name="file1"; filename="pic_1.jpeg"
  27. < C:\Users\Think\Desktop\1.jpeg
  28. --WebAppBoundary--
  30. --WebAppBoundary
  31. Content-Disposition: form-data; name="file2"; filename="pic_2.jpeg"
  33. < C:\Users\Think\Desktop\2.jpeg
  34. --WebAppBoundary--
  36. --WebAppBoundary--
  37. Content-Disposition: form-data;name=userName
  39. tom
  40. --WebAppBoundary--
  42. --WebAppBoundary--
  43. Content-Disposition: form-data;name=age
  45. 23
  46. --WebAppBoundary--
  47. ###

接口格式很简单，如下

  1. 请求方式 地址
  2. header部分，key=value格式，每个一行
  4. 参数部分(注意这个上面要有个空行)

此时文件的效果是下面这样，点击红框中的按钮，即可以运行这个测试用例

2.3、运行接口

3、http文件内容如何写？

HTTP Client提供了很多案例，点击Examples案例可以看到各种请求案例，这里就不细说了，大家一看就懂。

4、文件上传的写法

多文件上传且携带表单数据，这个比较特别，下面是接口代码

  1. //模拟多文件上传，顺便带上表单数据
  2. @PostMapping("/upload")
  3. public Map<String, Object> upload(@RequestParam("file1") MultipartFile file1,
  4.                                   @RequestParam("file2") MultipartFile file2,
  5.                                   User user,
  6.                                   HttpServletRequest request) {
  7. }

对应的HTTP Client的写法如下：

  1. ### 多文件上传文件接口测试
  2. POST http://localhost:8080/upload
  3. Content-Type: multipart/form-data; boundary=WebAppBoundary
  5. --WebAppBoundary
  6. Content-Disposition: form-data; name="file1"; filename="pic_1.jpeg"
  8. < C:\Users\Think\Desktop\1.jpeg
  9. --WebAppBoundary--
  11. --WebAppBoundary
  12. Content-Disposition: form-data; name="file2"; filename="pic_2.jpeg"
  14. < C:\Users\Think\Desktop\2.jpeg
  15. --WebAppBoundary--
  17. --WebAppBoundary--
  18. Content-Disposition: form-data;name=userName
  20. tom
  21. --WebAppBoundary--
  23. --WebAppBoundary--
  24. Content-Disposition: form-data;name=age
  26. 23
  27. --WebAppBoundary--
  28. ###

你可以把这个请求想象为页面中的一个表单，表单有4个元素：2个File元素，用来选择需要上传的2个文件，2个输入框，分别用来输入userName和age，用—WebAppBoundary来隔离每个元素，如果有多个元素，都需要用—WebAppBoundary隔离开来，如下：

5、环境切换

我们测试接口的时候，有开发环境、测试环境、UAT环境，生产环境，每个环境的接口信息都不一样，比如接口地址。

HTTP Client中可以创建环境配置文件，来对不同的环境信息进行配置，操作如下

5.1、创建环境配置文件

生成了一个环境配置文件，如下

文件内容格式

  1. {
  2.   "环境名称": {环境参数json格式},
  3.   "环境名称": {环境参数json格式}
  4. }

如

  1. {
  2.   "dev": {
  3.     "url": "http://localhost:8080",
  4.     "name": "张三"
  5.   },
  6.   "test": {
  7.     "url": "http://localhost:9090",
  8.     "name": "李四"
  9.   }
  10. }

5.2、http文件中引用环境配置信息

通过{{key}}可以引用环境中的信息，运行的时候会被替换，如：

  1. GET {{url}}/get

5.3、运行的时候选择环境

运行的时候会提示你选择环境，此时环境中的配置信息就被用上了

大家赶紧去体验一下。

最新资料

更多内容请访问：IT源点

注意：本文归作者所有，未经作者允许，不得转载

#SpringMVC教程
阅读全部
相关文章推荐
  • 1

全部评论: 0 条

    我有话说: