GAT2.0使用文档（单接口开发）

3   开始写用例

3.1接口用例开发

1)         准备工作

l  第一步从github(https://github.com/GeneralAutomationTesting/GAT2.0)上下载GAT2.0。

在获取的GAT2.0包里你会看到两个文件夹。如下图所示：

l  第二步从GAT2.0Demo包里找到IATStepGroup 并导入的eclipse.并确保导入后的项目没有引用错误。导入后的目录与【代码结构图】中的结构相似

2)         开始单接口用例开发

单一接口的用例的数据以及用例描述文件是存储在Excel文件中的。下面就详细解释一下Excel中各个字段的含义以及注意事项。

字段名称

字段说明

可选值/实例

ID

唯一即可

DomainName

接口URL的域名

http://api.demo.com

Path

域名后参数前的部分

/service/uerlist

ParameterName

url的参数，列名以$开头

ExpectResult

接口的期望结果

AssertType

断言方式

Equal：和期望结果相等

Contains：包含期望结果

Custom：需要自定义场景组件

AssertMethod

断言方式为自定义情况下需要提供场景组件方法

packagename.classname.methodname:场景组件的参数ID

SetupType

Custom

SetupContext

需要Setup情况下需要提供场景组件方法

packagename.classname.methodname:场景组件的参数ID

TearDownType

Custom

TearDownContext

packagename.classname.methodname:场景组件的参数ID

备注：空值必须以：$NULL代替，不能留空

l   第一步：在InterfaceAutomation->DataFiles->Excels目录下创建一个Excel文件。文件名称代表接口所属的模块，请起一个有意义的名字。

l   第二步：打开新创建的Excel文件，并把一个sheet的名字修改为接口的名字，注意一个sheet只能为一个接口写用例。Sheet名字请不要包含特殊字符等。

l   第三步：复制已经存在的excel文件中的各个列名，到新建的sheet中,并开始填写值。

图12

l   请注意一下几点：

n   确保ID唯一，DomainName,Path等字段的值都正确。

n   如果接口没有参数请确保没有以$开头的列。

n   如果不想传某个参数，可以把该参数的值置成$EMP.

n   Excel中的一行代表一个用例

n   如果需要添加描述性的列，列名请以#开头即可

n   黄色背景字段为默认字段，名称必须保持与图片中的一致。

n   绿色背景字段为接口参数，每增加一个参数在绿色字段增加一列即可。列名称为$+参数名称.如果没有参数请不要保留任何参数字段。

n   图片中可为空字段，在为空是请以$NULL代替

n   如果字段值为数字，请将单元格格式设置为字符串

l  第四步：完成以上步骤后，保存Excel文件。然后右击GatCreator.java运行。在运行之前请确保已经关闭了Excel文件，否则有可能出错。运行完成后就会生成相应的单元测试用例，如果在Eclipse中看不到，请刷新IATStepGroup项目。

3)         运行用例

到这步的时候你已经成功的完成了第一个用例，接下来是运行你的用例。

l   ：在package [com.gateside.autotesting.generation.unittest]中找到excel文件名_sheet名称.java文件然后点击右键，run as Testng就可以