Java接口自动化测试实战笔记

2018-11-15 本文已影响42人 AlanHou

Java接口自动化测试实战笔记

综述
代码管理工具Git
测试框架 TestNG
测试报告
Mock 接口框架
HTTP 协议接口
测试框架 HttpClient
SprintBoot 自动化测试开发
数据持久层框架 MyBatis</a
MyBatis+MySQL实现用例管理
TestNG+MyBatis实现数据校验
Jenkins持续集成

综述

需求阶段：项目立项、产品设计、需求文档
研发阶段：UI 设计、前端开发、后端开发、测试设计、测试开发（并行）
测试阶段：环境搭建、多项测试执行、BUG 修复、测试报告
项目上线：线上回归测试、上线报告、添加监控

接口测试范围：

功能测试：等价类划分法、边界值分析法、错误推断法、因果图法、判定表驱动法、正交试验法、功能图法、场景法

异常测试：数据异常(null,"",数据类型)、环境异常(负载均衡架构、冷热备份)

性能测试(狭义)：负载测试、压力测试或强度测试、并发测试、稳定性测试或可靠性测试

手工接口测试的常用工具

Postman
HttpRequest(Firefox 插件)
Fiddler(具备抓包和发送请求功能)
半自动化:Jmeter(结果统计方面不完善)

自动化框架的设计

显示层：测试报告
控制层：逻辑验证
持久层：测试用例存储（数据驱动）

测试代码：https://github.com/alanhou7/AutoTest

代码管理工具Git

安装客户端

yum install -y git # Linux
https://git-scm.com/downloads
brew install git # Mac
git --version
# 配置 SSH key
ssh-keygen -t rsa -C "email address"
cd ~/.ssh
# 复制 id_rsa.pub到 GitHub 中

# 配置多个 SSH key(创建.ssh/config 文件，多账号可以为 id_rsa,id_rsa.pub 重命名并在 config 中进行对应配置)
Host github.com
HostName github.com
User git_username
IdentityFile /Users/alan/.ssh/id_rsa.pub

Git命令

# 克隆项目到本地
git clone git@github.com/xxx.xxx.git
# 查看状态
git status
# 添加内容
git add xxx
git commit -m "comment"
# 推送到 GitHub
git push
# 拉取到本地
git pull
# 查看本地分支
git branch
# 查看远端分支
git branch -a
# 本地创建分支
git checkout -b branch1
# 推送分支
git push --set-upstream origin branch1
# 切换分支
git checkout master
# 删除本地分支
git branch -d branch1
# 删除远程分支
git branch -r -d origin/branch1
git push origin :branch1
# 合并指定分支内容到当前分支
git merge branch1
# 合并冲突通过<<<<<<<HEAD ... >>>>>>> branchname在文件中提示
# 回退到上一个版本，HEAD后添加几个^就是向前回退几个版本
git reset --hard HEAD^
# 或指定向前回退多少个版本
git reset -hard HEAD~10
# 查看历史版本号
git reflog
# 回退到指定版本号
git reset -hard version_no

测试框架 TestNG

TestNG比 Junit 涵盖功能更全面、适合复杂的集成测试，Junit 更适合隔离性比较强的单元测试

完整代码 Git 仓库

# pom.xml
<dependencies>
...
       <dependency>
        <groupId>org.testng</groupId>
        <artifactId>testng</artifactId>
        <version>6.10</version>
    </dependency>
</dependencies>

执行顺序

//最基本的注解，用来把方法标记为测试的一部分
@Test

//BeforeMethod 是在测试方法之前运行的
@BeforeMethod
//AfterMethod 是在测试方法之后运行的
@AfterMethod

//BeforeClass 是在类之前运行的方法
@BeforeClass
//AfterClass 是在类之后运行的方法
@AfterClass

//BeforeSuite测试套件在BeforeClass之前运行
@BeforeSuite
//AfterSuite测试套件在AfterClass之后运行
@AfterSuite

BeforeMethod和AfterMethod 会在类中的每个@Test 装饰的方法之前和之后运行

//忽略测试
@Test(enabled = false)

//分组测试
@Test(groups = "xxx")
//指定名称组运行之前运行的方法
@BeforeGroups("xxx")
//指定名称组运行之后运行的方法
@AfterGroups("xxx")

//类的分组测试(@Test(groups = "xxx")加在类上)，以下配置通过<groups>部分的配置将仅运行组名为 stu 的类
<?xml version="1.0" encoding="UTF-8" ?>

<suite name="suitename">
    <test name="onlyRunStu">
        <groups>
            <run>
                <include name="stu" />
            </run>
        </groups>
        <classes>
            <class name="org.alanhou.testng.groups.GroupsOnClass1"></class>
            <class name="org.alanhou.testng.groups.GroupsOnClass2"></class>
            <class name="org.alanhou.testng.groups.GroupsOnClass3"></class>
        </classes>
    </test>
</suite>

//异常测试
@Test(expectedExceptions = RuntimeException.class)
//依赖测试(所依赖的方法执行成功了都会执行当前方法)
@Test(dependsOnMethods = {"xxx"})

//参数化测试
@Parameters({"name","age"}) //类添加
//xml设置参数
<suite name="parameter">
    <test name="param">
        <classes>
            <parameter name="name" value="Jack" />
            <parameter name="age" value="10" />
            <class name="org.alanhou.testng.parameter.ParameterTest"></class>
        </classes>
    </test>
</suite>
//此外可以通过 DataProvider 进行参数传递

//多线程测试
//获取当前线程 ID
Thread.currentThread().getId() 
//parallel指定线程级别(tests,class,methods),thread-count指定线程数
<suite name="thread" parallel="methods" thread-count="3">

//超时测试
@Test(timeOut = 3000) //单位为毫秒

测试报告

Mock 接口框架

Moco 框架

演示代码 Git 仓库

// http 外还支持 https,socket，8888可修改为其它的端口号
java -jar ./moco-runner-0.12.0-standalone.jar http -p 8888 -c startup1.json

//GET请求可直接在浏览器中访问同，POST 请求可借助于 Postman 或 Jmeter
brew install jmeter
open /usr/local/bin/jmeter //或者直接输入 jmeter
//新建线程组>HTTP请求（POST请求）以及结果树（查看结果）
//GET在 request中使用 queries 传参，POST使用 forms
//也可使用 json 来进行 POST/GET请求
//header,cookies 可用添加头信息和 cookies 信息
//redirectTo 添加重定向信息

Jmeter 请求界面

HTTP 协议接口

Requests Header （请求头）

Header	解释	示例
Accept	指定客户端能够接收的内容类型	Accept: text/plain, text/html
Accept-Charset	浏览器可以接受的字符编码集。	Accept-Charset: iso-8859-5
Accept-Encoding	指定浏览器可以支持的web服务器返回内容压缩编码类型。	Accept-Encoding: compress, gzip
Accept-Language	浏览器可接受的语言	Accept-Language: en,zh
Accept-Ranges	可以请求网页实体的一个或者多个子范围字段	Accept-Ranges: bytes
Authorization	HTTP授权的授权证书	Authorization: Basic QWxhZGRpbjpvcGVuIHNlc2FtZQ==
Cache-Control	指定请求和响应遵循的缓存机制	Cache-Control: no-cache
Connection	表示是否需要持久连接。（HTTP 1.1默认进行持久连接）	Connection: close
Cookie	HTTP请求发送时，会把保存在该请求域名下的所有cookie值一起发送给web服务器。	Cookie: $Version=1; Skin=new;
Content-Length	请求的内容长度	Content-Length: 348
Content-Type	请求的与实体对应的MIME信息	Content-Type: application/x-www-form-urlencoded
Date	请求发送的日期和时间	Date: Tue, 15 Nov 2010 08:12:31 GMT
Expect	请求的特定的服务器行为	Expect: 100-continue
From	发出请求的用户的Email	From: user@email.com
Host	指定请求的服务器的域名和端口号	Host: www.baidu.com
If-Match	只有请求内容与实体相匹配才有效	If-Match: “737060cd8c284d8af7ad3082f209582d”
If-Modified-Since	如果请求的部分在指定时间之后被修改则请求成功，未被修改则返回304代码	If-Modified-Since: Sat, 29 Oct 2010 19:43:31 GMT
If-None-Match	如果内容未改变返回304代码，参数为服务器先前发送的Etag，与服务器回应的Etag比较判断是否改变	If-None-Match: “737060cd8c284d8af7ad3082f209582d”
If-Range	如果实体未改变，服务器发送客户端丢失的部分，否则发送整个实体。参数也为Etag	If-Range: “737060cd8c284d8af7ad3082f209582d”
If-Unmodified-Since	只在实体在指定时间之后未被修改才请求成功	If-Unmodified-Since: Sat, 29 Oct 2010 19:43:31 GMT
Max-Forwards	限制信息通过代理和网关传送的时间	Max-Forwards: 10
Pragma	用来包含实现特定的指令	Pragma: no-cache
Proxy-Authorization	连接到代理的授权证书	Proxy-Authorization: Basic QWxhZGRpbjpvcGVuIHNlc2FtZQ==
Range	只请求实体的一部分，指定范围	Range: bytes=500-999
Referer	先前网页的地址，当前请求网页紧随其后,即来路	Referer: https://www.baidu.com/
TE	客户端愿意接受的传输编码，并通知服务器接受接受尾加头信息	TE: trailers,deflate;q=0.5
Upgrade	向服务器指定某种传输协议以便服务器进行转换（如果支持）	Upgrade: HTTP/2.0, SHTTP/1.3, IRC/6.9, RTA/x11
User-Agent	User-Agent的内容包含发出请求的用户信息	User-Agent: Mozilla/5.0 (Linux; X11)
Via	通知中间网关或代理服务器地址，通信协议	Via: 1.0 fred, 1.1 nowhere.com (Apache/1.1)
Warning	关于消息实体的警告信息	Warn: 199 Miscellaneous warning

Responses Header（响应头）

Header	解释	示例
Accept-Ranges	表明服务器是否支持指定范围请求及哪种类型的分段请求	Accept-Ranges: bytes
Age	从原始服务器到代理缓存形成的估算时间（以秒计，非负）	Age: 12
Allow	对某网络资源的有效的请求行为，不允许则返回405	Allow: GET, HEAD
Cache-Control	告诉所有的缓存机制是否可以缓存及哪种类型	Cache-Control: no-cache
Content-Encoding	web服务器支持的返回内容压缩编码类型。	Content-Encoding: gzip
Content-Language	响应体的语言	Content-Language: en,zh
Content-Length	响应体的长度	Content-Length: 348
Content-Location	请求资源可替代的备用的另一地址	Content-Location: /index.htm
Content-MD5	返回资源的MD5校验值	Content-MD5: Q2hlY2sgSW50ZWdyaXR5IQ==
Content-Range	在整个返回体中本部分的字节位置	Content-Range: bytes 21010-47021/47022
Content-Type	返回内容的MIME类型	Content-Type: text/html; charset=utf-8
Date	原始服务器消息发出的时间	Date: Tue, 15 Nov 2010 08:12:31 GMT
ETag	请求变量的实体标签的当前值	ETag: “737060cd8c284d8af7ad3082f209582d”
Expires	响应过期的日期和时间	Expires: Thu, 01 Dec 2010 16:00:00 GMT
Last-Modified	请求资源的最后修改时间	Last-Modified: Tue, 15 Nov 2010 12:45:26 GMT
Location	用来重定向接收方到非请求URL的位置来完成请求或标识新的资源	Location: https://www.baidu.com/
Pragma	包括实现特定的指令，它可应用到响应链上的任何接收方	Pragma: no-cache
Proxy-Authenticate	它指出认证方案和可应用到代理的该URL上的参数	Proxy-Authenticate: Basic
refresh	应用于重定向或一个新的资源被创造，在5秒之后重定向（由网景提出，被大部分浏览器支持）	Refresh: 5; url=https://www.baidu.com/
Retry-After	如果实体暂时不可取，通知客户端在指定时间之后再次尝试	Retry-After: 120
Server	web服务器软件名称	Server: Apache/1.3.27 (Unix) (Red-Hat/Linux)
Set-Cookie	设置Http Cookie	Set-Cookie: UserID=JohnDoe; Max-Age=3600; Version=1
Trailer	指出头域在分块传输编码的尾部存在	Trailer: Max-Forwards
Transfer-Encoding	文件传输编码	Transfer-Encoding:chunked
Vary	告诉下游代理是使用缓存响应还是从原始服务器请求	Vary: *
Via	告知代理客户端响应是通过哪里发送的	Via: 1.0 fred, 1.1 nowhere.com (Apache/1.1)
Warning	警告实体可能存在的问题	Warning: 199 Miscellaneous warning
WWW-Authenticate	表明客户端请求实体应该使用的授权方案	WWW-Authenticate: Basic

注：HTTP部分内容来自 CSDN

Cookie 与 Session

Cookie 在客户端的头信息中，Session 在服务端存储，文件、数据库都可以
Session 通常需要 Cookie 的一个字段来对应用户与 Session，所以当浏览器禁止 Cookie 时，Session将失效

测试框架 HttpClient

测试时需运行Mock 接口框架部分的startupWithCookies.json进行配合

演示代码 Git 仓库

//pom.xml 中添加 HttpClient依赖
<dependency>
    <groupId>org.apache.httpcomponents</groupId>
    <artifactId>httpclient</artifactId>
    <version>4.1.3</version>
</dependency>
//HttpClient依赖的应用
@Test
public void test1() throws IOException {
    //用来存放结果
    String result;
    HttpGet get = new HttpGet("http://www.baidu.com");
    //用来执行 GET 方法
    HttpClient client = new DefaultHttpClient();
    HttpResponse response = client.execute(get);
    result = EntityUtils.toString(response.getEntity(), "utf-8");
    System.out.println(result);
}

SprintBoot 自动化测试开发

演示代码 Git 仓库

/**
 * 开发一个需要携带参数才能访问的 GET 请求
 * 第一种实现方式：url: key=value&key=value
 * 以下模拟获取商品列表
 */

@RequestMapping(value = "/get/with/param",method = RequestMethod.GET)
@ApiOperation(value = "需要携带参数才能访问的 GET 请求一",httpMethod = "GET")
public Map<String, Integer> getList(@RequestParam Integer start,
                                    @RequestParam Integer end){
    Map<String, Integer> myList = new HashMap<>();
    myList.put("鞋",400);
    myList.put("干脆面",1);
    myList.put("衬衫",300);

    return myList;
}

/**
 * 第二种需要携带参数访问的 GET 请求
 * url: ip:port/get/with/param/10/20
 */

@RequestMapping(value = "/get/with/param/{start}/{end}")
@ApiOperation(value = "需要携带参数才能访问的 GET 请求二",httpMethod = "GET")
public Map myGetList(@PathVariable Integer start,
                     @PathVariable Integer end){
    Map<String, Integer> myList = new HashMap<>();
    myList.put("鞋",400);
    myList.put("干脆面",1);
    myList.put("衬衫",300);

    return myList;
}

插件：Lombok

若运行异常请首先打开Preferences > Build, Execution, Deployment > Compiler > Annotation Processors > Enable annotation processing，同时安装应需要重启 IDEA

Swagger访问地址：http://localhost:8888/swagger-ui.html

在 Jmeter调试中显示 Cookies 信息

# 找到对应Jmeter 的配置文件
# Mac 地址：/usr/local/Cellar/jmeter/5.0/libexec/bin/jmeter.properties
# 修改如下内容
CookieManager.save.cookies=true

Swagger 测试页面

数据持久层框架 MyBatis

演示代码 Git 仓库

注意：yml 配置文件中冒号要加空格，否则会导致配置不生效

// 首先获取一个执行 sql 语句的对象

@Autowired
private SqlSessionTemplate template;

@RequestMapping(value = "/getUserCount",method = RequestMethod.GET)
@ApiOperation(value = "可以获取到的用户数",httpMethod = "GET")
public int getUserCount(){
    // getUserCount对应 mysql.xml 中的配置
   return template.selectOne("getUserCount");
}

@RequestMapping(value = "/addUser",method = RequestMethod.POST)
public int addUser(@RequestBody User user){
    return template.insert("addUser",user);
}

@RequestMapping(value = "/updateUser",method = RequestMethod.POST)
public int updateUser(@RequestBody User user){
    return template.update("updateUser",user);
}

@RequestMapping(value = "/deleteUser",method = RequestMethod.POST)
public int delUser(@RequestParam int id){
    return template.delete("deleteUser",id);
}

MyBatis+MySQL实现用例管理

完整代码 Git 仓库

# testng.xml
<?xml version="1.0" encoding="UTF-8" ?>
<suite name="用户管理系统测试套件">
    <test name="用户管理系统测试用例">
        <classes>
            <class name="org.alanhou.cases.LoginTest">
                <methods>
                    <include name="loginTrue"/>
                    <include name="loginFalse"/>
                </methods>
            </class>
            <class name="org.alanhou.cases.AddUserTest">
                <methods>
                    <include name="addUser"/>
                </methods>
            </class>
            <class name="org.alanhou.cases.GetUserInfoTest">
                <methods>
                    <include name="getUserInfo"/>
                </methods>
            </class>
            <class name="org.alanhou.cases.UpdateUserInfoTest">
                <methods>
                    <include name="updateUserInfo"/>
                    <include name="deleteUser"/>
                </methods>
            </class>
            <class name="org.alanhou.cases.GetUserInfoListTest">
                <methods>
                    <include name="getUserListInfo"/>
                </methods>
            </class>
        </classes>
    </test>
    <listeners>
        <listener class-name="org.alanhou.config.ExtentTestNGIReporterListener"/>
    </listeners>
</suite>

MyBatis+MySQL实现用例管理

TestNG+MyBatis实现数据校验

<plugin>
    <groupId>org.apache.maven.plugins</groupId>
    <artifactId>maven-surefire-plugin</artifactId>
    <version>2.22.1</version>
    <configuration>
        <suiteXmlFiles>
            <suiteXmlFile>
                ./src/main/resources/testng.xml
            </suiteXmlFile>
        </suiteXmlFiles>
    </configuration>
</plugin>

<!--Chapter13-->
<plugin>
    <groupId>org.springframework.boot</groupId>
    <artifactId>spring-boot-maven-plugin</artifactId>
    <configuration>
        <mainClass>org.alanhou.Application</mainClass>
    </configuration>
    <executions>
        <execution>
            <goals>
                <goal>repackage</goal>
            </goals>
        </execution>
    </executions>
</plugin>
<plugin>
    <artifactId>maven-compiler-plugin</artifactId>
    <configuration>
        <source>1.8</source>
        <target>1.8</target>
        <encoding>UTF-8</encoding>
        <compilerArguments>
            <extdirs>${project.basedir}/libcd</extdirs>
        </compilerArguments>
    </configuration>
</plugin>

Jenkins持续集成

# 打包命令
mvn clean package

wget https://mirrors.tuna.tsinghua.edu.cn/jenkins/war/latest/jenkins.war
java -jar jenkins.war --httpPort=8080
# 后台启动
nohup java -jar jenkins.war --httpPort=8080 &

# 配置任务 deploy
# 构建>Execute shell
source /etc/profile
pid=$(ps x | grep "Chapter13-1.0-SNAPSHOT.jar" | grep -v grep | awk '{print $1}')
if [ -n "$pid"]; then
kill -9 $pid
fi

cd Chapter13
mvn clean package
cd target
BUILD_ID=dontKillMe
nohup java -jar Chapter13-1.0-SNAPSHOT.jar &

# 构建后操作>Build other projects

# 配置任务 test
source /etc/profile
cd Chapter12
mvn clean package

result=$(curl -s http://127.0.0.1:8080/job/test/lastBuild/buildNumber --user admin001:123456)
mkdir /home/apache-tomcat-9.0.7/webapps/ROOT/$result
cp /root/.jenkins/workspace/test/Chapter12/test-output/index.html /home/apache-tomcat-9.0.7/webapps/ROOT/$result/index.html

Jenkins 测试

在 Mac 本地安装时，会出现This Jenkins instance appears to be offline.的报错

解决方法：将 ~/.jenkins/hudson.model.UpdateCenter.xml文件中的 https 修改为 http 再重新执行上述安装命令

安装插件

Rebuilder, Safe Restart

扩展知识：

IDEA 快捷键

Option+j 快速导入包

Cmd+j 快速输入，如 sout=System.out.println(); main导入

Option+Enter 代码提示自动补全

Cmd+Option+O 移除未使用的包引用

删除/移除了模块后可通过 Cmd+;快捷键进入 Project Structure点击+号来 Import Module

原文链接：Alan Hou 的个人博客

Java接口自动化测试实战笔记

综述

代码管理工具Git

测试框架 TestNG

测试报告

Mock 接口框架

HTTP 协议接口

测试框架 HttpClient

SprintBoot 自动化测试开发

数据持久层框架 MyBatis

MyBatis+MySQL实现用例管理

TestNG+MyBatis实现数据校验

Jenkins持续集成

猜你喜欢

热点阅读