Document Latest Features in README #27

Merged
kske merged 6 commits from f/improved-readme into develop 2021-11-26 13:54:58 +01:00
7 changed files with 53 additions and 22 deletions
Showing only changes of commit f620f06208 - Show all commits

View File

@ -16,7 +16,7 @@
<dependency>
<groupId>org.junit.jupiter</groupId>
<artifactId>junit-jupiter-api</artifactId>
<version>5.6.2</version>
<version>5.8.1</version>
<scope>test</scope>
</dependency>
</dependencies>
@ -26,5 +26,14 @@
<!-- Disable resource folder -->
<resources />
<!-- Run unit tests -->
<plugins>
<plugin>
<groupId>org.apache.maven.plugins</groupId>
<artifactId>maven-surefire-plugin</artifactId>
<version>3.0.0-M5</version>
</plugin>
</plugins>
</build>
</project>

View File

@ -11,7 +11,7 @@ import org.junit.jupiter.api.*;
* @author Leon Hofmeister
* @since 0.1.0
*/
class CancelTest {
public class CancelTest {
EventBus bus;
int hits;
@ -22,7 +22,7 @@ class CancelTest {
* @since 0.1.0
*/
@BeforeEach
void registerListener() {
public void registerListener() {
bus = new EventBus();
bus.registerListener(this);
}
@ -34,7 +34,7 @@ class CancelTest {
* @since 0.1.0
*/
@Test
void testCancellation() {
public void testCancellation() {
bus.dispatch(new SimpleEvent());
assertEquals(1, hits);
}

View File

@ -10,7 +10,7 @@ import org.junit.jupiter.api.Test;
* @author Kai S. K. Engelbart
* @since 1.1.0
*/
class DeadTest {
public class DeadTest {
EventBus bus = new EventBus();
String event = "This event has no handler";
@ -18,11 +18,11 @@ class DeadTest {
/**
* Tests dead event delivery.
*
*
* @since 1.1.0
*/
@Test
void testDeadEvent() {
public void testDeadEvent() {
bus.registerListener(this);
bus.dispatch(event);
assertTrue(deadEventHandled);
@ -32,11 +32,11 @@ class DeadTest {
/**
* Tests how the event bus reacts to an unhandled dead event. This should not lead to an
* exception or an endless recursion and should be logged instead.
*
*
* @since 1.1.0
*/
@Test
void testUnhandledDeadEvent() {
public void testUnhandledDeadEvent() {
bus.dispatch(event);
}

View File

@ -12,7 +12,7 @@ import org.junit.jupiter.api.*;
*/
@Polymorphic
@Priority(150)
class DispatchTest {
public class DispatchTest {
EventBus bus;
static int hits;
@ -23,7 +23,7 @@ class DispatchTest {
* @since 0.0.1
*/
@BeforeEach
void registerListener() {
public void registerListener() {
bus = new EventBus();
bus.registerListener(this);
bus.registerListener(SimpleEvent.class, e -> {
@ -39,7 +39,7 @@ class DispatchTest {
* @since 0.0.1
*/
@Test
void testDispatch() {
public void testDispatch() {
bus.dispatch(new SimpleEventSub());
bus.dispatch(new SimpleEvent());
}
@ -50,7 +50,7 @@ class DispatchTest {
* @since 1.2.0
*/
@Test
void testPrintExecutionOrder() {
public void testDebugExecutionOrder() {
String executionOrder = bus.debugExecutionOrder(SimpleEvent.class);
System.out.println(executionOrder);
assertEquals(

View File

@ -6,11 +6,11 @@ import org.junit.jupiter.api.Test;
/**
* Tests the dispatching of an exception event if an event handler threw an exception.
*
*
* @author Kai S. K. Engelbart
* @since 1.1.0
*/
class ExceptionTest {
public class ExceptionTest {
EventBus bus = new EventBus();
String event = "This event will cause an exception";
@ -19,11 +19,11 @@ class ExceptionTest {
/**
* Tests exception event delivery.
*
*
* @since 1.1.0
*/
@Test
void testExceptionEvent() {
public void testExceptionEvent() {
bus.registerListener(this);
bus.registerListener(new ExceptionListener());
bus.dispatch(event);
@ -34,11 +34,11 @@ class ExceptionTest {
/**
* Tests how the event bus reacts to an unhandled exception event. This should not lead to an
* exception or an endless recursion and should be logged instead.
*
*
* @since 1.1.0
*/
@Test
void testUnhandledExceptionEvent() {
public void testUnhandledExceptionEvent() {
bus.registerListener(this);
bus.dispatch(event);
bus.removeListener(this);

View File

@ -10,7 +10,7 @@ import org.junit.jupiter.api.*;
* @author Kai S. K. Engelbart
* @since 1.2.0
*/
class NestedTest {
public class NestedTest {
EventBus bus;
boolean nestedHit;
@ -21,7 +21,7 @@ class NestedTest {
* @since 1.2.0
*/
@BeforeEach
void registerListener() {
public void registerListener() {
bus = new EventBus();
bus.registerListener(this);
}
@ -34,7 +34,7 @@ class NestedTest {
* @since 1.2.0
*/
@Test
void testNestedDispatch() {
public void testNestedDispatch() {
bus.dispatch(new SimpleEvent());
assertTrue(nestedHit);
}

22
pom.xml
View File

@ -120,6 +120,28 @@
</goals>
</execution>
</executions>
<!-- Support JDK-style Javadoc tags -->
<configuration>
<tags>
<tag>
<name>apiNote</name>
<placement>a</placement>
<head>API Note:</head>
</tag>
<tag>
<name>implSpec</name>
<placement>a</placement>
<head>Implementation Requirements:</head>
</tag>
<tag>
<name>implNote</name>
<placement>a</placement>
<head>Implementation Note:</head>
</tag>
</tags>
</configuration>
</plugin>
<!-- GPG sign JAR -->