关于接口测试, 我们之前介绍过很多方法了, 有postman, soapUI, Jmeter等, 他们各有优势和劣势, 今天和大家分享的是如何用java TestNG来实现接口测试.
开始测试之前需要如下准备工作:
1. IDE环境, Intellij 或者eclipse, 个人推荐使用Intellij.
2. JKD1.8 以上
3. Maven 环境,
Maven环境配置
4. 被测接口(京东web版登录API)
首先来看下jd 登录接口,chrome浏览器打开www.jd.com, 使用chrome开发者工具, Windows用户按键盘F12, 将tab切换到Network, 使用密码登录方式, 登录成功后, 我们就可以获取到登录接口了,如果无法获取,使用charles第三方工具也是妥妥的.
看下我登录后开发者工具:
接着在ide中创建项目, 我们选择maven来创建项目
是不是非常的简单, 一步步都是next下去即可, Intellij就会帮你把maven项目创建好.
如果你的IDE里没有maven,也不用着急, 在菜单的Preference->plugs里可以添加所需插件
在创建好的项目中, 我们首先进入pom.xml文件, 这是maven的配置文件
代码语言:javascript复制<?xml version="1.0" encoding="UTF-8"?>
<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.api.test</groupId>
<artifactId>test</artifactId>
<version>1.0-SNAPSHOT</version>
</project>
这边需要添加相应的项目管理依赖包, 如testng等, 适个人情况添加所需的依赖包.
代码语言:javascript复制<properties>
<!-- 指明编译源代码时使用的字符编码,maven编译的时候默认使用的GBK编码,
通过project.build.sourceEncoding属性设置字符编码,告诉maven这个项目使用UTF-8来编译 -->
<project.build.sourceEncoding>UTF-8</project.build.sourceEncoding>
<!--这里可以设置需要运行group-->
<groupsTest>execShell</groupsTest>
</properties>
<dependencies>
<dependency>
<groupId>org.testng</groupId>
<artifactId>testng</artifactId>
<version>7.0.0</version>
</dependency>
<dependency>
<groupId>org.apache.poi</groupId>
<artifactId>poi</artifactId>
<version>3.10-FINAL</version>
</dependency>
<dependency>
<groupId>org.jsoup</groupId>
<artifactId>jsoup</artifactId>
<version>1.9.1</version>
</dependency>
<dependency>
<groupId>org.apache.httpcomponents</groupId>
<artifactId>httpclient</artifactId>
<version>4.5.2</version>
</dependency>
<dependency>
<groupId>org.apache.httpcomponents</groupId>
<artifactId>httpmime</artifactId>
<version>4.5.2</version>
</dependency>
<dependency>
<groupId>com.jcraft</groupId>
<artifactId>jsch</artifactId>
<version>0.1.54</version>
</dependency>
<dependency>
<groupId>mysql</groupId>
<artifactId>mysql-connector-java</artifactId>
<version>5.1.38</version>
</dependency>
<dependency>
<groupId>commons-beanutils</groupId>
<artifactId>commons-beanutils</artifactId>
<version>1.6</version>
</dependency>
<dependency>
<groupId>commons-collections</groupId>
<artifactId>commons-collections</artifactId>
<version>3.1</version>
</dependency>
<dependency>
<groupId>commons-logging</groupId>
<artifactId>commons-logging</artifactId>
<version>1.1</version>
</dependency>
<dependency>
<groupId>net.sf.ezmorph</groupId>
<artifactId>ezmorph</artifactId>
<version>1.0.6</version>
</dependency>
<dependency>
<groupId>net.sf.json-lib</groupId>
<artifactId>json-lib</artifactId>
<version>2.4</version>
</dependency>
</dependencies>
如果需要maven来帮你build项目也是可以的, 方法也是非常简单
代码语言:javascript复制 <build>
<plugins>
<plugin>
<groupId>org.apache.maven.plugins</groupId>
<artifactId>maven-compiler-plugin</artifactId>
<configuration>
<source>8</source>
<target>8</target>
</configuration>
</plugin>
<plugin>
<groupId>org.apache.maven.plugins</groupId>
<artifactId>maven-surefire-plugin</artifactId>
<version>2.19.1</version>
<configuration>
<!--<suiteXmlFiles>-->
<!--<suiteXmlFile>./src/test/testng.xml</suiteXmlFile>-->
<!--</suiteXmlFiles>-->
<threadCount>1</threadCount>
<forkCount>1</forkCount>
<reuseForks>true</reuseForks>
<forkMode>once</forkMode>
<argLine>-Dfile.encoding=UTF-8</argLine>
<groups>${groupsTest}</groups>
<includes>
<include>**/*Test.java</include>
</includes>
</configuration>
</plugin>
</plugins>
</build>
测试思路:
以下示例中参数都来自于chrome开发者工具中捕获的信息, 因为被测接口是post方法,且在接口中声明了提交方式:
Content-Type:application/x-www-form-urlencoded; charset=UTF-8
所以在接口测试过程中, form data里的信息都要作为参数添加.
完成以上内容就可以开始创建一个测试的java类, 在你的项目的/test/java下面创建 NewApiTest.java
代码语言:javascript复制
import org.apache.http.HttpEntity;
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.HttpPost;
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;
import org.testng.Assert;
import java.io.IOException;
import java.util.ArrayList;
import java.util.List;
/*
* @auth:louiezhou
* @return: 测试数据
* @parame:
*
*/
public class NewApiTest {
CloseableHttpResponse response=null;
String entityStr = null;
//登录url
String url ="https://passport.jd.com/uc/loginService?uuid=a25f6873-4dd9-4334-ad4c-e6f83f&ReturnUrl=https://www.jd.com/&r=0.8097302259069017&version=2015";
@Test(invocationCount = 1, threadPoolSize = 0)
public void JdLoginTest() throws IOException {
// 获取连接客户端工具
CloseableHttpClient httpClient=HttpClients.createDefault();
// 创建POST请求对象
HttpPost httpPost=new HttpPost(url);
// httpPost.addHeader post请求 header
httpPost.addHeader("Content-Type","application/x-www-form-urlencoded; charset=UTF-8");
httpPost.addHeader("User-Agent:","Mozilla/5.0 (Macintosh; Intel Mac OS X 10_14_0) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/80.0.3987.122 Safari/537.36");
// List<Header> headerList= Lists.newArrayList();
// headerList.add(new BasicHeader(HttpHeaders.CONTENT_TYPE,"application/x-www-form-urlencoded; charset=UTF-8"));
// headerList.add(new BasicHeader(HttpHeaders.USER_AGENT,"Mozilla/5.0 (Macintosh; Intel Mac OS X 10_14_0) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/80.0.3987.122 Safari/537.36"));
//参数封装对象
List<NameValuePair> params=new ArrayList<NameValuePair>();
try{
params.add(new BasicNameValuePair("uuid","a25f6873-4dd9-4334-e6f8992b8"));
params.add(new BasicNameValuePair("eid","BHM2GM3F6FVMTA3YNGT46VQ5QKW3WL6FUWFK7MSHDPF3SU4FHFSOLMBUP77TDQE5EB43BZPDT5J6PAQ6CFI"));
params.add(new BasicNameValuePair("fp","f0aef80fec848c014fc4bd234"));
params.add(new BasicNameValuePair("loginType","c"));
params.add(new BasicNameValuePair("loginname","zhangsan"));
params.add(new BasicNameValuePair("nloginpwd","Y2nHBYQ/YvBZMVxQMbWxt TTs cW8rrvbW1CYlmX61xfoLx7tgSpbgxZ8 /HCgefeAXphJVmefDdN/3d3UQLnFiyl7GSkGjZQNU4pw 9 202NovcR6q9G/haGpNKp/5h Xs J7BrUfKXvkmdmKS0fIs7ly0K OY/BHKcYg="));
params.add(new BasicNameValuePair("authcode","107fdb562e3240356c3ff97310e7"));
params.add(new BasicNameValuePair("pubKey","MIGfMA0GCSqGSIb3QUAA4GNADCBiQKBgQDC7kw8r6tq43pwApYvkJ5laljaN9BZb21TAIfT/vexbobzH7Q8SUdP5uDPXEBKzOjx2L28y7Xs1d9v3tdPfKI2LR7PAzWBmDMn8riHrDDNpUpJnlAGUqJG9ooPn8j7YNpcxCa1iybOlc2kEhmJn5uwoanQq CA6agNkqly2H4j6wIDAQAB"));
params.add(new BasicNameValuePair("sa_token", "B68C442BE6457547E701208059007998C0A52BF7A8EAD6AD256C8D009D929F000C9DF4192A57234E3EA6F615E156C81EFA53D580517BB9357FB9516A01E25761124AE9AF7B3CFA3C38D38484A734CB58C286401C2DEC2A5DFF3C9E856280AF80D4851C9B0239587771E8DC06B46454644D4908F4DC165CB70D86EAC7276BFBE489FFE2324EDDC5F71043BFB99B3D6E238B1AE9E67C3F297E0993B8497B1287640777CF4FFBA52FF032510AD19D7F371541C798742CB4378E5DD2119BADE9078310468AF8436A2B88593A92EEAF16FCFD55CD7F121B58D7A9A833D74068FACC5A6D6D8C3D1A850245F0742DEEC12BACF0FF9D5853FFDF1B37AC6A5E676DC635896AFD884D0BBB8A490E57234DF65A76AF189908F4AB80AEA36E56F6DD110EF7D36D119BB77F0B65774780348FFE859A68D2E0B3A3CDDAFD1BEFCD401530D536C8EF68B618969FC2FFD658FE0BA7BC2E7250F9CCDBB8F9AF360FC293F294A7279EA70043E860784C2E2CF11181C44561794A32AADDB2AC37B1294C08E7B63C85E6561F138195ECCF28EA0F08FB5A16DB7A20814DD914FC0C8A12BF29FFC4F73DD39361EBA1A849BB25B9F5957589347E205573754EA468D809CCCA698BFAB16373516DC8F5FEE8A24C2306850D601D6827C161F1A83057E0F93A97A0C034E"));
params.add(new BasicNameValuePair("seqSid","312437999206350"));
params.add(new BasicNameValuePair("useSlideAuthCode","1"));
params.add(new BasicNameValuePair("_t","_t"));
// 使用URL实体转换工具
UrlEncodedFormEntity entityParam = new UrlEncodedFormEntity(params, "UTF-8");
httpPost.setEntity(entityParam);
// 执行请求
response=httpClient.execute(httpPost);
// 获得响应的实体对象
HttpEntity entity=response.getEntity();
// 使用Apache提供的工具类进行转换成字符串
int code =response.getStatusLine().getStatusCode();
System.out.println("StatusCode: " code);
//断言
Assert.assertEquals(200,code);
entityStr=EntityUtils.toString(entity,"UTF-8");
System.out.println("接口返回结果是:=" entityStr);
}catch(Exception e){
e.printStackTrace();
}finally {
//释放资源
if(httpClient!=null) {
httpClient.close();
}
if (response!=null){
response.close();
}
}
}
}
声明:
1.示例使用testng, 因此必须在方法上添加@Test符号,便于被识别到是测试代码块
2.使用了java的httpclient, 它是一个客户端的http通讯实现库.
HttpClient的目标是发送和接收HTTP 报文,不缓存内容, 重新格式化请求/重定向URI,或者其它和 HTTP 运输无关的功能。
3.使用了List 的实现类ArrayList来封装对象, ArrayList的优点是查询速度比较快.
右键java文件, 选择run 即可执行, 让我们来看下执行结果:
思考:
这样一个接口测试就实现了, 但作为一名严格要求自我的资深测试工程师来说, 这样的设计合理吗?
是否满足数据和测试业务分离, 断言是否充足, 代码是否可以重用, 怎么去管理N多个测试用例, 怎么降低代码耦合度, 怎么进行多线程测试, 测试报告如何展示,如何自动构建, 诸多问题等待解决.
请持续关注我, 和你分享更多精彩内容.
Story:
人要有一个奋斗目标,这样活起来才有精神,有奔头。整天无所事事、无聊至极的,就是因为没有目标。从小就要为自己的人生制定一个目标,然后不断地向它靠近,终有一天你会达到这个目标。如果从小就糊里糊涂,对自己的人生不负责任,没有目标没有方向,那这一生也难有作为。每个人出门,都会有自己的目的地,如果不知道自己要去哪里,漫无目的地闲逛,那速度就会很慢;但当你清楚你自己要去的地方,你的步履就会情不自禁地加快。如果你分辨不清自己所在的方位,你会茫然若失;一旦你弄清了自己要去的方向,你会精神抖擞。这就是目标的力量。所以说,一个人有了目标,才会成功。