logo
搜索
我的图书馆

发文章

发文工具

其他工具

留言交流
搜索
分享

Java接口自动化测试框架设计

 huowufenghuang 2019-01-07

       前面一篇，我们介绍了Get方法的设计过程和测试结果，现在我们需要对前面代码进行重构和修改，本篇需要完成以下目标。

1）重构Get方法

2）如何进行JSON解析

3）使用TestNG方法进行测试断言

 

1.重构Get方法

 

      在前面文章，说过，之前写的Get方法比较繁琐，不光写了如何进行Get请求，还写了获取http响应状态码和JSON转换。现在我们需要抽取出来，设计Get请求方法，就只干一件事情，那就是如何发送get请求，其他的不要管。

      我们知道，请求之后会返回一个HTTP的响应对象，所以，我们把get方法的返回值类型改成了响应对象，并带上返回语句，重构代码之后，get方法代码如下。

  1. package com.qa.restclient;
  3. import java.io.IOException;
  4. import org.apache.http.client.ClientProtocolException;
  5. import org.apache.http.client.methods.CloseableHttpResponse;
  6. import org.apache.http.client.methods.HttpGet;
  7. import org.apache.http.impl.client.CloseableHttpClient;
  8. import org.apache.http.impl.client.HttpClients;
  11. public class RestClient {
  13.    //1. Get 请求方法
  15.    public CloseableHttpResponse get(String url) throwsClientProtocolException, IOException {
  17.       //创建一个可关闭的HttpClient对象
  18.       CloseableHttpClienthttpclient = HttpClients.createDefault();
  19.       //创建一个HttpGet的请求对象
  20.       HttpGethttpget = newHttpGet(url);
  21.       //执行请求,相当于postman上点击发送按钮，然后赋值给HttpResponse对象接收
  22.       CloseableHttpResponsehttpResponse = httpclient.execute(httpget);
  23.       return httpResponse;
  25.    }
  27. }

       由于我们不想在代码里写死例如像HTTP响应状态码200这样的硬编码，所以，这里我们在TestBase.java里把状态码给用常量写出来，方便每一个TestNG测试用例去调用去断言。

  1. package com.qa.base;
  3. import java.io.FileInputStream;
  4. import java.io.FileNotFoundException;
  5. import java.io.IOException;
  6. import java.util.Properties;
  8. public class TestBase {
  11.          public Properties prop;
  12.          public int RESPNSE_STATUS_CODE_200 = 200;
  13.          public int RESPNSE_STATUS_CODE_201 = 201;
  14.          public int RESPNSE_STATUS_CODE_404 = 404;
  15.          public int RESPNSE_STATUS_CODE_500 = 500;
  18.          //写一个构造函数
  19.          public TestBase() {
  21.                    try{
  22.                             prop= new Properties();
  23.                             FileInputStreamfis = new FileInputStream(System.getProperty("user.dir")+
  24. "/src/main/java/com/qa/config/config.properties");
  25.                             prop.load(fis);
  27.                    }catch (FileNotFoundException e) {
  28.                             e.printStackTrace();
  30.                    }catch (IOException e) {
  31.                             e.printStackTrace();
  33.                    }
  35.          }
  37. }

现在我们的测试类代码修改之后如下。

  1. package com.qa.tests;
  2. import java.io.IOException;
  3. importorg.apache.http.client.ClientProtocolException;
  4. importorg.apache.http.client.methods.CloseableHttpResponse;
  5. import org.testng.Assert;
  6. import org.testng.annotations.BeforeClass;
  7. import org.testng.annotations.Test;
  8. import com.qa.base.TestBase;
  9. import com.qa.restclient.RestClient;
  12. public class GetApiTest extends TestBase{
  14.          TestBase testBase;
  15.          String host;
  16.          String url;
  17.          RestClient restClient;
  18.          CloseableHttpResponse closeableHttpResponse;
  21.          @BeforeClass
  22.          public void setUp() {
  23.              testBase = new TestBase();
  24.              host = prop.getProperty("HOST");
  25.              url = host + "/api/users";         
  26.          }
  29.          @Test
  30.          public void getAPITest() throws ClientProtocolException, IOException {
  31.                    restClient = new RestClient();
  32.                    closeableHttpResponse= restClient.get(url);
  34.                    //断言状态码是不是200
  35.                    int statusCode = closeableHttpResponse.getStatusLine().getStatusCode();
  36.                    Assert.assertEquals(statusCode,RESPNSE_STATUS_CODE_200, "response status code is not 200");
  37.          }
  38. }
测试运行通过，没毛病。

2.写一个JSON解析的工具类

      在上面部分，我们只是写了执行Get请求和状态码是否200的断言。接下来，我们需要写有一个JSON解析工具类，这样就方便我们去json内容的断言。

下面这个JSON数据截图


      上面是一个标准的json的响应内容截图，第一个红圈”per_page”是一个json对象，我们可以根据”per_page”来找到对应值是3，而第二个红圈“data”是一个JSON数组，而不是对象，不能直接去拿到里面值，需要遍历数组。

      下面，我们写一个JSON解析的工具方法类，如果是像第一个红圈的JSON对象，我们直接返回对应的值，如果是需要解析类似data数组里面的json对象的值，这里我们构造方法默认解析数组第一个元素的内容。

在src/main/java下新建一个包：com.qa.util,然后在新包下创建一个TestUtil.java类。

  1. package com.qa.util;
  2. import com.alibaba.fastjson.JSONArray;
  3. import com.alibaba.fastjson.JSONObject;
  6. public class TestUtil {
  8.    /**
  10.     *
  12.     * @param responseJson ,这个变量是拿到响应字符串通过json转换成json对象
  14.     * @param jpath,这个jpath指的是用户想要查询json对象的值的路径写法
  16.     * jpath写法举例：1) per_page  2)data[1]/first_name ，data是一个json数组，[1]表示索引
  18.     * /first_name 表示data数组下某一个元素下的json对象的名称为first_name
  20.     * @return，返回first_name这个json对象名称对应的值
  22.     */
  25.    //1 json解析方法
  27.    public static String getValueByJPath(JSONObject responseJson, String jpath){
  29.       Objectobj = responseJson;
  31.       for(String s : jpath.split("/")) {
  33.         if(!s.isEmpty()) {
  35.            if(!(s.contains("[") || s.contains("]"))) {
  37.               obj = ((JSONObject) obj).get(s);
  39.            }else if(s.contains("[") || s.contains("]")) {
  41.               obj =((JSONArray)((JSONObject)obj).get(s.split("\\[")[0])).get(Integer.parseInt(s.split("\\[")[1].replaceAll("]", "")));
  43.            }
  44.         }
  45.       }
  46.       return obj.toString();
  47.    }
  48. }

       简单解释下上面的代码，主要是查询两种json对象的的值，第一种最简单的，这个json对象在整个json串的第一层，例如上面截图中的per_page，这个per_page就是通过jpath这个参数传入，返回的结果就是3. 第二种jpath的查询，例如我想查询data下第一个用户信息里面的first_name的值，这个时候jpath的写法就是data[0]/first_name，查询结果应该是Eve。


3.TestNG测试用例

下面，我们TestNG测试用例代码如下

 

  1. package com.qa.tests;
  3. import java.io.IOException;
  5. import org.apache.http.client.ClientProtocolException;
  6. import org.apache.http.client.methods.CloseableHttpResponse;
  7. import org.apache.http.util.EntityUtils;
  8. import org.testng.Assert;
  9. import org.testng.annotations.BeforeClass;
  10. import org.testng.annotations.Test;
  12. import com.alibaba.fastjson.JSON;
  13. import com.alibaba.fastjson.JSONObject;
  14. import com.qa.base.TestBase;
  15. import com.qa.restclient.RestClient;
  16. import com.qa.util.TestUtil;
  18. public class GetApiTest extends TestBase{
  19. 	TestBase testBase;
  20. 	String host;
  21. 	String url;
  22. 	RestClient restClient;
  23. 	CloseableHttpResponse closeableHttpResponse;
  26. 	@BeforeClass
  27. 	public void setUp() {
  28. 		testBase = new TestBase();
  29. 		host = prop.getProperty("HOST");
  30. 		url = host + "/api/users?page=2";
  32. 	}
  34. 	@Test
  35. 	public void getAPITest() throws ClientProtocolException, IOException {
  36. 		restClient = new RestClient();
  37. 		closeableHttpResponse = restClient.get(url);
  39. 		//断言状态码是不是200
  40. 		int statusCode = closeableHttpResponse.getStatusLine().getStatusCode();
  41. 		Assert.assertEquals(statusCode, RESPNSE_STATUS_CODE_200, "response status code is not 200");
  43. 		//把响应内容存储在字符串对象  
  44.         String responseString = EntityUtils.toString(closeableHttpResponse.getEntity(),"UTF-8");  
  46.         //创建Json对象，把上面字符串序列化成Json对象  
  47.         JSONObject responseJson = JSON.parseObject(responseString);  
  48.         //System.out.println("respon json from API-->" + responseJson); 
  50.         //json内容解析
  51.         String s = TestUtil.getValueByJPath(responseJson,"data[0]/first_name");
  52.         System.out.println(s);
  53. 	}	
  54. }

运行测试结果：

[RemoteTestNG] detected TestNGversion 6.14.3

Eve

PASSED: getAPITest

你还可以多写几个jpath来测试这个json解析工具类。

  1. String s = TestUtil.getValueByJPath(responseJson,"data[1]/id");
  3. String s = TestUtil.getValueByJPath(responseJson,"per_page");

4.TestNG自带的测试断言方法

        这里简单提一下TestNG的断言方法，我们一般测试都需要写断言的代码，否则这样的单元测试代码就没有意义。下面，我在statusCode和json解析的first_name进行断言。

  1. package com.qa.tests;
  3. import java.io.IOException;
  5. import org.apache.http.client.ClientProtocolException;
  6. import org.apache.http.client.methods.CloseableHttpResponse;
  7. import org.apache.http.util.EntityUtils;
  8. import org.testng.Assert;
  9. import org.testng.annotations.BeforeClass;
  10. import org.testng.annotations.Test;
  12. import com.alibaba.fastjson.JSON;
  13. import com.alibaba.fastjson.JSONObject;
  14. import com.qa.base.TestBase;
  15. import com.qa.restclient.RestClient;
  16. import com.qa.util.TestUtil;
  18. public class GetApiTest extends TestBase{
  19. 	TestBase testBase;
  20. 	String host;
  21. 	String url;
  22. 	RestClient restClient;
  23. 	CloseableHttpResponse closeableHttpResponse;
  26. 	@BeforeClass
  27. 	public void setUp() {
  28. 		testBase = new TestBase();
  29. 		host = prop.getProperty("HOST");
  30. 		url = host + "/api/users?page=2";
  32. 	}
  34. 	@Test
  35. 	public void getAPITest() throws ClientProtocolException, IOException {
  36. 		restClient = new RestClient();
  37. 		closeableHttpResponse = restClient.get(url);
  39. 		//断言状态码是不是200
  40. 		int statusCode = closeableHttpResponse.getStatusLine().getStatusCode();
  41. 		Assert.assertEquals(statusCode, RESPNSE_STATUS_CODE_200, "response status code is not 200");
  43. 		//把响应内容存储在字符串对象  
  44.         String responseString = EntityUtils.toString(closeableHttpResponse.getEntity(),"UTF-8");  
  46.         //创建Json对象，把上面字符串序列化成Json对象  
  47.         JSONObject responseJson = JSON.parseObject(responseString);  
  48.         //System.out.println("respon json from API-->" + responseJson); 
  50.         //json内容解析
  51.         String s = TestUtil.getValueByJPath(responseJson,"data[0]/first_name");
  52.         System.out.println(s);
  53.         Assert.assertEquals(s, "Eve","first name is not Eve");
  54. 	}
  55. }

经常使用的测试断言：

Assert.assertEquals(“现实结果”, "期待结果","断言失败时候打印日志消息");

 

    本站是提供个人知识管理的网络存储空间，所有内容均由用户发布，不代表本站观点。请注意甄别内容中的联系方式、诱导购买等信息，谨防诈骗。如发现有害或侵权内容，请点击一键举报。
    转藏 分享 献花（0）

    来自： huowufenghuang > 《测试》

    举报/认领

    0条评论

    发表

    请遵守用户 评论公约

    类似文章 更多