JUnit4 使用注解(元注释)进行测试

╰半夏微凉° 2022-09-29 05:21 190阅读 0赞

引用：[http://hi.baidu.com/engly0/blog/item/7586790142d64596e950cd9c.html][http_hi.baidu.com_engly0_blog_item_7586790142d64596e950cd9c.html]

JUnit 4 使用 Java 5 中的注解（annotation）

@Before：  
使用了该元数据的方法在每个测试方法执行之前都要执行一次。  
  
@After：  
使用了该元数据的方法在每个测试方法执行之后要执行一次。  
  
注意：@Before和@After标示的方法只能各有一个。这个相当于取代了JUnit以前版本中的setUp和tearDown方法，当然你还可以继续叫这个名字，不过JUnit不会霸道的要求你这么做了。  
在JUnit4.0之前，对错误的测试，我们只能通过fail来产生一个错误，并在try块里面assertTrue（true）来测试。现在，通过@Test元数据中的expected属性。expected属性的值是一个异常的类型  
  
@Test(timeout=xxx):  
该元数据传入了一个时间（毫秒）给测试方法，  
如果测试方法在制定的时间之内没有运行完，则测试也失败。

**3     @Test(expected=UnsupportedDBVersionException.class)**

指定抛出异常,没有异常测试不过.

@Test(expected=\*.class)

@ignore：  
该元数据标记的测试方法在测试中会被忽略。当测试的方法还没有实现，或者测试的方法已经过时，或者在某种条件下才能测试该方法（比如需要一个数据库联接，而在本地测试的时候，数据库并没有连接），那么使用该标签来标示这个方法。同时，你可以为该标签传递一个String的参数，来表明为什么会忽略这个测试方法。比如：@lgnore(“该方法还没有实现”)，在执行的时候，仅会报告该方法没有实现，而不会运行测试方法。

Spring 相关

**@Timed**

表明被注解的测试方法必须在规定的时间区间内执行完成（以毫秒记）。如果测试执行时间超过了规定的时间区间，测试就失败了。

注意该时间区间包括测试方法本身的执行，任何重复测试（参见 @Repeat），还有任何测试fixture的set up或tear down时间。

Spring的@Timed注解与JUnit 4的@Test(timeout=...)支持具有不同的语义。 特别地，鉴于JUnit 4处理测试执行超时（如通过在一个单独的线程中执行测试方法）的方式， 我们不可能在一个事务上下文中的测试方法上使用JUnit的@Test(timeout=...)配置。因此， 如果你想将一个测试方法配置成*计时*且*具事务性*的， 你就必须联合使用Spring的@Timed及@Transactional注解。 还值得注意的是@Test(timeout=...)只管测试方法本身执行的次数，如果超出的话立刻就会失败； 然而，@Timed关注的是测试执行的总时间（包括建立和销毁操作以及重复），并且不会令测试失败。

@Timed(millis=1000)

@ContextConfiguration 注解有以下两个常用的属性：

locations：可以通过该属性手工指定 Spring 配置文件所在的位置，可以指定一个或多个 Spring 配置文件。如下所示：  
@ContextConfiguration(locations=\{“xx/yy/beans1.xml”,” xx/yy/beans2.xml”\})inheritLocations：是否要继承父测试用例类中的 Spring 配置文件，默认为 true。如下面的例子：

如：

@ContextConfiguration(locations=\{"base-context.xml"\})

public class BaseTest \{ // ... \}

@ContextConfiguration(locations=\{"extended-context.xml"\})

public class ExtendedTest extends BaseTest \{ // ... \}

**@IfProfileValue**

提示一下，注解测试只针对特定的测试环境。 如果配置的ProfileValueSource类返回对应的提供者的名称值， 这个测试就可以启动。这个注解可以应用到一个类或者单独的方法。

@IfProfileValue(name=”java.vendor”, value=”Sun Microsystems Inc.”)

同时@IfProfileValue可配置一个值列表 (使用OR 语义) 来在JUnit环境中获得TestNG的测试组支持。 看下面的例子：

@IfProfileValue(name=”test-groups”, values=\{”unit-tests”, “integration-tests”\})

**@ProfileValueSourceConfiguration**

类级别注解用来指定当通过@IfProfileValue注解获取已配置的profile值时使用何种ProfileValueSource。 如果@ProfileValueSourceConfiguration没有在测试中声明，将默认使用SystemProfileValueSource。

@ProfileValueSourceConfiguration(CustomProfileValueSource.class)

**@DirtiesContext**

在测试方法上出现这个注解时，表明底层Spring容器在该方法的执行中被“污染”，从而必须在方法执行结束后重新创建（无论该测试是否通过）。

**@ExpectedException**

表明被注解方法预期在执行中抛出一个异常。预期异常的类型在注解中给定。如果该异常的实例在测试方法执行中被抛出， 则测试通过。同样的如果该异常实例没有在测试方法执行时抛出，则测试失败。

@ExpectedException(SomeBusinessException.class)

**@Repeat**

表明被注解的测试方法必须重复执行。执行的次数在注解中声明。

注意重复执行范围包括包括测试方法本身的执行，以及任何测试fixture的set up或tear down。

@Repeat(10)

**@Rollback**

表明被注解方法的事务在完成后是否需要被回滚。 如果true，事务将被回滚，否则事务将被提交。 使用@Rollback接口来在类级别覆写配置的默认回滚标志。

@Rollback(false)

**@NotTransactional**

出现该注解表明测试方法必须不在事务中执行。

@NotTransactional

Spring TestContext Framework还支持下面这些非特定于测试的注解，并且保持其语义不变。

@Autowired@Qualifier@Resource (javax.annotation)*如果JSR-250可用*@PersistenceContext (javax.persistence)*如果JPA可用*@PersistenceUnit (javax.persistence)*如果JPA可用*@Required@Transactional

**@TestExecutionListeners**

定义类级别的元数据，TestExecutionListeners会使用TestContextManager进行注册。 通常，@TestExecutionListeners与@ContextConfiguration会搭配使用。

@ContextConfiguration @TestExecutionListeners(\{CustomTestExecutionListener.class, AnotherTestExecutionListener.class\})

**@TransactionConfiguration**

为配置事务性测试定义了类级别的元数据。特别地，如果需要的PlatformTransactionManager不是“transactionManager”的话， 那么可以显式配置驱动事务的PlatformTransactionManager的bean名字。此外， 可以将defaultRollback标志改为false。通常，@TransactionConfiguration与@ContextConfiguration搭配使用。

@ContextConfiguration @TransactionConfiguration(transactionManager="txMgr", defaultRollback=false)

**@BeforeTransaction**  
表明被注解的public void方法应该在测试方法的事务开始*之前*执行， 该事务是通过@Transactional注解来配置的。

@BeforeTransaction

**@AfterTransaction**

表明被注解的public void方法应该在测试方法的事务结束*之后*执行， 该事务是通过@Transactional注解来配置的。

@AfterTransaction

**    @RunWith(CustomTestRunner.class)**  
       public class TestWordDealUtil \{......\}

JUnit 为单元测试提供了默认的测试运行器   
可以为每一个测试类指定使用某个具体的运行器   
**8    @RunWith(Suite.class)  
      @Suite.SuiteClasses(\{TestWordDealUtil.class\})**  
       public class RunAllUtilTestsSuite \{\}

创建一个空类作为测试套件的入口。   
使用注解 org.junit.runner.RunWith 和 org.junit.runners.Suite.SuiteClasses 修饰这个空类。   
将 org.junit.runners.Suite 作为参数传入注解 RunWith，以提示 JUnit 为此类使用套件运行器执行。   
将需要放入此测试套件的测试类组成数组作为注解 SuiteClasses 的参数。   
保证这个空类使用 public 修饰，而且存在公开的不带有任何参数的构造函数。

**9   参数化测试**

为准备使用参数化测试的测试类指定特殊的运行器 org.junit.runners.Parameterized。   
为测试类声明几个变量，分别用于存放期望值和测试所用数据。   
为测试类声明一个使用注解 org.junit.runners.Parameterized.Parameters 修饰的，返回值为 java.util.Collection 的公共静态方法，并在此方法中初始化所有需要测试的参数对。   
为测试类声明一个带有参数的公共构造函数，并在其中为第二个环节中声明的几个变量赋值。   
编写测试方法，使用定义的变量作为参数进行测试。   
      view plaincopy to clipboardprint?  
**@RunWith(Parameterized.class)   **  
public class TestWordDealUtilWithParam \{     
  
        private String expected;     
         
        private String target;     
         
**        @Parameters **  
        public static Collection words()\{     
                return Arrays.asList(new Object\[\]\[\]\{     
                \{"employee\_info", "employeeInfo"\},      //测试一般的处理情况     
                \{null, null\},                           //测试 null 时的处理情况     
|-------10--------20--------30--------40--------50--------60--------70--------80--------9|     
|-------- XML error: The previous line is longer than the max of 90 characters ---------|     
                \{"", ""\},                               //测试空字符串时的处理情况     
|-------10--------20--------30--------40--------50--------60--------70--------80--------9|     
|-------- XML error: The previous line is longer than the max of 90 characters ---------|     
                \{"employee\_info", "EmployeeInfo"\},      //测试当首字母大写时的情况     
                \{"employee\_info\_a", "employeeInfoA"\},   //测试当尾字母为大写时的情况     
                \{"employee\_a\_info", "employeeAInfo"\}    //测试多个相连字母大写时的情况     
                \});     
        \}     
         
        /\*\*   
        \* 参数化测试必须的构造函数   
        \* @param expected   期望的测试结果，对应参数集中的第一个参数   
        \* @param target 测试数据，对应参数集中的第二个参数   
        \*/   
        public TestWordDealUtilWithParam(String expected , String target)\{     
            this.expected = expected;     
            this.target = target;     
        \}     
         
        /\*\*   
        \* 测试将 Java 对象名称到数据库名称的转换   
        \*/   
       ** @Test** public void wordFormat4DB()\{     
            assertEquals(expected, WordDealUtil.wordFormat4DB(target));     
        \}     
\}   
**@RunWith(Parameterized.class)**  
public class TestWordDealUtilWithParam \{

private String expected;  
  
   private String target;  
  
**   @Parameters**  
   public static Collection words()\{  
        return Arrays.asList(new Object\[\]\[\]\{  
           \{"employee\_info", "employeeInfo"\},   //测试一般的处理情况  
           \{null, null\},        //测试 null 时的处理情况  
|-------10--------20--------30--------40--------50--------60--------70--------80--------9|  
|-------- XML error: The previous line is longer than the max of 90 characters ---------|  
           \{"", ""\},         //测试空字符串时的处理情况  
|-------10--------20--------30--------40--------50--------60--------70--------80--------9|  
|-------- XML error: The previous line is longer than the max of 90 characters ---------|  
           \{"employee\_info", "EmployeeInfo"\},   //测试当首字母大写时的情况  
           \{"employee\_info\_a", "employeeInfoA"\}, //测试当尾字母为大写时的情况  
           \{"employee\_a\_info", "employeeAInfo"\} //测试多个相连字母大写时的情况  
        \});  
   \}  
  
/\*\*  
\* 参数化测试必须的构造函数  
\* @param expected 期望的测试结果，对应参数集中的第一个参数  
\* @param target 测试数据，对应参数集中的第二个参数  
\*/  
   public TestWordDealUtilWithParam(String expected , String target)\{  
    this.expected = expected;  
    this.target = target;  
   \}  
  
/\*\*  
\* 测试将 Java 对象名称到数据库名称的转换  
\*/  
   **@Test** public void wordFormat4DB()\{  
    assertEquals(expected, WordDealUtil.wordFormat4DB(target));  
   \}  
\}

**2     @Before              @After                   (针对实例)**

使用注解 org,junit.Before 修饰用于初始化 Fixture 的方法。   
使用注解 org.junit.After 修饰用于注销 Fixture 的方法。   
保证这两种方法都使用 public void 修饰，而且不能带有任何参数。

**1    @BeforeClass      @AfterClass          (针对类)**

使用注解 org,junit.BeforeClass 修饰用于初始化 Fixture 的方法。   
使用注解 org.junit.AfterClass 修饰用于注销 Fixture 的方法。   
保证这两种方法都使用 public static void 修饰，而且不能带有任何参数。

[http_hi.baidu.com_engly0_blog_item_7586790142d64596e950cd9c.html]: http://hi.baidu.com/engly0/blog/item/7586790142d64596e950cd9c.html