一、参数
我们发送请求经常需要带有参数,使用 given()
就可以实现,当时当我们使用 given()
的时候发现其中有很多传参方法如下:
- param:通常我们都会使用 given().param 方法来传参,REST Assured 会根据 HTTP 方法自动尝试确定哪种参数类型(即查询或表单参数),如果是 GET,则查询参数将自动使用,如果使用 POST,则将使用表单参数:
下面我们以企业微信登录接口为例,演示param参数
@Test public void Login(){ given(). log().all() //大家自行去注册企业微信账号,并且正确获取corpid和corpsecret .param ( "corpid","wwc376242756245a87" ) .param ( "corpsecret","LTnDiVdqHzzmUz8fj21-0kgxv6wEDs3krBnO-0g4MPw" ) .when () .get("https://qyapi.weixin.qq.com/cgi-bin/gettoken") .then() .statusCode(200) .log().all(); }
output:
Request method: GET Request URI: https://qyapi.weixin.qq.com/cgi-bin/gettoken?corpid=wwc376242756245a88&corpsecret=LTnDiVdqHzzmUz8fj21-0kgxv6wEDs3krBnO-0g4MPw Proxy: <none> Request params: corpid=wwc376242756245a87 corpsecret=LTnDiVdqHzzmUz8fj21-0kgxv6wEDs3krBnO-0g4MPw Query params: <none> Form params: <none> Path params: <none> Headers: Accept=*/* Cookies: <none> Multiparts: <none> Body: <none> HTTP/1.1 200 OK Server: nginx Date: Tue, 29 Jun 2021 09:07:52 GMT Content-Type: application/json; charset=UTF-8 Content-Length: 277 Connection: keep-alive Error-Code: 0 Error-Msg: ok { "errcode": 0, "errmsg": "ok", "access_token": "v17VikmModARcZJO-UNBMqLngdPTvTvVE4qYH480cWkbVUXlst8UWKHd3KXv7q7A3V_32I-RlJ4uCv4-DL9D9Xh5_DcIR5wQ9Fjt2E1Ge4EbZloLZnAcisv13VmcTgdN_96YoEAqn5OghRzwIcbp4QOguPT758uLYIcL-h5LvYP8gnesyD2iV9cUhwWg8VvMADUOd_PmcXnjlQrn7BfmZQ", "expires_in": 7200 }
- queryParam 和 formParam: 有时候在 PUT 或 POST 请求中,需要区分查询参数和表单参数时,就需要使用queryParam 和 formParam 方法了,具体写法如下:
given().
formParam("formParamName", "value1").
queryParam("queryParamName", "value2").
when().
post("/something");
- pathParam:路径参数相对来说使用的比较少,至少目前来说笔者还未遇到过,下面是它的示例方法:
post("/reserve/{hotelId}/{roomNumber}", "My Hotel", 23);
则rest-assured可以这样发送:
given().
pathParam("hotelId", "My Hotel").
pathParam("roomNumber", 23).
when().
post("/reserve/{hotelId}/{roomNumber}").
then().
..
二、Content-Type设置
在我们请求接口的时候,经常需要指定接口的请求格式是什么类型的。很多场景下,不指定类型,是发送不成功或者返回的数据会是乱码。那么则如下:
从上面可以看出,其有两个方法,一个是接收一个字符串,一个是接收一个枚举类,所以一般有两种写法:
given().contentType(ContentType.JSON). ..
given().contentType("application/json"). ..
三、发送body
从上面可以看出body 接收类型有7种,这里我们只演示比较常见的一些
- 普通型(字符串),以发送企业微信应用消息为例:
package restassureddemo.weixin; import io.restassured.http.ContentType; import org.junit.jupiter.api.BeforeAll; import org.junit.jupiter.api.Test; import static io.restassured.RestAssured.given; public class TestWeixin { public static String access_token; @BeforeAll public static void getAccesstoken(){ access_token = given() .log().all() .params("corpid","wwc376242756245a87","corpsecret","LTnDiVdqHzzmUz8fj21-0kgxv6wEDs3krBnO-0g4MPw") .get("https://qyapi.weixin.qq.com/cgi-bin/gettoken") .then() .statusCode(200) .log().all() .extract().response().path("access_token"); } @Test void send() { given() .log().all() .queryParam("access_token", access_token) .contentType(ContentType.JSON) // .contentType("application/json;charset=utf-8") .body("{ " + " "touser" : "@all", " + " "msgtype" : "text", " + " "agentid" : 1000002, " + " "text" : { " + " "content" : "你的快递已到,请携带工卡前往邮件中心领取。\n出发前可查看<a href=\"http://work.weixin.qq.com\">邮件中心视频实况</a>,聪明避开排队。" " + " }") .post("https://qyapi.weixin.qq.com/cgi-bin/message/send") .then() .log().all(); } }
output:
{
"errcode": 0,
"errmsg": "ok. Warning: wrong json format. ",
"invaliduser": ""
}
备注:errmsg提示是错误的json format,说明多少是有一些问题的
表现:
- 通过 contentType 指定为 JSON,将 HashMap 序列化为 JSON(重点掌握,很多接口的传输内容都是json)
package restassureddemo.weixin; import io.restassured.http.ContentType; import org.junit.jupiter.api.BeforeAll; import org.junit.jupiter.api.Test; import java.util.HashMap; import java.util.Map; import static io.restassured.RestAssured.given; public class TestWeixin { public static String access_token; @BeforeAll public static void getAccesstoken(){ access_token = given() .log().all() .params("corpid","wwc376242756245a88","corpsecret","LTnDiVdqHzzmUz8fj21-0kgxv6wEDs3krBnO-0g4MPw") .get("https://qyapi.weixin.qq.com/cgi-bin/gettoken") .then() .statusCode(200) .log().all() .extract().response().path("access_token"); } @Test void send_HashMap() { //组装content的map Map<String,Object> contentMap = new HashMap<> (); contentMap.put ( "content","你的快递已到,请携带工卡前往邮件中心领取。 出发前可查看<a href=\"http://work.weixin.qq.com\">邮件中心视频实况</a>,聪明避开排队。" " ); //组装消息的map Map<String,Object> jsonAsMap = new HashMap<> (); jsonAsMap.put ( "touser","@all" ); jsonAsMap.put ( "msgtype","text" ); jsonAsMap.put ( "agentid",1000002 ); jsonAsMap.put ( "text", contentMap); given() .log().all() .queryParam("access_token", access_token) .contentType(ContentType.JSON) .body ( jsonAsMap ) .post("https://qyapi.weixin.qq.com/cgi-bin/message/send") .then() .log().all(); } }
output:
{
"errcode": 0,
"errmsg": "ok",
"invaliduser": ""
}
备注:
errmsg无提示,说明OK
- 通过 contentType 指定为 JSON,将 Message 对象序列化为 JSON
前提:idea配置好Lombok和jackson相关的库
给企业微信发送消息的body体结构为:
Body: { "touser": "@all", "msgtype": "text", "agentid": 1000002, "text": { "content": "你的快递已到,请携带工卡前往邮件中心领取。 出发前可查看<a href=\"http://work.weixin.qq.com\">邮件中心视频实况</a>,聪明避开排队。" " } }
所以定义两个对象实体类,Meassage和Text
import lombok.Data; @Data public class Measage { private String touser; private String msgtype; private int agentid; private Text text; }
import lombok.Data; @Data public class Text { private String content; }
测试方法:
@Test void send_Message_Object() { Text text = new Text (); text.setContent ( "你的快递已到,请携带工卡前往邮件中心领取。 出发前可查看<a href=\"http://work.weixin.qq.com\">邮件中心视频实况</a>,聪明避开排队。" " ); Measage measage = new Measage (); measage.setTouser ( "@all" ); measage.setMsgtype ( "text" ); measage.setAgentid ( 1000002 ); measage.setText ( text ); given() .log().all() .queryParam("access_token", access_token) .contentType(ContentType.JSON) .body ( measage ) .post("https://qyapi.weixin.qq.com/cgi-bin/message/send") .then() .log().all(); }
在此示例中,REST Assured 会将对象序列化为 JSON,因为请求内容类型设置为“application/json”。 如果在类路径中找到,它将首先尝试使用 Jackson,否则将使用 Gson。 如果您将内容类型更改为“application/xml”,则 REST Assured 将使用 JAXB 序列化为 XML。 如果未定义内容类型,REST Assured 将尝试按以下顺序序列化:
1、JSON using Jackson 2 (Faster Jackson (databind))
2、JSON using Jackson (databind)
3、JSON using Gson
4、JSON using Johnzon
5、JSON-B using Eclipse Yasson
6、XML using JAXB
rest-assured官方使用文档:https://github.com/rest-assured/rest-assured/wiki/Usage#examples