0312 java接口测试三棱军刺rest-assured

 # 背景 java程序员一般写的是后端服务是JavaWeb类型的项目，主要包括Http接口和dubbo接口，Http接口一般采用的rest风格，那么如何快速的对rest接口在第三方的测试框架上进行测试呢？ rest-assured框架是一个不错的工具。好比军人的三棱军刺，如上图。 使用之前，需要熟悉一下最基础的使用方法，在写完几个接口的测试用例之后，好比你可以使用你的三棱军刺熟练的进行基础的攻击了。 快速的来一个hello world吧！

假设你写了一个接口：lotto,访问路径是: http://localhost:8080/lotto

接口返回值是： ```json { "lotto":{ "lottoId":5, "winning-numbers":[2,45,34,23,7,5,3], "winners":[{ "winnerId":23, "numbers":[2,45,34,23,3,5] },{ "winnerId":54, "numbers":[52,3,12,11,18,22] }] } } ``` 如何快速的验证接口是否返回正常值呢？ ```java get("/lotto").then().body("lotto.winners.winnerId", hasItems(23, 54)); ``` 使用简单吧！ # 引入 不多说，直接maven的方式引入：注意，我直接按照默认的scope引入的，不是test；
主要引入以下2个依赖，原因如下：
rest-assured: 主要测试基本的http的rest风格接口，这个是最基础的依赖；
json-path: 主流的接口主要返回json，对接口进行测试用例测试，主要也是判断json返回某路径下的数据；
```xml io.rest-assured rest-assured 4.2.0 io.rest-assured json-path 4.2.0 ``` 然后你就可以愉快的编写测试用例，然后使用rest-assured进行接口测试了。 # 使用要点
先上简单代码吧！

先准备测试数据： ```java final TestCaseDataModel testCaseDataModel = new TestCaseDataModel(); final LoginRestReq loginRestReq = LoginRestReq.builder() .appId("2a6bf452219cfe44c7f78231e3c80a13072b6727") .nonce("123456") .timestamp(System.currentTimeMillis()) .userId("lxlifuchun") .userName("李福春") .build(); String appSecret = "91e47f584dae551170ade272b2c7a69f"; loginRestReq.setChecksum(SignUtils.generateCheckSum(loginRestReq.getAppId(), appSecret, loginRestReq.getTimestamp(), loginRestReq.getNonce())); testCaseDataModel.setInputParam(loginRestReq); ExpectModel expectModel = new ExpectModel(); expectModel.setPath("data.id"); expectModel.setMatcher(Matchers.lessThan(0)); testCaseDataModel.setExpectResult(Arrays.asList(expectModel)); ``` ```java RestAssured.baseURI = "https://rest-beta.xxx.com"; final ValidatableResponse validatableResponse = given().contentType(ContentType.JSON) .header("requestId", UUID.randomUUID().toString()) .body(testCaseData.getInputParam()). post("/user_service/user/login") .then().contentType(ContentType.JSON); for (Object obj : testCaseData.getExpectResult()) { ExpectModel item = (ExpectModel) obj; validatableResponse.body(item.getPath(), item.getMatcher()); } ``` 做的事情很简单，就是拿一个登录接口来实际的试一下： login接口接受一个json的参数，LoginRestReq对下转换之后得到；
然后返回数据，数据中有一个用户id,路径是 data.id，如果id大于0，标识登录操作成功，登录接口正常。 很好的完成了接口的测试，如果失败，会抛出错误，捕获错误，然后输出信息，标识测试用例不通过，提示到界面或者发送邮件给到开发人员，即完成了接口的自动化测试。 # 小结 简单的使用了工具rest-assured完成了接口测试，实在是一个很好用的工具。最近工作太忙,没法输出内容丰富的文章，发一篇短小的文章吧！希望可以帮到你！ 原创不易，转载请注明出处。