JUNIT 5 & TESTCONTAINERS. Testing with Java and Docker

Transcription

1 JUNIT 5 & TESTCONTAINERS Testing with Java and Docker

2 TIM RIEMER Solution Vorwerk Digital tim.riemer@vorwerk.de Co-Lead Kotlin UG github.com/timriemer

3 JUNIT 5

4 JUNIT 5 JUnit 5 = JUnit Platform + JUnit Jupiter + JUnit Vintage Current version: No public modifier needed Requires Java 8 or greater Support in IntelliJ IDEA and Eclipse IDE

5 public void simpletest() { assertequals(2, 1+1); }

6 EXAMPLE // JUnit 4 Imports import org.junit.test; import static org.junit.assert.assertequals;

7 EXAMPLE // JUnit 5 Imports import org.junit.jupiter.api.test; import static org.junit.jupiter.api.assertions.assertequals;

8 DEPENDENCIES <dependency> <groupid>org.junit.jupiter</groupid> <artifactid>junit-jupiter-engine</artifactid> <version>5.3.1</version> <scope>test</scope> </dependency>

9 ANNOTATIONS // static void tearup() { System.out.println("tearUp!"); } // static void teardown() { System.out.println("tearDown!"); }

10 ANNOTATIONS // void before() { System.out.println("before!"); } // void after() { System.out.println("after!"); }

11 ANNOTATIONS // @Test void simpletest() { assertequals(2, 1+1); }

12 ANNOTATIONS Nested test classes Must be non-static inner classes Can contain test methods, method No limit for depth of class hierarchy

13 class InnerClass void innerclasstest() { assertequals(4, 2+2); } }

14 ANNOTATIONS validate that the sum of equals 4") void shouldchecksumofcalculation() { assertequals(4, 2+2); }

15

16 ASSERTIONS New class: org.junit.jupiter.api.assertions Use of lambdas for lazy evaluation of messages Grouping of assertions New way to handle exceptions

17 void simpletest() { assertequals(5, 2+2, () -> "Result should be 5"); }

18 void simpletestforassertall() { assertall( () -> assertequals(2, 1+1), () -> assertequals(4, 2+2) ); }

19 void shouldthrowexception() { assertthrows(unsupportedoperationexception.class, () -> { throw new UnsupportedOperationException ("Operation not supported"); }); }

20 void shouldcheckthrownexception() { var exception = assertthrows(unsupportedoperationexception.class, () -> { throw new UnsupportedOperationException ("Operation not supported"); }); assertequals("operation not supported, exception.getmessage()); }

21 void testasserttimeout() { asserttimeout(ofseconds(10), () -> { Thread.sleep(15000); }); }

22 void testasserttimeoutpreemptively() { asserttimeoutpreemptively(ofseconds(10), () -> { Thread.sleep(15000); }); }

23 ASSUMPTIONS TestAbortedException if assumption fails -> test is void assumptiontest() { assumetrue(true); assumefalse(false); assumingthat("abc".equals("abc"), () -> assertequals(2, 1+1)); }

24 DYNAMIC Stream<DynamicTest> dynamictestsfromstream() { return Stream.of(1, 2, 3).map(i -> dynamictest("test " + i, () -> { assertequals(i * 2, i + i); })); }

25 DYNAMIC TESTS

26 CONDITIONAL TEST EXECUTION ExecutionCondition as extension API DisabledCondition simplest example annotation

27 CONDITIONAL TEST =, matches = =, matches = ), support for scripting languages, EXPERIMENTAL

28 PARAMETERIZED TESTS Experimental feature junit-jupiter-params dependency needed

29 = {"java8", "java9", "java10"}) void parameterizedtest(string param) { asserttrue(param.contains("java")); }

30 PARAMETERIZED = "[{index}] => = {"java8", "java9", "java10"}) void parameterizedtest(string param) { asserttrue(param.contains("java")); }

31 PARAMETERIZED for String, int, long and methodname ) - method must return Stream, Iterator or foo, bar, foo2, bar2 =

32 PARALLEL TEST EXCECUTION src/test/resources/junit-platform.properties: junit.jupiter.execution.parallel.enabled = true #junit.jupiter.execution.parallel.config.strategy = dynamic #junit.jupiter.execution.parallel.config.dynamic.factor = 1 #junit.jupiter.execution.parallel.config.strategy = fixed #junit.jupiter.execution.parallel.config.fixed.parallelism = 4 #junit.jupiter.execution.parallel.config.strategy = custom #junit.jupiter.execution.parallel.config.custom.class =

33 PARALLEL TEST EXCECUTION Synchronization for @ResourceLock(value =, mode = ) value: user-defined String, SYSTEM_PROPERTIES,, SYSTEM_OUT, SYSTEM_ERR mode: READ, READ_WRITE

34 WHAT and filtering in build with dynamic / TestTemplateInvocationContextProvider Extension API, extensions registered

35

36 INTRODUCTION Java library to launch Docker containers during JUnit tests Integration tests against the data access layer Integration tests with external dependencies (e.g. message broker, database, ) UI tests with containerized, Selenium compatible, web browsers

37 INTRODUCTION Current version: Requires Docker installation Requires Java 8 Compatible with JUnit

38 DEPENDENCIES <dependency> <groupid>org.testcontainers</groupid> <artifactid>testcontainers</artifactid> <version>1.9.1</version> <scope>test</scope> </dependency>

39 OWN MAVEN MODULES MySQL PostgreSQL Oracle XE Kafka Selenium

40 JUNIT public static GenericContainer wildfly = new GenericContainer("jboss/wildfly").withExposedPorts(8080, public void getexposedports() { var ports = wildfly.getexposedports(); var expectedports = Arrays.asList(8080, 9990); assertequals(expectedports, ports); }

41 JUNIT 5 static GenericContainer wildfly = new GenericContainer("jboss/wildfly").withExposedPorts(8080, static void startup() { wildfly.start(); static void teardown() { wildfly.stop(); void getexposedports() { var ports = wildfly.getexposedports(); var expectedports = Arrays.asList(8080, 9990); assertequals(expectedports, ports); }

42 GENERIC CONTAINER Offers flexible support for any container image as test dependency Reference public docker images Internal dockerized services

43 GENERIC CONTAINER withexposedports( ) withenv( ) withlabel( ) getcontaineripaddress() getmappedport( )

44 SPECIALISED CONTAINER Create images from Dockerfile withfilefromstring( ) withfilefromclasspath( ) Use Dockerfile DSL to define Dockerfiles in code

45 SPECIALISED void testdockerdslcontainer() { var container = new GenericContainer( new ImageFromDockerfile().withDockerfileFromBuilder(builder -> { builder.from( alpine:3.2").run("apk add --update git").cmd("git", version").build(); })).withexposedports(80); assertequals(arrays.aslist(80), container.getexposedports()); }

46 SPECIALISED CONTAINER Use database container to test database specific features No local setup or VM 100% database compatibility instead of in-memory H2 MySQL PostgreSQL Oracle XE

47 TESTCONTAINERS EXTENSION (NAIVE APPROACH) public class TestcontainersExtension implements BeforeAllCallback, AfterAllCallback { private List<Field> public void beforeall(extensioncontext context) throws Exception { // find all containers via Reflection, add them to allcontainers and iterate over them ((GenericContainer) f.get(container)).start(); // } public void afterall(extensioncontext context) throws Exception { // iterate over allcontainers and stop each container ((GenericContainer) f.get(container)).stop(); // }

48 SPECIALISED CONTAINER on class level private static PostgreSQLContainer postgres = new void testsimplesql() throws SQLException { // HikariConfig, HikariDataSource and Statement omitted statement.execute("select 1"); ResultSet resultset = statement.getresultset(); resultset.next(); assertequals(1, resultset.getint(1)); } }

49 SELENIUM WEBDRIVER CONTAINER Compatible with Selenium 2 / Webdriver tests Use of all Selenium docker images from selenium-docker project Clean and fixed environment for each browser and test Selenium API and browser compatibility assured VNC recording (optionally just failed tests)

50 SELENIUM WEBDRIVER CONTAINER on class level private BrowserWebDriverContainer chrome = new BrowserWebDriverContainer<>().withDesiredCapabilities(DesiredCapabilities.chrome()).withNetwork(Network.SHARED).withNetworkAliases("vnchost").withRecordingMode(BrowserWebDriverContainer.VncRecordingMode.SKIP, null); private VncRecordingContainer vnc = new void searchfortestcontainersongoogle() { chrome.getwebdriver().get(" chrome.getwebdriver().findelement(by.name("q")).sendkeys("testcontainers"); chrome.getwebdriver().findelement(by.name("q")).submit(); assertequals("testcontainers", driver.findelement(by.name( q")).getattribute("value")); } vnc.saverecordingtofile(new File("build/", name + testcontainers.flv ));

51 FUTURE Testcontainers 2.0 API cleanup Decoupling from JUnit 4 to support other frameworks directly

52 ALTERNATIVES TestNG Other JVM languages Groovy, Spock, Testcontainers-Spock Kotlin, Testcontainers (with workaround)

53 github.com/timriemer/jdk10_junit_testcontainers