TestNG 使用入门教程

谁践踏了优雅 2022-02-27 09:20 573阅读 0赞

参照：[https://testng.org/doc/documentation-main.html][https_testng.org_doc_documentation-main.html]

阅读目录

1.  [TestNG介绍][TestNG]
2.  [在Eclipse中在线安装TestNG][Eclipse_TestNG]
3.  [在Eclipse中离线安装Testng][Eclipse_Testng]
4.  [TestNG最简单的测试][TestNG 1]
5.  [TestNG的基本注解][TestNG 2]
6.  [TestNG中如何执行测试][TestNG 3]
7.  [使用testtng.xml 文件执行 case ][testtng.xml _ case]
8.  [TestNG按顺序执行Case][TestNG_Case]
9.  [TestNG异常测试][TestNG 4]
10. [TestNG组测试][TestNG 5]
11. [TestNG参数化测试][TestNG 6]
12. [TestNG忽略测试][TestNG 7]
13. [TestNG 依赖测试][TestNG 8]
14. [TestNG测试结果报告][TestNG 9]

# TestNG介绍 #

TestNG是Java中的一个测试框架， 类似于JUnit 和NUnit,   功能都差不多， 只是功能更加强大，使用也更方便

Java中已经有一个JUnit的测试框架了。  TestNG比JUnit功能强大的多。  测试人员一般用TestNG来写自动化测试。  开发人员一般用JUnit写单元测试。

官方网站: [http://testng.org/doc/index.html][http_testng.org_doc_index.html]

# 在Eclipse中在线安装TestNG #

打开Eclipse   Help ->Install New Software ,   然后Add   "[http://beust.com/eclipse][http_beust.com_eclipse]"

![030942544628581.png][]

# 在Eclipse中离线安装Testng #

首先下载testng离线包:　 [http://pan.baidu.com/s/1hrEaX6k][http_pan.baidu.com_s_1hrEaX6k]

1. 将解压后的文件..\\eclipse-testng离线包\\features\\org.testng.eclipse\_6.9.9.201510270734　  文件夹　放到　　　　　　eclipse--》features目录下

2. 将解压后的文件..\\eclipse-testng离线包\\plugins\\org.testng.eclipse\_6.9.8.201510130443　 文件夹　 放到                 eclipse--》plugins目录下

3. 重启eclipse

4. 验证是否安装成功，file-->new-->other-->TestNg

![263119-20160408072122468-1248913039.png][]

# TestNG最简单的测试 #

下面是TestNG的最简单的一个例子

package TankLearn2.Learn;
    
    import org.junit.AfterClass;
    import org.junit.BeforeClass;
    import org.testng.annotations.Test;
    
    public class TestNGLearn1 {
    
        @BeforeClass
        public void beforeClass() {
            System.out.println("this is before class");
        }
    
        @Test
        public void TestNgLearn() {
            System.out.println("this is TestNG test case");
        }
    
        @AfterClass
        public void afterClass() {
            System.out.println("this is after class");
        }
    }

# TestNG的基本注解 #

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

# TestNG中如何执行测试 #

第一种直接执行：右键要执行的方法，　　点Run As ->TestNG Test

![050727158475617.png][]

# 使用testtng.xml 文件执行 case  #

第二种:  通过testng.xml文件来执行. 把要执行的case, 放入testng.xml文件中。 右键点击testng.xml,   点Run As

testng.xml

<?xml version="1.0" encoding="UTF-8"?><!DOCTYPE suite SYSTEM "http://testng.org/testng-1.0.dtd" >
 <suite name="Suite1">
 <test name="test12">
 <classes>
 <class name="TankLearn2.Learn.TestNGLearn1" />
 </classes>
 </test>
 </suite>

![050729215814295.png][]

# TestNG按顺序执行Case #

在testng.xml中，可以控制测试用例按顺序执行。  当preserve-order="true"是，可以保证节点下面的方法是按顺序执行的

<?xml version="1.0" encoding="UTF-8"?><!DOCTYPE suite SYSTEM "http://testng.org/testng-1.0.dtd" >
 <suite name="Suite1">
 <test name="test12" preserve-order="true">
 <classes>
 <class name="TankLearn2.Learn.TestNGLearn1">
 <methods>
 <include name="TestNgLearn3" />
 <include name="TestNgLearn1" />
 <include name="TestNgLearn2" />
 </methods>
 </class>
 </classes>
 </test>
 </suite>

# TestNG异常测试 #

测试中，有时候我们期望某些代码抛出异常。

TestNG通过@Test(expectedExceptions)  来判断期待的异常， 并且判断Error Message

package TankLearn2.Learn;
    
    import org.testng.annotations.Test;
    
    public class ExceptionTest {
        
        @Test(expectedExceptions = IllegalArgumentException.class, expectedExceptionsMessageRegExp="NullPoint")
        public void testException(){
            throw new IllegalArgumentException("NullPoint");
        }
    }

# TestNG组测试 #

TestNG中可以把测试用例分组，这样可以按组来执行测试用例比如：

package TankLearn2.Learn;
    
    import org.testng.annotations.Test;
    
    public class GroupTest {
        
        @Test(groups = {"systemtest"})
        public void testLogin(){
            System.out.println("this is test login");
        }
        
        @Test(groups = {"functiontest"})
        public void testOpenPage(){
            System.out.println("this is test Open Page");
        }
    }

然后在testng.xml中 按组执行测试用例

<?xml version="1.0" encoding="UTF-8"?>
 <!DOCTYPE suite SYSTEM "http://testng.org/testng-1.0.dtd" >
 <suite name="Suite1">
 <test name="test1">
 <groups>
 <run>
 <include name="functiontest" />
 </run>
 </groups>
 </test>
 </suite>

# TestNG参数化测试 #

软件测试中，经常需要测试大量的数据集。 测试代码的逻辑完全一样，只是测试的参数不一样。  这样我们就需要一种 “传递测试参数的机制”。 避免写重复的测试代码

TestNG提供了2种传递参数的方式。

第一种: testng.xml 方式使代码和测试数据分离，方便维护

第二种：@DataProvider能够提供比较复杂的参数。 (也叫data-driven testing)

方法一：　通过testng.xml 传递参数给测试代码

package TankLearn2.Learn;
    
    import org.testng.annotations.Parameters;
    import org.testng.annotations.Test;
    
    public class ParameterizedTest1 {
        
        @Test
        @Parameters("test1")
        public void ParaTest(String test1){
            System.out.println("This is " + test1);
        }
    }

testng.xml

<?xml version="1.0" encoding="UTF-8"?><!DOCTYPE suite SYSTEM "http://testng.org/testng-1.0.dtd" >
 <suite name="Suite1">
 <parameter name="test1" value="Tank" />
 <parameter name="test1" value="Xiao" />
 <test name="test12">
 <classes>
 <class name="TankLearn2.Learn.ParameterizedTest1" />
 </classes>
 </test>
 </suite>

方式二:   通过DataProvider传递参数

package TankLearn2.Learn;
    
    import org.testng.annotations.DataProvider;
    import org.testng.annotations.Test;
    
    public class DataProviderLearn {
        
        @DataProvider(name="user")
        public Object[][] Users(){
            return new Object[][]{
                    {"root","passowrd"},
                    {"cnblogs.com", "tankxiao"},
                    {"tank","xiao"}
            };
        }
        
        @Test(dataProvider="user")
        public void verifyUser(String userName, String password){
            System.out.println("Username: "+ userName + " Password: "+ password);
        }
    }

# TestNG忽略测试 #

有时候测试用例还没准备好， 可以给测试用例加上@Test(enable = false)，  来禁用此测试用例

package TankLearn2.Learn;
    
    import org.testng.annotations.Test;
    
    public class TesgNGIgnore {
        
        @Test(enabled = false)
        public void testIgnore(){
            System.out.println("This test case will ignore");
        }
    }

# TestNG 依赖测试 #

有时候，我们需要按顺序来调用测试用例，  那么测试用例之间就存在依赖关系。 TestNG支持测试用例之间的依赖

package TankLearn2.Learn;
    
    import org.testng.annotations.Test;
    
    public class DependsTest {
        
        @Test
        public void setupEnv(){
            System.out.println("this is setup Env");
        }
        
        @Test(dependsOnMethods = {"setupEnv"})
        public void testMessage(){
            System.out.println("this is test message");
        }
    }

# TestNG测试结果报告 #

测试报告是测试非常重要的部分.

TestNG默认情况下，会生产两种类型的测试报告HTML的和XML的。 测试报告位于 "test-output" 目录下.

![050741002222302.png][]

当然我们也可以设置测试报告的内容级别.

verbose="2" 标识的就是记录的日志级别，共有0-10的级别，其中0表示无，10表示最详细

<?xml version="1.0" encoding="UTF-8"?><!DOCTYPE suite SYSTEM "http://testng.org/testng-1.0.dtd" >
 <suite name="Suite1">
 <test name="test12" verbose="2">
 <classes>
 <class name="TankLearn2.Learn.TestNGLearn1" />
 </classes>
 </test>
 </suite>

[https_testng.org_doc_documentation-main.html]: https://testng.org/doc/documentation-main.html
[TestNG]: https://www.cnblogs.com/TankXiao/p/3888070.html#introduce
[Eclipse_TestNG]: https://www.cnblogs.com/TankXiao/p/3888070.html#install
[Eclipse_Testng]: https://www.cnblogs.com/TankXiao/p/3888070.html#offlineInstall
[TestNG 1]: https://www.cnblogs.com/TankXiao/p/3888070.html#simpleTest
[TestNG 2]: https://www.cnblogs.com/TankXiao/p/3888070.html#annotation
[TestNG 3]: https://www.cnblogs.com/TankXiao/p/3888070.html#execute
[testtng.xml _ case]: https://www.cnblogs.com/TankXiao/p/3888070.html#testng
[TestNG_Case]: https://www.cnblogs.com/TankXiao/p/3888070.html#order
[TestNG 4]: https://www.cnblogs.com/TankXiao/p/3888070.html#exceptionTest
[TestNG 5]: https://www.cnblogs.com/TankXiao/p/3888070.html#groupTest
[TestNG 6]: https://www.cnblogs.com/TankXiao/p/3888070.html#argumentTest
[TestNG 7]: https://www.cnblogs.com/TankXiao/p/3888070.html#ignoreTest
[TestNG 8]: https://www.cnblogs.com/TankXiao/p/3888070.html#dependcyTest
[TestNG 9]: https://www.cnblogs.com/TankXiao/p/3888070.html#testReport
[http_testng.org_doc_index.html]: http://testng.org/doc/index.html
[http_beust.com_eclipse]: http://beust.com/eclipse
[030942544628581.png]: /images/20220227/25858bb2b3264c0b87dd70e5dcf0c09f.png
[http_pan.baidu.com_s_1hrEaX6k]: http://pan.baidu.com/s/1hrEaX6k
[263119-20160408072122468-1248913039.png]: /images/20220227/304afba3f76243a9a22428517a582eea.png
[050727158475617.png]: /images/20220227/e8c0d0799be345c8a0135d6d736f2ff9.png
[050729215814295.png]: /images/20220227/6b1db1eb4c984f2ca2c869316e66ee51.png
[050741002222302.png]: /images/20220227/323f0fa4dad74c668bb9f14df62245d2.png