单元测试系列[v1.0.0][TestNG注解]

古城微笑少年丶 2022-11-28 10:54 136阅读 0赞

## TestNG注解 ##

<table> 
 <thead> 
  <tr> 
   <th align="left">注解</th> 
   <th align="left">描述</th> 
  </tr> 
 </thead> 
 <tbody> 
  <tr> 
   <td align="left">@BeforeSuite</td> 
   <td align="left">The annotated method will be run before all tests in this suite have run.</td> 
  </tr> 
  <tr> 
   <td align="left">@AfterSuite</td> 
   <td align="left">The annotated method will be run after all tests in this suite have run.</td> 
  </tr> 
  <tr> 
   <td align="left">@BeforeTest</td> 
   <td align="left">The annotated method will be run before any test method belonging to the classes inside the tag is run.</td> 
  </tr> 
  <tr> 
   <td align="left">@AfterTest</td> 
   <td align="left">The annotated method will be run after all the test methods belonging to the classes inside the tag have run.</td> 
  </tr> 
  <tr> 
   <td align="left">@BeforeGroups</td> 
   <td align="left">The list of groups that this configuration method will run before. This method is guaranteed to run shortly before the first test method that belongs to any of these groups is invoked.</td> 
  </tr> 
  <tr> 
   <td align="left">@AfterGroups</td> 
   <td align="left">The list of groups that this configuration method will run after. This method is guaranteed to run shortly after the last test method that belongs to any of these groups is invoked.</td> 
  </tr> 
  <tr> 
   <td align="left">@BeforeClass</td> 
   <td align="left">The annotated method will be run before the first test method in the current class is invoked.</td> 
  </tr> 
  <tr> 
   <td align="left">@AfterClass</td> 
   <td align="left">The annotated method will be run after all the test methods in the current class have been run.</td> 
  </tr> 
  <tr> 
   <td align="left">@BeforeMethod</td> 
   <td align="left">The annotated method will be run before each test method.</td> 
  </tr> 
  <tr> 
   <td align="left">@AfterMethod</td> 
   <td align="left">The annotated method will be run after each test method.</td> 
  </tr> 
 </tbody> 
</table>

## TestNG测试类超类中的注解行为 ##

*  The annotations above will also be honored (inherited) when placed on a superclass of a TestNG class. This is useful for example to centralize test setup for multiple test classes in a common superclass.
 *  In that case, TestNG guarantees that the “@Before” methods are executed in inheritance order (highest superclass first, then going down the inheritance chain), and the “@After” methods in reverse order (going up the inheritance chain).

<table> 
 <thead> 
  <tr> 
   <th align="left">注解行为</th> 
   <th align="left">描述</th> 
  </tr> 
 </thead> 
 <tbody> 
  <tr> 
   <td align="left">alwaysRun</td> 
   <td align="left">1. For before methods (beforeSuite, beforeTest, beforeTestClass and beforeTestMethod, but not beforeGroups): If set to true, this configuration method will be run regardless of what groups it belongs to.2. For after methods (afterSuite, afterClass, …): If set to true, this configuration method will be run even if one or more methods invoked previously failed or was skipped.</td> 
  </tr> 
  <tr> 
   <td align="left">dependsOnGroups</td> 
   <td align="left">The list of groups this method depends on.</td> 
  </tr> 
  <tr> 
   <td align="left">dependsOnMethods</td> 
   <td align="left">The list of methods this method depends on.</td> 
  </tr> 
  <tr> 
   <td align="left">enabled</td> 
   <td align="left">Whether methods on this class/method are enabled.</td> 
  </tr> 
  <tr> 
   <td align="left">groups</td> 
   <td align="left">The list of groups this class/method belongs to.</td> 
  </tr> 
  <tr> 
   <td align="left">inheritGroups</td> 
   <td align="left">If true, this method will belong to groups specified in the @Test annotation at the class level.</td> 
  </tr> 
  <tr> 
   <td align="left">onlyForGroups</td> 
   <td align="left">Only for @BeforeMethod and @AfterMethod. If specified, then this setup/teardown method will only be invoked if the corresponding test method belongs to one of the listed groups.</td> 
  </tr> 
  <tr> 
   <td align="left">@DataProvider</td> 
   <td align="left">Marks a method as supplying data for a test method. The annotated method must return an Object[][] where each Object[] can be assigned the parameter list of the test method. The @Test method that wants to receive data from this DataProvider needs to use a dataProvider name equals to the name of this annotation.<strong>name</strong>:The name of this data provider. If it’s not supplied, the name of this data provider will automatically be set to the name of the method.<strong>parallel</strong>:If set to true, tests generated using this data provider are run in parallel. Default value is false.</td> 
  </tr> 
  <tr> 
   <td align="left">@Factory</td> 
   <td align="left">Marks a method as a factory that returns objects that will be used by TestNG as Test classes. The method must return Object[].</td> 
  </tr> 
  <tr> 
   <td align="left">@Listeners</td> 
   <td align="left">That is used to listen the whole process of excuting, If use default listener, do not neet to do anything, If use personal lisener, then you have to config.Defines listeners on a test class.<strong>value</strong>:The list of variables used to fill the parameters of this method.</td> 
  </tr> 
  <tr> 
   <td align="left">@Test</td> 
   <td align="left">Marks a class or a method as part of the test.<strong>alwaysRun</strong>:If set to true, this test method will always be run even if it depends on a method that failed.<strong>dataProvider</strong>:The name of the data provider for this test method.<strong>dataProviderClass</strong>:The class where to look for the data provider. If not specified, the data provider will be looked on the class of the current test method or one of its base classes. If this attribute is specified, the data provider method needs to be static on the specified class.<strong>dependsOnGroups</strong>:The list of groups this method depends on.<strong>dependsOnMethods</strong>:The list of methods this method depends on.<strong>description</strong>:The description for this method.<strong>enabled</strong>:Whether methods on this class/method are enabled.<strong>expectedExceptions</strong>:The list of exceptions that a test method is expected to throw. If no exception or a different than one on this list is thrown, this test will be marked a failure.<strong>groups</strong>:The list of groups this class/method belongs to.<strong>invocationCount</strong>:The number of times this method should be invoked.<strong>invocationTimeOut</strong>:The maximum number of milliseconds this test should take for the cumulated time of all the invocationcounts. This attribute will be ignored if invocationCount is not specified.<strong>priority</strong>:The priority for this test method. Lower priorities will be scheduled first.<strong>successPercentage</strong>:The percentage of success expected from this method.<strong>singleThreaded</strong>:If set to true, all the methods on this test class are guaranteed to run in the same thread, even if the tests are currently being run with parallel=“methods”. This attribute can only be used at the class level and it will be ignored if used at the method level. Note: this attribute used to be called sequential (now deprecated).<strong>timeOut</strong>:The maximum number of milliseconds this test should take.<strong>threadPoolSize</strong>:The size of the thread pool for this method. The method will be invoked from multiple threads as specified by invocationCount. Note: this attribute is ignored if invocationCount is not specified</td> 
  </tr> 
 </tbody> 
</table>

## 代码实例 ##

package org.example;
    import org.testng.annotations.BeforeMethod;
    import org.testng.annotations.BeforeClass;
    import org.testng.annotations.BeforeGroups;
    import org.testng.annotations.BeforeSuite;
    import org.testng.annotations.BeforeTest;
    import org.testng.annotations.AfterMethod;
    import org.testng.annotations.AfterClass;
    import org.testng.annotations.AfterGroups;
    import org.testng.annotations.AfterTest;
    import org.testng.annotations.AfterSuite;
    import org.testng.annotations.Test;
    
    public class FirstTest { 
    
        @BeforeMethod
        public void beforeMethod(){ 
            System.out.println("This is BeforeMethod...");
        }
    
        @BeforeTest
        public void beforeTest(){ 
            System.out.println("This is BeforeTest...");
        }
    
        @BeforeSuite
        public void beforeSuite(){ 
            System.out.println("This is BeforeSuite...");
        }
    
        @BeforeGroups(groups = { "group1"})
        public void beforeGroups1(){ 
            System.out.println("This is group1 of BeforeGroups...");
        }
    
        @BeforeGroups(groups = { "group2"})
        public void beforeGroups2(){ 
            System.out.println("This is group2 of BeforeGroups...");
        }
    
        @BeforeClass
        public void beforeClass(){ 
            System.out.println("This is BeforeClass...");
        }
    
        @AfterMethod
        public void afterMethod(){ 
            System.out.println("This is AfterMethod...");
        }
        @AfterClass
        public void afterClass(){ 
            System.out.println("This is AfterClass...");
        }
        @AfterTest
        public void afterTest(){ 
            System.out.println("This is AfterTest...");
        }
        @AfterGroups(groups = { "group1"})
        public void afterGroups1(){ 
            System.out.println("This is group1 of AfterGroups...");
        }
        @AfterGroups(groups = { "group2"})
        public void afterGroups2(){ 
            System.out.println("This is group2 of AfterGroups...");
        }
        @AfterSuite
        public void afterSuite(){ 
            System.out.println("This is AfterSuite...");
        }
    
        @Test(groups = { "group1"})
        public void testCaseN01(){ 
            System.out.println("Try testing something in group1");
        }
    
        @Test(groups = { "group2"})
        public void testCaseN02(){ 
            System.out.println("Try testing something in group2");
        }
    
        @Test(groups = { "group2"})
        public void testCaseN03(){ 
            System.out.println("Try testing something in group2");
        }
    
        @Test(groups = { "group1", "group2"})
        public void testCaseN04(){ 
            System.out.println("Try testing something in group1 and group2");
        }
    
    }

### testng.xml配置 ###

<?xml version="1.0" encoding="UTF-8"?>
    <!DOCTYPE suite SYSTEM "https://testng.org/testng-1.0.dtd" >
    <suite name="All Test Suite">
        <test verbose="2" preserve-order="true" name="D:/MavenTestNG">
            <classes>
                <class name="org.example.FirstTest">
                    <methods>
                        <include name="testCaseN01"/>
                        <include name="testCaseN02"/>
                        <include name="testCaseN03"/>
                        <include name="testCaseN04"/>
                    </methods>
                </class>
            </classes>
        </test>
    </suite>

### 基于TestNG6.14.3版本执行测试用例 ###

This is BeforeSuite...
    
    
    This is BeforeTest...
    
    
    This is BeforeClass...
    
    
    This is group1 of BeforeGroups...
    
    
    This is BeforeMethod...
    
    
    Try testing something in group1
    
    
    This is AfterMethod...
    
    
    This is group2 of BeforeGroups...
    
    
    This is BeforeMethod...
    
    
    Try testing something in group2
    
    
    This is AfterMethod...
    
    
    This is BeforeMethod...
    
    
    Try testing something in group2
    
    
    This is AfterMethod...
    
    
    This is BeforeMethod...
    
    
    Try testing something in group1 and group2
    
    
    This is AfterMethod...
    
    
    This is group2 of AfterGroups...
    
    
    This is group1 of AfterGroups...
    
    
    This is AfterClass...
    
    
    This is AfterTest...
    
    PASSED: testCaseN01
    PASSED: testCaseN02
    PASSED: testCaseN03
    PASSED: testCaseN04
    ===============================================
        src/test
        Tests run: 4, Failures: 0, Skips: 0
    ===============================================
    This is AfterSuite...
    ===============================================
    All Test Suite
    Total tests run: 4, Failures: 0, Skips: 0
    ===============================================
    Process finished with exit code 0