Merge branch 'develop'

Author: Gerald Unterrainer

.gitignore

@@ -22,3 +22,5 @@
 # virtual machine crash logs, see http://www.java.com/en/download/help/error_hotspot.xml
 hs_err_pid*
 /target/
+
+.settings/

.settings/org.eclipse.jdt.core.prefs

@@ -1,4 +1,5 @@
 eclipse.preferences.version=1
+org.eclipse.jdt.core.compiler.codegen.methodParameters=generate
 org.eclipse.jdt.core.compiler.codegen.targetPlatform=13
 org.eclipse.jdt.core.compiler.compliance=13
 org.eclipse.jdt.core.compiler.problem.enablePreviewFeatures=disabled

pom.xml

@@ -10,7 +10,7 @@
 
 	<modelVersion>4.0.0</modelVersion>
 	<artifactId>crontab-scheduler</artifactId>
-	<version>0.1.10</version>
+	<version>0.1.11</version>
 	<name>CrontabScheduler</name>
 	<packaging>jar</packaging>
 

src/main/java/info/unterrainer/commons/crontabscheduler/CrontabScheduler.java

@@ -20,14 +20,26 @@ public class CrontabScheduler {
 
 	protected ScheduledExecutorService executor;
 	protected Map<String, BasicCrontabHandler> registeredHandlers = new HashMap<>();
+	protected boolean handlingActive = true;
+
+	public CrontabScheduler activateHandling() {
+		handlingActive = true;
+		return this;
+	}
+
+	public CrontabScheduler deactivateHandling() {
+		handlingActive = false;
+		return this;
+	}
 
 	/**
 	 * Sets new handlers or replaces existing ones in a way that no event-trigger
 	 * gets lost.
 	 *
 	 * @param handlers the handlers to set or use to replace the old ones
+	 * @return an instance of {@link CrontabScheduler} to provide a fluent interface
 	 */
-	public synchronized void setHandlers(final Collection<BasicCrontabHandler> handlers) {
+	public synchronized CrontabScheduler setHandlers(final Collection<BasicCrontabHandler> handlers) {
 		if (handlers == null)
 			throw new NullPointerException("Specify a valid collection of handlers.");
 		for (BasicCrontabHandler handler : handlers)
@@ -38,15 +50,17 @@ public synchronized void setHandlers(final Collection<BasicCrontabHandler> handl
 		for (BasicCrontabHandler handler : handlers)
 			newMap.put(handler.getName(), handler);
 		setHandlers(newMap);
+		return this;
 	}
 
 	/**
 	 * Sets new handlers or replaces existing ones in a way that no event-trigger
 	 * gets lost.
 	 *
 	 * @param handlers the handlers to set or use to replace the old ones
+	 * @return an instance of {@link CrontabScheduler} to provide a fluent interface
 	 */
-	public synchronized void setHandlers(final Map<String, BasicCrontabHandler> handlers) {
+	public synchronized CrontabScheduler setHandlers(final Map<String, BasicCrontabHandler> handlers) {
 		ZonedDateTime now = ZonedDateTime.now();
 		if (handlers == null)
 			throw new NullPointerException("Specify a valid collection of handlers.");
@@ -65,6 +79,7 @@ public synchronized void setHandlers(final Map<String, BasicCrontabHandler> hand
 		for (BasicCrontabHandler handler : registeredHandlers.values())
 			handler.initialize(now);
 		pollAndAdvanceHandlers(now, oldMap);
+		return this;
 	}
 
 	/**
@@ -94,9 +109,10 @@ public synchronized List<BasicCrontabHandler> getCopyOfHandlers() {
 		return new ArrayList<>(registeredHandlers.values());
 	}
 
-	public synchronized void clearHandlers() {
+	public synchronized CrontabScheduler clearHandlers() {
 		log.debug("Clearing handler-map.");
 		registeredHandlers.clear();
+		return this;
 	}
 
 	@Builder
@@ -115,6 +131,10 @@ private synchronized void pollAndAdvanceHandlers(final Map<String, BasicCrontabH
 
 	private synchronized void pollAndAdvanceHandlers(final ZonedDateTime now,
 			final Map<String, BasicCrontabHandler> handlers) {
+
+		if (!handlingActive)
+			return;
+
 		for (BasicCrontabHandler handler : handlers.values())
 			try {
 				handler.eventuallyHandle(now);