jfx-testrunner

JUnit Testrunner for JavaFX Tests

License	The Apache Software License, Version 2.0
GroupId	de.saxsys
ArtifactId	jfx-testrunner
Last Version	1.2
Release Date	Oct 28, 2015
Type	jar
Description	jfx-testrunner JUnit Testrunner for JavaFX Tests
Project Organization	Saxonia Systems AG
Source Code Management	https://github.com/sialcasa/jfx-testrunner

Download jfx-testrunner

Filename	Size
jfx-testrunner-1.2.pom
jfx-testrunner-1.2.jar	6 KB
jfx-testrunner-1.2-sources.jar	3 KB
jfx-testrunner-1.2-javadoc.jar	36 KB

How to add to project

Apache Maven

<!-- https://jarcasting.com/artifacts/de.saxsys/jfx-testrunner/ -->
<dependency>
    <groupId>de.saxsys</groupId>
    <artifactId>jfx-testrunner</artifactId>
    <version>1.2</version>
</dependency>

Gradle Groovy

// https://jarcasting.com/artifacts/de.saxsys/jfx-testrunner/
implementation 'de.saxsys:jfx-testrunner:1.2'

Gradle Kotlin

// https://jarcasting.com/artifacts/de.saxsys/jfx-testrunner/
implementation ("de.saxsys:jfx-testrunner:1.2")

Apache Buildr

'de.saxsys:jfx-testrunner:jar:1.2'

Apache Ivy

<dependency org="de.saxsys" name="jfx-testrunner" rev="1.2">
  <artifact name="jfx-testrunner" type="jar" />
</dependency>

Groovy Grape

@Grapes(
@Grab(group='de.saxsys', module='jfx-testrunner', version='1.2')
)

Scala SBT

libraryDependencies += "de.saxsys" % "jfx-testrunner" % "1.2"

Leiningen

[de.saxsys/jfx-testrunner "1.2"]

Dependencies

compile (1)

Group / Artifact	Type	Version
junit : junit	jar	4.11

Project Modules

There are no modules declared in this project.

JavaFX JUnit-4 Testrunner

###Testrunner is going to be merged to mvvmfx### ####1.2 is the last version of testrunner - check this page in the next weeks for more information####

---

based on http://awhite.blogspot.de/2013/04/javafx-junit-testing.html - Credits to Andy White

###Maven dependency###

<dependency>
		<groupId>de.saxsys</groupId>
		<artifactId>jfx-testrunner</artifactId>
		<version>1.2</version>
</dependency>

####Use the testrunner to bootstrap JavaFX for your tests####

@RunWith(JfxRunner.class)
public class TestClass {
...
}

####Use @TestInJfxThread annotation to run specific tests in the JavaFX-thread####

@RunWith(JfxRunner.class)
public class TestClass {

    @Test
    @TestInJfxThread
    public void testWithFXThread() throws Exception {
        Assert.assertTrue(Platform.isFxApplicationThread());
    }
    
    @Test
    public void testWithFXThread() throws Exception {
        Assert.assertFalse(Platform.isFxApplicationThread());
    }
}

####Easy testing of Services with Servicewrapper####

• Allows you to wait for a Service execution
• Allows you to access the Service properties, without getting Runtime Exceptions because you accessed them from outside of the JavaFX-thread

@RunWith(JfxRunner.class)
public class TestClass {
    @Test
	public void testMultipleServiceCallsWithWrapper() throws Exception {
		
		ServiceWrapper wrapper = new ServiceWrapper(new ServiceToTest());
		wrapper.startAndWait(5000);
		
		assertEquals("I'm an expensive result 1", wrapper.getValue());
		assertEquals(1.0, wrapper.getProgress(), 1);
		assertEquals("Test", wrapper.getMessage());
		
		wrapper.reset();
		assertEquals(null, wrapper.getValue());
		assertEquals(-1, wrapper.getProgress(), 1);
		
		wrapper.startAndWait(5000);
		assertEquals("I'm an expensive result 2", wrapper.getValue());
		
		wrapper.restartAndWait(5000);
		assertEquals("I'm an expensive result 3", wrapper.getValue());
	}
}

####Advanced Testing of JavaFX Services####

• Allows you to wait for specific property values of the Service

@RunWith(JfxRunner.class)
public class TestClass {
    	@Test
	public void testMultipleServiceCallsUsingTargetValue() throws ExecutionException, InterruptedException,
			TimeoutException {
		ServiceWrapper wrapper = new ServiceWrapper(new ServiceToTest());
		
		wrapper.startAndWaitForValue(
				service::stateProperty, State.SUCCEEDED, 5000);
		assertEquals("I'm an expensive result 1", wrapper.getValue());
		
		wrapper.restartAndWaitForValue(service::stateProperty,
				State.SUCCEEDED, 5000);
		assertEquals("I'm an expensive result 2", wrapper.getValue());
		assertEquals(State.SUCCEEDED, wrapper.getState());
	}
}

Versions

Version
1.2 Oct 28, 2015
1.1 Aug 12, 2014
1.0 Jul 21, 2014