APIテストを自動化する方法はたくさんあります。百花が咲いていると言えます。それぞれにメリットがあります。本日は、RestAssuredとTestNGを組み合わせてAPI自動化テストを実現する方法を簡単に紹介します。 。
環境建設
新しいMavenプロジェクトを作成し、pomファイルで以下を直接構成し、Rest AssuredとTestNGの対応するパッケージをインポートし、実際の状況に応じて最新バージョンをインポートします。
<!-- https://mvnrepository.com/artifact/io.rest-assured/rest-assured -->
<dependency>
<groupId>io.rest-assured</groupId>
<artifactId>rest-assured</artifactId>
<version>3.0.5</version>
</dependency>
<!-- https://mvnrepository.com/artifact/org.testng/testng -->
<dependency>
<groupId>org.testng</groupId>
<artifactId>testng</artifactId>
<version>6.11</version>
</dependency>
デモ
デモデモを入手
ここでは、Jianshuのホームページで推奨される作成者APIを例として取り上げます。このAPIは、Getリクエスト、リクエストアドレス、およびパラメーターです:http ://www.jianshu.com/users/recommended?seen_ids3%count=5&only_unfollowed=true
次に、Rest Assuredを使用してこのリクエストをシミュレートします。
最初に、静的メソッドをインポートする必要があります。
import static io.restassured.RestAssured.*;
次に、ケースを作成します。
@Test()
public void getHttpTest() {
Response response = given()
.get("http://www.jianshu.com/users/recommended?seen_ids=&count=5&only_unfollowed=true");
// 打印出 response 的body
response.print();
}
httpsプロトコルデモ
httpsプロトコルを想定して、Douban検索ブックAPIを例として取り上げます。詳細なAPIを次の図に示します。
豆弁本クエリ
次に、最後のケースでは、URLの直後のパラメーターに従ってリクエストを開始しました。次に、パラメーターを削除し、.params( "key"、 "value"、 "key"、 "value" ....)を使用しました。 、そしてhttpsだったので、すべてのリクエストがすべてのホスト名をサポートするように、ssl構成を追加する必要があります。
@Test()
public void getHttpsTest() {
Response response = given()
// 配置SSL 让所有请求支持所有的主机名
.config((RestAssured.config().sslConfig(new SSLConfig().relaxedHTTPSValidation())))
.params("q", "自动化测试", "start", 0, "count", 2)
.get("https://api.douban.com/v2/book/search");
// 打印出 response 的body
response.print();
}
.params( "key"、 "value"、 "key"、 "value" ....)を使用してすべてのパラメーターをリクエストのパラメーターに入れることに加えて、parame( "key"、 "value ") 形。
@Test()
public void getHttpsTest2() {
Response response = given()
.config((RestAssured.config().sslConfig(new SSLConfig().relaxedHTTPSValidation())))
.param("q", "自动化测试")
.param("start", 0)
.param("count", 2)
.get("https://api.douban.com/v2/book/search");
// 打印出 response 的body
response.print();
}
デモ後
POSTリクエストの例としてログインAPIを取り上げましょう。
リクエストメソッド:POST
プロトコル:HTTP
リクエストアドレス:http://XXX.XXXX.com/Home/Login
リクエストパラメータ:UserName = xxx&Password = ******** &CheckCode =&Remember = false&LoginCheckCode =7505
リクエストのContent-Typeは次のとおりです。application/x-www-form-urlencoded
次に、実装は次のようになります。
@Test
public void postTest2() {
Response response = given()
// 设置request Content-Type
.contentType("application/x-www-form-urlencoded")
// 请求参数 放body
.body("UserName=XXXX&Password=XXXXXX&CheckCode=&Remember=false&LoginCheckCode=7505")
// POST 请求
.post("http://XXXX.XXXX.com/Home/Login");
response.print();
}
もちろん、リクエストのContent-Typeタイプがapplication / x-www-form-urlencodedの場合は、param()またはparams()を使用して直接管理することもでき
ますが、application / jsonの場合は、パラメーターのみを管理できます。 body()を使用します。
@Test
public void postTest3(){
Response response = given()
.contentType("application/x-www-form-urlencoded")
.param("CheckCode", "")
.param("LoginCheckCode", "3719")
.param("Password", "XXXXX")
.param("Remember", "true")
.param("UserName", "XXXXX")
.post("http://XXXX.XXXXX.com/Home/Login");
response.print();
}
ヘッダー、Cookieを設定します
ヘッダーとCookieの設定はparamに似ています。header()、headers()、cookie()、cookies()メソッドがあり、使用法はparamに似ています。
Response response = given()
.cookie("cookie","value")
.cookies("cookiename1", "value1", "cookiename2", "value2")
.header("Accept-Encoding:", "gzip, deflate")
.headers("header1","value1","header2","value2")
.get("XXXXXXX");
応答ステータスコードの取得:StatusCode
ステータスコードを取得し、int型を返します。
response.getStatusCode();
応答Cookieを取得する
特定のCookieを取得します。
response.getCookie("cookiesName")
すべてのCookieを取得し、マップを返します。
Map cookies = response1.getCookies();
応答ヘッダーの一般的な操作
- すべてのヘッダーを取得します。
Headers headers = response.getHeaders();
- 指定されたヘッダーを取得します。
response.getHeader("header name");
// 等同上面方法
Headers headers = response.getHeaders();
headers.get("header name");
- ヘッダーが存在するかどうかを判別し、ブール型を返します
Headers headers = response.getHeaders();
headers.hasHeaderWithName("XXX")
- ヘッダーが空かどうかを確認します
Headers headers = response.getHeaders();
headers.exist()
応答本文を取得
応答本文を取得し、文字列型に変換します。
response.getBody().asString()
完全な例は、以下のJSON解析とともに示されています。
JSONを解析する
Rest Assuredには、JSONとxmlの解析がサポートされています。たとえば、Douban BooksQueryAPIを例として取り上げましょう。リクエストパラメータでq="automatic test"、start = 0、count = 5とすると、このリクエストをシミュレートします。簡単なJSON解析を実行します。
@Test
public void jsonParsed() {
Response response = given()
.config((RestAssured.config().sslConfig(new SSLConfig().relaxedHTTPSValidation())))
.params("q", "自动化测试", "start", 0, "count", 5)
.get("https://api.douban.com/v2/book/search");
// 打印出 response 的body
response.print();
int statusCode = response.getStatusCode();
System.out.println("statusCode:" + statusCode);
// 获取Response 的所有 headers 并输出
Headers headers = response.getHeaders();
System.out.println(headers.toString());
// 获取Response中header名为Content-Type的值
String contentType = response.getHeader("Content-Type");
System.out.println("contentType:" + contentType);
// 等同上面方法
System.out.println(headers.get("Content-Type"));
// 校验某个Header 是否存在
System.out.println(headers.hasHeaderWithName("fasdfaf"));
System.out.println(headers.hasHeaderWithName("Server"));
// 如果Response 的headers不为空则返回true
System.out.println(headers.exist());
Map<String, String> cookiesMap = response.cookies();
for (String key : cookiesMap.keySet()) {
System.out.println(key + ":" + cookiesMap.get(key));
}
System.out.println(response.cookie("bid"));
// 把Response 的body转成string类型
System.out.println(response.getBody().asString());
int count = response.jsonPath().getInt("count");
System.out.println("count:" + count);
// 获取所有的 subtitle
ArrayList<String> subtitles = response.jsonPath().get("books.subtitle");
for (int i = 0; i < subtitles.size(); i++) {
System.out.println(subtitles.get(i));
}
// 获取特定某个的subtitle
String subtitle = response.jsonPath().get("books.subtitle[0]");
System.out.println(subtitle);
// 获取倒数第二个的subtitle
String subtitle1 = response.jsonPath().get("books.subtitle[-2]");
System.out.println(subtitle1);
// 获取特定tags底下的所有title
ArrayList<String> tagTitle = response.jsonPath().get("books.tags[2].title");
for (int i = 0; i < tagTitle.size(); i++) {
System.out.println(tagTitle.get(i));
}
// 获取所有的 title
ArrayList<ArrayList<String>> tagTitles = response.jsonPath().get("books.tags.title");
for (int i = 0; i < tagTitles.size(); i++) {
for (int j = 0; j < tagTitles.get(i).size(); j++) {
System.out.println(tagTitles.get(i).get(j));
}
System.out.println("---------------------");
}
// 获取Response json里面所有title = "Selenium 2自动化测试实战"的title
String title = response.jsonPath().get("books.title.findAll{title ->title==\"Selenium 2自动化测试实战\"}").toString();
System.out.println(title);
// 获取Response json中 1< numRaters <=20的所有 numRaters
String numRaters = response.jsonPath().get("books.rating.numRaters.findAll{numRaters -> numRaters>1 && numRaters<=20}").toString();
System.out.println(numRaters);
// 获取Response json种title = "基于Selenium 2的自动化测试"对应的 author
String title2 = response.jsonPath().get("books.findAll{it.title==\"基于Selenium 2的自动化测试\"}.author").toString();
System.out.println(title2);
}
応答が期待どおりかどうかを確認します
Rest Assuredは、hasITems、is、equalToなどの静的メソッドを使用できるようにします。使用する場合は、最初にメソッドをインポートします。
import static org.hamcrest.CoreMatchers.hasItems;
import static org.hamcrest.Matchers.is;
import static org.hamcrest.core.IsEqual.equalTo;
@Test
public void testDemo1() {
Response response = given()
.config((RestAssured.config().sslConfig(new SSLConfig().relaxedHTTPSValidation())))
.params("q", "自动化测试", "start", 0, "count", 5)
.expect()
// 判断 title是否包含了 自动化 和 自动化测试
.body("books.tags[2].title", hasItems("自动化", "自动化测试"))
// 判断 count 值是否为 5
.body("count", is(5))
// 判断 publisher 值是否为 "电子工业出版社"
.body("books.publisher[0]", is("电子工业出版社"))
// 判断 title 是否等于 5
.body("count", equalTo(5))
.when()
.get("https://api.douban.com/v2/book/search");
// 打印出 response 的body
response.print();
}
Rest Assuredは検証メソッドを提供しますが、実際のAPI自動テストプロセスでは、検証するフィールドが多数あることが多いため、直接検証するJSONフィールドを解析してから、TestNGが提供するAssertクラスを使用して検証。チェック。
例を追加
Web APIの多くのAPIリクエストは、ユーザーがログインした後に開始する必要があり、ユーザーがログインしているかどうかを判断するのはCookieを判断するためであることが多いため、このような問題が発生した場合は、必要なAPIにCookieを設定するだけで済みます。ログインAPIとしてシミュレートされます生成されたCookieを使用できます。
たとえば、デモでは、2番目のリクエストを渡す前提は、最初のリクエストのCookieを取得することです。次に、最初のリクエストの応答にあるすべてのCookieを、リクエストとして2番目のリクエストに入れます。
@Test
public void postHttpsTest3() {
Response response1 = given()
.contentType("application/x-www-form-urlencoded")
.body("UserName=XXXX&Password=XXXXX&CheckCode=&Remember=false&LoginCheckCode=7505")
.post("http://XXXX.XXXX.com/Home/Login");
response1.print();
// 获取reponse中所有的cookies
Map cookies = response1.getCookies();
Response response2 = given()
// 写入第一个请求的cookies
.cookies(cookies)
.contentType("application/x-www-form-urlencoded")
.param("ActionName", "")
.param("CurrentUserNo", "XXXXX")
.post("http://XXXX.XXXXX.com/Home/IsCurrentAccountValid");
response2.print();
}
最後に、すべての人が学習してテストできるようにするために、非常に包括的なコンテンツを含む、すべての人のための13Gの超実用的な乾物学習リソースを特別に用意しました。
これには、ソフトウェア学習ロードマップ、50日以上のクラスビデオ、16の攻撃実際のプロジェクト、80を超えるソフトウェアテストソフトウェア、37のテストドキュメント、70のソフトウェアテスト関連の質問、40のテスト経験レベルの記事、数千のコピーが含まれます。質問、2021年のソフトウェアテストのインタビューコレクション、およびソフトウェアテストの仕事のために選択されたさまざまな履歴書、それがすべての人に役立つことを願っています...
私の公式アカウントをフォローしてください:[プログラマーEr Hei]この情報を入手してください!
自習中に情報が見つからず、誰も質問に答えず、数日後に諦めたくないという気持ちを味わいたくない場合は、私たちのグループに参加できます:785128166一緒に話し合い、交換しましょう。さまざまなソフトウェアテスト資料や技術交流もあります。