多测师是一家拥有先进的教学理念,强大的师资团队,业内好评甚多的接口自动化测试培训机构!

17727591462

联系电话

您现在所在位置:接口自动化测试培训 > 新闻资讯

深入了解接口测试框架RestAssured的使用

更新时间:2022-07-11 09:12:56 作者:多测师 浏览:26

  一、什么是RestAssured

  与动态语言(如Ruby或Groovy)相比,用java测试和验证REST服务要困难的多。RestAssured将使用这些语言的简单性带入java域。

深入了解接口测试框架RestAssured的使用

  二、RestAssured常规用法

  官方文档:https://github.com/rest-assured/rest-assured/wiki/Usage

  Maven依赖:

  io.rest-assured

  rest-assured

  3.0.6

  test

  其他的如jsonPath,xmlPath,Spring的依赖去上方地址去查找。

  1、简单的get无参请求

  import org.junit.Test;

  import static io.restassured.RestAssured.;

  import static io.restassured.matcher.ResponseAwareMatcher.;

  import static org.hamcrest.Matcher.*;

  public class Baidu {

  @Test

  public void testGetHtml(){

  given()

  .log().all().get("https://www.baidu.com")

  .then()

            .log().all().statusCode(200);

  }

  }

  看一下输入内容,百度的html文档,那么解析一下代码。

  .given()表示开头输入数据。

  .log()表示打印日志。

  .all()表示打印所有的日志。

  .get(https://www.baidu.com)表示get请求该域名(post请求方式:.post())。

  .then()表示对结果进行断言。

  .statusCode()表示对状态码进行断言。

  其实是等价于:curl -L https://www.baidu.com

  ps:此处有个细节内容

    import static xx.xxx.*;

    导入该类的静态方法;也可只导入某个静态方法;在测试类中,可直接用方法名调用静态方法,而不必用ClassName.方法名的方式。

    例如:可以将System.out.printIn();写成静态方法print(),在使用的时候直接print()即可。

    上述测试方法中的given()、.then()。

  2、传参get请求

  上例中并没有传入参数,那再上一个传入参数的demo。

  import org.junit.Test;

  import static io.restassured.RestAssured.*;

  public class LocalInterface {

  @Test

  public void testlocal(){

  given()

  .queryParam("username","Richered")

  .when()

  .get("http://localhost:8000/CGIProject/cgi-bin/")

  .then()

  .statusCode(200);

  }

  }

  此处请求本地启动的cgi服务接口。

  可以看到,.queryParam()传入参数username=Richered。

  .get()请求接口http://localhost:8000/CGIProject/cgi-bin/

  请求成功。

  查看服务端接收到的请求,可以看到是标准的http请求。

  3、http头信息处理方法

  那么我们在日常的工作中难免会自定义请求头信息,最常见的是自定义Cookie。

  请求头如何去构造。

  given()

  .queryParam("username","Richered")

  .header("Cookie","Custom Cookie")

  提供方法.header()即可搞定。

  4、form表单传参

  given()

  .header("Cookie","Custom Cookie")

  .formParam("username","Richered")

  方法.formParam()

  5、https请求

  useRelaxedHTTPSValidation();

  该方法表示信任证书

  6、向代理服务器发送请求

  proxy("127.0.0.1",8000);

  7、发送请求数据为json报文

  ps:json、xml类的报文需要引入其提供的依赖。

  io.rest-assured

  json-schema-validator

  4.1.2

  test

  demo:

  @Test

  public void testPostJson(){

  HashMap<String , Object> map = new HashMap<String ,Object>();

  map.put("username","admin");

  map.put("password","admin");

  map.put("capcha","n6d58");

      given().log().all()

              .contentType(ContentType.JSON)

              .body(map)

      .when()

              .post("http://localhost:8080/renren-fast/sys/login")

      .then()

              .statusCode(200);

  }

  可以看到发送json报文的方式是使用HashMap的方式进行组合json格式。

  ps:需要指定请求报文的类型:contentType(ContentType.JSON)

  那么其他报文类型也是一样的。

  8、断言

  断言绝对是重中之重。上方的demo中有提到断言,.statusCode()【断言其状态码】,当然我们断言仅仅凭状态码是不够的。

  RestAssured支持jsonpath、xpath语法、Groovy语法断言。

  其断言方式大概有这么几种:

  1)标志性断言:assertXXX:assertEqual

  2)Hamcrest断言assertThat:assertThat(x, is(3))

  3)RestAssured断言:then().xx

  4)body断言:Xmlpath、jsonpath等

  这里就直接使用官方demo来写例子。

  ps:官方的json报文还是和前面Jmeter断言那一篇的报文例子一样。

  jsonpath、xpath语法在这儿就不提了,都是基本功,一些基本用法可以翻翻前面的内容。

  demo响应报文内容:

  {

  "store":{

  "book":[

  {

  "author":"Nigel Rees",

  "category":"reference",

  "price":8.95,

  "title":"Sayings of the Century"

  },

  {

  "author":"Evelyn Waugh",

  "category":"fiction",

  "price":12.99,

  "title":"Sword of Honour"

  },

  {

  "author":"Herman Melville",

  "category":"fiction",

  "isbn":"0-553-21311-3",

  "price":8.99,

  "title":"Moby Dick"

  },

  {

  "author":"J. R. R. Tolkien",

  "category":"fiction",

  "isbn":"0-395-19395-8",

  "price":22.99,

  "title":"The Lord of the Rings"

  }

  ]

  }

  }

  官方demo:断言该报文中价格低于10的书籍title为:Moby Dick和Sayings of the Century

  @Test

  public void TestAssertion(){

  given()

  .contentType(ContentType.JSON)

  .when()

  .get("http://localhost:8000/CGIProject/cgi-bin/store.json")

  .then()

  .log().all()

  .body("store.book.findAll { it.price < 10 }.title",hasItems("Sayings of the Century", "Moby Dick"));

  }

  使用闭包查找价格低于10的所有书籍,返回书籍的title,再使用hasItems匹配断言标题。

  findAll关键字、hasItems()方法。

  再做一个错误的断言例子,断言一下价格低于5的书籍是否为Sayings of the Century和 Moby Dick(修改上方表达式中的价格即可),查看一下报错,其断言失败的原因很清楚,无与表达式相匹配的结果;表达式内容。

  官方提供了更为复杂的demo2:

  要求:断言所有作者姓名长度之和大于50。

  展示Groovy强大的时候来了。

  看看其处理方式,简单又易懂。

  then().

  body("store.book.author.collect { it.length() }.sum()", greaterThan(50));

  store.book.author:得到所有的作者

  使用闭包{it.lenth()},调用结果列表中的collect方法,其作用为:对每个作者使用length()方法。

  在列表中只需要使用.sum()方法对所有长度进行求和。最终结果为53,大于50.

  ps:groovy使用*为列表每个元素调用函数的方法非常方便:

    def words = ['ant','buffalo','cat','dinosaur']

    assert[3,6,3,8] ==words*.length()

  详情请去官方文档中查看。

  使用jsonpath的方式也一并贴上来:

  int sumOfAllAuthorLengths = from(response).getInt("store.book.author*.length().sum()");

  assertThat(sumOfAllAuthorLengths, is(53));

  还有一个需要注意的地方,断言内容为float和double类型的数据,需要加f和d。

  9、官方推荐书写格式

  given()

  .xxxxx

  .when()

  .xxxxx

  .then()

  .xxxxx

  10、获取响应数据

  在上方的例子中,为了方便查看请求过程,使用了.log().all()的方法。

  那么获取响应数据:

  InputStream stream = get("http://localhost:8000/CGIProject/cgi-bin/store.json").asInputStream();

  byte[] byteArray = get("http://localhost:8000/CGIProject/cgi-bin/store.json").asByteArray();

  String json = get("http://localhost:8000/CGIProject/cgi-bin/store.json").asString();

  11、上下文关联

  在常见的业务逻辑中,会有这么一种业务逻辑。

  例如:先登录-->购买商品

  购买商品必须先登录成功,那么开发的实现方式均不一致。

  有可能是登录成功之后响应报文中传给客户端一些参数,继续请求;有可能是登录成功将校验成功的令牌存入cookie中,当然还有更为复杂的,此处只是举例。

  针对这种业务逻辑RestAssured中如何处理?

  响应报文demo:

  {

  "title" : "My Title",

  "_links": {

  "self": { "href": "/title" },

  "next": { "href": "/title?page=2" }

  }

  }


  @Test

  public void Relation(){

  String nextTitleLink = given().

  param("param_name","param_value").

  when().

  get("http://localhost:8000/CGIProject/cgi-bin/MyTitle.json").

  then().

  contentType(ContentType.JSON).

  body("title", equalTo("My Title")).

  extract().

  path("_links.next.href");

  System.out.println(nextTitleLink);

      given().log().all()

              .get("http://localhost:8000/CGIProject/cgi-bin/MyTitle.json" + nextTitleLink);

  }

  extract().path("jsonpath表达式");

  该例既请求校验了接口,也拿到了自己需要的参数数据;

  那如果需要从响应报文中取到多个参数呢?官方也给出了解释:

  @Test

  public void Relation1(){

  Response response = given().

  param("param_name","param_value").

  when().

  get("http://localhost:8000/CGIProject/cgi-bin/MyTitle.json").

  then().

  contentType(ContentType.JSON).

  body("title", equalTo("My Title")).

  extract().

  response();

  String nextTitleLink = response.path("_links.next.href");

  String headerValue = response.header("headerName");

  }

  以上内容为大家介绍了接口测试框架RestAssured的使用,本文由多测师亲自撰写,希望对大家有所帮助。了解更多接口测试相关知识:https://www.aichudan.com/xwzx/

联系电话

17727591462

返回顶部