Marc Philipp. Senior Software Karlsruhe. JUnit Maintainer seit Web:

Transkript

1 JUnit 5

2 Marc Philipp Senior Software Karlsruhe JUnit Maintainer seit 2012 Web:

3 Programmiermodell

4 DEMO

5 Meta Annotations Annotationen können miteinander FastTest {} void test() void test() {}

6 @DisplayName("A stack") class instantiated with new Stack()") void isinstantiatedwithnew() {/*... Tests new") class WhenNew void createnewstack() empty") void isempty() {/*... pushing an element") class AfterPushing void pushanelement() is no longer empty") void isnotempty() {/*... */} } } } //...

7 Dynamic Stream<DynamicTest> dynamictestsfromstream() { return IntStream.iterate(0, n -> n + 2).limit(11).mapToObj(n -> dynamictest("test" + n, () -> { asserttrue(n % 2 == 0); })); }

8 Warum brauchen wir ein neues JUnit?

9 Runner Sehr mächtig: Komplette Ausführung kann angepasst werden Aber: Es kann nur einen Runner pro Testklasse geben! Runner lassen sich nicht kombinieren, z. B. SpringJUnit4ClassRunner + Parameterized

10 Rules Neuer Erweiterungsmechanismus seit JUnit 4.7 Wrapper um Ausführung eines Tests oder einer Testklasse Sehr gute Kombinierbarkeit Aber: Oft nicht mächtig genug, um auf die Testausführung auf unterschiedlichen Ebenen zu beeinflussen (z.b. Spring)

11

12 Bisherige Architektur Jeder verwendet das junit.jar.

13 Umbenennen einer Instanzvariable ist kein Problem, oder? beta-1

14 The success of JUnit as a platform prevents the development of JUnit as a tool. Johannes Link,

15 Modularisierung

16 Separation of Concerns 1. Eine API um Tests zu schreiben (Jupiter API) 2. Erweiterbarer Mechanismus zum Auffinden und Ausführen von Tests (Test Engine SPI) 3. Eine API für die Testausführung durch Tools (Launcher API)

17 VINTAGE JUPITER THIRD PARTY PLATFORM

18 THIRD PARTY JUPITER VINTAGE PLATFORM

19 Testausführung IDEs: IntelliJ unterstützt JUnit 5 M2 seit Eclipse-Unterstützung gibt es auf einem Branch Übergangslösung für andere IDEs: JUnitPlatform Runner Gradle/Maven: Plugin/Provider verfügbar siehe Manuell: ConsoleLauncher

20 JUnitPlatform Runner für eine public class JupiterTest void sometest() { // test something } }

21 JUnitPlatform Runner @IncludeEngines({"junit-jupiter", "junit-vintage"}) public class JUnit4SuiteDemo { // this class can be run using JUnit 4 }

22 Kompatibilität Rückwärtskompatibilität (junit-vintage-engine) ermöglicht schrittweise Migration auf Jupiter Vorwärtskompatibilität (JUnitPlatform Runner) ermöglicht Testausführung mit alten Tools

23 Extensions

24 Prefer extension points over features. JUnit Core Principles

25 Registrierung Eine (!) Annotation zur Registrierung von Extensions An Testklassen oder -methoden Gleichzeitige Registrierung beliebig vieler Extensions wird unterstützt Kann auch als Meta-Annotation verwendet werden!

26 DEMO

27 Extension Points Conditional Test Execution Test Lifecycle Callbacks ContainerExecutionCondition BeforeAllCallback TestExecutionCondition BeforeEachCallback General Purpose BeforeTestExecutionCallback TestInstancePostProcessor AfterTestExecutionCallback TestExecutionExceptionHandler AfterEachCallback ParameterResolver AfterAllCallback

28 Eine Extension Mehrere Extension Points Eine Extension kann mehrere Extension- Interfaces implementieren E.g. BeforeEachCallback und AfterEachCallback

29 ParameterResolver Konstruktoren und Testmethoden können nun Parameter haben Registrierte ParameterResolvers sind dafür zuständig, die Parameter aufzulösen Beispiele: TestInfoParameterResolver, TestReporterParameterResolver, MockitoExtension

30 Third-party Extensions (Auswahl) SpringExtension Core Spring TestContext Framework Features Constructor und Method @Value uprest Declarative Tests für REST APIs

31 Ausblick

32 Roadmap to GA M4 (März 2017): Parametrisierte Tests M5 (Juni 2017): Kompatibilität mit Java RC1 (Juli 2017): Letzte Änderungen vor GA (August 2017): GA

33 class void testtemplate() { // test something } } class MyTestTemplateInvocationContextProvider implements TestTemplateInvocationContextProvider public Iterator<TestTemplateInvocationContext> provide(containerextensioncontext context) { return singleton(new MyTestTemplateInvocationContext()).iterator(); } } class MyTestTemplateInvocationContext implements TestTemplateInvocationContext public String getdisplayname(int invocationindex) { } return "[" + invocationindex + "]"; public List<Extension> getadditionalextensions() { return aslist(new MyParameterResolver(), new MyTestInstancePostProcessor()); }

34 class "foo, 1", "bar, 2" }) void testwithparametersfromannotation(string parameter, int i) { // test void testwithparametersfrommethods(string parameter) { } static Iterable<String> providermethod() { return aslist("foo", "bar"); @FileSource("bar.csv") void testwithparametersfromfile(string parameter) { }

35 Loslegen! User Guide: Beispielprojekte für Gradle and Maven: Javadoc:

36 Feedback wanted! Website: Code & Issues: Twitter: