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就可以