接口自动化·分享·第一篇·剖析接口本质并搭建接口自动化环境

　　对于大多数未做过接口测试的同学来说，可能并不清楚接口到底是什么，甚至你去问很多做过接口测试的同学什么是接口，他们也说不出个所以然，大多数人可能知道接口大概是什么，也知道怎么测，但是不知道如何用专业的术语去描述出来。

　　接口的本质：接口就是一个函数，通过将接口部署到web容器（tomcat，jboss，weblogic等），发布服务后，就可以通过一个url地址去访问到接口了。而接口文档里面描述的接口参数呢其实就是函数的参数，接口的返回数据就是函数的返回值。即：接口=函数，接口参数=函数参数，接口返回值=函数返回值。以如下接口项目中的“获取用户列表”接口为例:（http://116.23.246.159:8380/futureloan/mvc/api/member/list），它其实就对应了后台的一个这样的一个同名函数：

        /**
	 * 获取用户列表
	 * 
	 * @return
	 */
	@RequestMapping
	public @ResponseBody Result list() {
		Result result = null;
		try {
			List<Member> members = memberService.list();
			result = new Result(true, Ret.MEMBER_LIST_SUCCESS.code(), members, Ret.MEMBER_LIST_SUCCESS.value());
		} catch (Exception e) {
			logger.error(e);
			result = new Result(false, Ret.MEMBER_LIST_FAIL.code(), Ret.MEMBER_LIST_FAIL.value());
		}
		return result;
	}        

　　接口测试跟ui测试的本质区别：

UI测试更专注于ui页面，而不关注系统内部实现，一个功能模块是否有bug，所有的判断依据都直接来自于前端页面反馈，跟我们的预期对比，一样就测试通过，不一样就是bug。而接口不一样，需要借助某些客户端工具模拟前端页面发送接口请求，测试人员通过判断接口返回数据与预期是否一致，对测试人员的技术要求更高。

　　接口测试到底是在项目哪个阶段去做？

接口测试可以在项目的任意阶段做，只要接口已经开发出来了，提前介入，就能提前发现问题，不管系统是不是已经将页面与后台接口集成了，项目时间充足的前提下都最好对接口进行一轮或者多轮测试，基于两点原因：1）某些请求如果绕过前端直接往接口发送非法数据，而接口也有相应处理措施，那么将最大限度的降低了系统的风险；2）后端控制好了，所有的问题就集中与前端这一块了。

　　手工测试接口有哪些工具：Postman，jmeter，Soapui，Fiddler等主流的工具都能完成。

　　什么是接口自动化? 通过代码驱动测试而非人工。

　　为什么需要做接口自动化? 通过机器来替代人工，解放生产力。

　　如何做接口自动化? 通过http技术处理接口调用。

　　接口自动化环境如何搭建：

　　1.创建maven项目，为什么用maven项目，最重要最直接的原因是希望maven来管理咱们的项目依赖，这样我们就不需要满世界的找各种jar包去下载了。

　　2.集成HttpClient，在maven项目引入HttpClient-4.5.2这个框架的依赖，这个框架提供了一些http技术可以帮助咱们去发起接口调用并处理接口返回数据，以下是依赖描述。

<dependency>

    <groupId>org.apache.httpcomponents</groupId>

    <artifactId>httpclient</artifactId>

    <version>4.5.2</version>

</dependency>

　　3.集成testng，利用testng这个测试框架来帮助咱们来更好的管理测试类，以及它提供了丰富的注解，方便咱们去实现多场景测试设计。以下是依赖描述。

<dependency>

<groupId>org.testng</groupId>

<artifactId>testng</artifactId>

<version>6.8.8</version>

<scope>test</scope>

</dependency>

　　4.至于项目的其他依赖在后面的接口自动化框架实现过程中再给大家补充，本节只为实现一个最简单的环境和一个接口调用案例。

　　小试牛刀：通过http技术post一次接口请求，完成对于登录接口（login）的调用，并得到接口返回数据。代码如下：

 

package com.lemonban;

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

import org.apache.http.NameValuePair;
import org.apache.http.client.entity.UrlEncodedFormEntity;
import org.apache.http.client.methods.CloseableHttpResponse;
import org.apache.http.client.methods.HttpGet;
import org.apache.http.client.methods.HttpPost;
import org.apache.http.client.utils.URLEncodedUtils;
import org.apache.http.impl.client.CloseableHttpClient;
import org.apache.http.impl.client.HttpClients;
import org.apache.http.message.BasicNameValuePair;
import org.apache.http.util.EntityUtils;
import org.testng.annotations.Test;

public class HelloWorld {
	@Test
	public void test(){
		String restUrl = "http://116.23.246.159:8380/lmcanon/mvc/member/api/member/login";
		//1.决定接口提交的方式（post/get），此处以post为例
		HttpPost httpPost = new HttpPost(restUrl);
		//2.准备提交参数
		List<NameValuePair> params = new ArrayList<NameValuePair>();
		BasicNameValuePair basicNameValuePair1 = new BasicNameValuePair("nickname", "admin");
		BasicNameValuePair basicNameValuePair2 = new BasicNameValuePair("password", "d5149ce361d6ee80eeccc260795eb1d1");
		params.add(basicNameValuePair1);
		params.add(basicNameValuePair2);
		//3.参数封装到请求体当中
		try {
			httpPost.setEntity(new UrlEncodedFormEntity(params));
			//4.准备客户端（HttpClient）
			CloseableHttpClient httpClient = HttpClients.createDefault();
			//5.提交请求
			CloseableHttpResponse httpResponse = httpClient.execute(httpPost);
			String name = httpResponse.getFirstHeader("Set-Cookie").getName();
			String value = httpResponse.getFirstHeader("Set-Cookie").getValue();
			HttpUtils.addHeader(name, value);
			System.out.println("name="+name+",value="+value);
			//6.解析接口返回数据
			String result = EntityUtils.toString(httpResponse.getEntity());
			System.out.println("*********返回数据："+result);
		} catch (Exception e) {
			// TODO Auto-generated catch block
			e.printStackTrace();
		}
	}
}

 

 

 　　代码执行结果：

　　　　

　　总结：以上代码是一个简单的案例，离我们的接口自动化框架还差十万八千里。我们的最后的测试框架是针对于不同类型接口项目的自动化测试统一解决方案，因此兼容性，复用性都要达到最大化，而这些都需要好的设计思想去支撑，以下为我们在实现这个测试框架中需要去逐步解决的几个问题：

 

　　下一篇专注于单接口测试到多接口的测试的过渡实现。大家敬请期待。