在做自动化测试中,参数化非常常见。例如你希望你的自动化脚本能在不同的环境中执行。 当然参数化的方式非常多,例如可以把环境变量存放在文本中,excel文件中或者配置文件中等等,然后去写段代码去读取,往往需要编写一定的代码量,那有没有几乎没代码从而又可以实现参数化的方式呢?
这里简单介绍如何通过Testng + Jenkins 做参数化。
我们想通过Testng 做参数化除了可使用@DataProvider注解(详细例子参考:http://www.jianshu.com/p/895e4c118db9)这里不多说明,还可以用Testng提供的另一个注解@Parameters ,我们这里讲讲入如何通过这个注解测试方法传递任意个数的参数。
使用前稍作说明,DataProvider和Parameters使用场景的区别。DataProvider适合做比较复杂的参数化,测试值较多的情况,也就是我们常用来做数据驱动。而Parameters则适合参数值较为简单的场景,例如刚提到的代码需要在不同的测试环境执行,这个环境就是需要从代码抽取出来的参数。
@Parameters的用法,我们直接看个例子:
首先我们新建个测试,代码如下:
@Parameters({"env", "name", "pwd"})
@Test
public void parameterTest(String env, String userName, String pwd) {
System.out.println("测试环境:" + env + "_登录名: " + userName + "_密码: " + pwd);
}
上面测试方法parameterTest()中有3个参数(env,userName,pwd),而这三个参数值我们通过@Parameters注解来获取,需要注意的是这里的测试方法的参数跟@Parameters设置的获取参数的参数名可以不一致,但参数个数需要一致,否则会报错。这样我们已经写好了获取数据源,这时我们就得编写数据源。
我们都知道Testng的测试方法可以通过xml文件来运行,那么这时可以新建个xml文件,并在该xml文件设置数据源,xml如下:
<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE suite SYSTEM "http://testng.org/testng-1.0.dtd">
<suite name="Custom suite">
<!-- name 必须Parameters注解接收名一致,value就是为参数的值-->
<parameter name="env" value="qa"/>
<parameter name="name" value="meyoung"/>
<parameter name="pwd" value="123456"/>
<test verbose="1" name="Selenium_Demo" annotations="JDK">
<classes>
<!-- 设置需要执行的class路径名-->
<class name="com.meyoung.demo.ParametersTest"/>
</classes>
</test>
</suite>
上面的xml中跟以往执行的xml相比,我们只是在上面加入parameter 标签,并设置对应的name和value值。需要注意的是name的值必须跟测试方法中@Parameters设置的接收参数的参数名一致,但参数个数可以xml中parameter标签的个数>=@Parameters接收的参数个数。value则是要传入的数据。
最后我们执行运行这个xml,看下执行结果:
按期望值输出,准确无误。
@Parameters 注解除了跟@Test一起用外,还可以跟BeforeXXX和AfterXXX注解一起用,但是不能跟@DataProvider一起使用。
到这里我们其实已经讲完了通过Testng做参数化,但肯定有疑问呀,这跟代码里面写死的有啥区别,如果需要换个环境换个用户不还得去修改xml文件。
咦。。。
这时我们想起了构建脚本我们都用Jenkins,而且Jenkins构建时可以参数化构建,那我们是不是可以把这些参数的值通过Jenkins构件时传入呢? 答案肯定的。怎么做?
我们新建个Jenkins job,勾选参数化构建过程,并添加4个构建参数如下,除了测试方法用到的参数外,我们还添加了RunTest参数,来指定我们需要执行的xml文件:
接着我们添加构建方式,推荐用maven工程,然后我们直接用maven命令执行,这里我直接指向本地的pom文件:
再接着我们需要修改下我们的工程代码
1). 修改pom.xml文件加入执行和编译插件,并添加${RunTest}用于获取Jenkins的构建参数。
<build>
<plugins>
<plugin>
<!-- 编译插件-->
<groupId>org.apache.maven.plugins</groupId>
<artifactId>maven-compiler-plugin</artifactId>
<version>3.3</version>
<inherited>true</inherited>
<configuration>
<source>1.8</source>
<target>1.8</target>
<encoding>UTF-8</encoding>
</configuration>
</plugin>
<!-- Testng 执行插件-->
<plugin>
<groupId>org.apache.maven.plugins</groupId>
<artifactId>maven-surefire-plugin</artifactId>
<version>2.17</version>
<configuration>
<suiteXmlFiles>
<!-- 通过 ${RunTest} 来获取Jenkins的构建参数-->
<suiteXmlFile>${RunTest}</suiteXmlFile>
</suiteXmlFiles>
</configuration>
</plugin>
</plugins>
</build>
2).修改刚创建的Testng 执行xml,把原来的value的值改成获取Jenkins构建参数的方式,修改后的xml如下:
<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE suite SYSTEM "http://testng.org/testng-1.0.dtd">
<suite name="Custom suite">
<!-- name 必须Parameters注解接收名一致,${XXX}获取Jenkins的构建参数名-->
<parameter name="env" value="${env}"/>
<parameter name="name" value="${UserName}"/>
<parameter name="pwd" value="${password}"/>
<test verbose="1" name="Selenium_Demo" annotations="JDK">
<classes>
<!-- 设置需要执行的class路径名-->
<class name="com.meyoung.demo.ParametersTest"/>
</classes>
</test>
</suite>
注意:通过${}获取Jenkins构建参数的值,{}中的值必须跟Jenkins设置的构建参数名一致
最后保存配置,我们试着构建下Job看看结果,例如我构建如下:
那么从控制台输出可以看到输出数据达到预期,则构建成功:
这样以后我们构件时就可以通过Jenkins上填写不同的参数,以达到构建参数化的效果。