摘要：執行順序，包含和兩種形式，剛好對應各階段的初始化和清理另外和可以定義不同的組合，比如指定某個功能模塊，或者以提測版本號將測試類方法分組

suit -> class -> method，包含before和after兩種形式，剛好對應各階段的初始化（setup）和清理（teardown）

另外test 和 groups可以定義不同的組合，比如指定某個功能模塊（package），或者以提測版本號將測試類/方法分組

import org.testng.Assert;
import org.testng.annotations.*;

public class App {
    private void log(String action) {
        final String FORMATTER = "===== %-20s =====";
        System.out.println(String.format(FORMATTER, action));
    }

    @BeforeSuite
    public void beforeSuit() {
        log("before suit");
    }

    @AfterSuite
    public void afterSuit() {
        log("after suit");
    }

    @BeforeClass
    public void beforeClass() {
        log("before class");
    }

    @AfterClass
    public void afterClass() {
        log("after class");
    }

    @BeforeMethod
    public void beforeMethod() {
        log("before method");
    }

    @AfterMethod
    public void afterMethod() {
        log("after method");
    }

    @Test
    public void testAdd() {
        log("test add");
        Assert.assertEquals(4, 1 + 3);
    }
 }
 
---------------------------------------------------
===== before suit          =====
===== before class         =====
===== before method        =====
===== test add             =====
===== after method         =====
===== after class          =====
===== after suit           =====

另外，除了@Test注解可以出現多次外，before/after + suit/test/class/method等也可以出現多次，不過貌似沒多大意義

測試方法是否生效，默認為true；如果不希望執行，可以置為false

@Test(enabled = false)

測試方法的上游依賴，如果依賴的對象執行失敗，則該測試方法不執行（skip）

public class App {
    private void log(String action) {
        final String FORMATTER = "===== %-20s =====";
        System.out.println(String.format(FORMATTER, action));
    }

    @Test(dependsOnMethods = {"upMethod"})
    public void downMethod() {
        log("run down method");
        Assert.assertEquals(2, 1+1);
    }

    @Test
    public void upMethod() {
        log("run up method");
        Assert.assertEquals(3, 5/3);
    }
}

------------------------------------------------
===============================================
Default Suite
Total tests run: 2, Failures: 1, Skips: 1
==============================================

Assert無法實現異常的校驗，但無法避免異常的發生，或者希望人為地拋出異常，因此需要借助此參數

public class App {

    @Test(expectedExceptions = {java.lang.ArithmeticException.class})
    public void testExcption() {
        int a = 5 / 0;
    }
}

方法引用的測試數據，避免同一個方法書寫多次，可以設計為數據驅動

public class App {

    @DataProvider(name = "data")
    public Object[][] data() {
        return new Object[][] {
                {1, 1},
                {2, 4},
                {3, 9},
        };
    }

    @Test(dataProvider = "data")
    public void testSquare(int num, int expected) {
        int result = num * num;
        Assert.assertEquals(result, expected);
    }
}

測試方法的數據提供者，必須返回Object[][]對象

包含2個參數：

name，唯一命名，且測試方法的dataProvider與其一致；如果為空，默認為方法名

parallel，默認為false；在并行執行不影響測試執行時，設置為true可以提高任務的執行效率

測試方法查找指定的dataProvider時，默認是當前類及其父類

如果數據由其他類提供，則需指定dataProviderClass，并且由@DataProvider注解的方法必須為static

public class App {

    @Test(dataProvider = "data", dataProviderClass = DataDriver.class)
    public void testSquare(int num, int expected) throws InterruptedException {
        int result = num * num;
        Assert.assertEquals(result, expected);
    }
}

class DataDriver {
    @DataProvider(name = "data", parallel = true)
    public static Object[][] data() {
        return new Object[][] {
                {1, 1},
                {2, 4},
                {3, 9},
        };
    }
}

多個測試方法可以指定同一個DataProvider

DataProvider支持將Method作為第一個參數，根據不同的方法讀取不同的數據文件，如Excel、Txt

public class App {

    @Test(dataProvider = "dp", dataProviderClass = DataDriver.class)
    public void test_1(String arg) {
        System.out.println("== run test-1");
        Assert.assertTrue(arg != null);
    }

    @Test(dataProvider = "dp", dataProviderClass = DataDriver.class)
    public void test_2(String arg) {
        System.out.println("== run test-2");
        Assert.assertTrue(arg != null);
    }
}

class DataDriver {
    @DataProvider(name = "dp")
    public static Object[][] data(Method method) {
        System.out.println(method.getName());
        return new Object[][]{
                {"java"},
        };
    }
}

----------------------------------------------------
test_1
== run test-1
test_2
== run test-2

加載環境變量

比如在初始化時，根據提供的參數區分開發環境與測試環境

@Parameters(value = {"jdbcUrl"})
@BeforeSuite
public void initSuit(String jdbcUrl) {
    String jdbcurl = jdbcUrl;
}

那么parameter的值在哪設置呢？ ——testng.xml

  
  
  ...

當然與jenkins結合會更妙

Parameters are scoped. In testng.xml, you can declare them either under a  tag or under . If two parameters have the same name, it"s the one defined in  that has precedence. This is convenient if you need to specify a parameter applicable to all your tests and override its value only for certain tests.*
test標簽下的參數優先級高于suit

動態創建測試類

拿官網例子來講：編寫一個方法實現多次訪問同一網頁

// 官網使用了parameter，然后需要在testng.xml中配置多個參數值，實屬麻煩

public class TestWebServer {
  @Test(parameters = { "number-of-times" })
  public void accessPage(int numberOfTimes) {
    while (numberOfTimes-- > 0) {
     // access the web page
    }
  }
}

那么使用@Factory將簡化配置

public class WebTest {
    private int m_numberOfTimes;

    public WebTest(int numberOfTimes) {
        m_numberOfTimes = numberOfTimes;
    }

    @Test
    public void testServer() {
        for (int i = 0; i < m_numberOfTimes; i++) {
            // access the web page
        }
    }
}
-----------------------------------------------------
public class WebTestFactory {
    @Factory
    public Object[] createInstances() {
        Object[] result = new Object[10];
        for (int i = 0; i < 10; i++) {
            result[i] = new WebTest(i * 10);
        }
        return result;
    }
}

通過@Factory動態創建測試類，返回Object[]對象 —— 包含一組測試類實例，框架會自動運行每個實例下的測試方法

不過，雖然簡化了配置，但并不是指不用配置，需要在testng.xml中指定工廠類

但是細想一下，測試方法的參數化可以通過@DataProvider實現

我理解的二者區別如下：

@Factory實現測試類的動態創建，@DataProvider改變測試方法的實參

@Factory實例化的類及屬性對所有測試方法有效

@Factory和@DataProvider可以一起使用，花式組合數據

應用于測試類，忽略該類下所有的測試方法

相當于@Test(enabled=false)，不過是批量的