单元测试系列[v1.0.1][Junit5注解]

落日映苍穹つ 2022-11-28 13:33 84阅读 0赞

>  *  The JUnit Platform serves as a foundation for launching testing frameworks on the JVM. It also defines the TestEngine API for developing a testing framework that runs on the platform. Furthermore, the platform provides a Console Launcher to launch the platform from the command line and a JUnit 4 based Runner for running any TestEngine on the platform in a JUnit 4 based environment. First-class support for the JUnit Platform also exists in popular IDEs (see IntelliJ IDEA, Eclipse, NetBeans, and Visual Studio Code) and build tools (see Gradle, Maven, and Ant).

>  *  JUnit Jupiter is the combination of the new programming model and extension model for writing tests and extensions in JUnit 5. The Jupiter sub-project provides a TestEngine for running Jupiter based tests on the platform.

>  *  JUnit Vintage provides a TestEngine for running JUnit 3 and JUnit 4 based tests on the platform.

## Junit5注解 ##

<table> 
 <thead> 
  <tr> 
   <th align="left">注解</th> 
   <th align="left">描述</th> 
  </tr> 
 </thead> 
 <tbody> 
  <tr> 
   <td align="left">@Test</td> 
   <td align="left">Denotes that a method is a test method. Unlike JUnit 4’s @Test annotation, this annotation does not declare any attributes, since test extensions in JUnit Jupiter operate based on their own dedicated annotations. Such methods are inherited unless they are overridden.</td> 
  </tr> 
  <tr> 
   <td align="left">@ParameterizedTest</td> 
   <td align="left">Denotes that a method is a parameterized test. Such methods are inherited unless they are overridden.</td> 
  </tr> 
  <tr> 
   <td align="left">@RepeatedTest</td> 
   <td align="left">Denotes that a method is a test template for a repeated test. Such methods are inherited unless they are overridden.</td> 
  </tr> 
  <tr> 
   <td align="left">@TestFactory</td> 
   <td align="left">Denotes that a method is a test factory for dynamic tests. Such methods are inherited unless they are overridden.</td> 
  </tr> 
  <tr> 
   <td align="left">@TestTemplate</td> 
   <td align="left">Denotes that a method is a template for test cases designed to be invoked multiple times depending on the number of invocation contexts returned by the registered providers. Such methods are inherited unless they are overridden.</td> 
  </tr> 
  <tr> 
   <td align="left">@TestMethodOrder</td> 
   <td align="left">Used to configure the test method execution order for the annotated test class; similar to JUnit 4’s @FixMethodOrder. Such annotations are inherited.</td> 
  </tr> 
  <tr> 
   <td align="left">@TestInstance</td> 
   <td align="left">Used to configure the test instance lifecycle for the annotated test class. Such annotations are inherited.</td> 
  </tr> 
  <tr> 
   <td align="left">@DisplayName</td> 
   <td align="left">Declares a custom display name for the test class or test method. Such annotations are not inherited.</td> 
  </tr> 
  <tr> 
   <td align="left">@DisplayNameGeneration</td> 
   <td align="left">Declares a custom display name generator for the test class. Such annotations are inherited.</td> 
  </tr> 
  <tr> 
   <td align="left">@BeforeEach</td> 
   <td align="left">Denotes that the annotated method should be executed before each @Test, @RepeatedTest, @ParameterizedTest, or @TestFactory method in the current class; analogous to JUnit 4’s @Before. Such methods are inherited unless they are overridden.</td> 
  </tr> 
  <tr> 
   <td align="left">@AfterEach</td> 
   <td align="left">Denotes that the annotated method should be executed after each @Test, @RepeatedTest, @ParameterizedTest, or @TestFactory method in the current class; analogous to JUnit 4’s @After. Such methods are inherited unless they are overridden.</td> 
  </tr> 
  <tr> 
   <td align="left">@BeforeAll</td> 
   <td align="left">Denotes that the annotated method should be executed before all @Test, @RepeatedTest, @ParameterizedTest, and @TestFactory methods in the current class; analogous to JUnit 4’s @BeforeClass. Such methods are inherited (unless they are hidden or overridden) and must be static (unless the “per-class” test instance lifecycle is used).</td> 
  </tr> 
  <tr> 
   <td align="left">@AfterAll</td> 
   <td align="left">Denotes that the annotated method should be executed after all @Test, @RepeatedTest, @ParameterizedTest, and @TestFactory methods in the current class; analogous to JUnit 4’s @AfterClass. Such methods are inherited (unless they are hidden or overridden) and must be static (unless the “per-class” test instance lifecycle is used).</td> 
  </tr> 
  <tr> 
   <td align="left">@Nested</td> 
   <td align="left">Denotes that the annotated class is a non-static nested test class. @BeforeAll and @AfterAll methods cannot be used directly in a @Nested test class unless the “per-class” test instance lifecycle is used. Such annotations are not inherited.</td> 
  </tr> 
  <tr> 
   <td align="left">@Tag</td> 
   <td align="left">Used to declare tags for filtering tests, either at the class or method level; analogous to test groups in TestNG or Categories in JUnit 4. Such annotations are inherited at the class level but not at the method level.</td> 
  </tr> 
  <tr> 
   <td align="left">@Disabled</td> 
   <td align="left">Used to disable a test class or test method; analogous to JUnit 4’s @Ignore. Such annotations are not inherited.</td> 
  </tr> 
  <tr> 
   <td align="left">@Timeout</td> 
   <td align="left">Used to fail a test, test factory, test template, or lifecycle method if its execution exceeds a given duration. Such annotations are inherited.</td> 
  </tr> 
  <tr> 
   <td align="left">@ExtendWith</td> 
   <td align="left">Used to register extensions declaratively. Such annotations are inherited.</td> 
  </tr> 
  <tr> 
   <td align="left">@RegisterExtension</td> 
   <td align="left">Used to register extensions programmatically via fields. Such fields are inherited unless they are shadowed.</td> 
  </tr> 
  <tr> 
   <td align="left">@TempDir</td> 
   <td align="left">Used to supply a temporary directory via field injection or parameter injection in a lifecycle method or test method; located in the org.junit.jupiter.api.io package.</td> 
  </tr> 
 </tbody> 
</table>

## 被测代码 ##

package com.davieyang.application;
    
    public class CalculatorForPpi { 
        public static long calculate(int width, int height, double size){ 
            long result;
            if (width > 0 && height > 0 && size>0){ 
               result = Math.round(Math.pow((Math.pow(width, 2) + Math.pow(height, 2)) / Math.pow(size, 2), 0.5));
            }else { 
                result = -1;
            }
            return result;
        }
    }

## 测试代码 ##

package com.davieyang.application;
    import org.junit.jupiter.api.Assertions;
    import org.junit.jupiter.api.BeforeAll;
    import org.junit.jupiter.api.Test;
    
    
    public class CalculatorForPpiTest { 
        private static int width;
        private static int height;
        private static double size;
        @BeforeAll
        static void init(){ 
            width=750;
            height=1334;
            size=4.7;
        }
    
        @Test
        public void testCase1(){ 
            Assertions.assertEquals(326, CalculatorForPpi.calculate(width, height, size));
        }
    }