TestNG基本注解（一）

TestNG基本注解

 

注解	描述
@BeforeSuite	注解的方法将只运行一次，运行所有测试前此套件中。
@AfterSuite	注解的方法将只运行一次此套件中的所有测试都运行之后。
@BeforeClass	注解的方法将只运行一次先行先试在当前类中的方法调用。
@AfterClass	注解的方法将只运行一次后已经运行在当前类中的所有测试方法。
@BeforeTest	注解的方法将被运行之前的任何测试方法属于内部类的 <test>标签的运行。
@AfterTest	注解的方法将被运行后，所有的测试方法，属于内部类的<test>标签的运行。
@BeforeGroups	组的列表，这种配置方法将之前运行。此方法是保证在运行属于任何这些组第一个测试方法，该方法被调用。
@AfterGroups	组的名单，这种配置方法后，将运行。此方法是保证运行后不久，最后的测试方法，该方法属于任何这些组被调用。
@BeforeMethod	注解的方法将每个测试方法之前运行。
@AfterMethod	被注释的方法将被运行后，每个测试方法。
@DataProvider	标志着一个方法，提供数据的一个测试方法。注解的方法必须返回一个Object[] []，其中每个对象[]的测试方法的参数列表中可以分配。 该@Test 方法，希望从这个DataProvider的接收数据，需要使用一个dataProvider名称等于这个注解的名字。
@Factory	作为一个工厂，返回TestNG的测试类的对象将被用于标记的方法。该方法必须返回Object[]。
@Listeners	定义一个测试类的监听器。
@Parameters	介绍如何将参数传递给@Test方法。
@Test	标记一个类或方法作为测试的一部分。

 1、作用域的不一样划分出了各种不同的标签：

一个套件（suite）包含多个测试(test)

一个测试（test）包含多个类（class）

一个测试（test）包含多个组（group）

一个类（class）包含多个方法（method）

2、定义组

在上述基本标签后均可以定义他们所属的组，定义如下：

 @BeforeGroups(groups="test01")
 public void group(){
  System.out.println("I am a group!");
 }

group方法属于test01这个组，只有当执行test01这个组时group方法才能执行。

每个防范可以属于多个组，定义如下：

 @BeforeClass(groups={"test01","test02"})
 public void classs(){
  System.out.println("tAutoTest01-BeforeClass");
 }

当执行test01和test02时该方法都会执行。

3、参数化

（1）、xml参数传递

代码定义：

 @Test
 @Parameters("myName")//可同时传递多个参数如：@Parameters({"myName","myName01"})

 public void test01(String myName) {
  System.out.println(myName);
 }

xml定义：

<suite name="Suite" parallel="none">
 <parameter name="myName" value="YinTing"></parameter>
 <test name="Test">
 <classes>
 <class name="com.sword.test.tAutoTest01"></class>
 </classes>
 </test>
 <test name="Test01">
 <classes>
 <class name="com.sword.test.tAutoTest"></class> <!-- 该值覆盖了前面定义的YinTing-->
 </classes>
 </test>
</suite> <!-- Suite -->

（2）、代码动态传递（数据提供者）

代码定义：

@DataProvider(name="TestData")//定义数据的提供者
 public Object[][] data() {
  
  return new Object[][]{{"YinTing",26},{"YangYi",24}};
 }
 @Test(dataProvider="TestData")//指定数据提供者

 public void test01(String name,Integer age){
  System.out.println("姓名："+name+"    "+"年龄："+age);
 }

4、工厂

策略：一般我们会在标有@Factory注解的方法中对测试类进行调用，这时TestNg会自动调用测试类中带有@Test注解的方法

工厂类代码定义：

package com.sword.test;

import org.testng.annotations.Factory;

public class tAutoFactory {
 @Factory
 public Object[] test01(){
  Object test01[]=new Object[10];
  for(int i=00;i<10;i++){
   test01[i]=new tAutoTest01(i);
  }
  return test01;
 }
}

Test类代码定义：

package com.sword.test;
import org.testng.annotations.DataProvider;
import org.testng.annotations.Test;

public class tAutoTest01 {
 public int i=0;
 public tAutoTest01(int i){
  this.i=i;
 }
 @DataProvider(name="TestData")
 public Object[][] data() {
  
  return new Object[][]{{"YinTing",26},{"YangYi",24}};
 }
 @Test(dataProvider="TestData")
 public void test01(String name,Integer age){
  System.out.println("姓名："+name+"    "+"年龄："+age);
  System.out.println("-------------------"+this.i+"--------------------");
  try {
   Thread.sleep(1000);
  } catch (InterruptedException e) {
   // TODO Auto-generated catch block
   e.printStackTrace();
  }
 }
}

XML定义：

<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE suite SYSTEM "http://testng.org/testng-1.0.dtd">
<suite name="Suite" parallel="none">
 <parameter name="myName" value="YinTing"></parameter>
 <test name="Test">
 <classes>
 <class name="com.sword.test.tAutoFactory"></class>
 </classes>
 </test>
</suite> <!-- Suite -->

执行结果：

姓名：YinTing    年龄：26
-------------------7--------------------
姓名：YangYi    年龄：24
-------------------7--------------------
姓名：YinTing    年龄：26
-------------------5--------------------
姓名：YangYi    年龄：24
-------------------5--------------------
姓名：YinTing    年龄：26
-------------------2--------------------
姓名：YangYi    年龄：24
-------------------2--------------------
姓名：YinTing    年龄：26
-------------------4--------------------
姓名：YangYi    年龄：24
-------------------4--------------------
姓名：YinTing    年龄：26
-------------------3--------------------
姓名：YangYi    年龄：24
-------------------3--------------------
姓名：YinTing    年龄：26
-------------------6--------------------
姓名：YangYi    年龄：24
-------------------6--------------------
姓名：YinTing    年龄：26
-------------------8--------------------
姓名：YangYi    年龄：24
-------------------8--------------------
姓名：YinTing    年龄：26
-------------------1--------------------
姓名：YangYi    年龄：24
-------------------1--------------------
姓名：YinTing    年龄：26
-------------------0--------------------
姓名：YangYi    年龄：24
-------------------0--------------------
姓名：YinTing    年龄：26
-------------------9--------------------
姓名：YangYi    年龄：24
-------------------9--------------------

===============================================
Suite
Total tests run: 20, Failures: 0, Skips: 0
===============================================

5、监听器

 该地址讲解的相当详细：http://www.ibm.com/developerworks/cn/opensource/os-cn-testinglistener/index.html

6、顺序执行测试&依赖测试&忽略测试

（1）、顺序执行测试

xml定义：

<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE suite SYSTEM "http://testng.org/testng-1.0.dtd">
<suite name="Suite" parallel="none">
 <parameter name="myName" value="YinTing"></parameter>
 <test name="Test"  preserve-order="true"><!-- 顺序执行测试中的测试方法 -->
 <classes>
 <class name="com.sword.test.tAutoFactory"></class>
 </classes>
 </test>
</suite> <!-- Suite -->

（2）、依赖测试

代码定义：

package com.sword.test;

import org.testng.annotations.Test;

public class tAutoTest {
 @Test
 public void test02(){
  System.out.println("I am test02!");
  throw new RuntimeException();
 }
 @Test(dependsOnMethods="test02")//test01依赖test02的成功执行，才能执行。当test02抛出异常不能正常执行后，test01已不能执行。
 public void test01(){
  System.out.println("YinTing");
 }
}

执行报告：

I am test02!
FAILED: test02
java.lang.RuntimeException
 at com.sword.test.tAutoTest.test02(tAutoTest.java:10)
 at sun.reflect.NativeMethodAccessorImpl.invoke0(Native Method)
 at sun.reflect.NativeMethodAccessorImpl.invoke(NativeMethodAccessorImpl.java:39)
 at sun.reflect.DelegatingMethodAccessorImpl.invoke(DelegatingMethodAccessorImpl.java:25)
 at java.lang.reflect.Method.invoke(Method.java:597)
 at org.testng.internal.MethodInvocationHelper.invokeMethod(MethodInvocationHelper.java:84)
 at org.testng.internal.Invoker.invokeMethod(Invoker.java:714)
 at org.testng.internal.Invoker.invokeTestMethod(Invoker.java:901)
 at org.testng.internal.Invoker.invokeTestMethods(Invoker.java:1231)
 at org.testng.internal.TestMethodWorker.invokeTestMethods(TestMethodWorker.java:127)
 at org.testng.internal.TestMethodWorker.run(TestMethodWorker.java:111)
 at org.testng.TestRunner.privateRun(TestRunner.java:767)
 at org.testng.TestRunner.run(TestRunner.java:617)
 at org.testng.SuiteRunner.runTest(SuiteRunner.java:335)
 at org.testng.SuiteRunner.runSequentially(SuiteRunner.java:330)
 at org.testng.SuiteRunner.privateRun(SuiteRunner.java:291)
 at org.testng.SuiteRunner.run(SuiteRunner.java:240)
 at org.testng.SuiteRunnerWorker.runSuite(SuiteRunnerWorker.java:52)
 at org.testng.SuiteRunnerWorker.run(SuiteRunnerWorker.java:86)
 at org.testng.TestNG.runSuitesSequentially(TestNG.java:1224)
 at org.testng.TestNG.runSuitesLocally(TestNG.java:1149)
 at org.testng.TestNG.run(TestNG.java:1057)
 at org.testng.remote.RemoteTestNG.run(RemoteTestNG.java:111)
 at org.testng.remote.RemoteTestNG.initAndRun(RemoteTestNG.java:204)
 at org.testng.remote.RemoteTestNG.main(RemoteTestNG.java:175)

SKIPPED: test01

===============================================
    Default test
    Tests run: 2, Failures: 1, Skips: 1
===============================================

（3）、忽略测试

代码定义：

package com.sword.test;

import org.testng.annotations.Test;

public class tAutoTest {
 @Test(enabled=false)//该方法不会被执行。
 public void test02(){
  System.out.println("I am test02!");
 }
 @Test
 public void test01(){
  System.out.println("YinTing");
 }
}

执行报告：

YinTing
PASSED: test01

===============================================
    Default test
    Tests run: 1, Failures: 0, Skips: 0