接口自动化：HttpClient + TestNG + Java(二) - 第一个接口测试：get请求

在上一篇中，我们搭建好了HttpClient + TestNG + Java的自动化接口测试环境，这一篇我们就赶紧开始编写我们的第一个接口测试用例。

本篇会对问题解决的思路进行更详尽的阐述。

2.1 确定被测接口

首先一个现实的问题，我们要有一个待测接口来验证我们自动化方案的可行性。

我们可以选择在自己的本地去部署一套待测接口，当然也可以选择公网上的接口去进行测试，这里我们选择后者。

我选定的是apishop这个站点：https://www.apishop.net/

这个站点提供非常多，种类齐全的对外开放的接口，其实主要是给其他网站提供各种接口服务的，比如我们接下来要用到的手机号归属地查询接口。当然用他来实现我们的测试也完全没问题。

从上图可以看到，我们可以对这个接口进行符合标准格式的请求，红框中给出的就是我们要去用自动化验证的反馈信息。

反馈信息可以划分为三个部分：

• 状态返回码
• 反馈信息主体
• 反馈头部信息

2.2 创建发送接口的测试类

首先我们来考虑，在我们的项目中写这么个类，让他能够实现发送请求，接收反馈，验证反馈的功能。暂时我们只考虑发送GET方法的请求。

2.2.1 创建所有变量

在我们的第一个测试类中，我们需要使用httpClient来发送请求，接收反馈，然后对反馈信息做一个存储处理和验证。

在我们的项目src/main/java目录下新建一个包名为：com.test.client，在包下新建一个testGetAPI.java类，

首先我们考虑需要如下变量：

        String url；
        CloseableHttpClient httpClient;
        HttpGet httpGet;
        CloseableHttpResponse httpResponse;
        String responseBody;
        int responseCode;
        Header[] responseHeader;

• url是我们去进行get请求的地址；
• httpClient是用来发送http请求的HttpClient实例；
• httpGet是get请求的一个实例；
• httpResponse用来存储我们接收到的反馈；
• responseBody用来存储反馈的主体信息；
• responseCode用来存储反馈的状态码；
• responseHeader用来存储反馈的头部信息；

将以上变量创建。

2.2.2 实现请求发送和反馈接收

接下来实现请求的发送和反馈接收。

首先URL配置如下（部分apikey出于安全原因隐去）：

String url = "https://api.apishop.net/communication/phone/getLocationByPhoneNum?apiKey=nMke6NK29c40*********3eec8aa0808389b16c4&phoneNum=1861195236";

接下来用三行代码来发送请求，接收反馈：

　　
　　//创建一个httpClient的实例
　　httpClient = HttpClients.createDefault();
　　//创建一个httpGet请求实例
　　httpGet = new HttpGet(url);
　　//使用httpClient实例发送刚创建的get请求，并用httpResponse将反馈接收
　　httpResponse = httpClient.execute(httpGet);

其实到这一步我们的主体工作已经做完了，接下来要对接收到的反馈进行一个处理、分析和验证。

我们可以想到，要从httpResponse中提取出上文提到的header,body,code三部分信息。处理代码如下：

　　
　　//从反馈中提取出状态码
　　responseCode = httpResponse.getStatusLine().getStatusCode();
　　//从反馈中提取出反馈主体
　　responseBody = httpResponse.getEntity();
　　//从反馈中提取出所有头部信息
　　responseHeader = httpResponse.getAllHeaders();        

2.2.3 结果验证和处理

接下来用systemOut的方式，将我们提取到这三部分信息一一打印出来，得出的结果如下：

This is the response code:200
This is the response body:ResponseEntityProxy{[Content-Type: text/plain; charset=utf-8,Content-Length: 159,Chunked: false]}
This is the response header:[Lorg.apache.http.Header;@4a9789ee

这里的问题在于，我们发现反馈信息主体和头部格式都不是我们想要的，可验证的格式，所以我们需要以下代码做一些处理：

　　//用EntityUtils工具类将反馈主体处理为字符串形式
　　String resnponseBodyString = EntityUtils.toString(responseBody,"utf-8");

　　//用哈希图将反馈头信息以键值对形式保存
　　HashMap<String,String> hashMap = new HashMap<String,String>();
　　for(Header header:responseHeader){
　　　　hashMap.put(header.getName(), header.getValue());
　　}    

然后再将处理后的变量打印，得到：

This is the response code:200
This is the response body:{"statusCode":"000000","desc":"查询成功","result":{"province":"北京","city":"北京","areacode":"010","zip":"100000","company":"中国联通","card":""}}
This is the response header in hash{Access-Control-Allow-Origin=*, Date=Tue, 20 Nov 2018 03:40:43 GMT, Content-Length=159, Connection=keep-alive, Content-Type=text/plain; charset=utf-8}

可以看到，到这个程度，我们已经可以去验证反馈的正确性了。当然要注意到response body也就是反馈主体还不是以json格式呈现的，我们可以进一步对他做json格式处理，这个放到后续内容。

暂时我们还没有自动验证和断言，但是通过肉眼比对，我们已经能够验证整个请求过程的正确性。

最终我们的整体代码如下：

import java.io.IOException;
import java.util.HashMap;

import org.apache.http.Header;
import org.apache.http.HttpEntity;
import org.apache.http.client.ClientProtocolException;
import org.apache.http.client.methods.CloseableHttpResponse;
import org.apache.http.client.methods.HttpGet;
import org.apache.http.impl.client.CloseableHttpClient;
import org.apache.http.impl.client.HttpClients;
import org.apache.http.util.EntityUtils;

import com.alibaba.fastjson.JSON;
import com.alibaba.fastjson.JSONObject;

public class TestGet {

    public static void main(String[] args) throws ClientProtocolException, IOException {
        String url = "https://api.apishop.net/communication/phone/getLocationByPhoneNum?apiKey=nMke6NK29c40********c8aa0808389b16c4&phoneNum=1861195236";
        CloseableHttpClient httpClient;
        HttpGet httpGet;
        CloseableHttpResponse httpResponse;
        HttpEntity responseBody;
        int responseCode;
        Header[] responseHeader;

        httpClient = HttpClients.createDefault();
        httpGet = new HttpGet(url);
        httpResponse = httpClient.execute(httpGet);

        responseCode = httpResponse.getStatusLine().getStatusCode();
        responseBody = httpResponse.getEntity();
        responseHeader = httpResponse.getAllHeaders();

        String responseBodyString = EntityUtils.toString(responseBody,"utf-8");

        HashMap<String,String> hashMap = new HashMap<String,String>();
        for(Header header:responseHeader){
            hashMap.put(header.getName(), header.getValue());
        }

        System.out.println("This is the response code:" + responseCode);
        System.out.println("This is the response body:" + responseBodyString);
        System.out.println("This is the response header in hash" + hashMap);

    }

}

下一篇我们对当前的测试做一个优化调整和基础封装。