Java接口自动化测试项目构建规范

java接口自动化测试项目构建规范

概要：

本文档旨在指导说明如何基于eclipse+maven构建Java接口自动化测试项目，并遵循相关规范说明，各Java接口自动化测试项目需按此规范执行

基本要求

1）JDK：JDK1.8

svn:////软件共享/SOFT/jdk-8u25-windows-x64.exe

2)git客户端

svn:////软件共享/SOFT/Git-2.5.3-64-bit.exe

3)Eclipse：相关插件testNG、maven等已安装配置好

svn:////软件共享/SOFT/eclipse-jee-mars-R-win32-x86_64.zip

4)构建Java项目编码要求：统一使用UTF-8编码

5)所有项目源码使用teamcode管理

Teamcode操作及最佳实践

git clone ssh://{yourUserName}@:29418/fangdd/engineering/teamcode && scp -p -P 29418 {yourUserName}@:hooks/commit-msg teamcode/.git/hooks/

clone后可参考specs目录下teamcode-workflow.md与teamcode-best-practice.md说明Maven基本配置

maven环境配置.ppt

testNG测试框架介绍及使用

T e s t N G介绍.p

构建步骤说明

1）新建Java maven项目，如下图所示，点击新建

2、弹窗中选择新建Java maven项目，如下图所示，下一步

3、修改workspace路径为Eclipse workspace路径，如下如所示，下一步

4、选择类别，如下图所示，下一步

5、输入相关信息，完成

groupId 统一为com.fangdd.qa

artifactId为java项目名，自定义，如agent-service-test

version默认

package统一为com.fangdd

6、Java项目建好后修改项目编码

选中项目右键，选择如下箭头所指

修改项目编码为UTF-8

7、选中项目右键，新建package，选择如下箭头所指

8、输入如下图所示，完成

9、更改项目buildpath，选中项目右键，选择如下图所示

10、弹框中切换至source

11、点击Add Folder，弹框中勾选resources，如下图所示，OK

项目建好后基本结构如下，将默认的App.java 与AppTest.java删除后续相关配置文件均存放至resources目录下

12、从代码库clone出agent-service-test项目(确保本机已安装及配置

好git相关配置)(作为后续新建项目demo参考)

git clone ssh://{yourUserName}@:29418/fangdd/testcode/agent-service-test && scp -p -P 29418 {yourUserName}@:hooks/commit-msg agent-service-test/.git/hooks/

13、配置新建项目

1）重命名新建项目pom.xml文件为pom-back.xml，重命名操作如下图所示

2)复制agent-service-test中pom.xml及.gitignore文件至新建项目根目录

保持一致，如下红框所示内容

4)修改后变为如下图所示

5)覆盖完成后即可删除pom-back.xml文件

6)拷贝agent-service-test下src/main/resources目录下资源文件至新建项目src/main/resources 目录(可根据自身项目需要增加、修改或删除配置)，如下图红框所示

Server.properties：主要配置工具类的基础配置，也可将自身项目测试的相关配置也配置在该文件中，如被测系统ip、port等配置信息

Db.properties：主要配置数据库连接信息，测试项目有需要操作数据库的，可将相关配置信息配置在此文件中

log4j.properties：主要配置日志相关配置信息，基本不用修

7)同时需要将相关properties配置文件编码做修改，选中某配置文件，右键菜单选择如下图所示

8)弹窗中修改编码为UTF-8，点击OK即可（OK后如有提示弹窗，选择yes）

14、在src/main/java目录及src/test/java新建相关package，我们目前测试代码的结构主要包括两部分，处理逻辑的action与action对应的testcase(可根据项目情况自定义)，故此，需要新建两个package，testcase的package需建在src/test/java下

Package命名规范:

Action package(被测试类package)：

com.fangdd.项目名.action

Testcase package(测试类package，与被测试类package保持一致)：

com.fangdd.项目名.action

以agent项目为例：

Action package(被测试类package)：

com.fangdd. agent.action

Testcase package(测试类package，与被测试类package保持一致)：

com.fangdd. agent.action

如需其他package，根据自身项目需要自定义

15、最终项目完成后目录结构如下：