1. TestNG API
本章节将讨论如何使用TestNG API来创建自己的TestNG对象。TestNG的API基本由接口组成，这样做是为了容易模拟TestNG返回的对象。
1.1 org.testng.TestNG、ITestResult、ITestListener、ITestNGMethod
TestNG类是TestNG的的主入口，它让我们指定测试类，指定包含的分组或排除的分组，指定要执行的XML文件等。
public static void mian(String[] args){ TestNG tng = new TestNG(); tng.setTestClasses(new Class[]{ MyTest.class}); TestListenerAdapter listener = new TestListenerAdapter(); tng.addListener(listener); tng.run(); log("PASSED:" + listener.getPassedTests().size()); }
这里TestListenerAdapter类提供了ITestListener接口的一个简单实现。这里使用TestListenerAdapter的另一项功能：记录所有通过的测试案例数量。
通过TestListenerAdapter可以方便的获取结果的程序清单，如果需要为这个类添加功能，又保留测试结果程序清单，则可以调用被覆盖方法的super()方法，如下所示：
public class MyTestListener extends TestListenerAdapter{ public void onTestSuccess(ITestResult result){ super.onTestSuccess(result); //do you own processing } }
TestListenerAdapter 保存了测试结果：
public List<ITestResult> getPassedTests() public List<ITestResult> getFailedTests() public List<ITestResult> getSkippedTests()
ITestResult 接口能让我们获取某个测试状态、测试方法、参数，以及开始时间和结束时间：
public void onTestSuccess(ITestResult iTestResult) { long time = (iTestResult.getEndMillis() - iTestResult.getStartMillis()); log("Success, method:" + iTestResult.getMethod() +" #parameters:"+iTestResult.getParameters().length + " time:" + time); }
ITestResult# getResult 返回一个ITestNGMethod，这个是TestNG对测试方法的一个视图。从这个对象我们可以获得TestNG对象当前调用的原始java.lang.reflact.Method, 并获得其他信息，如：
- 分组/方法信息（这个方法所属的分组，它依赖的分组和方法）。
- 调用的次数，线程池的大小以及超时设置。
- 这个方法是否是一个配置方法（@Before/@After）, 它是哪一种配置方法：
ITestNGMethod method = iTestResult.getMethod(); log(" Method:"+method.getMethodName() +" invocationCount:" +method.getInvocationCount() +" #groups:"+method.getGroups().length +" timeOut:"+method.getTimeOut());
1.2 XML API
TestNG提供了一个简单的接口，让我们访问自己的testng.xml, 甚至可以从头创建它。与XML API相关的这些类在org.testng.xml中，每个XML标签都有一个对应的类：
|
标签 |
类名 |
| <suite> | XmlSuite |
| <test> | XmlTest |
| <package> | XmlPackage |
| <class> | XmlClass |
| <method-selector> | XmlMethodSelector |
xml 文件如下：
<suite name="testng" verbose="1" thread-count="2">
<parameter name="first-name" value="cedric" />
<test name="Regression 1">
<group>
<run>
<exclude name="excludeThisGroup"/>
</run>
</group>
<classes>
<class name="test.parameter.test1" />
<class name="test.parameter.test2" />
</classes>
</test>
</suite>
XmlSuite的值：
| 方法 | 返回结果 |
| getName() | testng |
| getVerbose() | true |
| getThreadCount() | 2 |
| getParameters() | Map<String, String>:{“first-name”=>”cedric”} |
| geTests() | List<XmlTest> |
XmlTest的值：
| 方法 | 返回结果 |
| getName() | Regression1 |
| getIncludeGroups() | {} |
| getExcludeGroups() | List<String>:{“excludeThisGroup”} |
| getXmlClasses | List<XmlClasses>:{ “test.parameter.test1”, ”test.parameter.test2” } |
| geTests() | List<XmlTest> |
1.3 生成xml文件
XmlSuite suite = new XmlSuite(); suite.setName("TestNG"); suite.setVerbose(1); suite.setThreadCount(2); Map<String, String> parameters = new HashMap<String, String>(); parameters.put("first-name", "credic"); suite.setParameters(parameters); XmlTest test = new XmlTest(suite); test.setName("regression1"); test.setExcludedGroups(Arrays.asList(new String[]{"excludedGroup"})); XmlClass[] classes = new XmlClass[]{ new XmlClass("test.parameters.test1"), new XmlClass("test.parameters.test1"), }; test.setXmlClasses(Arrays.asList(classes); TestNG tng = new TestNG(); //指定xml路径方式 tng.setTestSuites(Arrays.asList(new String[]{ "testng.xml","test-15/testng.xml"})) //使用当前生成的文件 tng.setXmlSuites(Arrays.asList(new XmlSuite[]{ suite })); tng.run();
2. 方法选择器：
Testng通过方法选择器（IMethodSelector）来决定在执行测试时，包含或排除哪些方法。
TestNG的默认方法选择器：XmlMethodSelector，它会根据testng.xml中的内容来实现决定逻辑，它的优先级为10.
- 如果希望你自己的选择器先调用，则可以把优先级设为0~9.
- 如果先考虑testng.xml， 则把优先级设置为大于10.
- 如果希望自己的方法选择器替换所有默认的方法，将优先级设置为负数。在这种情况下只有带负数优先级的方法选择器会生效。
- 方法选择器直接是OR的关系：即一个方法选择器对某个测试方法返回true，则这个测试方法就会包含在这次执行中，否则，具有下一个优先级的方法选择器会被调用（0排在10前面）。如果没有方法选择器则返回true，这个测试方法不会执行。
3 annotation转换器（annotationTransformer）
用户实现annotation转换器，是为了覆盖TestNG在运行时看到的annotation。
public void InvocationTransform implements IAnnotationTransformer{ public void transform(ITest test, class cls, Constructor con, Method method){ if("two".equals(method.getName()){ test.setInvocationCount(2); }else if("three".equals(method.getName()){ test.setInvocationCount(3); } } }
其他用法：
- timeout：修改测试方法的超时设置；
- enabled：修改 @Test annotation上的enabled标识。
- invocationCount：用于多线程环境或负载测试。
- threadPoolSize：annotation可以查询本地信息（处理器个数，可用堆大小或计算机负载），然后增加或减少线程池的大小。
- successPercentage：和invocationCount一起使用，允许一定的失败比例。
- dataprovider:在运行时修改数据提供者的名称。用于数据提供者本身执行动态判断。
- description:用于HTML报告生成。
- group：可以进行基于环境的变量分组调整。
- dependsOnGroups/dependsOnMethod/alwaysRun:这些属性会直接影响执行顺序，请尽量避免使用annotation转换器来修改他们。
4. 报告api
4.1 默认报告：
默认报告生成在./test-output目录下
4.2 报告api
- 利用org.testng.Reporter类，向默认报告添加定制信息。
- ITestListener 是一个实现了org.testng.ITestListener接口的类，其中的onStart()和onFinish() 分别在testSuite开始和结束时被调用。onTest*开头的方法在测试方法被执行时调用。
- IReporter 实现了org.testng.IReporter接口