# demo-client

**Repository Path**: fastjrun/demo-client

## Basic Information

- **Project Name**: demo-client
- **Description**: 一个基于testng的接口测试用例集合实例
- **Primary Language**: Java
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2017-08-30
- **Last Updated**: 2022-05-25

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

## demo-client项目说明

demo-client是一个普通的maven项目(https://gitee.com/fastjrun/demo-client)，主要是用来配合讲解如何编写和维护接口测试用例，其中demo_user.xml是接口定义文档，pom中提到的测试接口地址为：[http://demo.fastjrun.cn/demo-buffle](http://demo.fastjrun.cn/demo-buffle)。 具体接口定义可以参考如下网址：[http://demo.fastjrun.cn/demo-buffle/swagger-ui.html](http://demo.fastjrun.cn/demo-buffle/swagger-ui.html)

### 准备windows开发环境
- 参考[开发工具及安装规划](https://my.oschina.net/fastjrun/blog/643626)

## 普通玩法
### 下载ciHelper1.7版本，install本地
```
#以下操作需要在git bash中执行
cd d:/workshop
git clone https://gitee.com/fastjrun/ciHelper.git
cd ciHelper
git checkout v1.7
mvn clean install
```

### 下载demo-client
```
#以下操作需要在git bash中执行
cd d:/workshop
git clone https://gitee.com/fastjrun/demo-client.git
cd demo-client
git checkout v1.1
mvn clean package
```
成功的话，会看到测试用例被执行，输出界面类似如下  
![输入图片说明](https://static.oschina.net/uploads/img/201710/25211147_aBWS.png "在这里输入图片标题")

 **备注：** 如果没有配置私服，且第一次用maven，可能会比较慢，而且会容易被中断，多试几次，直到你看到以上步骤全部OK；如果你使用阿里云的私服地址（[http://maven.aliyun.com/nexus/content/groups/public](http://maven.aliyun.com/nexus/content/groups/public)）做mirror也可以加快这个进度。


## 进阶玩法
### 下载ciAgent版本，install到本地
```
#以下操作需要在git bash中执行
cd d:/workshop
git clone https://gitee.com/fastjrun/ciagent.git
cd ciagent
git checkout v1.2
#先install本地cidev-sdk和xercesImpl
cd lib
mvn install:install-file -Dfile=cidev-sdk-1.3-SNAPSHOT.jar -DgroupId=com.fastjrun -DartifactId=cidev-sdk -Dversion=1.3-SNAPSHOT -Dpackaging=jar
mvn install:install-file -Dfile=xercesImpl-2.9.1.jar -DgroupId=xerces -DartifactId=xercesImpl -Dversion=2.9.1 -Dpackaging=jar
cd ..
mvn clean install
```
ciAgent是一个maven插件，作为代理和快嘉网发生交互，具体如何发生作用可以看ciAgent代码。ciAgent如何用可以参考pom-fastjrun.xml配置。

### 代码自动生成
demo_user.xml是一个维护了接口定义、输入参数定义、返回参数定义的文档，我们可以通过修改该文件达到修改接口代码和接口测试代码重新生成的目的。

示例中，我们从demo_user.xml中删除自动登录接口如下，看看代码自动生成的效果  
1、删除自动登录接口    
![删除选中部分文字](https://static.oschina.net/uploads/img/201710/25212759_kki7.png "在这里输入图片标题")  
2、重新生成代码
```
cd d:/workshop/demo_client
mvn clean package -Dcommongc.skip=false -f pom-fastjrun.xml
```
成功的话，会看到测试用例被执行，输出界面类似如下  
![输入图片说明](https://static.oschina.net/uploads/img/201710/25213308_4aAd.png "在这里输入图片标题")  
比较上一次的执行结果，可以看到测试用例少执行了一条。

理论上，你可以通过维护demo_user.xml生成相当部分返回数据为json格式的restful协议类型接口，并在生成代码后，重新配置src\main\resources\testdata\local.properties中的接口请求参数，执行mvn clean package即可。