Java接口自动化测试实战001----get、post方法实现与封装

一、接口测试

1、接口测试流程

• 根据接口文档编写测试用例
• 准备测试数据
• 准备工具（测试工具or接口测试代码）
• 填写接口信息（接口地址、请求方式等）
• 准备请求头数据（如果有必要，比如：cookies，Content-Type等）
• 发起请求，获取接口的相应信息（状态码、响应报文、或者某些特殊的响应头数据）
• 根据报文判断实际与预期结果是否一致

2、HTTP请求

   HTTP请求表示的是从客户端发送到服务器端的请求，HttpGet和HttpPost都是HttpRequest的实现类，属于子类对象，其关系如下图所示：

 

3、HTTP响应

   HTTP响应表示的是从服务器到客户端的响应，其使用方法有以下几种：

• 从响应对象中获取返回的数据：getEntity()
• 从响应对象中获取响应状态码：getStatusLine().getStatusCode()
• 从响应对象中获取响应头信息：getAllHeaders()

二、接口自动化测试之Get请求

1、get请求的特点

• 以get方式提交请求到服务器
• Get参数不是封装在请求体当中的（由没有setEntity方法可以看出来）
• 数据长度是有限制的
• 支持get提交的接口一般都是从服务器上拿下来数据

2、HttpGet请求

     HttpGet是模拟实现Http协议下get请求的java类，它关键的api函数有以下几个：

• 构造函数：HttpGet httpGet=new HttpGet(url);创建一个get对象，以get方式提交接口请求
• 组合拼接参数：URLEncodedUtils.format(params,”utf-8”);----UrlEncodeFormEntity以表单的形式提交数据.

     注意：如果以get提交的接口请求有需要传参数，参数通常直接拼接在url后面的。

3、HttpGet请求代码实现

（1）实现思想

•   准备测试地址和测试数据，并拼接
•   创建HttpGet对象，指定接口请求方式： HttpGet httpGet=new HttpGet(url);
•   设置请求头信息：httpGet.setHeader(String,String);
•   创建一个可关闭的HttpClient对象：HttpClient httpclient=HttpClients.createDefault();
•   执行请求获取响应信息：HttpResponse httpresponse=httpclient.execute(get);
•   获取响应的状态码：int code=httpresponse.getStatusLine().getStatusCode();
•   获取响应的报文：String result=EntityUtils.toString((httpresponse.getEntity()));

（2）实现代码

   根据实现思想，编写测试代码，如下：

package testInterface.test_V1;

import java.io.IOException;

import org.apache.http.HttpResponse;
import org.apache.http.client.HttpClient;
import org.apache.http.client.methods.HttpGet;
import org.apache.http.impl.client.HttpClients;
import org.apache.http.util.EntityUtils;

public class doGet {

    public static void main(String[] args) {
    //http://127.0.0.1:8080/api/pay/getAllBaseWatercategory?pageNum=1&pageSize=10&name=
    //1、准备URL和测试数据，并拼接成请求的测试地址
     String  url="http://127.0.0.1:8080/api/pay/getAllBaseWatercategory";
     String para="pageNum=1&pageSize=10&name=";     //测试数据
     url=url+"?"+para;    //拼接请求地址
     
     //2、创建HttpGet对象，指定接口提交的方式
     HttpGet get =new HttpGet(url);
     
     //3、设置请求头
     get.setHeader("Authorization", "Bearer eyJhbGciOiJIUzUxMiJ9.eyJzdWIiOjMsImxvZ2luVG9rZW4iOiI3YTc3MDYwYy1jMDkzLTRhYzMtYTFlMC04MGJiNGZmYjIyZmMiLCJleHAiOjE1OTM3MDUyNTB9.k2WvdxXOE-XVNdl3zk-Ee8oxDR4Licj5lSC8rhFN2xSPC1lxPDqYkoLnBGfPEB56Aic7_2b100QTmmoByUyfmA");
     
     //4、创建一个可关闭的HttpClient对象
     HttpClient httpclient=HttpClients.createDefault();
     try {
     //5、执行post请求，获取响应信息（状态码、响应报文、响应头等）。相当于jmeter上点击运行按钮，然后赋值给HttpResponse对象接收
        HttpResponse httpresponse=httpclient.execute(get);
        
     //6、获取响应状态码和响应报文，并输出
        int code=httpresponse.getStatusLine().getStatusCode();
        System.out.print(code);
        String result=EntityUtils.toString((httpresponse.getEntity()));
        System.out.print(result);
    } catch (Exception e) {
        e.printStackTrace();
    } 
 }

}

三、接口自动化测试之Post请求

1、Post提交的特点

• 以post方式提交请求到服务器
• 参数一般是封装到请求体中提交的
• 参数长度没有长度限制
• 支持post方式提交的接口往往是把数据提交到服务器上去

2、HttpPost请求

• HttpGet是模拟实现Http协议下post请求的java类，它关键的api函数有以下几个：
• 构造函数：HttpPost httpPost=new HttpPost(url);创建一个post对象，以post方式提交接口请求
• 设置参数到请求体：post.setEntity(entity,charset);通过此方法将接口参数设置到请求体中。 

3、HttpPost请求具体实现

（1）实现思想

•   准备测试地址和测试数据
•   使用BasicNameValuePair封装post请求中的参数名称和值： 
• List<BasicNameValuePair> parameters=new ArrayList<BasicNameValuePair>();
• parameters.add(new BasicNameValuePair("mobile",mobile));
•   把请求参数放到请求体中--------定义请求的实体，并把参数传进来，定义编码格式为utf-8：post.setEntity(new UrlEncodedFormEntity(parameters,"utf-8"));     
•   创建HttpPost对象，指定接口请求方式： HttpPost httpPost=new HttpPost(url);
•   设置请求头信息：httpGet.setHeader(String,String);
•   创建一个可关闭的HttpClient对象：HttpClient httpclient=HttpClients.createDefault();
•   执行请求获取响应信息：HttpResponse httpresponse=httpclient.execute(post);
•   获取响应的状态码：int code=httpresponse.getStatusLine().getStatusCode();
•   获取响应的报文：String result=EntityUtils.toString((httpresponse.getEntity()));

（2）实现代码

根据实现思想，编写测试代码，如下：

package testInterface.test_V1;


import java.io.IOException;
import java.util.ArrayList;
import java.util.List;

import org.apache.http.HttpResponse;
import org.apache.http.client.ClientProtocolException;
import org.apache.http.client.HttpClient;
import org.apache.http.client.entity.UrlEncodedFormEntity;
import org.apache.http.client.methods.HttpPost;
import org.apache.http.impl.client.HttpClients;
import org.apache.http.message.BasicNameValuePair;
import org.apache.http.util.EntityUtils;

public class doPost {
    public static void  main(String[] args) throws ClientProtocolException, IOException {
        //1、准备测试请求的地址和参数（测试数据）
        String url="http://127.0.0.1:8080/api/user/smsCodeLogin";
        String mobile="13265537610";
        String smsCode="9999";
        
        //2、使用BasicNameValuePair封装post请求中的参数名称和值
        List<BasicNameValuePair> parameters=new ArrayList<BasicNameValuePair>();
        parameters.add(new BasicNameValuePair("mobile",mobile));
        parameters.add(new BasicNameValuePair("smsCode",smsCode));
        
        //3、创建HttpPost对象，指定接口提交的方式
        HttpPost post=new HttpPost(url);
        
        //4、把请求参数放到请求体中--------定义请求的实体，并把参数传进来，定义编码格式为utf-8
        post.setEntity(new UrlEncodedFormEntity(parameters,"utf-8"));
        
         //5、创建一个可关闭的HttpClient对象
        HttpClient httpclient=HttpClients.createDefault();
        
         //6、执行post请求，获取响应信息（状态码、响应报文、响应头等）。相当于jmeter上点击运行按钮，然后赋值给HttpResponse对象接收
        HttpResponse httpresponse=httpclient.execute(post);
        
        //7、获取响应状态码和响应报文，并输出
        int code=httpresponse.getStatusLine().getStatusCode();
        System.out.print(code);
        String result=EntityUtils.toString((httpresponse.getEntity()));
        System.out.print(result);
    }
}

四、封装之拆分get、 post请求

1、拆分getDemo类

(1)实现步骤

• 主函数中处理url和参数，将参数封装到map集合中，调用doGet方法传入url和参数；
• 新建doGet方法，处理map中的参数拼接到地址中，之后执行请求，步骤与之前一样。

（2）实现代码如下：

拆分getDemo类为主函数调用doGet方法的形式，如下所示：

public class getDemo {

    public static void main(String[] args) {
          //http://114.135.61.188:58088/api/pay/getAllBaseWatercategory?pageNum=1&pageSize=10&name=
        //1、准备URL和测试数据，并拼接成请求的测试地址
         String  url="http://114.135.61.188:58088/api/pay/getAllBaseWatercategory";
         String para="pageNum=1&pageSize=10&name=";     //测试数据
         String pageNum="1";
         String pageSize="10";
         String name="";
         Map<String,String> parameter=new HashMap<String,String>();
         parameter.put("pageNum",pageNum);
         parameter.put("pageSize",pageSize);
         parameter.put("name",name);

         doGet(url,parameter);
    }
        
    public static void doGet(String url,Map<String,String> parameter) {
        //拼接URL
        Set<String>  keys=parameter.keySet();
        int mark=1;  //定义一个标志位
        for (String para : keys) {
            if(mark==1) {
                url=url+"?"+para+"="+parameter.get(para);
            }else {
                url=url+"&"+para+"="+parameter.get(para);
            }
            mark++;
        }
        System.out.print(url);
     //2、创建HttpGet对象，指定接口提交的方式
     HttpGet get =new HttpGet(url);
     
     //3、设置请求头
     get.setHeader("Authorization", "Bearer eyJhbGciOiJIUzUxMiJ9.eyJzdWIiOjMsImxvZ2luVG9rZW4iOiI3YTc3MDYwYy1jMDkzLTRhYzMtYTFlMC04MGJiNGZmYjIyZmMiLCJleHAiOjE1OTM3MDUyNTB9.k2WvdxXOE-XVNdl3zk-Ee8oxDR4Licj5lSC8rhFN2xSPC1lxPDqYkoLnBGfPEB56Aic7_2b100QTmmoByUyfmA");
     
     //4、创建一个可关闭的HttpClient对象
     HttpClient httpclient=HttpClients.createDefault();
     try {
     //5、执行post请求，获取响应信息（状态码、响应报文、响应头等）。相当于jmeter上点击运行按钮，然后赋值给HttpResponse对象接收
        HttpResponse httpresponse=httpclient.execute(get);
        
     //6、获取响应状态码和响应报文，并输出
        int code=httpresponse.getStatusLine().getStatusCode();
        System.out.print(code);
        String result=EntityUtils.toString((httpresponse.getEntity()));
        System.out.print(result);
    } catch (Exception e) {
        e.printStackTrace();
    } 
 }

}

2、拆分postDemo类

(1)实现步骤

• 主函数中处理url和参数，将参数封装到map集合中，调用doGet方法传入url和参数；
• 新建doPost方法，处理map中的参数并封装到请求中，之后执行请求，步骤与之前一样。

(2)实现代码如下

拆分postDemo类为主函数调用doPost方法的形式，如下所示：

public class postDemo {
    public static void  main(String[] args) throws ClientProtocolException, IOException {
        //1、准备测试请求的地址和参数（测试数据）
        String url="http://114.135.61.188:58088/api/user/smsCodeLogin";
        String mobile="18800000000";
        String smsCode="9999";
         Map<String,String> parameter=new HashMap<String,String>();
         parameter.put("mobile",mobile);
         parameter.put("smsCode",smsCode);
         doPost(url,parameter);

     }    
    public static void doPost(String url, Map<String,String> parameter) throws ClientProtocolException, IOException {
       
        //2、使用BasicNameValuePair封装post请求中的参数名称和值
        List<BasicNameValuePair> parameters=new ArrayList<BasicNameValuePair>();
        Set<String> keys=parameter.keySet();
        for (String para : keys) {
            parameters.add(new BasicNameValuePair(para,parameter.get(para)));
        }
        
        //3、创建HttpPost对象，指定接口提交的方式
        HttpPost post=new HttpPost(url);
        
        //4、把请求参数放到请求体中--------定义请求的实体，并把参数传进来，定义编码格式为utf-8
        post.setEntity(new UrlEncodedFormEntity(parameters,"utf-8"));
        
         //5、创建一个可关闭的HttpClient对象
        HttpClient httpclient=HttpClients.createDefault();
        
         //6、执行post请求，获取响应信息（状态码、响应报文、响应头等）。相当于jmeter上点击运行按钮，然后赋值给HttpResponse对象接收
        HttpResponse httpresponse=httpclient.execute(post);
        
        //7、获取响应状态码和响应报文，并输出
        int code=httpresponse.getStatusLine().getStatusCode();
        System.out.print(code);
        String result=EntityUtils.toString((httpresponse.getEntity()));
        System.out.print(result);      
    }
}

五、封装get、 post请求到HttpUtil类

1、封装思想 

      提取GetDemo和PostDemo类中的doGet和doPost方法，封装到HttpUtil类中，方便之后调用，降低耦合性。

2、封装实现

（1）项目环境搭建：创建maven项目----在pom.xml中配置httpclient，配置如下：

<project xmlns="http://maven.apache.org/POM/4.0.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd">
  <modelVersion>4.0.0</modelVersion>
  <groupId>com.interface.test</groupId>
  <artifactId>testInterface</artifactId>
  <version>0.0.1-SNAPSHOT</version>
  <dependencies>
  <!-- https://mvnrepository.com/artifact/org.apache.httpcomponents/httpclient -->
      <dependency>
          <groupId>org.apache.httpcomponents</groupId>
          <artifactId>httpclient</artifactId>
          <version>4.5.2</version>
       </dependency>
  </dependencies>
</project>

（2）封装HttpUtil类，并将GetDemo和PostDemo类中的doGet和doPost方法复制粘贴至HttpUtil类中，并将方法修改为静态方法，方便之后调用，如下所示：

public class HttpUtil {
    public static void doGet(String url,Map<String,String> parameter) {
        //拼接URL
        Set<String>  keys=parameter.keySet();
        int mark=1;  //定义一个标志位
        for (String para : keys) {
            if(mark==1) {
                url=url+"?"+para+"="+parameter.get(para);
            }else {
                url=url+"&"+para+"="+parameter.get(para);
            }
            mark++;
        }
        System.out.print(url+"
");
     //2、创建HttpGet对象，指定接口提交的方式
     HttpGet get =new HttpGet(url);
     
     //3、设置请求头
     get.setHeader("Authorization", "Bearer eyJhbGciOiJIUzUxMiJ9.eyJzdWIiOjMsImxvZ2luVG9rZW4iOiI3YTc3MDYwYy1jMDkzLTRhYzMtYTFlMC04MGJiNGZmYjIyZmMiLCJleHAiOjE1OTM3MDUyNTB9.k2WvdxXOE-XVNdl3zk-Ee8oxDR4Licj5lSC8rhFN2xSPC1lxPDqYkoLnBGfPEB56Aic7_2b100QTmmoByUyfmA");
     
     //4、创建一个可关闭的HttpClient对象
     HttpClient httpclient=HttpClients.createDefault();
     try {
     //5、执行post请求，获取响应信息（状态码、响应报文、响应头等）。相当于jmeter上点击运行按钮，然后赋值给HttpResponse对象接收
        HttpResponse httpresponse=httpclient.execute(get);
        
     //6、获取响应状态码和响应报文，并输出
        int code=httpresponse.getStatusLine().getStatusCode();
        System.out.print(code);
        String result=EntityUtils.toString((httpresponse.getEntity()));
        System.out.print(result);
    } catch (Exception e) {
        e.printStackTrace();
    } 
 }
    public static void doPost(String url, Map<String,String> parameter) throws ClientProtocolException, IOException {
           
        //2、使用BasicNameValuePair封装post请求中的参数名称和值
        List<BasicNameValuePair> parameters=new ArrayList<BasicNameValuePair>();
        Set<String> keys=parameter.keySet();
        for (String para : keys) {
            parameters.add(new BasicNameValuePair(para,parameter.get(para)));
        }
        
        //3、创建HttpPost对象，指定接口提交的方式
        HttpPost post=new HttpPost(url);
        
        //4、把请求参数放到请求体中--------定义请求的实体，并把参数传进来，定义编码格式为utf-8
        post.setEntity(new UrlEncodedFormEntity(parameters,"utf-8"));
        
         //5、创建一个可关闭的HttpClient对象
        HttpClient httpclient=HttpClients.createDefault();
        
         //6、执行post请求，获取响应信息（状态码、响应报文、响应头等）。相当于jmeter上点击运行按钮，然后赋值给HttpResponse对象接收
        HttpResponse httpresponse=httpclient.execute(post);
        
        //7、获取响应状态码和响应报文，并输出
        int code=httpresponse.getStatusLine().getStatusCode();
        System.out.print(code);
        String result=EntityUtils.toString((httpresponse.getEntity()));
        System.out.print(result);
    
        
    }
}

六、总结

1、概述

2、实现post、get请求

3、拆分post、get请求

4、将doGet和doPost方法封装到HttpUtil类