├── .gitignore
├── NOTICE.txt
├── src
    ├── test
    │   └── java
    │   │   └── com
    │   │       └── github
    │   │           └── victormpcmun
    │   │               └── delayedbatchexecutor
    │   │                   ├── simulator
    │   │                       ├── SimulatorUtils.java
    │   │                       ├── DBEMultipleRequestsTest.java
    │   │                       ├── DBE3Builder.java
    │   │                       └── ClientParallelRequestSimulator.java
    │   │                   └── TupleListTransposerTest.java
    └── main
    │   ├── java
    │       └── com
    │       │   └── github
    │       │       └── victormpcmun
    │       │           └── delayedbatchexecutor
    │       │               ├── TupleBlocking.java
    │       │               ├── TupleListTransposer.java
    │       │               ├── TupleMono.java
    │       │               ├── Tuple.java
    │       │               ├── TupleListDuplicatedFinder.java
    │       │               ├── TupleFuture.java
    │       │               ├── DelayedBatchExecutor2.java
    │       │               ├── DelayedBatchExecutor3.java
    │       │               ├── DelayedBatchExecutor4.java
    │       │               ├── DelayedBatchExecutor5.java
    │       │               ├── DelayedBatchExecutor6.java
    │       │               ├── DelayedBatchExecutor7.java
    │       │               └── DelayedBatchExecutor.java
    │   └── javadoc
    │       └── doc-files
    │           ├── future.xml
    │           ├── mono.xml
    │           ├── blocking.xml
    │           ├── future.svg
    │           ├── blocking.svg
    │           └── mono.svg
├── pom.xml
├── README.md
└── LICENSE.txt


/.gitignore:
--------------------------------------------------------------------------------
1 | *.iml
2 | target
3 | .idea


--------------------------------------------------------------------------------
/NOTICE.txt:
--------------------------------------------------------------------------------
1 | DelayedBatchExecutor
2 | Copyright 2019 Victor Porcar
3 | 
4 | This product includes "project reactor" software (https://projectreactor.io/).


--------------------------------------------------------------------------------
/src/test/java/com/github/victormpcmun/delayedbatchexecutor/simulator/SimulatorUtils.java:
--------------------------------------------------------------------------------
 1 | package com.github.victormpcmun.delayedbatchexecutor.simulator;
 2 | 
 3 | public class SimulatorUtils {
 4 | 
 5 |     static void sleepCurrentThread(int milliseconds) {
 6 |         try {
 7 |             Thread.sleep(milliseconds);
 8 |         } catch (InterruptedException e) {
 9 |             e.printStackTrace();
10 |             throw new RuntimeException("InterruptedException", e);
11 |         }
12 |     }
13 | 
14 | 
15 |     static String concatenateInt(long long1, int int2) {
16 |         return long1 + "_" + int2;
17 |     }
18 | }
19 | 


--------------------------------------------------------------------------------
/src/main/java/com/github/victormpcmun/delayedbatchexecutor/TupleBlocking.java:
--------------------------------------------------------------------------------
 1 | package com.github.victormpcmun.delayedbatchexecutor;
 2 | 
 3 | import java.util.concurrent.ExecutionException;
 4 | 
 5 | class TupleBlocking<T> extends TupleFuture<T> {
 6 | 
 7 | 	TupleBlocking(Object... argsAsArray) {
 8 | 		super(argsAsArray);
 9 | 	}
10 | 
11 | 	T getValueBlocking() {
12 | 		try {
13 | 			return get();
14 | 		} catch (ExecutionException e) {
15 | 			throw (RuntimeException) e.getCause();
16 | 		} catch (InterruptedException e) {
17 | 			throw new RuntimeException("Interrupted waiting.  it shouldn't happen ever", e);
18 | 		}
19 | 	}
20 | }
21 | 


--------------------------------------------------------------------------------
/src/main/java/com/github/victormpcmun/delayedbatchexecutor/TupleListTransposer.java:
--------------------------------------------------------------------------------
 1 | package com.github.victormpcmun.delayedbatchexecutor;
 2 | 
 3 | import java.util.ArrayList;
 4 | import java.util.List;
 5 | 
 6 | class TupleListTransposer {
 7 | 
 8 | 	static <T> List<List<Object>> transposeValuesAsListOfList(List<Tuple<T>> paramList) {
 9 | 		int argsCounter = paramList.get(0).getArgsSize();
10 | 		List<List<Object>> listOfListsOfArgs = buildEmptyListOfListsOfArgs(argsCounter);
11 | 		for (Tuple<?> tuple : paramList) {
12 | 			for (int argPosition = 0; argPosition < argsCounter; argPosition++) {
13 | 				Object object = tuple.getArgumentByPosition(argPosition);
14 | 				listOfListsOfArgs.get(argPosition).add(object);
15 | 			}
16 | 		}
17 | 		return listOfListsOfArgs;
18 | 	}
19 | 
20 | 	private static List<List<Object>> buildEmptyListOfListsOfArgs(int argsCounter) {
21 | 		List<List<Object>> listOfListsOfArgs = new ArrayList<>();
22 | 
23 | 		for (int argPosition = 0; argPosition < argsCounter; argPosition++) {
24 | 			listOfListsOfArgs.add(argPosition, new ArrayList<>());
25 | 		}
26 | 		return listOfListsOfArgs;
27 | 	}
28 | }
29 | 


--------------------------------------------------------------------------------
/src/main/java/com/github/victormpcmun/delayedbatchexecutor/TupleMono.java:
--------------------------------------------------------------------------------
 1 | package com.github.victormpcmun.delayedbatchexecutor;
 2 | 
 3 | import reactor.core.publisher.Mono;
 4 | 
 5 | class TupleMono<T> extends Tuple<T> {
 6 | 
 7 | 	private Mono<T> mono;
 8 | 	private boolean done;
 9 | 
10 | 	private Object locker = new Object();
11 | 
12 | 	TupleMono(Object... argsAsArray) {
13 | 		super(argsAsArray);
14 | 		this.done = false;
15 | 		this.mono = Mono.create(monoSink -> {
16 | 			if (!done) {
17 | 				try {
18 | 					// TODO: avoid this wait, any good suggestion of how to do it ?
19 | 					synchronized (locker) {
20 | 						locker.wait();
21 | 					}
22 | 				} catch (InterruptedException e) {
23 | 					throw new RuntimeException("Can not get Value from thread");
24 | 				}
25 | 			}
26 | 			if (hasRuntimeException()) {
27 | 				monoSink.error(getRuntimeException());
28 | 			} else {
29 | 				monoSink.success(result);
30 | 			}
31 | 		});
32 | 	}
33 | 
34 | 	Mono<T> getMono() {
35 | 		return mono;
36 | 	}
37 | 
38 | 	@Override
39 | 	void continueIfIsWaiting() {
40 | 		synchronized (locker) {
41 | 			this.done = true;
42 | 			locker.notify();
43 | 		}
44 | 	}
45 | }
46 | 


--------------------------------------------------------------------------------
/src/test/java/com/github/victormpcmun/delayedbatchexecutor/TupleListTransposerTest.java:
--------------------------------------------------------------------------------
 1 | package com.github.victormpcmun.delayedbatchexecutor;
 2 | 
 3 | import org.junit.Assert;
 4 | import org.junit.Test;
 5 | 
 6 | import java.util.ArrayList;
 7 | import java.util.List;
 8 | 
 9 | public class TupleListTransposerTest {
10 | 
11 | 	private static final String ARG11 = "ARG11";
12 | 	private static final String ARG12 = "ARG11";
13 | 	private static final String ARG21 = "ARG11";
14 | 	private static final String ARG22 = "ARG11";
15 | 
16 | 	@Test
17 | 	public void tupleListTest() {
18 | 		List<Tuple<Integer>> tupleList = new ArrayList<>();
19 | 		Tuple<Integer> tuple1 = new TupleFuture<>(ARG11, ARG12);
20 | 		Tuple<Integer> tuple2 = new TupleFuture<>(ARG21, ARG22);
21 | 
22 | 		tupleList.add(tuple1);
23 | 		tupleList.add(tuple2);
24 | 
25 | 		List<List<Object>> tranposedTupleAsListOfList = TupleListTransposer.transposeValuesAsListOfList(tupleList);
26 | 
27 | 		Assert.assertEquals(tranposedTupleAsListOfList.get(0).get(0), ARG11);
28 | 		Assert.assertEquals(tranposedTupleAsListOfList.get(0).get(0), ARG21);
29 | 		Assert.assertEquals(tranposedTupleAsListOfList.get(0).get(0), ARG12);
30 | 		Assert.assertEquals(tranposedTupleAsListOfList.get(0).get(0), ARG22);
31 | 	}
32 | 
33 | }
34 | 


--------------------------------------------------------------------------------
/src/main/java/com/github/victormpcmun/delayedbatchexecutor/Tuple.java:
--------------------------------------------------------------------------------
 1 | package com.github.victormpcmun.delayedbatchexecutor;
 2 | 
 3 | import java.util.Arrays;
 4 | 
 5 | abstract class Tuple<T> {
 6 | 	protected T result;
 7 | 	protected final Object[] argsAsArray;
 8 | 	protected RuntimeException runtimeException;
 9 | 	private int hashCode;
10 | 
11 | 	Tuple(Object... argsAsArray) {
12 | 		this.result = null;
13 | 		this.argsAsArray = argsAsArray;
14 | 		this.hashCode = Arrays.hashCode(argsAsArray);
15 | 
16 | 	}
17 | 
18 | 	void copyResultAndRuntimeExceptionFromTuple(Tuple<T> tuple) {
19 | 		this.result = tuple.getResult();
20 | 		this.runtimeException = tuple.getRuntimeException();
21 | 	}
22 | 
23 | 	public void setResult(T result) {
24 | 		this.result = result;
25 | 	}
26 | 
27 | 	public void setRuntimeException(RuntimeException runtimeException) {
28 | 		this.runtimeException = runtimeException;
29 | 	}
30 | 
31 | 	int getArgsSize() {
32 | 		return argsAsArray.length;
33 | 	}
34 | 
35 | 	Object getArgumentByPosition(int argPosition) {
36 | 		return argsAsArray[argPosition];
37 | 	}
38 | 
39 | 	public T getResult() {
40 | 		return result;
41 | 	}
42 | 
43 | 	abstract void continueIfIsWaiting();
44 | 
45 | 	RuntimeException getRuntimeException() {
46 | 		return runtimeException;
47 | 	}
48 | 
49 | 	boolean hasRuntimeException() {
50 | 		return runtimeException != null;
51 | 	}
52 | 
53 | 	@Override
54 | 	public boolean equals(Object o) {
55 | 		if (o == this)
56 | 			return true;
57 | 		if (!(o instanceof Tuple))
58 | 			return false;
59 | 		Tuple<?> tuple = (Tuple<?>) o;
60 | 		return Arrays.equals(argsAsArray, tuple.argsAsArray);
61 | 	}
62 | 
63 | 	@Override
64 | 	public int hashCode() {
65 | 		return hashCode;
66 | 	}
67 | }
68 | 


--------------------------------------------------------------------------------
/src/main/java/com/github/victormpcmun/delayedbatchexecutor/TupleListDuplicatedFinder.java:
--------------------------------------------------------------------------------
 1 | package com.github.victormpcmun.delayedbatchexecutor;
 2 | 
 3 | import java.util.ArrayList;
 4 | import java.util.HashMap;
 5 | import java.util.List;
 6 | import java.util.Map;
 7 | 
 8 | class TupleListDuplicatedFinder<T> {
 9 | 
10 | 	private List<Tuple<T>> allTupleList;
11 | 	private List<Tuple<T>> tupleListUnique;
12 | 	private Map<Integer, Integer> duplicatedMapIndex;
13 | 	Map<Integer, List<Integer>> hashCodeByTuplesIndexInList = new HashMap<>();
14 | 
15 | 	TupleListDuplicatedFinder(List<Tuple<T>> allTupleList) {
16 | 		this.allTupleList = allTupleList;
17 | 		duplicatedMapIndex = new HashMap<>();
18 | 		tupleListUnique = new ArrayList<>();
19 | 
20 | 		for (int index = 0; index < allTupleList.size(); index++) {
21 | 			Tuple<T> tuple = allTupleList.get(index);
22 | 			int tupleHashCode = tuple.hashCode();
23 | 			List<Integer> listOfIndexesMatchingHashCode = hashCodeByTuplesIndexInList.get(tupleHashCode);
24 | 
25 | 			if (listOfIndexesMatchingHashCode == null) {
26 | 				List<Integer> listOfIndexes = new ArrayList<>();
27 | 				listOfIndexes.add(index);
28 | 				hashCodeByTuplesIndexInList.put(tupleHashCode, listOfIndexes);
29 | 				tupleListUnique.add(tuple);
30 | 			} else {
31 | 				Integer matchingIndex = listOfIndexesMatchingHashCode.stream()
32 | 						.filter(indexInList -> tuple.equals(allTupleList.get(indexInList))).findAny().orElse(null);
33 | 				if (matchingIndex != null) {
34 | 					duplicatedMapIndex.put(index, matchingIndex);
35 | 				} else {
36 | 					listOfIndexesMatchingHashCode.add(index);
37 | 					tupleListUnique.add(tuple);
38 | 				}
39 | 			}
40 | 
41 | 		}
42 | 	}
43 | 
44 | 	List<Tuple<T>> getAllTupleList() {
45 | 		return allTupleList;
46 | 	}
47 | 
48 | 	List<Tuple<T>> getTupleListUnique() {
49 | 		return tupleListUnique;
50 | 	}
51 | 
52 | 	Map<Integer, Integer> getDuplicatedMapIndex() {
53 | 		return duplicatedMapIndex;
54 | 	}
55 | }
56 | 


--------------------------------------------------------------------------------
/src/test/java/com/github/victormpcmun/delayedbatchexecutor/simulator/DBEMultipleRequestsTest.java:
--------------------------------------------------------------------------------
 1 | package com.github.victormpcmun.delayedbatchexecutor.simulator;
 2 | 
 3 | import com.github.victormpcmun.delayedbatchexecutor.DelayedBatchExecutor3;
 4 | import org.junit.Assert;
 5 | import org.junit.Test;
 6 | 
 7 | import java.util.function.BiFunction;
 8 | 
 9 | public class DBEMultipleRequestsTest {
10 | 
11 | 	@Test
12 | 	public void manyRequestsPerSecondTest() {
13 | 		// tests parameters
14 | 		int requestsPerSecond = 200;
15 | 		int testDurationSeconds = 10;
16 | 		// delayed-batch-executor
17 | 		long dbeDurationWindowInMillis=200;
18 | 		int dbeMaxSize = 200;
19 | 		int dbeCallBackToCompleteInMillis=50;
20 | 
21 | 		launchTest(requestsPerSecond,testDurationSeconds,dbeDurationWindowInMillis,dbeMaxSize,dbeCallBackToCompleteInMillis);
22 | 
23 | 	}
24 | 
25 | 
26 | 
27 | 	private void launchTest(
28 | 			int requestsPerSecond,
29 | 			int testDurationInSeconds,
30 | 			long dbeDurationWindowInMillis,
31 | 			int dbeMaxSize,
32 | 			int msToCompleteDbeCallBack) {
33 | 
34 | 
35 | 		//-----------
36 | 
37 | 		DelayedBatchExecutor3<String, Long,Integer> dbe3 = DBE3Builder.buildDBE(dbeDurationWindowInMillis, dbeMaxSize, msToCompleteDbeCallBack);
38 | 
39 | 		BiFunction<Long,Integer,String> biFunction = (duration,maxSize) -> dbe3.execute(duration,maxSize);
40 | 
41 | 		ClientParallelRequestSimulator clientParallelRequestSimulator =  new ClientParallelRequestSimulator(
42 | 				requestsPerSecond,
43 | 				testDurationInSeconds,
44 | 				biFunction
45 | 		);
46 | 
47 | 		clientParallelRequestSimulator.go();
48 | 
49 | 		// wait two seconds to allow threads to finish
50 | 		SimulatorUtils.sleepCurrentThread((testDurationInSeconds+2)*1000);
51 | 
52 | 		Assert.assertEquals(
53 | 				clientParallelRequestSimulator.getTotalExpectedRequests(),
54 | 				clientParallelRequestSimulator.getTotalRequestsSinceBeginning());
55 | 
56 | 		clientParallelRequestSimulator.logExecutionReport();
57 | 	}
58 | 
59 | 
60 | 
61 | 
62 | }
63 | 


--------------------------------------------------------------------------------
/src/main/java/com/github/victormpcmun/delayedbatchexecutor/TupleFuture.java:
--------------------------------------------------------------------------------
 1 | package com.github.victormpcmun.delayedbatchexecutor;
 2 | 
 3 | import java.time.Duration;
 4 | import java.time.Instant;
 5 | import java.util.concurrent.ExecutionException;
 6 | import java.util.concurrent.Future;
 7 | import java.util.concurrent.TimeUnit;
 8 | import java.util.concurrent.TimeoutException;
 9 | 
10 | class TupleFuture<T> extends Tuple<T> implements Future<T> {
11 | 
12 | 	private final Instant initInstant;
13 | 	private Instant endInstant;
14 | 	private boolean done;
15 | 
16 | 	TupleFuture(Object... argsAsArray) {
17 | 		super(argsAsArray);
18 | 		this.done = false;
19 | 		this.initInstant = Instant.now();
20 | 	}
21 | 
22 | 	Future<T> getFuture() {
23 | 		return this;
24 | 	}
25 | 
26 | 	@Override
27 | 	void continueIfIsWaiting() {
28 | 		synchronized (this) {
29 | 			this.endInstant = Instant.now();
30 | 			this.done = true;
31 | 			this.notify();
32 | 		}
33 | 	}
34 | 
35 | 	@Override
36 | 	public boolean isDone() {
37 | 		return done;
38 | 	}
39 | 
40 | 	@Override
41 | 	public boolean cancel(boolean mayInterruptIfRunning) {
42 | 		return false;
43 | 	}
44 | 
45 | 	@Override
46 | 	public boolean isCancelled() {
47 | 		return false;
48 | 	}
49 | 
50 | 	@Override
51 | 	public T get() throws InterruptedException, ExecutionException {
52 | 		try {
53 | 			return get(0L);
54 | 		} catch (TimeoutException te) {
55 | 			throw new RuntimeException("This RuntimeException should never thrown at this point.", te);
56 | 		}
57 | 	}
58 | 
59 | 	@Override
60 | 	public T get(long timeout, TimeUnit unit) throws InterruptedException, ExecutionException, TimeoutException {
61 | 		long milliseconds = TimeUnit.MILLISECONDS.convert(timeout, unit);
62 | 		return get(milliseconds);
63 | 	}
64 | 
65 | 	public Duration getDelayedTime() {
66 | 		return Duration.between(initInstant, endInstant);
67 | 	}
68 | 
69 | 	private T get(long millisecondsWait) throws InterruptedException, ExecutionException, TimeoutException {
70 | 		synchronized (this) {
71 | 			if (!done) {
72 | 				if (millisecondsWait == 0L) {
73 | 					this.wait();
74 | 				} else {
75 | 					this.wait(millisecondsWait);
76 | 					if (!done) {
77 | 						throw new TimeoutException("can not get the result in " + millisecondsWait);
78 | 					}
79 | 				}
80 | 			}
81 | 		}
82 | 		if (hasRuntimeException()) {
83 | 			throw new ExecutionException(getRuntimeException());
84 | 		}
85 | 		return result;
86 | 	}
87 | }
88 | 


--------------------------------------------------------------------------------
/src/test/java/com/github/victormpcmun/delayedbatchexecutor/simulator/DBE3Builder.java:
--------------------------------------------------------------------------------
 1 | package com.github.victormpcmun.delayedbatchexecutor.simulator;
 2 | 
 3 | import org.slf4j.Logger;
 4 | import org.slf4j.LoggerFactory;
 5 | 
 6 | import java.time.Duration;
 7 | import java.util.ArrayList;
 8 | import java.util.List;
 9 | 
10 | public class DBE3Builder {
11 | 
12 | 
13 |     private static final Logger log = LoggerFactory.getLogger(DBE3Builder.class);
14 | 
15 |     public static com.github.victormpcmun.delayedbatchexecutor.DelayedBatchExecutor3<String, Long,Integer> buildDBE(
16 |             long delayedBatchExecutorWindow,
17 |             int delayedBatchExecutorMaxSize,
18 |             int msToCompleteDbeCallBack) {
19 | 
20 |         Duration delayedBatchExecutorWindowDuration = Duration.ofMillis(delayedBatchExecutorWindow);
21 | 
22 |         com.github.victormpcmun.delayedbatchexecutor.DelayedBatchExecutor3<String, Long,Integer> dbe3 = com.github.victormpcmun.delayedbatchexecutor.DelayedBatchExecutor3.create(
23 |                 delayedBatchExecutorWindowDuration,
24 |                 delayedBatchExecutorMaxSize /*,
25 | 				Executors.newFixedThreadPool(4),
26 | 				8192,
27 | 				true*/,
28 |                 (timestampLongList, threadNumberIntegerList) -> {
29 |                     long now = System.currentTimeMillis();
30 |                     SimulatorUtils.sleepCurrentThread(msToCompleteDbeCallBack);
31 | 
32 |                     long maxDurationWaiting = -1;
33 | 
34 |                     for (long timestamp:timestampLongList) {
35 |                         long duration = now - timestamp;
36 |                         if (duration>maxDurationWaiting) {
37 |                             maxDurationWaiting=duration;
38 |                         }
39 |                     }
40 | 
41 | 
42 |                     String currentThreadName = Thread.currentThread().getName();
43 | 
44 |                     log.info("DBE Callback executed in thread {}. Size of list {}. Max wait to be invoked: {} ms",
45 |                             currentThreadName,
46 |                             threadNumberIntegerList.size() ,
47 |                             maxDurationWaiting);
48 | 
49 |                     List<String> result = new ArrayList<>();
50 |                     for (int i=0; i<threadNumberIntegerList.size();i++) {
51 |                         String resultForSecondAndThread = SimulatorUtils.concatenateInt(timestampLongList.get(i), threadNumberIntegerList.get(i));
52 |                         result.add(resultForSecondAndThread);
53 |                     }
54 | 
55 |                     return result;
56 |                 });
57 | 
58 |         return dbe3;
59 | 
60 |     }
61 | }
62 | 


--------------------------------------------------------------------------------
/src/main/javadoc/doc-files/future.xml:
--------------------------------------------------------------------------------
1 | <mxfile host="app.diagrams.net" modified="2020-03-20T16:24:07.308Z" agent="Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/80.0.3987.149 Safari/537.36" etag="xgDgQ67zoh6UMPEN6fsx" version="12.8.5" type="device"><diagram name="Page-1" id="13e1069c-82ec-6db2-03f1-153e76fe0fe0">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</diagram></mxfile>


--------------------------------------------------------------------------------
/src/main/javadoc/doc-files/mono.xml:
--------------------------------------------------------------------------------
1 | <mxfile host="app.diagrams.net" modified="2020-03-20T16:24:49.007Z" agent="Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/80.0.3987.149 Safari/537.36" etag="KIYfBIyUPFY13mUgvnBT" version="12.8.5" type="device"><diagram name="Page-1" id="13e1069c-82ec-6db2-03f1-153e76fe0fe0">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</diagram></mxfile>


--------------------------------------------------------------------------------
/src/main/javadoc/doc-files/blocking.xml:
--------------------------------------------------------------------------------
1 | <mxfile host="app.diagrams.net" modified="2020-03-20T16:23:19.892Z" agent="Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/80.0.3987.149 Safari/537.36" etag="nXBMOfVbkbDFSdeFTaF5" version="12.8.5" type="device"><diagram name="Page-1" id="13e1069c-82ec-6db2-03f1-153e76fe0fe0">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</diagram></mxfile>


--------------------------------------------------------------------------------
/src/test/java/com/github/victormpcmun/delayedbatchexecutor/simulator/ClientParallelRequestSimulator.java:
--------------------------------------------------------------------------------
  1 | package com.github.victormpcmun.delayedbatchexecutor.simulator;
  2 | 
  3 | 
  4 | import org.slf4j.Logger;
  5 | import org.slf4j.LoggerFactory;
  6 | 
  7 | import java.util.*;
  8 | import java.util.concurrent.*;
  9 | import java.util.concurrent.atomic.AtomicLong;
 10 | import java.util.function.BiFunction;
 11 | 
 12 | public class ClientParallelRequestSimulator extends TimerTask {
 13 | 
 14 |     private final Logger log = LoggerFactory.getLogger(getClass());
 15 | 
 16 |     int currentSecond;
 17 | 
 18 |     int requestsPerSecond;
 19 | 
 20 |     BiFunction<Long,Integer,String> requestFunction;
 21 | 
 22 |     int testDurationInSeconds;
 23 |     int totalRequestsSinceBeginning;
 24 | 
 25 |     ExecutorService executorService;
 26 | 
 27 |     Set<String> allRequestsSet;
 28 |     AtomicLong maxTimeInFinishingCall;
 29 | 
 30 |     int totalExpectedRequests;
 31 | 
 32 |     public ClientParallelRequestSimulator(
 33 |             int requestsPerSecond,
 34 |             int testDurationInSecond,
 35 |             BiFunction<Long,Integer,String> requestFunction) {
 36 | 
 37 |         this.totalRequestsSinceBeginning =0;
 38 |         this.currentSecond =0;
 39 |         this.requestsPerSecond = requestsPerSecond;
 40 |         this.requestFunction = requestFunction;
 41 | 
 42 |         this.testDurationInSeconds=testDurationInSecond;
 43 |         this.executorService = Executors.newFixedThreadPool(10000);
 44 |         this.allRequestsSet = Collections.synchronizedSet(new HashSet<>());
 45 |         this.maxTimeInFinishingCall= new AtomicLong(-1);
 46 |         this.totalExpectedRequests = requestsPerSecond * testDurationInSeconds;
 47 |     }
 48 | 
 49 | 
 50 |     public void run() {
 51 | 
 52 |         if (currentSecond > (testDurationInSeconds-1)) {
 53 |             // do nothing
 54 |             return;
 55 |         }
 56 | 
 57 |         List<Future<Void>> threads = new ArrayList<>();
 58 |         int threadCounter;
 59 |         for (threadCounter = 0; threadCounter < requestsPerSecond; threadCounter++) {
 60 |             Callable<Void> callable = getCallableForThread(
 61 |                     threadCounter,
 62 |                     this.requestFunction,
 63 |                     this);
 64 |             threads.add(executorService.submit(callable));
 65 |         }
 66 | 
 67 |         log.info("begin second {} => created {} requests", currentSecond, threadCounter);
 68 | 
 69 |         currentSecond++;
 70 | 
 71 |     }
 72 | 
 73 |     public void go() {
 74 |         Timer timer = new Timer();
 75 |         timer.scheduleAtFixedRate(this, 0, 1000);
 76 |     }
 77 | 
 78 | 
 79 |     public Set<String> getCallsNotFinished() {
 80 |         return allRequestsSet;
 81 |     }
 82 | 
 83 | 
 84 |     private Callable<Void> getCallableForThread(
 85 |             int threadNumber,
 86 |             BiFunction<Long,Integer,String> biFunction,
 87 |             ClientParallelRequestSimulator clientParallelRequestSimulator) {
 88 |         return () -> {
 89 | 
 90 |             int delay = getRandomIntegerFromInterval(0, 999);
 91 |             SimulatorUtils.sleepCurrentThread(delay);
 92 | 
 93 |             long initTimestamp = System.currentTimeMillis();
 94 | 
 95 |             String callIdentifier = SimulatorUtils.concatenateInt(initTimestamp,threadNumber);
 96 | 
 97 |             clientParallelRequestSimulator.allRequestsSet.add(callIdentifier);
 98 |             clientParallelRequestSimulator.totalRequestsSinceBeginning++;
 99 | 
100 |             String result = biFunction.apply(initTimestamp, threadNumber);
101 | 
102 | 
103 |             clientParallelRequestSimulator.allRequestsSet.remove(callIdentifier);
104 |             long callDuration = System.currentTimeMillis() - initTimestamp;
105 | 
106 | 
107 |             if (clientParallelRequestSimulator.maxTimeInFinishingCall.longValue()<callDuration) {
108 |                 clientParallelRequestSimulator.maxTimeInFinishingCall.set(callDuration);
109 |             }
110 | 
111 | 
112 |             if (!result.equals(callIdentifier)) {
113 |                 throw new RuntimeException("Unexpected value blabla");
114 |             }
115 |             return null;
116 |         };
117 |     }
118 | 
119 | 
120 |     private Integer getRandomIntegerFromInterval(int min, int max) {
121 |         return ThreadLocalRandom.current().nextInt(min, max + 1);
122 |     }
123 | 
124 |     public void logExecutionReport() {
125 |         log.info("---------------------------------------------------");
126 | 
127 |         log.info("total expected requests: {}" , getTotalExpectedRequests());
128 |         log.info("total total Requests Since Beginning: {}" , getTotalRequestsSinceBeginning());
129 |         log.info("Calls not finished: {}" , getCallsNotFinished());
130 |         log.info("Max call duration in time {}", maxTimeInFinishingCall);
131 |     }
132 | 
133 | 
134 |     public int getTotalRequestsSinceBeginning() {
135 |         return totalRequestsSinceBeginning;
136 |     }
137 | 
138 | 
139 |     public int getTotalExpectedRequests() {
140 |         return totalExpectedRequests;
141 |     }
142 | 
143 | }
144 | 


--------------------------------------------------------------------------------
/pom.xml:
--------------------------------------------------------------------------------
  1 | <?xml version="1.0" encoding="UTF-8"?>
  2 | <project xmlns="http://maven.apache.org/POM/4.0.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd">
  3 |     <modelVersion>4.0.0</modelVersion>
  4 | 
  5 |     <groupId>com.github.victormpcmun</groupId>
  6 |     <artifactId>delayed-batch-executor</artifactId>
  7 |     <version>3.2-SNAPSHOT</version>
  8 |     <packaging>jar</packaging>
  9 | 
 10 |     <name>${project.groupId}:${project.artifactId}</name>
 11 |     <description>A component to decrease the number of required queries by batching them in Java multi-threaded applications</description>
 12 |     <url>https://github.com/victormpcmun/delayed-batch-executor</url>
 13 | 
 14 |     <licenses>
 15 |         <license>
 16 |             <name>The Apache Software License, Version 2.0</name>
 17 |             <url>http://www.apache.org/licenses/LICENSE-2.0.txt</url>
 18 |         </license>
 19 |     </licenses>
 20 | 
 21 |     <developers>
 22 |         <developer>
 23 |             <name>Victor Porcar</name>
 24 |             <email>victormpcmun@gmail.com</email>
 25 |             <organization>Victor Porcar</organization>
 26 |             <organizationUrl>https://github.com/victormpcmun</organizationUrl>
 27 |         </developer>
 28 |     </developers>
 29 | 
 30 |     <scm>
 31 |         <connection>scm:git:git://github.com/victormpcmun/delayed-batch-executor.git</connection>
 32 |         <developerConnection>scm:git:https://github.com/victormpcmun/delayed-batch-executor.git</developerConnection>
 33 |         <url>http://github.com/victormpcmun/delayed-batch-executor/tree/master</url>
 34 |         <tag>HEAD</tag>
 35 |     </scm>
 36 | 
 37 |     <distributionManagement>
 38 |         <snapshotRepository>
 39 |             <id>ossrh</id>
 40 |             <url>https://oss.sonatype.org/content/repositories/snapshots</url>
 41 |         </snapshotRepository>
 42 |         <repository>
 43 |             <id>ossrh</id>
 44 |             <url>https://oss.sonatype.org/service/local/staging/deploy/maven2/</url>
 45 |         </repository>
 46 |     </distributionManagement>
 47 | 
 48 |     <properties>
 49 |         <reactor-core.version>3.2.11.RELEASE</reactor-core.version>
 50 |         <project.build.sourceEncoding>UTF-8</project.build.sourceEncoding>
 51 |         <project.reporting.outputEncoding>UTF-8</project.reporting.outputEncoding>
 52 |     </properties>
 53 | 
 54 |     <dependencies>
 55 |         <dependency>
 56 |             <groupId>io.projectreactor</groupId>
 57 |             <artifactId>reactor-core</artifactId>
 58 |             <version>${reactor-core.version}</version>
 59 |         </dependency>
 60 | 
 61 |         <dependency>
 62 |             <groupId>junit</groupId>
 63 |             <artifactId>junit</artifactId>
 64 |             <version>4.13.1</version>
 65 |             <scope>test</scope>
 66 |         </dependency>
 67 | 
 68 |         <dependency>
 69 |             <groupId>ch.qos.logback</groupId>
 70 |             <artifactId>logback-classic</artifactId>
 71 |             <version>1.3.12</version>
 72 |         </dependency>
 73 |     </dependencies>
 74 | 
 75 |     <build>
 76 |         <plugins>
 77 |             <plugin>
 78 |                 <groupId>org.apache.maven.plugins</groupId>
 79 |                 <artifactId>maven-compiler-plugin</artifactId>
 80 |                 <version>3.8.1</version>
 81 |                 <configuration>
 82 |                     <source>1.8</source>
 83 |                     <target>1.8</target>
 84 |                 </configuration>
 85 |             </plugin>
 86 |             <plugin>
 87 |                 <groupId>org.apache.maven.plugins</groupId>
 88 |                 <artifactId>maven-javadoc-plugin</artifactId>
 89 |                 <version>3.1.1</version>
 90 |                 <configuration>
 91 |                     <show>public</show>
 92 |                     <nohelp>true</nohelp>
 93 |                 </configuration>
 94 |                 <executions>
 95 |                     <execution>
 96 |                         <id>attach-javadocs</id>
 97 |                         <goals>
 98 |                             <goal>jar</goal>
 99 |                         </goals>
100 |                     </execution>
101 |                 </executions>
102 |             </plugin>
103 |             <plugin>
104 |                 <groupId>org.apache.maven.plugins</groupId>
105 |                 <artifactId>maven-source-plugin</artifactId>
106 |                 <version>3.2.0</version>
107 |                 <executions>
108 |                     <execution>
109 |                         <id>attach-sources</id>
110 |                         <goals>
111 |                             <goal>jar</goal>
112 |                         </goals>
113 |                     </execution>
114 |                 </executions>
115 |             </plugin>
116 | 
117 |             <plugin>
118 |                 <groupId>org.apache.maven.plugins</groupId>
119 |                 <artifactId>maven-gpg-plugin</artifactId>
120 |                 <version>1.6</version>
121 |                 <executions>
122 |                     <execution>
123 |                         <id>sign-artifacts</id>
124 |                         <phase>verify</phase>
125 |                         <goals>
126 |                             <goal>sign</goal>
127 |                         </goals>
128 |                     </execution>
129 |                 </executions>
130 |             </plugin>
131 |         </plugins>
132 |     </build>
133 | </project>
134 | 


--------------------------------------------------------------------------------
/README.md:
--------------------------------------------------------------------------------
  1 | 
  2 | ## ARTICLE IN DZONE
  3 | 
  4 | https://dzone.com/articles/delayedbatchexecutor-how-to-optimize-database-usag
  5 | 
  6 | 
  7 | ## LATEST VERSION
  8 | 
  9 | https://search.maven.org/artifact/com.github.victormpcmun/delayed-batch-executor
 10 | 
 11 | ## Rationale behind of DelayeBatchExecutor
 12 | 
 13 | There are several scenarios in which concurrent threads execute many times the same query (with different parameters) to a database at almost the same time. 
 14 | 
 15 | For example, a REST endpoint serving tens or hundreds requests per second in which each one requires to retrieve a row from table by a different Id.
 16 | 
 17 | In a similar way, another typical scenario is a message listener that consumes a large number of messages per second and requires to execute a query by a different Id to process each one.
 18 | 
 19 | In these cases, the database executes many times the same query in a short interval of time (say few milliseconds) like these:
 20 | ```sql
 21 | SELECT * FROM TABLE WHERE ID   = <id1>
 22 | SELECT * FROM TABLE WHERE ID   = <id2>
 23 | ...
 24 | SELECT * FROM TABLE WHERE ID   = <idn>
 25 | ```
 26 | DelayedBatchExecutor is a component that allows easily to *convert* these n queries of 1 parameter into just one single query with n parameters, like this one:
 27 | 
 28 | ```sql
 29 | SELECT * FROM TABLE WHERE ID IN (<id1>, <id2>, ..., <idn>)
 30 | ```
 31 | 
 32 | The advantages of executing one query with n parameters instead of n queries of 1 parameter are the following:
 33 | 
 34 | * The usage of network resources is reduced dramatically: The number of round-trips to the database is 1 instead of n.
 35 | 
 36 | * Optimization of database server resources: you would be surprised how well databases optimize queries of n parameters. Pick any large table of your schema and analyse the execution time and CPU usage a for a single query of n parameters versus n queries of 1 parameter.
 37 | 
 38 | * The usage of database connections from the connection pool is reduced: there are more available connections overall, which means less waiting time for a connection on peak times.
 39 | 
 40 | In short, it is much more efficient executing 1 query of n parameters than n queries of one parameter, which means that the system as a whole requires less resources.
 41 | 
 42 | ## DelayedBatchExecutor In Action
 43 | 
 44 | It basically works by creating *time windows* where the parameters of the queries executed during the *time window* are collected in a list. 
 45 | As soon as the *time window* finishes, the list is passed (via callback) to a method that executes one single query with all the parameters in the list and returns another list with the results. Each thread receives their corresponding result from the result list according to one of the following policies as explained below: blocking , non-blocking (Future) and non-blocking (Reactive).
 46 | 
 47 | A DelayedBatchExecutor is defined by three parameters:
 48 |  
 49 |  * TimeWindow: defined as java.time.Duration
 50 |  * max size: it is the max number of items to be collected in the list
 51 |  * batchCallback: it receives the parameters list to perform a single query and must return a list with the corresponding results. 
 52 |     - It can be implemented as method reference or lambda expression.
 53 |     - It is invoked automatically as soon as the TimeWindow is finished OR the collection list is full. 
 54 |     - The returned list must have a correspondence in elements with the parameters list, this means that the value of position 0 of the returned list must be the one corresponding to parameter in position 0 of the param list and so on...
 55 |     - By default, duplicated parameters (by [hashCode](https://docs.oracle.com/javase/8/docs/api/java/lang/Object.html#hashCode--) and [equals](https://docs.oracle.com/javase/8/docs/api/java/lang/Object.html#equals-java.lang.Object-)) are removed from the parameters list automatically. This is optimal in most cases although there is a way for having all parameters (including duplicates) if it is required (See Advanced Usage)
 56 | 	
 57 |   Now, Let's define a DelayedBatchExecutor to receive an Integer value as parameter and return a String, and having a time window = 50 milliseconds, a max size = 100 elements and having the batchCallback defined as method reference: 
 58 |   
 59 |   ```java
 60 | DelayedBatchExecutor2<String,Integer> dbe = DelayedBatchExecutor2.create(Duration.ofMillis(50), 100, this::myBatchCallBack);
 61 |   
 62 | ...
 63 |   
 64 | List<String> myBatchCallBack(List<Integer> listOfIntegers) {
 65 | 	List<String>  resultList = ...// execute query:SELECT * FROM TABKE WHERE ID IN (listOfIntegers.get(0), ..., listOfIntegers.get(n));
 66 |                                 // use your favourite API: JDBC, JPA, Hibernate,...
 67 |   	...
 68 |   	return resultList;
 69 | }
 70 | ```
 71 | 
 72 | The same DelayedBatchExecutor2 but having the callback defined as lambda expression would be:
 73 | 
 74 | ```java
 75 | DelayedBatchExecutor2<String,Integer> dbe = DelayedBatchExecutor2.create(Duration.ofMillis(50), 100, listOfIntegers-> 
 76 | {
 77 |   List<String>  resultList = ...// execute query:SELECT * FROM TABLE WHERE ID IN (listOfIntegers.get(0), ..., listOfIntegers.get(n));
 78 |                                 // use your favourite API: JDBC, JPA, Hibernate,...
 79 |   ...
 80 |   return resultList;
 81 |   
 82 |  });
 83 |   ``` 
 84 | NOTE: the instance `dbe` must be accesible from the code being executed by the threads (it is often declared as instance variable of a singleton DAO).
 85 | Once defined the DelayedBatchExecutor instance, it is easy to use it from the code executed in each thread
 86 | 
 87 |   ```java
 88 | // this code is executed in one of the multiple threads
 89 | int param=...;
 90 | String result = dbe.execute(param); // all the threads executing this code within a interval of 50 ms will have 
 91 | 			            // their parameters (an integer value) collected in a list (list of integers) 
 92 | 				    // that will be passed to the callback method, and from the list returned from this
 93 | 				    // method, each thread will receive its corresponding value
 94 | 				    // all this managed behind the scenes by the DelayedBatchExecutor
 95 | }
 96 | ```
 97 | NOTE:
 98 | - To create a DelayedBatchExecutor for taking more than one argument see FootNote 1
 99 | - In the example above, the thread is stopped when the execute(...) method is executed until the result is available (blocking behaviour). This is one of the three execution policies of the DelayedBatchExecutor
100 | 
101 | 
102 | ### Execution Policies
103 | 
104 | There are three policies to use a DelayedBatchExecutor from the code being executed from the threads
105 | 
106 | #### Blocking
107 | 
108 | The thread is blocked until the result is available, it is implemented by using the method `execute(...)`
109 |  
110 | ```java 
111 |     int param = ...
112 | 	...
113 |     String result = dbe.execute(param); // this thread will be blocked until the result is available
114 |     // compute with result
115 | ```
116 | The following diagram depicts how blocking policy works:
117 | 
118 | ![Blocking image](/src/main/javadoc/doc-files/blocking.svg)
119 | 
120 | 
121 | #### Non-blocking (java.util.concurrent.Future)
122 | 
123 | The thread is not blocked, it is implemented by using the method `executeAsFuture(...)`
124 | 
125 | ```java 
126 |     int param = ...
127 |        ...	
128 |     Future<String> resultFuture = dbe.executeAsFuture(param); // the thread will not  be blocked
129 |     // compute something else
130 |     String result = resultFuture.get();  // Blocks the thread until the result is available (if necessary)
131 |     // compute with result
132 | ```
133 | 
134 | The following diagram depicts how Future policy works:
135 | 
136 | ![Future image](/src/main/javadoc/doc-files/future.svg)
137 | 
138 | 
139 | #### Non-blocking (Reactive using Reactor framework):
140 |  
141 |  The thread is not blocked, it is implemented by using the method `executeAsMono(...)`
142 |  
143 | ```java 
144 |     int param =...
145 |        ...
146 |     reactor.core.publisher.Mono<String> resultMono = dbe.executeAsMono(param); // the thread will not  be blocked
147 |     // compute something else
148 |     resultMono.subscribe(stringResult -> {
149 |          // compute with stringResult
150 |       });
151 | ```
152 | The following diagram depicts how Reactive policy works:
153 | 
154 | ![Reactive image](/src/main/javadoc/doc-files/mono.svg)
155 | 
156 | ### Advanced Usage
157 | 
158 | There are three parameters of a DelayedBatchExecutor that must be known to get the most of it:
159 | 
160 | - ExecutorService: the callback method is actually executed in a parallel thread, which is provided by an java.util.concurrent.ExecutorService. By default this Executor is `Executors.newFixedThreadPool(4)`.
161 | 
162 | - bufferQueueSize: it is the max size of the internal list, by default its value is 8192.
163 | 
164 | - removeDuplicates: if false, then DelayedBatchExecutor won't removed all duplicated parameters from the parameters list before invoking the batchCallback. By default its value is true.
165 | 
166 | These parameters can be set by using the following constructor:
167 | 
168 | ```java
169 | ... 
170 | int maxSize=20;
171 | ExecutorService executorService= Executors.newFixedThreadPool(10);
172 | int bufferQueueSize= 16384;
173 | boolean removeDuplicates = false;
174 |   
175 | DelayedBatchExecutor2<Integer,String> dbe = DelayedBatchExecutor2.create(
176 |     Duration.ofMillis(200), 
177 |     maxSize,
178 |     executorService,
179 |     bufferQueueSize,
180 |     removeDuplicates,
181 |     this::myBatchCallBack);
182 | ```
183 |  At any time, the configuration paramaters can be updated by using this thread safe method
184 |  
185 | ```java
186 | ...
187 | dbe.updateConfig(
188 |     Duration.ofMillis(200), 
189 |     maxSize,
190 |     executorService,
191 |     bufferQueueSize,
192 |     removeDuplicates,
193 |     this::myBatchCallBack);
194 |  ```
195 | 
196 | -----
197 | -Foot Note 1:  The example shows a DelayedBatchExecutor for a parameter of type Integer and a return type of String, hence DelayedBatchExecutor2<String,Integer>
198 | 
199 | For a DelayedBatchExecutor for two parameters (say Integer and Date) and a returning type String, the definition would be:
200 | DelayedBatchExecutor3<String,Integer,Date> and so on...
201 | 


--------------------------------------------------------------------------------
/src/main/java/com/github/victormpcmun/delayedbatchexecutor/DelayedBatchExecutor2.java:
--------------------------------------------------------------------------------
  1 | package com.github.victormpcmun.delayedbatchexecutor;
  2 | 
  3 | import reactor.core.publisher.Mono;
  4 | 
  5 | import java.time.Duration;
  6 | import java.util.List;
  7 | import java.util.concurrent.ExecutionException;
  8 | import java.util.concurrent.ExecutorService;
  9 | import java.util.concurrent.Future;
 10 | 
 11 | /**
 12 |  * Delayed Batch Executor for one argument of type A and return type Z <br>
 13 |  * 
 14 |  * <pre>
 15 |  * {@code
 16 |  * DelayedBatchExecutor2<String,Integer> dbe = DelayedBatchExecutor2.create(Duration.ofMillis(50), 10, this::myBatchCallback);
 17 |  *
 18 |  * ...
 19 |  *
 20 |  * public void usingDelayedBatchExecutor(Integer param1) {
 21 |  *
 22 |  *    // using blocking behaviour
 23 |  *    String stringResult1 = dbe.execute(param1); // the thread will be blocked until the result is available
 24 |  *    // compute with stringResult1
 25 |  *
 26 |  *
 27 |  *    // using Future
 28 |  *    Future<String> resultAsFutureString = dbe.executeAsFuture(param1); // the thread will not  be blocked
 29 |  *    // compute something else
 30 |  *    String stringResult2 = resultAsFutureString.get();  // Blocks the thread if necessary for the computation to complete, and then retrieves its result.
 31 |  *    // compute with stringResult2
 32 |  *
 33 |  *
 34 |  *    // using Mono
 35 |  *    Mono<String> monoResult = dbe.executeAsMono(param1); // the thread will not  be blocked
 36 |  *    // compute something else
 37 |  *    monoResult.subscribe(stringResult3 -> {
 38 |  *     // compute with stringResult
 39 |  *    });
 40 |  *
 41 |  * }
 42 |  *
 43 |  * ...
 44 |  *
 45 |  * List<String> myBatchCallback(List<Integer> arg1List) {
 46 |  *   List<String> result = ...
 47 |  *   ...
 48 |  *   return result;
 49 |  *}
 50 |  *}
 51 |  * </pre>
 52 |  * 
 53 |  * @author Victor Porcar
 54 |  *
 55 |  */
 56 | 
 57 | public class DelayedBatchExecutor2<Z, A> extends DelayedBatchExecutor<Z> {
 58 | 
 59 | 	/**
 60 | 	 * Receive as argument a List of type A and returns a List of type Z. It can be
 61 | 	 * implemented as a lambda expression or method reference <br>
 62 | 	 * <br>
 63 | 	 * 
 64 | 	 * <pre>
 65 | 	 * <b>Lambda expression</b>
 66 | 	 * {@code
 67 | 	 * DelayedBatchExecutor2<String,Integer> dbe = DelayedBatchExecutor2.create(Duration.ofMillis(50), 10, arg1List ->
 68 | 	 * {
 69 | 	 *      //arg1List is a List<Integer>
 70 | 	 *      List<String> result = ...
 71 | 	 *	    ...
 72 | 	 *      return result;
 73 | 	 *});
 74 | 	 *}
 75 | 	 * <b>Method reference</b>
 76 | 	 * {@code
 77 | 	 * DelayedBatchExecutor2<Integer,String> dbe = DelayedBatchExecutor2.create(Duration.ofMillis(50), 10, this::myBatchCallBack);
 78 | 	 * ...
 79 | 	 * List<String> myBatchCallBack(List<Integer> arg1List) {
 80 | 	 *      List<String> result = ...
 81 | 	 *	    ...
 82 | 	 *      return result;
 83 | 	 *}
 84 | 	 *}
 85 | 	 * </pre>
 86 | 	 * 
 87 | 	 * @author Victor Porcar
 88 | 	 *
 89 | 	 */
 90 | 	@FunctionalInterface
 91 | 	public interface BatchCallBack2<Z, A> {
 92 | 		List<Z> apply(List<A> firstParam);
 93 | 	}
 94 | 
 95 | 	private final BatchCallBack2<Z, A> batchCallBack;
 96 | 
 97 | 	/**
 98 | 	 * Factory method to create an instance of a Delayed Batch Executor for one
 99 | 	 * argument of type A and return type Z. Similar to
100 | 	 * {@link DelayedBatchExecutor2#create(Duration, int, ExecutorService, int, boolean, BatchCallBack2)}
101 | 	 * defaulting to: <br>
102 | 	 * <br>
103 | 	 * -executorService: the one returned by static method
104 | 	 * {@link #getDefaultExecutorService()} <br>
105 | 	 * -bufferQueueSize: the value of constant {@link #DEFAULT_BUFFER_QUEUE_SIZE}
106 | 	 * <br>
107 | 	 * -removeDuplicates:true <br>
108 | 	 * 
109 | 	 * @param <Z>            the return type
110 | 	 * @param <A>            the type of the argument
111 | 	 * @param duration       the time window, defined as {@link Duration }.
112 | 	 * @param size           the max collected size. As soon as the count of
113 | 	 *                       collected parameters reaches this size, the
114 | 	 *                       batchCallBack method is executed
115 | 	 * @param batchCallback2 the method reference or lambda expression that receives
116 | 	 *                       a list of type A and returns a list of Type Z (see
117 | 	 *                       {@link BatchCallBack2})
118 | 	 * @return an instance of {@link DelayedBatchExecutor2}
119 | 	 *
120 | 	 */
121 | 
122 | 	public static <Z, A> DelayedBatchExecutor2<Z, A> create(Duration duration, int size,
123 | 			BatchCallBack2<Z, A> batchCallback2) {
124 | 		return new DelayedBatchExecutor2<>(duration, size, null, DEFAULT_BUFFER_QUEUE_SIZE, true, batchCallback2);
125 | 	}
126 | 
127 | 	/**
128 | 	 * Factory method to create an instance of a Delayed Batch Executor for one
129 | 	 * argument of type A and return type Z <br>
130 | 	 * 
131 | 	 * @param <Z>              the return type
132 | 	 * @param <A>              the type of the argument
133 | 	 * @param duration         the time window, defined as {@link Duration }.
134 | 	 * @param size             the max collected size. As soon as the count of
135 | 	 *                         collected parameters reaches this size, the
136 | 	 *                         batchCallBack method is executed
137 | 	 * @param executorService  to define the pool of threads to executed the
138 | 	 *                         batchCallBack method in asynchronous mode
139 | 	 * @param bufferQueueSize  max size of the internal queue to buffer values
140 | 	 * @param removeDuplicates if true then duplicated arguments from execute*(...)
141 | 	 *                         methods are not passed to the batchCallBack
142 | 	 *                         (considering same {@link Object#hashCode()} and being
143 | 	 *                         {@link Object#equals(Object)})
144 | 	 * @param batchCallback2   the method reference or lambda expression that
145 | 	 *                         receives a list of type A and returns a list of Type
146 | 	 *                         Z (see {@link BatchCallBack2})
147 | 	 * @return an instance of {@link DelayedBatchExecutor2}
148 | 	 *
149 | 	 */
150 | 
151 | 	public static <Z, A> DelayedBatchExecutor2<Z, A> create(Duration duration, int size,
152 | 			ExecutorService executorService, int bufferQueueSize, boolean removeDuplicates,
153 | 			BatchCallBack2<Z, A> batchCallback2) {
154 | 		return new DelayedBatchExecutor2<>(duration, size, executorService, bufferQueueSize, removeDuplicates,
155 | 				batchCallback2);
156 | 	}
157 | 
158 | 	private DelayedBatchExecutor2(Duration duration, int size, ExecutorService executorService, int bufferQueueSize,
159 | 			boolean removeDuplicates, BatchCallBack2<Z, A> batchCallBack) {
160 | 		super(duration, size, executorService, bufferQueueSize, removeDuplicates);
161 | 		this.batchCallBack = batchCallBack;
162 | 	}
163 | 
164 | 	/**
165 | 	 * Return the result of type Z (blocking the thread until the result is
166 | 	 * available), which is obtained from the returned list of the batchCallBack
167 | 	 * method for the given argument <br>
168 | 	 * <br>
169 | 	 * It will throw any {@link RuntimeException} thrown inside of the
170 | 	 * {@link BatchCallBack2 } <br>
171 | 	 * It will throw a {@link RuntimeException} if the internal buffer Queue of this
172 | 	 * Delayed Batch Executor is full. <br>
173 | 	 * <br>
174 | 	 * <img src="{@docRoot}/doc-files/blocking.svg" alt="blocking">
175 | 	 * 
176 | 	 * @param arg1 value of the argument of type A defined for this Delayed Batch
177 | 	 *             Executor
178 | 	 * @return the result of type Z
179 | 	 *
180 | 	 *
181 | 	 */
182 | 	public Z execute(A arg1) {
183 | 		TupleBlocking<Z> tupleBlocking = new TupleBlocking<>(arg1);
184 | 		enlistTuple(tupleBlocking);
185 | 		Z value = tupleBlocking.getValueBlocking();
186 | 		return value;
187 | 	}
188 | 
189 | 	/**
190 | 	 * Return a {@link Future } containing the corresponding value from the returned
191 | 	 * list of the batchCallBack method for the given argument <br>
192 | 	 * <br>
193 | 	 * The invoking thread is not blocked. The result will be available by invoking
194 | 	 * method {@link Future#get()} of the {@link Future }. This method will block
195 | 	 * the thread until the result is available <br>
196 | 	 * <br>
197 | 	 * <img src="{@docRoot}/doc-files/future.svg" alt ="future"> <br>
198 | 	 * It will throw a {@link RuntimeException} if the internal buffer Queue of this
199 | 	 * Delayed Batch Executor is full. <br>
200 | 	 * If a {@link RuntimeException} is thrown inside of the {@link BatchCallBack2
201 | 	 * }, then it will be the cause of the checked Exception
202 | 	 * {@link ExecutionException} thrown by {@link Future#get()} as per contract of
203 | 	 * {@link Future#get()} <br>
204 | 	 * <br>
205 | 	 * 
206 | 	 * @param arg1 value of the argument of type A defined for this Delayed Batch
207 | 	 *             Executor
208 | 	 * @return a {@link Future } for the result of type Z
209 | 	 *
210 | 	 */
211 | 	public Future<Z> executeAsFuture(A arg1) {
212 | 		TupleFuture<Z> tupleFuture = new TupleFuture<>(arg1);
213 | 		enlistTuple(tupleFuture);
214 | 		Future<Z> future = tupleFuture.getFuture();
215 | 		return future;
216 | 	}
217 | 
218 | 	/**
219 | 	 * Return a <a href=
220 | 	 * "https://projectreactor.io/docs/core/release/api/reactor/core/publisher/Mono.html">Mono</a>,
221 | 	 * publishing the value obtained from the returned list of the batchCallBack
222 | 	 * method for the given parameter. <br>
223 | 	 * <br>
224 | 	 * The invoking thread is not blocked <br>
225 | 	 * <br>
226 | 	 * <img src="{@docRoot}/doc-files/mono.svg" alt="mono"> <br>
227 | 	 * It will throw a {@link RuntimeException} if the internal buffer Queue of this
228 | 	 * Delayed Batch Executor is full. <br>
229 | 	 * If a {@link RuntimeException} is thrown inside of the {@link BatchCallBack2
230 | 	 * }, then it will be the propagated as any {@link RuntimeException } thrown
231 | 	 * from <a href=
232 | 	 * "https://projectreactor.io/docs/core/release/api/reactor/core/publisher/Mono.html">Mono</a>
233 | 	 * <br>
234 | 	 * <br>
235 | 	 * 
236 | 	 * @param arg1 value of the argument of type A defined for this Delayed Batch
237 | 	 *             Executor
238 | 	 * @return a <a href=
239 | 	 *         "https://projectreactor.io/docs/core/release/api/reactor/core/publisher/Mono.html">Mono</a>
240 | 	 *         for the result of type Z
241 | 	 *
242 | 	 *
243 | 	 */
244 | 	public Mono<Z> executeAsMono(A arg1) {
245 | 		TupleMono<Z> tupleMono = new TupleMono<>(arg1);
246 | 		enlistTuple(tupleMono);
247 | 		Mono<Z> mono = tupleMono.getMono();
248 | 		return mono;
249 | 	}
250 | 
251 | 	@SuppressWarnings("unchecked")
252 | 	@Override
253 | 	protected List<Z> getResultListFromBatchCallBack(List<List<Object>> transposedTupleList) {
254 | 		return batchCallBack.apply((List<A>) transposedTupleList.get(0));
255 | 	}
256 | }


--------------------------------------------------------------------------------
/src/main/java/com/github/victormpcmun/delayedbatchexecutor/DelayedBatchExecutor3.java:
--------------------------------------------------------------------------------
  1 | package com.github.victormpcmun.delayedbatchexecutor;
  2 | 
  3 | import reactor.core.publisher.Mono;
  4 | 
  5 | import java.time.Duration;
  6 | import java.util.List;
  7 | import java.util.concurrent.ExecutionException;
  8 | import java.util.concurrent.ExecutorService;
  9 | import java.util.concurrent.Future;
 10 | 
 11 | /**
 12 |  * Delayed Batch Executor for two arguments (of types A and B) and return type Z
 13 |  * <br>
 14 |  * 
 15 |  * <pre>
 16 |  * {@code
 17 |  * DelayedBatchExecutor3<String,Integer,Integer> dbe = DelayedBatchExecutor3.create(Duration.ofMillis(50), 10, this::myBatchCallback);
 18 |  *
 19 |  * ...
 20 |  *
 21 |  * public void usingDelayedBatchExecutor(Integer param1, Integer param2) {
 22 |  *
 23 |  *    // using blocking behaviour
 24 |  *    String stringResult1 = dbe.execute(param1, param2); // the thread will be blocked until the result is available
 25 |  *    // compute with stringResult1
 26 |  *
 27 |  *
 28 |  *    // using Future
 29 |  *    Future<String> resultAsFutureString = dbe.executeAsFuture(param1, param2); // the thread will not  be blocked
 30 |  *    // compute something else
 31 |  *    String stringResult2 = resultAsFutureString.get();  // Blocks the thread if necessary for the computation to complete, and then retrieves its result.
 32 |  *    // compute with stringResult2
 33 |  *
 34 |  *
 35 |  *    // using Mono
 36 |  *    Mono<String> monoResult = dbe.executeAsMono(param1, param2); // the thread will not  be blocked
 37 |  *    // compute something else
 38 |  *    monoResult.subscribe(stringResult3 -> {
 39 |  *     // compute with stringResult
 40 |  *    });
 41 |  * }
 42 |  *
 43 |  * ...
 44 |  *
 45 |  * List<String> myBatchCallback(List<Integer> arg1List, List<Integer> arg2List) {
 46 |  *   List<String> result = ...
 47 |  *   ...
 48 |  *   return result;
 49 |  *}
 50 |  *}
 51 |  * </pre>
 52 |  * 
 53 |  * @author Victor Porcar
 54 |  *
 55 |  */
 56 | public class DelayedBatchExecutor3<Z, A, B> extends DelayedBatchExecutor<Z> {
 57 | 
 58 | 	/**
 59 | 	 * Receive as argument two Lists of type A and B and returns a List of type Z.
 60 | 	 * It can be implemented as a lambda expression or method reference <br>
 61 | 	 * <br>
 62 | 	 * 
 63 | 	 * <pre>
 64 | 	 * <b>Lambda expression</b>
 65 | 	 * {@code
 66 | 	 * DelayedBatchExecutor3<String,Integer,Integer> dbe = DelayedBatchExecutor3.create(Duration.ofMillis(50), 10, (arg1List, arg2List) ->
 67 | 	 * {
 68 | 	 *      //arg1List and arg2List are List<Integer>
 69 | 	 *      List<String> result = ...
 70 | 	 *	    ...
 71 | 	 *      return result;
 72 | 	 *});
 73 | 	 *}
 74 | 	 * <b>Method reference</b>
 75 | 	 * {@code
 76 | 	 * DelayedBatchExecutor3<String,Integer,Integer> dbe = DelayedBatchExecutor3.create(Duration.ofMillis(50), 10, this::myBatchCallBack);
 77 | 	 * ...
 78 | 	 * List<String> myBatchCallBack(List<Integer> arg1List, List<Integer> arg2List) {
 79 | 	 *      List<String> result = ...
 80 | 	 *	    ...
 81 | 	 *      return result;
 82 | 	 *}
 83 | 	 *}
 84 | 	 * </pre>
 85 | 	 * 
 86 | 	 * @author Victor Porcar
 87 | 	 *
 88 | 	 */
 89 | 	@FunctionalInterface
 90 | 	public interface BatchCallBack3<Z, A, B> {
 91 | 		List<Z> apply(List<A> firstParam, List<B> secondParam);
 92 | 	}
 93 | 
 94 | 	private final BatchCallBack3<Z, A, B> batchCallBack;
 95 | 
 96 | 	/**
 97 | 	 * Factory method to create an instance of a Delayed Batch Executor for two
 98 | 	 * arguments (of types A and B) and return type Z. Similar to
 99 | 	 * {@link DelayedBatchExecutor3#create(Duration, int, ExecutorService, int, boolean, BatchCallBack3)}
100 | 	 * defaulting to: <br>
101 | 	 * <br>
102 | 	 * -executorService: the one returned by static method
103 | 	 * {@link #getDefaultExecutorService()} <br>
104 | 	 * -bufferQueueSize: the value of constant {@link #DEFAULT_BUFFER_QUEUE_SIZE}
105 | 	 * <br>
106 | 	 * -removeDuplicates:true <br>
107 | 	 * 
108 | 	 * @param <Z>            the return type
109 | 	 * @param <A>            the type of the first argument
110 | 	 * @param <B>            the type of the second argument
111 | 	 * @param duration       the time window, defined as {@link Duration }.
112 | 	 * @param size           the max collected size. As soon as the count of
113 | 	 *                       collected parameters reaches this size, the
114 | 	 *                       batchCallBack method is executed
115 | 	 * @param batchCallback3 the method reference or lambda expression that receives
116 | 	 *                       a list of type A and returns a list of Type Z (see
117 | 	 *                       {@link BatchCallBack3})
118 | 	 * @return an instance of {@link DelayedBatchExecutor3}
119 | 	 *
120 | 	 */
121 | 
122 | 	public static <Z, A, B> DelayedBatchExecutor3<Z, A, B> create(Duration duration, int size,
123 | 			BatchCallBack3<Z, A, B> batchCallback3) {
124 | 		return new DelayedBatchExecutor3<>(duration, size, null, DEFAULT_BUFFER_QUEUE_SIZE, true, batchCallback3);
125 | 	}
126 | 
127 | 	/**
128 | 	 * Factory method to create an instance of a Delayed Batch Executor for two
129 | 	 * arguments (of types A and B) and return type Z <br>
130 | 	 * 
131 | 	 * @param <Z>              the return type
132 | 	 * @param <A>              the type of the first argument
133 | 	 * @param <B>              the type of the second argument
134 | 	 * @param duration         the time window, defined as {@link Duration }.
135 | 	 * @param size             the max collected size. As soon as the count of
136 | 	 *                         collected parameters reaches this size, the
137 | 	 *                         batchCallBack method is executed
138 | 	 * @param executorService  to define the pool of threads to executed the
139 | 	 *                         batchCallBack method in asynchronous mode
140 | 	 * @param bufferQueueSize  max size of the internal queue to buffer values
141 | 	 * @param removeDuplicates if true then duplicated arguments from execute*(...)
142 | 	 *                         methods are not passed to the batchCallBack
143 | 	 *                         (considering same {@link Object#hashCode()} and being
144 | 	 *                         {@link Object#equals(Object)})
145 | 	 * @param batchCallback3   the method reference or lambda expression that
146 | 	 *                         receives a list of type A and returns a list of Type
147 | 	 *                         Z (see {@link BatchCallBack3})
148 | 	 * @return an instance of {@link DelayedBatchExecutor3}
149 | 	 *
150 | 	 */
151 | 
152 | 	public static <Z, A, B> DelayedBatchExecutor3<Z, A, B> create(Duration duration, int size,
153 | 			ExecutorService executorService, int bufferQueueSize, boolean removeDuplicates,
154 | 			BatchCallBack3<Z, A, B> batchCallback3) {
155 | 		return new DelayedBatchExecutor3<>(duration, size, executorService, bufferQueueSize, removeDuplicates,
156 | 				batchCallback3);
157 | 	}
158 | 
159 | 	private DelayedBatchExecutor3(Duration duration, int size, ExecutorService executorService, int bufferQueueSize,
160 | 			boolean removeDuplicates, BatchCallBack3<Z, A, B> batchCallBack) {
161 | 		super(duration, size, executorService, bufferQueueSize, removeDuplicates);
162 | 		this.batchCallBack = batchCallBack;
163 | 	}
164 | 
165 | 	/**
166 | 	 * Return the result of type Z (blocking the thread until the result is
167 | 	 * available), which is obtained from the returned list of the batchCallBack
168 | 	 * method for the given argument <br>
169 | 	 * <br>
170 | 	 * It will throw any {@link RuntimeException} thrown inside of the
171 | 	 * {@link BatchCallBack3 } <br>
172 | 	 * It will throw a {@link RuntimeException} if the internal buffer Queue of this
173 | 	 * Delayed Batch Executor is full. <br>
174 | 	 * <br>
175 | 	 * <img src="{@docRoot}/doc-files/blocking.svg" alt="blocking">
176 | 	 * 
177 | 	 * @param arg1 value of the first argument of type A defined for this Delayed
178 | 	 *             Batch Executor
179 | 	 * @param arg2 value of the second argument of type B defined for this Delayed
180 | 	 *             Batch Executor
181 | 	 * @return the result of type Z
182 | 	 *
183 | 	 *
184 | 	 */
185 | 	public Z execute(A arg1, B arg2) {
186 | 		TupleBlocking<Z> tupleBlocking = new TupleBlocking<>(arg1, arg2);
187 | 		enlistTuple(tupleBlocking);
188 | 		Z value = tupleBlocking.getValueBlocking();
189 | 		return value;
190 | 	}
191 | 
192 | 	/**
193 | 	 * Return a {@link Future } containing the corresponding value from the returned
194 | 	 * list of the batchCallBack method for the given argument <br>
195 | 	 * <br>
196 | 	 * The invoking thread is not blocked. The result will be available by invoking
197 | 	 * method {@link Future#get()} of the {@link Future }. This method will block
198 | 	 * the thread until the result is available <br>
199 | 	 * <br>
200 | 	 * <img src="{@docRoot}/doc-files/future.svg" alt ="future"> <br>
201 | 	 * It will throw a {@link RuntimeException} if the internal buffer Queue of this
202 | 	 * Delayed Batch Executor is full. <br>
203 | 	 * If a {@link RuntimeException} is thrown inside of the {@link BatchCallBack3
204 | 	 * }, then it will be the cause of the checked Exception
205 | 	 * {@link ExecutionException} thrown by {@link Future#get()} as per contract of
206 | 	 * {@link Future#get()} <br>
207 | 	 * <br>
208 | 	 * 
209 | 	 * @param arg1 value of the first argument of type A defined for this Delayed
210 | 	 *             Batch Executor
211 | 	 * @param arg2 value of the second argument of type B defined for this Delayed
212 | 	 *             Batch Executor
213 | 	 * @return a {@link Future } for the result of type Z
214 | 	 *
215 | 	 */
216 | 	public Future<Z> executeAsFuture(A arg1, B arg2) {
217 | 		TupleFuture<Z> tupleFuture = new TupleFuture<>(arg1, arg2);
218 | 		enlistTuple(tupleFuture);
219 | 		Future<Z> future = tupleFuture.getFuture();
220 | 		return future;
221 | 	}
222 | 
223 | 	/**
224 | 	 * Return a <a href=
225 | 	 * "https://projectreactor.io/docs/core/release/api/reactor/core/publisher/Mono.html">Mono</a>,
226 | 	 * publishing the value obtained from the returned list of the batchCallBack
227 | 	 * method for the given parameter. <br>
228 | 	 * <br>
229 | 	 * The invoking thread is not blocked <br>
230 | 	 * <br>
231 | 	 * <img src="{@docRoot}/doc-files/mono.svg" alt="mono"> <br>
232 | 	 * It will throw a {@link RuntimeException} if the internal buffer Queue of this
233 | 	 * Delayed Batch Executor is full. <br>
234 | 	 * If a {@link RuntimeException} is thrown inside of the {@link BatchCallBack3},
235 | 	 * then it will be the propagated as any {@link RuntimeException } thrown from
236 | 	 * <a href=
237 | 	 * "https://projectreactor.io/docs/core/release/api/reactor/core/publisher/Mono.html">Mono</a>
238 | 	 * <br>
239 | 	 * <br>
240 | 	 * 
241 | 	 * @param arg1 value of the first argument of type A defined for this Delayed
242 | 	 *             Batch Executor
243 | 	 * @param arg2 value of the second argument of type B defined for this Delayed
244 | 	 *             Batch Executor
245 | 	 * @return a <a href=
246 | 	 *         "https://projectreactor.io/docs/core/release/api/reactor/core/publisher/Mono.html">Mono</a>
247 | 	 *         for the result of type Z
248 | 	 *
249 | 	 *
250 | 	 */
251 | 	public Mono<Z> executeAsMono(A arg1, B arg2) {
252 | 		TupleMono<Z> tupleMono = new TupleMono<>(arg1, arg2);
253 | 		enlistTuple(tupleMono);
254 | 		Mono<Z> mono = tupleMono.getMono();
255 | 		return mono;
256 | 	}
257 | 
258 | 	@SuppressWarnings("unchecked")
259 | 	@Override
260 | 	protected List<Z> getResultListFromBatchCallBack(List<List<Object>> transposedTupleList) {
261 | 		return batchCallBack.apply((List<A>) transposedTupleList.get(0), (List<B>) transposedTupleList.get(1));
262 | 	}
263 | }


--------------------------------------------------------------------------------
/LICENSE.txt:
--------------------------------------------------------------------------------
  1 | 
  2 |                                  Apache License
  3 |                            Version 2.0, January 2004
  4 |                         http://www.apache.org/licenses/
  5 | 
  6 |    TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION
  7 | 
  8 |    1. Definitions.
  9 | 
 10 |       "License" shall mean the terms and conditions for use, reproduction,
 11 |       and distribution as defined by Sections 1 through 9 of this document.
 12 | 
 13 |       "Licensor" shall mean the copyright owner or entity authorized by
 14 |       the copyright owner that is granting the License.
 15 | 
 16 |       "Legal Entity" shall mean the union of the acting entity and all
 17 |       other entities that control, are controlled by, or are under common
 18 |       control with that entity. For the purposes of this definition,
 19 |       "control" means (i) the power, direct or indirect, to cause the
 20 |       direction or management of such entity, whether by contract or
 21 |       otherwise, or (ii) ownership of fifty percent (50%) or more of the
 22 |       outstanding shares, or (iii) beneficial ownership of such entity.
 23 | 
 24 |       "You" (or "Your") shall mean an individual or Legal Entity
 25 |       exercising permissions granted by this License.
 26 | 
 27 |       "Source" form shall mean the preferred form for making modifications,
 28 |       including but not limited to software source code, documentation
 29 |       source, and configuration files.
 30 | 
 31 |       "Object" form shall mean any form resulting from mechanical
 32 |       transformation or translation of a Source form, including but
 33 |       not limited to compiled object code, generated documentation,
 34 |       and conversions to other media types.
 35 | 
 36 |       "Work" shall mean the work of authorship, whether in Source or
 37 |       Object form, made available under the License, as indicated by a
 38 |       copyright notice that is included in or attached to the work
 39 |       (an example is provided in the Appendix below).
 40 | 
 41 |       "Derivative Works" shall mean any work, whether in Source or Object
 42 |       form, that is based on (or derived from) the Work and for which the
 43 |       editorial revisions, annotations, elaborations, or other modifications
 44 |       represent, as a whole, an original work of authorship. For the purposes
 45 |       of this License, Derivative Works shall not include works that remain
 46 |       separable from, or merely link (or bind by name) to the interfaces of,
 47 |       the Work and Derivative Works thereof.
 48 | 
 49 |       "Contribution" shall mean any work of authorship, including
 50 |       the original version of the Work and any modifications or additions
 51 |       to that Work or Derivative Works thereof, that is intentionally
 52 |       submitted to Licensor for inclusion in the Work by the copyright owner
 53 |       or by an individual or Legal Entity authorized to submit on behalf of
 54 |       the copyright owner. For the purposes of this definition, "submitted"
 55 |       means any form of electronic, verbal, or written communication sent
 56 |       to the Licensor or its representatives, including but not limited to
 57 |       communication on electronic mailing lists, source code control systems,
 58 |       and issue tracking systems that are managed by, or on behalf of, the
 59 |       Licensor for the purpose of discussing and improving the Work, but
 60 |       excluding communication that is conspicuously marked or otherwise
 61 |       designated in writing by the copyright owner as "Not a Contribution."
 62 | 
 63 |       "Contributor" shall mean Licensor and any individual or Legal Entity
 64 |       on behalf of whom a Contribution has been received by Licensor and
 65 |       subsequently incorporated within the Work.
 66 | 
 67 |    2. Grant of Copyright License. Subject to the terms and conditions of
 68 |       this License, each Contributor hereby grants to You a perpetual,
 69 |       worldwide, non-exclusive, no-charge, royalty-free, irrevocable
 70 |       copyright license to reproduce, prepare Derivative Works of,
 71 |       publicly display, publicly perform, sublicense, and distribute the
 72 |       Work and such Derivative Works in Source or Object form.
 73 | 
 74 |    3. Grant of Patent License. Subject to the terms and conditions of
 75 |       this License, each Contributor hereby grants to You a perpetual,
 76 |       worldwide, non-exclusive, no-charge, royalty-free, irrevocable
 77 |       (except as stated in this section) patent license to make, have made,
 78 |       use, offer to sell, sell, import, and otherwise transfer the Work,
 79 |       where such license applies only to those patent claims licensable
 80 |       by such Contributor that are necessarily infringed by their
 81 |       Contribution(s) alone or by combination of their Contribution(s)
 82 |       with the Work to which such Contribution(s) was submitted. If You
 83 |       institute patent litigation against any entity (including a
 84 |       cross-claim or counterclaim in a lawsuit) alleging that the Work
 85 |       or a Contribution incorporated within the Work constitutes direct
 86 |       or contributory patent infringement, then any patent licenses
 87 |       granted to You under this License for that Work shall terminate
 88 |       as of the date such litigation is filed.
 89 | 
 90 |    4. Redistribution. You may reproduce and distribute copies of the
 91 |       Work or Derivative Works thereof in any medium, with or without
 92 |       modifications, and in Source or Object form, provided that You
 93 |       meet the following conditions:
 94 | 
 95 |       (a) You must give any other recipients of the Work or
 96 |           Derivative Works a copy of this License; and
 97 | 
 98 |       (b) You must cause any modified files to carry prominent notices
 99 |           stating that You changed the files; and
100 | 
101 |       (c) You must retain, in the Source form of any Derivative Works
102 |           that You distribute, all copyright, patent, trademark, and
103 |           attribution notices from the Source form of the Work,
104 |           excluding those notices that do not pertain to any part of
105 |           the Derivative Works; and
106 | 
107 |       (d) If the Work includes a "NOTICE" text file as part of its
108 |           distribution, then any Derivative Works that You distribute must
109 |           include a readable copy of the attribution notices contained
110 |           within such NOTICE file, excluding those notices that do not
111 |           pertain to any part of the Derivative Works, in at least one
112 |           of the following places: within a NOTICE text file distributed
113 |           as part of the Derivative Works; within the Source form or
114 |           documentation, if provided along with the Derivative Works; or,
115 |           within a display generated by the Derivative Works, if and
116 |           wherever such third-party notices normally appear. The contents
117 |           of the NOTICE file are for informational purposes only and
118 |           do not modify the License. You may add Your own attribution
119 |           notices within Derivative Works that You distribute, alongside
120 |           or as an addendum to the NOTICE text from the Work, provided
121 |           that such additional attribution notices cannot be construed
122 |           as modifying the License.
123 | 
124 |       You may add Your own copyright statement to Your modifications and
125 |       may provide additional or different license terms and conditions
126 |       for use, reproduction, or distribution of Your modifications, or
127 |       for any such Derivative Works as a whole, provided Your use,
128 |       reproduction, and distribution of the Work otherwise complies with
129 |       the conditions stated in this License.
130 | 
131 |    5. Submission of Contributions. Unless You explicitly state otherwise,
132 |       any Contribution intentionally submitted for inclusion in the Work
133 |       by You to the Licensor shall be under the terms and conditions of
134 |       this License, without any additional terms or conditions.
135 |       Notwithstanding the above, nothing herein shall supersede or modify
136 |       the terms of any separate license agreement you may have executed
137 |       with Licensor regarding such Contributions.
138 | 
139 |    6. Trademarks. This License does not grant permission to use the trade
140 |       names, trademarks, service marks, or product names of the Licensor,
141 |       except as required for reasonable and customary use in describing the
142 |       origin of the Work and reproducing the content of the NOTICE file.
143 | 
144 |    7. Disclaimer of Warranty. Unless required by applicable law or
145 |       agreed to in writing, Licensor provides the Work (and each
146 |       Contributor provides its Contributions) on an "AS IS" BASIS,
147 |       WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or
148 |       implied, including, without limitation, any warranties or conditions
149 |       of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A
150 |       PARTICULAR PURPOSE. You are solely responsible for determining the
151 |       appropriateness of using or redistributing the Work and assume any
152 |       risks associated with Your exercise of permissions under this License.
153 | 
154 |    8. Limitation of Liability. In no event and under no legal theory,
155 |       whether in tort (including negligence), contract, or otherwise,
156 |       unless required by applicable law (such as deliberate and grossly
157 |       negligent acts) or agreed to in writing, shall any Contributor be
158 |       liable to You for damages, including any direct, indirect, special,
159 |       incidental, or consequential damages of any character arising as a
160 |       result of this License or out of the use or inability to use the
161 |       Work (including but not limited to damages for loss of goodwill,
162 |       work stoppage, computer failure or malfunction, or any and all
163 |       other commercial damages or losses), even if such Contributor
164 |       has been advised of the possibility of such damages.
165 | 
166 |    9. Accepting Warranty or Additional Liability. While redistributing
167 |       the Work or Derivative Works thereof, You may choose to offer,
168 |       and charge a fee for, acceptance of support, warranty, indemnity,
169 |       or other liability obligations and/or rights consistent with this
170 |       License. However, in accepting such obligations, You may act only
171 |       on Your own behalf and on Your sole responsibility, not on behalf
172 |       of any other Contributor, and only if You agree to indemnify,
173 |       defend, and hold each Contributor harmless for any liability
174 |       incurred by, or claims asserted against, such Contributor by reason
175 |       of your accepting any such warranty or additional liability.
176 | 
177 |    END OF TERMS AND CONDITIONS
178 | 
179 |    APPENDIX: How to apply the Apache License to your work.
180 | 
181 |       To apply the Apache License to your work, attach the following
182 |       boilerplate notice, with the fields enclosed by brackets "[]"
183 |       replaced with your own identifying information. (Don't include
184 |       the brackets!)  The text should be enclosed in the appropriate
185 |       comment syntax for the file format. We also recommend that a
186 |       file or class name and description of purpose be included on the
187 |       same "printed page" as the copyright notice for easier
188 |       identification within third-party archives.
189 | 
190 |    Copyright [yyyy] [name of copyright owner]
191 | 
192 |    Licensed under the Apache License, Version 2.0 (the "License");
193 |    you may not use this file except in compliance with the License.
194 |    You may obtain a copy of the License at
195 | 
196 |        http://www.apache.org/licenses/LICENSE-2.0
197 | 
198 |    Unless required by applicable law or agreed to in writing, software
199 |    distributed under the License is distributed on an "AS IS" BASIS,
200 |    WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
201 |    See the License for the specific language governing permissions and
202 | 


--------------------------------------------------------------------------------
/src/main/java/com/github/victormpcmun/delayedbatchexecutor/DelayedBatchExecutor4.java:
--------------------------------------------------------------------------------
  1 | package com.github.victormpcmun.delayedbatchexecutor;
  2 | 
  3 | import reactor.core.publisher.Mono;
  4 | 
  5 | import java.time.Duration;
  6 | import java.util.List;
  7 | import java.util.concurrent.ExecutionException;
  8 | import java.util.concurrent.ExecutorService;
  9 | import java.util.concurrent.Future;
 10 | 
 11 | /**
 12 |  * Delayed Batch Executor for three arguments (of types A,B and C) and return
 13 |  * type Z <br>
 14 |  * 
 15 |  * <pre>
 16 |  * {@code
 17 |  * DelayedBatchExecutor4<String,Integer,Integer,Integer> dbe = DelayedBatchExecutor4.create(Duration.ofMillis(50), 10, this::myBatchCallback);
 18 |  *
 19 |  * ...
 20 |  *
 21 |  * public void usingDelayedBatchExecutor(Integer param1, Integer param2, Integer param3) {
 22 |  *
 23 |  *    // using blocking behaviour
 24 |  *    String stringResult1 = dbe.execute(param1, param2, param3); // the thread will be blocked until the result is available
 25 |  *    // compute with stringResult1
 26 |  *
 27 |  *
 28 |  *    // using Future
 29 |  *    Future<String> resultAsFutureString = dbe.executeAsFuture(param1, param2, param3); // the thread will not  be blocked
 30 |  *    // compute something else
 31 |  *    String stringResult2 = resultAsFutureString.get();  // Blocks the thread if necessary for the computation to complete, and then retrieves its result.
 32 |  *    // compute with stringResult2
 33 |  *
 34 |  *
 35 |  *    // using Mono
 36 |  *    Mono<String> monoResult = dbe.executeAsMono(param1, param2, param3); // the thread will not  be blocked
 37 |  *    // compute something else
 38 |  *    monoResult.subscribe(stringResult -> {
 39 |  *     // compute with stringResult
 40 |  *    });
 41 |  * }
 42 |  *
 43 |  * ...
 44 |  *
 45 |  * List<String> myBatchCallback(List<Integer> arg1List, List<Integer> arg2List, List<Integer> arg3List) {
 46 |  *   List<String> result = ...
 47 |  *   ...
 48 |  *   return result;
 49 |  *}
 50 |  *}
 51 |  * </pre>
 52 |  * 
 53 |  * @author Victor Porcar
 54 |  *
 55 |  */
 56 | 
 57 | public class DelayedBatchExecutor4<Z, A, B, C> extends DelayedBatchExecutor<Z> {
 58 | 
 59 | 	/**
 60 | 	 * Receive as argument three Lists of type A,B,C and returns a List of type Z.
 61 | 	 * It can be implemented as a lambda expression or method reference <br>
 62 | 	 * <br>
 63 | 	 * 
 64 | 	 * <pre>
 65 | 	 * <b>Lambda expression</b>
 66 | 	 * {@code
 67 | 	 * DelayedBatchExecutor4<String,Integer,Integer,Integer> dbe = DelayedBatchExecutor4.create(Duration.ofMillis(50), 10, (arg1List, arg2List, arg3list) ->
 68 | 	 * {
 69 | 	 *      //arg1List,arg2List and arg3List are List<Integer>
 70 | 	 *      List<String> result = ...
 71 | 	 *	    ...
 72 | 	 *      return result;
 73 | 	 *});
 74 | 	 *}
 75 | 	 * <b>Method reference</b>
 76 | 	 * {@code
 77 | 	 * DelayedBatchExecutor4<String,Integer,Integer,Integer> dbe = DelayedBatchExecutor4.create(Duration.ofMillis(50), 10, this::myBatchCallBack);
 78 | 	 * ...
 79 | 	 * List<String> myBatchCallBack(List<Integer> arg1List, List<Integer> arg2List, List<Integer> arg3List) {
 80 | 	 *      List<String> result = ...
 81 | 	 *	    ...
 82 | 	 *      return result;
 83 | 	 *}
 84 | 	 *}
 85 | 	 * </pre>
 86 | 	 * 
 87 | 	 * @author Victor Porcar
 88 | 	 *
 89 | 	 */
 90 | 	@FunctionalInterface
 91 | 	public interface BatchCallBack4<Z, A, B, C> {
 92 | 		List<Z> apply(List<A> firstParam, List<B> secondParam, List<C> thirdParam);
 93 | 	}
 94 | 
 95 | 	private final BatchCallBack4<Z, A, B, C> batchCallBack;
 96 | 
 97 | 	/**
 98 | 	 * Factory method to create an instance of a Delayed Batch Executor for two
 99 | 	 * arguments (of types A,B and C) and return type Z. Similar to
100 | 	 * {@link DelayedBatchExecutor4#create(Duration, int, ExecutorService, int, boolean, BatchCallBack4)}
101 | 	 * defaulting to: <br>
102 | 	 * <br>
103 | 	 * -executorService: the one returned by static method
104 | 	 * {@link #getDefaultExecutorService()} <br>
105 | 	 * -bufferQueueSize: the value of constant {@link #DEFAULT_BUFFER_QUEUE_SIZE}
106 | 	 * <br>
107 | 	 * -removeDuplicates:true <br>
108 | 	 * 
109 | 	 * @param <Z>            the return type
110 | 	 * @param <A>            the type of the first argument
111 | 	 * @param <B>            the type of the second argument
112 | 	 * @param <C>            the type of the third argument
113 | 	 * @param duration       the time window, defined as {@link Duration }.
114 | 	 * @param size           the max collected size. As soon as the count of
115 | 	 *                       collected parameters reaches this size, the
116 | 	 *                       batchCallBack method is executed
117 | 	 * @param batchCallback4 the method reference or lambda expression that receives
118 | 	 *                       a list of type A and returns a list of Type Z (see
119 | 	 *                       {@link BatchCallBack4})
120 | 	 * @return an instance of {@link DelayedBatchExecutor4}
121 | 	 *
122 | 	 */
123 | 	public static <Z, A, B, C> DelayedBatchExecutor4<Z, A, B, C> create(Duration duration, int size,
124 | 			BatchCallBack4<Z, A, B, C> batchCallback4) {
125 | 		return new DelayedBatchExecutor4<>(duration, size, null, DEFAULT_BUFFER_QUEUE_SIZE, true, batchCallback4);
126 | 	}
127 | 
128 | 	/**
129 | 	 * Factory method to create an instance of a Delayed Batch Executor for two
130 | 	 * arguments (of types A,B and C) and return type Z <br>
131 | 	 * 
132 | 	 * @param <Z>              the return type
133 | 	 * @param <A>              the type of the first argument
134 | 	 * @param <B>              the type of the second argument
135 | 	 * @param <C>              the type of the third argument
136 | 	 * @param duration         the time window, defined as {@link Duration }.
137 | 	 * @param size             the max collected size. As soon as the count of
138 | 	 *                         collected parameters reaches this size, the
139 | 	 *                         batchCallBack method is executed
140 | 	 * @param executorService  to define the pool of threads to executed the
141 | 	 *                         batchCallBack method in asynchronous mode
142 | 	 * @param bufferQueueSize  max size of the internal queue to buffer values.
143 | 	 * @param removeDuplicates if true then duplicated arguments from execute*(...)
144 | 	 *                         methods are not passed to the batchCallBack
145 | 	 *                         (considering same {@link Object#hashCode()} and being
146 | 	 *                         {@link Object#equals(Object)})
147 | 	 * @param batchCallback4   the method reference or lambda expression that
148 | 	 *                         receives a list of type A and returns a list of Type
149 | 	 *                         Z (see {@link BatchCallBack4})
150 | 	 * @return an instance of {@link DelayedBatchExecutor4}
151 | 	 *
152 | 	 */
153 | 
154 | 	public static <Z, A, B, C> DelayedBatchExecutor4<Z, A, B, C> create(Duration duration, int size,
155 | 			ExecutorService executorService, int bufferQueueSize, boolean removeDuplicates,
156 | 			BatchCallBack4<Z, A, B, C> batchCallback4) {
157 | 		return new DelayedBatchExecutor4<>(duration, size, executorService, bufferQueueSize, removeDuplicates,
158 | 				batchCallback4);
159 | 	}
160 | 
161 | 	private DelayedBatchExecutor4(Duration duration, int size, ExecutorService executorService, int bufferQueueSize,
162 | 			boolean removeDuplicates, BatchCallBack4<Z, A, B, C> batchCallBack) {
163 | 		super(duration, size, executorService, bufferQueueSize, removeDuplicates);
164 | 		this.batchCallBack = batchCallBack;
165 | 	}
166 | 
167 | 	/**
168 | 	 * Return the result of type Z (blocking the thread until the result is
169 | 	 * available), which is obtained from the returned list of the batchCallBack
170 | 	 * method for the given argument <br>
171 | 	 * <br>
172 | 	 * It will throw any {@link RuntimeException} thrown inside of the
173 | 	 * {@link BatchCallBack4} <br>
174 | 	 * It will throw a {@link RuntimeException} if the internal buffer Queue of this
175 | 	 * Delayed Batch Executor is full. <br>
176 | 	 * <br>
177 | 	 * <img src="{@docRoot}/doc-files/blocking.svg" alt="blocking">
178 | 	 * 
179 | 	 * @param arg1 value of the first argument of type A defined for this Delayed
180 | 	 *             Batch Executor
181 | 	 * @param arg2 value of the second argument of type B defined for this Delayed
182 | 	 *             Batch Executor
183 | 	 * @param arg3 value of the third argument of type C defined for this Delayed
184 | 	 *             Batch Executor
185 | 	 * @return the result of type Z
186 | 	 *
187 | 	 *
188 | 	 */
189 | 	public Z execute(A arg1, B arg2, C arg3) {
190 | 		TupleBlocking<Z> tupleBlocking = new TupleBlocking<>(arg1, arg2, arg3);
191 | 		enlistTuple(tupleBlocking);
192 | 		Z value = tupleBlocking.getValueBlocking();
193 | 		return value;
194 | 	}
195 | 
196 | 	/**
197 | 	 * Return a {@link Future } containing the corresponding value from the returned
198 | 	 * list of the batchCallBack method for the given argument <br>
199 | 	 * <br>
200 | 	 * The invoking thread is not blocked. The result will be available by invoking
201 | 	 * method {@link Future#get()} of the {@link Future }. This method will block
202 | 	 * the thread until the result is available <br>
203 | 	 * <br>
204 | 	 * <img src="{@docRoot}/doc-files/future.svg" alt ="future"> <br>
205 | 	 * It will throw a {@link RuntimeException} if the internal buffer Queue of this
206 | 	 * Delayed Batch Executor is full. <br>
207 | 	 * If a {@link RuntimeException} is thrown inside of the {@link BatchCallBack4},
208 | 	 * then it will be the cause of the checked Exception {@link ExecutionException}
209 | 	 * thrown by {@link Future#get()} as per contract of {@link Future#get()} <br>
210 | 	 * <br>
211 | 	 * 
212 | 	 * @param arg1 value of the first argument of type A defined for this Delayed
213 | 	 *             Batch Executor
214 | 	 * @param arg2 value of the second argument of type B defined for this Delayed
215 | 	 *             Batch Executor
216 | 	 * @param arg3 value of the third argument of type C defined for this Delayed
217 | 	 *             Batch Executor
218 | 	 * @return a {@link Future } for the result of type Z
219 | 	 *
220 | 	 */
221 | 	public Future<Z> executeAsFuture(A arg1, B arg2, C arg3) {
222 | 		TupleFuture<Z> tupleFuture = new TupleFuture<>(arg1, arg2, arg3);
223 | 		enlistTuple(tupleFuture);
224 | 		Future<Z> future = tupleFuture.getFuture();
225 | 		return future;
226 | 	}
227 | 
228 | 	/**
229 | 	 * Return a <a href=
230 | 	 * "https://projectreactor.io/docs/core/release/api/reactor/core/publisher/Mono.html">Mono</a>,
231 | 	 * publishing the value obtained from the returned list of the batchCallBack
232 | 	 * method for the given parameter. <br>
233 | 	 * <br>
234 | 	 * The invoking thread is not blocked <br>
235 | 	 * <br>
236 | 	 * <img src="{@docRoot}/doc-files/mono.svg" alt="mono"> <br>
237 | 	 * It will throw a {@link RuntimeException} if the internal buffer Queue of this
238 | 	 * Delayed Batch Executor is full. <br>
239 | 	 * If a {@link RuntimeException} is thrown inside of the {@link BatchCallBack4},
240 | 	 * then it will be the propagated as any {@link RuntimeException } thrown from
241 | 	 * <a href=
242 | 	 * "https://projectreactor.io/docs/core/release/api/reactor/core/publisher/Mono.html">Mono</a>
243 | 	 * <br>
244 | 	 * <br>
245 | 	 * 
246 | 	 * @param arg1 value of the first argument of type A defined for this Delayed
247 | 	 *             Batch Executor
248 | 	 * @param arg2 value of the second argument of type B defined for this Delayed
249 | 	 *             Batch Executor
250 | 	 * @param arg3 value of the third argument of type C defined for this Delayed
251 | 	 *             Batch Executor
252 | 	 * @return a <a href=
253 | 	 *         "https://projectreactor.io/docs/core/release/api/reactor/core/publisher/Mono.html">Mono</a>
254 | 	 *         for the result of type Z
255 | 	 *
256 | 	 *
257 | 	 */
258 | 	public Mono<Z> executeAsMono(A arg1, B arg2, C arg3) {
259 | 		TupleMono<Z> tupleMono = new TupleMono<>(arg1, arg2, arg3);
260 | 		enlistTuple(tupleMono);
261 | 		Mono<Z> mono = tupleMono.getMono();
262 | 		return mono;
263 | 	}
264 | 
265 | 	@SuppressWarnings("unchecked")
266 | 	@Override
267 | 	protected List<Z> getResultListFromBatchCallBack(List<List<Object>> transposedTupleList) {
268 | 		return batchCallBack.apply((List<A>) transposedTupleList.get(0), (List<B>) transposedTupleList.get(1),
269 | 				(List<C>) transposedTupleList.get(2));
270 | 	}
271 | }


--------------------------------------------------------------------------------
/src/main/java/com/github/victormpcmun/delayedbatchexecutor/DelayedBatchExecutor5.java:
--------------------------------------------------------------------------------
  1 | package com.github.victormpcmun.delayedbatchexecutor;
  2 | 
  3 | import reactor.core.publisher.Mono;
  4 | 
  5 | import java.time.Duration;
  6 | import java.util.List;
  7 | import java.util.concurrent.ExecutionException;
  8 | import java.util.concurrent.ExecutorService;
  9 | import java.util.concurrent.Future;
 10 | 
 11 | /**
 12 |  * Delayed Batch Executor for four arguments (of types A,B,C and D) and return
 13 |  * type Z <br>
 14 |  * 
 15 |  * <pre>
 16 |  * {@code
 17 |  * DelayedBatchExecutor5<String,Integer,Integer,Integer,Integer> dbe = DelayedBatchExecutor5.create(Duration.ofMillis(50), 10, this::myBatchCallback);
 18 |  *
 19 |  * ...
 20 |  *
 21 |  * public void usingDelayedBatchExecutor(Integer param1, Integer param2, Integer param3, Integer param4) {
 22 |  *
 23 |  *    // using blocking behaviour
 24 |  *    String stringResult1 = dbe.execute(param1, param2, param3,param4); // the thread will be blocked until the result is available
 25 |  *    // compute with stringResult1
 26 |  *
 27 |  *
 28 |  *    // using Future
 29 |  *    Future<String> resultAsFutureString = dbe.executeAsFuture(param1, param2, param3, param4); // the thread will not  be blocked
 30 |  *    // compute something else
 31 |  *    String stringResult2 = resultAsFutureString.get();  // Blocks the thread if necessary for the computation to complete, and then retrieves its result.
 32 |  *    // compute with stringResult2
 33 |  *
 34 |  *
 35 |  *    // using Mono
 36 |  *    Mono<String> monoResult = dbe.executeAsMono(param1, param2, param3, param4); // the thread will not  be blocked
 37 |  *    // compute something else
 38 |  *    monoResult.subscribe(stringResult -> {
 39 |  *     // compute with stringResult
 40 |  *    });
 41 |  * }
 42 |  *
 43 |  * ...
 44 |  *
 45 |  * List<String> myBatchCallback(List<Integer> arg1List, List<Integer> arg2List, List<Integer> arg3List, List<Integer> arg4List) {
 46 |  *   List<String> result = ...
 47 |  *   ...
 48 |  *   return result;
 49 |  *}
 50 |  *}
 51 |  * </pre>
 52 |  * 
 53 |  * @author Victor Porcar
 54 |  *
 55 |  */
 56 | 
 57 | public class DelayedBatchExecutor5<Z, A, B, C, D> extends DelayedBatchExecutor<Z> {
 58 | 
 59 | 	/**
 60 | 	 * Receive as argument four Lists of type A,B,C,D and returns a List of type Z.
 61 | 	 * It can be implemented as a lambda expression or method reference <br>
 62 | 	 * <br>
 63 | 	 * 
 64 | 	 * <pre>
 65 | 	 * <b>Lambda expression</b>
 66 | 	 * {@code
 67 | 	 * DelayedBatchExecutor5<String,Integer,Integer,Integer,Integer> dbe = DelayedBatchExecutor5.create(Duration.ofMillis(50), 10, (arg1List, arg2List, arg3list,arg4List) ->
 68 | 	 * {
 69 | 	 *      //arg1List,arg2List,arg3List and arg4List are List<Integer>
 70 | 	 *      List<String> result = ...
 71 | 	 *	    ...
 72 | 	 *      return result;
 73 | 	 *});
 74 | 	 *}
 75 | 	 * <b>Method reference</b>
 76 | 	 * {@code
 77 | 	 * DelayedBatchExecutor5<String,Integer,Integer,Integer,Integer> dbe = DelayedBatchExecutor5.create(Duration.ofMillis(50), 10, this::myBatchCallBack);
 78 | 	 * ...
 79 | 	 * List<String> myBatchCallBack(List<Integer> arg1List, List<Integer> arg2List, List<Integer> arg3List, List<Integer> arg4List) {
 80 | 	 *      List<String> result = ...
 81 | 	 *	    ...
 82 | 	 *      return result;
 83 | 	 *}
 84 | 	 *}
 85 | 	 * </pre>
 86 | 	 * 
 87 | 	 * @author Victor Porcar
 88 | 	 *
 89 | 	 */
 90 | 	@FunctionalInterface
 91 | 	public interface BatchCallBack5<Z, A, B, C, D> {
 92 | 		List<Z> apply(List<A> firstParam, List<B> secondParam, List<C> thirdParam, List<D> fourthParam);
 93 | 	}
 94 | 
 95 | 	private final BatchCallBack5<Z, A, B, C, D> batchCallBack;
 96 | 
 97 | 	/**
 98 | 	 * Factory method to create an instance of a Delayed Batch Executor for two
 99 | 	 * arguments (of types A,B,C and D) and return type Z. Similar to
100 | 	 * {@link DelayedBatchExecutor5#create(Duration, int, ExecutorService, int, boolean, BatchCallBack5)}
101 | 	 * defaulting to: <br>
102 | 	 * <br>
103 | 	 * -executorService: the one returned by static method
104 | 	 * {@link #getDefaultExecutorService()} <br>
105 | 	 * -bufferQueueSize: the value of constant {@link #DEFAULT_BUFFER_QUEUE_SIZE}
106 | 	 * <br>
107 | 	 * -removeDuplicates:true <br>
108 | 	 * 
109 | 	 * @param <Z>            the return type
110 | 	 * @param <A>            the type of the first argument
111 | 	 * @param <B>            the type of the second argument
112 | 	 * @param <C>            the type of the third argument
113 | 	 * @param <D>            the type of the fourth argument
114 | 	 * @param duration       the time window, defined as {@link Duration }.
115 | 	 * @param size           the max collected size. As soon as the count of
116 | 	 *                       collected parameters reaches this size, the
117 | 	 *                       batchCallBack method is executed
118 | 	 * @param batchCallback5 the method reference or lambda expression that receives
119 | 	 *                       a list of type A and returns a list of Type Z (see
120 | 	 *                       {@link BatchCallBack5})
121 | 	 * @return an instance of {@link DelayedBatchExecutor5}
122 | 	 *
123 | 	 */
124 | 	public static <Z, A, B, C, D> DelayedBatchExecutor5<Z, A, B, C, D> create(Duration duration, int size,
125 | 			BatchCallBack5<Z, A, B, C, D> batchCallback5) {
126 | 		return new DelayedBatchExecutor5<>(duration, size, null, DEFAULT_BUFFER_QUEUE_SIZE, true, batchCallback5);
127 | 	}
128 | 
129 | 	/**
130 | 	 * Factory method to create an instance of a Delayed Batch Executor for two
131 | 	 * arguments (of types A,B,C and D) and return type Z <br>
132 | 	 * 
133 | 	 * @param <Z>              the return type
134 | 	 * @param <A>              the type of the first argument
135 | 	 * @param <B>              the type of the second argument
136 | 	 * @param <C>              the type of the third argument
137 | 	 * @param <D>              the type of the fourth argument
138 | 	 * @param duration         the time window, defined as {@link Duration }.
139 | 	 * @param size             the max collected size. As soon as the count of
140 | 	 *                         collected parameters reaches this size, the
141 | 	 *                         batchCallBack method is executed
142 | 	 * @param executorService  to define the pool of threads to executed the
143 | 	 *                         batchCallBack method in asynchronous mode
144 | 	 * @param bufferQueueSize  max size of the internal queue to buffer values
145 | 	 * @param removeDuplicates if true then duplicated arguments from execute*(...)
146 | 	 *                         methods are not passed to the batchCallBack
147 | 	 *                         (considering same {@link Object#hashCode()} and being
148 | 	 *                         {@link Object#equals(Object)})
149 | 	 * @param batchCallback5   the method reference or lambda expression that
150 | 	 *                         receives a list of type A and returns a list of Type
151 | 	 *                         Z (see {@link BatchCallBack5})
152 | 	 * @return an instance of {@link DelayedBatchExecutor5}
153 | 	 *
154 | 	 */
155 | 	public static <Z, A, B, C, D> DelayedBatchExecutor5<Z, A, B, C, D> create(Duration duration, int size,
156 | 			ExecutorService executorService, int bufferQueueSize, boolean removeDuplicates,
157 | 			BatchCallBack5<Z, A, B, C, D> batchCallback5) {
158 | 		return new DelayedBatchExecutor5<>(duration, size, executorService, bufferQueueSize, removeDuplicates,
159 | 				batchCallback5);
160 | 	}
161 | 
162 | 	private DelayedBatchExecutor5(Duration duration, int size, ExecutorService executorService, int bufferQueueSize,
163 | 			boolean removeDuplicates, BatchCallBack5<Z, A, B, C, D> batchCallBack) {
164 | 		super(duration, size, executorService, bufferQueueSize, removeDuplicates);
165 | 		this.batchCallBack = batchCallBack;
166 | 	}
167 | 
168 | 	/**
169 | 	 * Return the result of type Z (blocking the thread until the result is
170 | 	 * available), which is obtained from the returned list of the batchCallBack
171 | 	 * method for the given argument <br>
172 | 	 * <br>
173 | 	 * It will throw any {@link RuntimeException} thrown inside of the
174 | 	 * {@link BatchCallBack5 } <br>
175 | 	 * It will throw a {@link RuntimeException} if the internal buffer Queue of this
176 | 	 * Delayed Batch Executor is full. <br>
177 | 	 * <br>
178 | 	 * <img src="{@docRoot}/doc-files/blocking.svg" alt="blocking">
179 | 	 * 
180 | 	 * @param arg1 value of the first argument of type A defined for this Delayed
181 | 	 *             Batch Executor
182 | 	 * @param arg2 value of the second argument of type B defined for this Delayed
183 | 	 *             Batch Executor
184 | 	 * @param arg3 value of the third argument of type C defined for this Delayed
185 | 	 *             Batch Executor
186 | 	 * @param arg4 value of the fourth argument of type D defined for this Delayed
187 | 	 *             Batch Executor
188 | 	 * @return the result of type Z
189 | 	 *
190 | 	 *
191 | 	 */
192 | 	public Z execute(A arg1, B arg2, C arg3, D arg4) {
193 | 		TupleBlocking<Z> tupleBlocking = new TupleBlocking<>(arg1, arg2, arg3, arg4);
194 | 		enlistTuple(tupleBlocking);
195 | 		Z value = tupleBlocking.getValueBlocking();
196 | 		return value;
197 | 	}
198 | 
199 | 	/**
200 | 	 * Return a {@link Future } containing the corresponding value from the returned
201 | 	 * list of the batchCallBack method for the given argument <br>
202 | 	 * <br>
203 | 	 * The invoking thread is not blocked. The result will be available by invoking
204 | 	 * method {@link Future#get()} of the {@link Future }. This method will block
205 | 	 * the thread until the result is available <br>
206 | 	 * <br>
207 | 	 * <img src="{@docRoot}/doc-files/future.svg" alt ="future"> <br>
208 | 	 * It will throw a {@link RuntimeException} if the internal buffer Queue of this
209 | 	 * Delayed Batch Executor is full. <br>
210 | 	 * If a {@link RuntimeException} is thrown inside of the {@link BatchCallBack5
211 | 	 * }, then it will be the cause of the checked Exception
212 | 	 * {@link ExecutionException} thrown by {@link Future#get()} as per contract of
213 | 	 * {@link Future#get()} <br>
214 | 	 * <br>
215 | 	 * 
216 | 	 * @param arg1 value of the first argument of type A defined for this Delayed
217 | 	 *             Batch Executor
218 | 	 * @param arg2 value of the second argument of type B defined for this Delayed
219 | 	 *             Batch Executor
220 | 	 * @param arg3 value of the third argument of type C defined for this Delayed
221 | 	 *             Batch Executor
222 | 	 * @param arg4 value of the fourth argument of type D defined for this Delayed
223 | 	 *             Batch Executor
224 | 	 * @return a {@link Future } for the result of type Z
225 | 	 *
226 | 	 */
227 | 	public Future<Z> executeAsFuture(A arg1, B arg2, C arg3, D arg4) {
228 | 		TupleFuture<Z> tupleFuture = new TupleFuture<>(arg1, arg2, arg3, arg4);
229 | 		enlistTuple(tupleFuture);
230 | 		Future<Z> future = tupleFuture.getFuture();
231 | 		return future;
232 | 	}
233 | 
234 | 	/**
235 | 	 * Return a <a href=
236 | 	 * "https://projectreactor.io/docs/core/release/api/reactor/core/publisher/Mono.html">Mono</a>,
237 | 	 * publishing the value obtained from the returned list of the batchCallBack
238 | 	 * method for the given parameter. <br>
239 | 	 * <br>
240 | 	 * The invoking thread is not blocked <br>
241 | 	 * <br>
242 | 	 * <img src="{@docRoot}/doc-files/mono.svg" alt="mono"> <br>
243 | 	 * It will throw a {@link RuntimeException} if the internal buffer Queue of this
244 | 	 * Delayed Batch Executor is full. <br>
245 | 	 * If a {@link RuntimeException} is thrown inside of the {@link BatchCallBack5},
246 | 	 * then it will be the propagated as any {@link RuntimeException } thrown from
247 | 	 * <a href=
248 | 	 * "https://projectreactor.io/docs/core/release/api/reactor/core/publisher/Mono.html">Mono</a>
249 | 	 * <br>
250 | 	 * <br>
251 | 	 * 
252 | 	 * @param arg1 value of the first argument of type A defined for this Delayed
253 | 	 *             Batch Executor
254 | 	 * @param arg2 value of the second argument of type B defined for this Delayed
255 | 	 *             Batch Executor
256 | 	 * @param arg3 value of the third argument of type C defined for this Delayed
257 | 	 *             Batch Executor
258 | 	 * @param arg4 value of the fourth argument of type D defined for this Delayed
259 | 	 *             Batch Executor
260 | 	 * @return a <a href=
261 | 	 *         "https://projectreactor.io/docs/core/release/api/reactor/core/publisher/Mono.html">Mono</a>
262 | 	 *         for the result of type Z
263 | 	 *
264 | 	 *
265 | 	 */
266 | 	public Mono<Z> executeAsMono(A arg1, B arg2, C arg3, D arg4) {
267 | 		TupleMono<Z> tupleMono = new TupleMono<>(arg1, arg2, arg3, arg4);
268 | 		enlistTuple(tupleMono);
269 | 		Mono<Z> mono = tupleMono.getMono();
270 | 		return mono;
271 | 	}
272 | 
273 | 	@SuppressWarnings("unchecked")
274 | 	@Override
275 | 	protected List<Z> getResultListFromBatchCallBack(List<List<Object>> transposedTupleList) {
276 | 		return batchCallBack.apply((List<A>) transposedTupleList.get(0), (List<B>) transposedTupleList.get(1),
277 | 				(List<C>) transposedTupleList.get(2), (List<D>) transposedTupleList.get(3));
278 | 	}
279 | }


--------------------------------------------------------------------------------
/src/main/java/com/github/victormpcmun/delayedbatchexecutor/DelayedBatchExecutor6.java:
--------------------------------------------------------------------------------
  1 | package com.github.victormpcmun.delayedbatchexecutor;
  2 | 
  3 | import reactor.core.publisher.Mono;
  4 | 
  5 | import java.time.Duration;
  6 | import java.util.List;
  7 | import java.util.concurrent.ExecutionException;
  8 | import java.util.concurrent.ExecutorService;
  9 | import java.util.concurrent.Future;
 10 | 
 11 | /**
 12 |  * Delayed Batch Executor for five arguments (of types A,B,C,D and E) and return
 13 |  * type Z <br>
 14 |  * 
 15 |  * <pre>
 16 |  * {@code
 17 |  * DelayedBatchExecutor6<String,Integer,Integer,Integer,Integer,Integer> dbe = DelayedBatchExecutor6.create(Duration.ofMillis(50), 10, this::myBatchCallback);
 18 |  *
 19 |  * ...
 20 |  *
 21 |  * public void usingDelayedBatchExecutor(Integer param1, Integer param2, Integer param3, Integer param4,Integer param5) {
 22 |  *
 23 |  *    // using blocking behaviour
 24 |  *    String stringResult1 = dbe.execute(param1, param2, param3, param4, param5); // the thread will be blocked until the result is available
 25 |  *    // compute with stringResult1
 26 |  *
 27 |  *
 28 |  *    // using Future
 29 |  *    Future<String> resultAsFutureString = dbe.executeAsFuture(param1, param2, param3, param4, param5); // the thread will not  be blocked
 30 |  *    // compute something else
 31 |  *    String stringResult2 = resultAsFutureString.get();  // Blocks the thread if necessary for the computation to complete, and then retrieves its result.
 32 |  *    // compute with stringResult2
 33 |  *
 34 |  *
 35 |  *    // using Mono
 36 |  *    Mono<String> monoResult = dbe.executeAsMono(param1, param2, param3, param4, param5); // the thread will not  be blocked
 37 |  *    // compute something else
 38 |  *    monoResult.subscribe(stringResult3 -> {
 39 |  *     // compute with stringResult3
 40 |  *    });
 41 |  * }
 42 |  *
 43 |  * ...
 44 |  *
 45 |  * List<String> myBatchCallback(List<Integer> arg1List, List<Integer> arg2List, List<Integer> arg3List, List<Integer> arg4List, List<Integer> arg5List) {
 46 |  *   List<String> result = ...
 47 |  *   ...
 48 |  *   return result;
 49 |  *}
 50 |  *}
 51 |  * </pre>
 52 |  * 
 53 |  * @author Victor Porcar
 54 |  *
 55 |  */
 56 | 
 57 | public class DelayedBatchExecutor6<Z, A, B, C, D, E> extends DelayedBatchExecutor<Z> {
 58 | 
 59 | 	/**
 60 | 	 * Receive as argument four Lists of type A,B,C,D,E and returns a List of type
 61 | 	 * Z. It can be implemented as a lambda expression or method reference <br>
 62 | 	 * <br>
 63 | 	 * 
 64 | 	 * <pre>
 65 | 	 * <b>Lambda expression</b>
 66 | 	 * {@code
 67 | 	 * DelayedBatchExecutor6<String,Integer,Integer,Integer,Integer,Integer> dbe = DelayedBatchExecutor6.create(Duration.ofMillis(50), 10, (arg1List, arg2List, arg3list,arg4List,arg5List) ->
 68 | 	 * {
 69 | 	 *      //arg1List,arg2List,arg3List,arg4List and arg5List are List<Integer>
 70 | 	 *      List<String> result = ...
 71 | 	 *	    ...
 72 | 	 *      return result;
 73 | 	 *});
 74 | 	 *}
 75 | 	 * <b>Method reference</b>
 76 | 	 * {@code
 77 | 	 * DelayedBatchExecutor6<String,Integer,Integer,Integer,Integer,Integer> dbe = DelayedBatchExecutor6.create(Duration.ofMillis(50), 10, this::myBatchCallBack);
 78 | 	 * ...
 79 | 	 * List<String> myBatchCallBack(List<Integer> arg1List, List<Integer> arg2List, List<Integer> arg3List, List<Integer> arg4List, List<Integer> arg5List) {
 80 | 	 *      List<String> result = ...
 81 | 	 *	    ...
 82 | 	 *      return result;
 83 | 	 *}
 84 | 	 *}
 85 | 	 * </pre>
 86 | 	 * 
 87 | 	 * @author Victor Porcar
 88 | 	 *
 89 | 	 */
 90 | 	@FunctionalInterface
 91 | 	public interface BatchCallBack6<Z, A, B, C, D, E> {
 92 | 		List<Z> apply(List<A> firstParam, List<B> secondParam, List<C> thirdParam, List<D> fourthParam,
 93 | 				List<E> fifthParam);
 94 | 	}
 95 | 
 96 | 	private final BatchCallBack6<Z, A, B, C, D, E> batchCallBack;
 97 | 
 98 | 	/**
 99 | 	 * Factory method to create an instance of a Delayed Batch Executor for two
100 | 	 * arguments (of types A,B,C,D and E) and return type Z. Similar to
101 | 	 * {@link DelayedBatchExecutor6#create(Duration, int, ExecutorService, int, boolean, BatchCallBack6)}
102 | 	 * defaulting to: <br>
103 | 	 * <br>
104 | 	 * -executorService: the one returned by static method
105 | 	 * {@link #getDefaultExecutorService()} <br>
106 | 	 * -bufferQueueSize: the value of constant {@link #DEFAULT_BUFFER_QUEUE_SIZE}
107 | 	 * <br>
108 | 	 * -removeDuplicates:true <br>
109 | 	 * 
110 | 	 * @param <Z>            the return type
111 | 	 * @param <A>            the type of the first argument
112 | 	 * @param <B>            the type of the second argument
113 | 	 * @param <C>            the type of the third argument
114 | 	 * @param <D>            the type of the fourth argument
115 | 	 * @param <E>            the type of the fifth argument
116 | 	 * @param duration       the time window, defined as {@link Duration }.
117 | 	 * @param size           the max collected size. As soon as the count of
118 | 	 *                       collected parameters reaches this size, the
119 | 	 *                       batchCallBack method is executed
120 | 	 * @param batchCallback6 the method reference or lambda expression that receives
121 | 	 *                       a list of type A and returns a list of Type Z (see
122 | 	 *                       {@link BatchCallBack6})
123 | 	 * @return an instance of {@link DelayedBatchExecutor6}
124 | 	 *
125 | 	 */
126 | 	public static <Z, A, B, C, D, E> DelayedBatchExecutor6<Z, A, B, C, D, E> create(Duration duration, int size,
127 | 			BatchCallBack6<Z, A, B, C, D, E> batchCallback6) {
128 | 		return new DelayedBatchExecutor6<>(duration, size, null, DEFAULT_BUFFER_QUEUE_SIZE, true, batchCallback6);
129 | 	}
130 | 
131 | 	/**
132 | 	 * Factory method to create an instance of a Delayed Batch Executor for two
133 | 	 * arguments (of types A,B,C,D and E) and return type Z <br>
134 | 	 * 
135 | 	 * @param <Z>              the return type
136 | 	 * @param <A>              the type of the first argument
137 | 	 * @param <B>              the type of the second argument
138 | 	 * @param <C>              the type of the third argument
139 | 	 * @param <D>              the type of the fourth argument
140 | 	 * @param <E>              the type of the fifth argument
141 | 	 * @param duration         the time window, defined as {@link Duration }.
142 | 	 * @param size             the max collected size. As soon as the count of
143 | 	 *                         collected parameters reaches this size, the
144 | 	 *                         batchCallBack method is executed
145 | 	 * @param executorService  to define the pool of threads to executed the
146 | 	 *                         batchCallBack method in asynchronous mode
147 | 	 * @param bufferQueueSize  max size of the internal queue to buffer values.
148 | 	 * @param removeDuplicates if true then duplicated arguments from execute*(...)
149 | 	 *                         methods are not passed to the batchCallBack
150 | 	 *                         (considering same {@link Object#hashCode()} and being
151 | 	 *                         {@link Object#equals(Object)})
152 | 	 * @param batchCallback6   the method reference or lambda expression that
153 | 	 *                         receives a list of type A and returns a list of Type
154 | 	 *                         Z (see {@link BatchCallBack6})
155 | 	 * @return an instance of {@link DelayedBatchExecutor6}
156 | 	 *
157 | 	 */
158 | 
159 | 	public static <Z, A, B, C, D, E> DelayedBatchExecutor6<Z, A, B, C, D, E> create(Duration duration, int size,
160 | 			ExecutorService executorService, int bufferQueueSize, boolean removeDuplicates,
161 | 			BatchCallBack6<Z, A, B, C, D, E> batchCallback6) {
162 | 		return new DelayedBatchExecutor6<>(duration, size, executorService, bufferQueueSize, removeDuplicates,
163 | 				batchCallback6);
164 | 	}
165 | 
166 | 	private DelayedBatchExecutor6(Duration duration, int size, ExecutorService executorService, int bufferQueueSize,
167 | 			boolean removeDuplicates, BatchCallBack6<Z, A, B, C, D, E> batchCallBack) {
168 | 		super(duration, size, executorService, bufferQueueSize, removeDuplicates);
169 | 		this.batchCallBack = batchCallBack;
170 | 	}
171 | 
172 | 	/**
173 | 	 * Return the result of type Z (blocking the thread until the result is
174 | 	 * available), which is obtained from the returned list of the batchCallBack
175 | 	 * method for the given argument <br>
176 | 	 * <br>
177 | 	 * It will throw any {@link RuntimeException} thrown inside of the
178 | 	 * {@link BatchCallBack6 } <br>
179 | 	 * It will throw a {@link RuntimeException} if the internal buffer Queue of this
180 | 	 * Delayed Batch Executor is full. <br>
181 | 	 * <br>
182 | 	 * <img src="{@docRoot}/doc-files/blocking.svg" alt="blocking">
183 | 	 * 
184 | 	 * @param arg1 value of the first argument of type A defined for this Delayed
185 | 	 *             Batch Executor
186 | 	 * @param arg2 value of the second argument of type B defined for this Delayed
187 | 	 *             Batch Executor
188 | 	 * @param arg3 value of the third argument of type C defined for this Delayed
189 | 	 *             Batch Executor
190 | 	 * @param arg4 value of the fourth argument of type D defined for this Delayed
191 | 	 *             Batch Executor
192 | 	 * @param arg5 value of the fifth argument of type E defined for this Delayed
193 | 	 *             Batch Executor
194 | 	 * @return the result of type Z
195 | 	 *
196 | 	 *
197 | 	 */
198 | 	public Z execute(A arg1, B arg2, C arg3, D arg4, E arg5) {
199 | 		TupleBlocking<Z> tupleBlocking = new TupleBlocking<>(arg1, arg2, arg3, arg4, arg5);
200 | 		enlistTuple(tupleBlocking);
201 | 		Z value = tupleBlocking.getValueBlocking();
202 | 		return value;
203 | 	}
204 | 
205 | 	/**
206 | 	 * Return a {@link Future } containing the corresponding value from the returned
207 | 	 * list of the batchCallBack method for the given argument <br>
208 | 	 * <br>
209 | 	 * The invoking thread is not blocked. The result will be available by invoking
210 | 	 * method {@link Future#get()} of the {@link Future }. This method will block
211 | 	 * the thread until the result is available <br>
212 | 	 * <br>
213 | 	 * <img src="{@docRoot}/doc-files/future.svg" alt ="future"> <br>
214 | 	 * It will throw a {@link RuntimeException} if the internal buffer Queue of this
215 | 	 * Delayed Batch Executor is full. <br>
216 | 	 * If a {@link RuntimeException} is thrown inside of the {@link BatchCallBack6
217 | 	 * }, then it will be the cause of the checked Exception
218 | 	 * {@link ExecutionException} thrown by {@link Future#get()} as per contract of
219 | 	 * {@link Future#get()} <br>
220 | 	 * <br>
221 | 	 * 
222 | 	 * @param arg1 value of the first argument of type A defined for this Delayed
223 | 	 *             Batch Executor
224 | 	 * @param arg2 value of the second argument of type B defined for this Delayed
225 | 	 *             Batch Executor
226 | 	 * @param arg3 value of the third argument of type C defined for this Delayed
227 | 	 *             Batch Executor
228 | 	 * @param arg4 value of the fourth argument of type D defined for this Delayed
229 | 	 *             Batch Executor
230 | 	 * @param arg5 value of the fifth argument of type E defined for this Delayed
231 | 	 *             Batch Executor
232 | 	 * @return a {@link Future } for the result of type Z
233 | 	 *
234 | 	 */
235 | 	public Future<Z> executeAsFuture(A arg1, B arg2, C arg3, D arg4, E arg5) {
236 | 		TupleFuture<Z> tupleFuture = new TupleFuture<>(arg1, arg2, arg3, arg4, arg5);
237 | 		enlistTuple(tupleFuture);
238 | 		Future<Z> future = tupleFuture.getFuture();
239 | 		return future;
240 | 	}
241 | 
242 | 	/**
243 | 	 * Return a <a href=
244 | 	 * "https://projectreactor.io/docs/core/release/api/reactor/core/publisher/Mono.html">Mono</a>,
245 | 	 * publishing the value obtained from the returned list of the batchCallBack
246 | 	 * method for the given parameter. <br>
247 | 	 * <br>
248 | 	 * The invoking thread is not blocked <br>
249 | 	 * <br>
250 | 	 * <img src="{@docRoot}/doc-files/mono.svg" alt="mono"> <br>
251 | 	 * It will throw a {@link RuntimeException} if the internal buffer Queue of this
252 | 	 * Delayed Batch Executor is full. <br>
253 | 	 * If a {@link RuntimeException} is thrown inside of the {@link BatchCallBack6},
254 | 	 * then it will be the propagated as any {@link RuntimeException } thrown from
255 | 	 * <a href=
256 | 	 * "https://projectreactor.io/docs/core/release/api/reactor/core/publisher/Mono.html">Mono</a>
257 | 	 * <br>
258 | 	 * <br>
259 | 	 * 
260 | 	 * @param arg1 value of the first argument of type A defined for this Delayed
261 | 	 *             Batch Executor
262 | 	 * @param arg2 value of the second argument of type B defined for this Delayed
263 | 	 *             Batch Executor
264 | 	 * @param arg3 value of the third argument of type C defined for this Delayed
265 | 	 *             Batch Executor
266 | 	 * @param arg4 value of the fourth argument of type D defined for this Delayed
267 | 	 *             Batch Executor
268 | 	 * @param arg5 value of the fifth argument of type E defined for this Delayed
269 | 	 *             Batch Executor
270 | 	 * @return a <a href=
271 | 	 *         "https://projectreactor.io/docs/core/release/api/reactor/core/publisher/Mono.html">Mono</a>
272 | 	 *         for the result of type Z
273 | 	 *
274 | 	 *
275 | 	 */
276 | 	public Mono<Z> executeAsMono(A arg1, B arg2, C arg3, D arg4, E arg5) {
277 | 		TupleMono<Z> tupleMono = new TupleMono<>(arg1, arg2, arg3, arg4, arg5);
278 | 		enlistTuple(tupleMono);
279 | 		Mono<Z> mono = tupleMono.getMono();
280 | 		return mono;
281 | 	}
282 | 
283 | 	@SuppressWarnings("unchecked")
284 | 	@Override
285 | 	protected List<Z> getResultListFromBatchCallBack(List<List<Object>> transposedTupleList) {
286 | 		return batchCallBack.apply((List<A>) transposedTupleList.get(0), (List<B>) transposedTupleList.get(1),
287 | 				(List<C>) transposedTupleList.get(2), (List<D>) transposedTupleList.get(3),
288 | 				(List<E>) transposedTupleList.get(4));
289 | 	}
290 | }


--------------------------------------------------------------------------------
/src/main/java/com/github/victormpcmun/delayedbatchexecutor/DelayedBatchExecutor7.java:
--------------------------------------------------------------------------------
  1 | package com.github.victormpcmun.delayedbatchexecutor;
  2 | 
  3 | import reactor.core.publisher.Mono;
  4 | 
  5 | import java.time.Duration;
  6 | import java.util.List;
  7 | import java.util.concurrent.ExecutionException;
  8 | import java.util.concurrent.ExecutorService;
  9 | import java.util.concurrent.Future;
 10 | 
 11 | /**
 12 |  * Delayed Batch Executor for six arguments (of types A,B,C,D,E,F) and return
 13 |  * type Z <br>
 14 |  * 
 15 |  * <pre>
 16 |  * {@code
 17 |  * DelayedBatchExecutor7<String,Integer,Integer,Integer,Integer,Integer,Integer> dbe = DelayedBatchExecutor7.create(Duration.ofMillis(50), 10, this::myBatchCallback);
 18 |  *
 19 |  * ...
 20 |  *
 21 |  * public void usingDelayedBatchExecutor(Integer param1, Integer param2, Integer param3, Integer param4,Integer param5,Integer param6) {
 22 |  *
 23 |  *    // using blocking behaviour
 24 |  *    String stringResult1 = dbe.execute(param1, param2, param3, param4, param5, param6); // the thread will be blocked until the result is available
 25 |  *    // compute with stringResult1
 26 |  *
 27 |  *
 28 |  *    // using Future
 29 |  *    Future<String> resultAsFutureString = dbe.executeAsFuture(param1, param2, param3, param4, param5, param6); // the thread will not  be blocked
 30 |  *    // compute something else
 31 |  *    String stringResult2 = resultAsFutureString.get();  // Blocks the thread if necessary for the computation to complete, and then retrieves its result.
 32 |  *    // compute with stringResult2
 33 |  *
 34 |  *
 35 |  *    // using Mono
 36 |  *    Mono<String> monoResult = dbe.executeAsMono(param1, param2, param3, param4, param5, param6); // the thread will not  be blocked
 37 |  *    // compute something else
 38 |  *    monoResult.subscribe(stringResult3 -> {
 39 |  *     // compute with stringResult3
 40 |  *    });
 41 |  * }
 42 |  *
 43 |  * ...
 44 |  *
 45 |  * List<String> myBatchCallback(List<Integer> arg1List, List<Integer> arg2List, List<Integer> arg3List, List<Integer> arg4List, List<Integer> arg5List, List<Integer> arg6List) {
 46 |  *   List<String> result = ...
 47 |  *   ...
 48 |  *   return result;
 49 |  *}
 50 |  *}
 51 |  * </pre>
 52 |  * 
 53 |  * @author Victor Porcar
 54 |  *
 55 |  */
 56 | 
 57 | public class DelayedBatchExecutor7<Z, A, B, C, D, E, F> extends DelayedBatchExecutor<Z> {
 58 | 
 59 | 	/**
 60 | 	 * Receive as argument six Lists of type A,B,C,D,E,F and returns a List of type
 61 | 	 * Z. It can be implemented as a lambda expression or method reference <br>
 62 | 	 * <br>
 63 | 	 * 
 64 | 	 * <pre>
 65 | 	 * <b>Lambda expression</b>
 66 | 	 * {@code
 67 | 	 * DelayedBatchExecutor7<String,Integer,Integer,Integer,Integer,Integer,Integer> dbe = DelayedBatchExecutor7.create(Duration.ofMillis(50), 10, (arg1List, arg2List, arg3list, arg4List, arg5List, arg6List) ->
 68 | 	 * {
 69 | 	 *      //arg1List,arg2List,arg3List,arg4List, arg5List and arg6List are List<Integer>
 70 | 	 *      List<String> result = ...
 71 | 	 *	    ...
 72 | 	 *      return result;
 73 | 	 *});
 74 | 	 *}
 75 | 	 * <b>Method reference</b>
 76 | 	 * {@code
 77 | 	 * DelayedBatchExecutor7<String,Integer,Integer,Integer,Integer,Integer,Integer> dbe = DelayedBatchExecutor7.create(Duration.ofMillis(50), 10, this::myBatchCallBack);
 78 | 	 * ...
 79 | 	 * List<String> myBatchCallBack(List<Integer> arg1List, List<Integer> arg2List, List<Integer> arg3List, List<Integer> arg4List, List<Integer> arg5List, List<Integer> arg6List) {
 80 | 	 *      List<String> result = ...
 81 | 	 *	    ...
 82 | 	 *      return result;
 83 | 	 *}
 84 | 	 *}
 85 | 	 * </pre>
 86 | 	 * 
 87 | 	 * @author Victor Porcar
 88 | 	 *
 89 | 	 */
 90 | 	@FunctionalInterface
 91 | 	public interface BatchCallBack7<Z, A, B, C, D, E, F> {
 92 | 		List<Z> apply(List<A> firstParam, List<B> secondParam, List<C> thirdParam, List<D> fourthParam,
 93 | 				List<E> fifthParam, List<F> sixthParam);
 94 | 	}
 95 | 
 96 | 	private final BatchCallBack7<Z, A, B, C, D, E, F> batchCallBack;
 97 | 
 98 | 	/**
 99 | 	 * Factory method to create an instance of a Delayed Batch Executor for six
100 | 	 * arguments (of types A,B,C,D,E,F) and return type Z. Similar to
101 | 	 * {@link DelayedBatchExecutor7#create(Duration, int, ExecutorService, int, boolean, BatchCallBack7)}
102 | 	 * defaulting to: <br>
103 | 	 * <br>
104 | 	 * -executorService: the one returned by static method
105 | 	 * {@link #getDefaultExecutorService()} <br>
106 | 	 * -bufferQueueSize: the value of constant {@link #DEFAULT_BUFFER_QUEUE_SIZE}
107 | 	 * <br>
108 | 	 * -removeDuplicates:true <br>
109 | 	 * 
110 | 	 * @param <Z>            the return type
111 | 	 * @param <A>            the type of the first argument
112 | 	 * @param <B>            the type of the second argument
113 | 	 * @param <C>            the type of the third argument
114 | 	 * @param <D>            the type of the fourth argument
115 | 	 * @param <E>            the type of the fifth argument
116 | 	 * @param <F>            the type of the sixth argument
117 | 	 * @param duration       the time window, defined as {@link Duration }.
118 | 	 * @param size           the max collected size. As soon as the count of
119 | 	 *                       collected parameters reaches this size, the
120 | 	 *                       batchCallBack method is executed
121 | 	 * @param batchCallback7 the method reference or lambda expression that receives
122 | 	 *                       a list of type A and returns a list of Type Z (see
123 | 	 *                       {@link BatchCallBack7})
124 | 	 * @return an instance of {@link DelayedBatchExecutor7}
125 | 	 *
126 | 	 */
127 | 
128 | 	public static <Z, A, B, C, D, E, F> DelayedBatchExecutor7<Z, A, B, C, D, E, F> create(Duration duration, int size,
129 | 			BatchCallBack7<Z, A, B, C, D, E, F> batchCallback7) {
130 | 		return new DelayedBatchExecutor7<>(duration, size, null, DEFAULT_BUFFER_QUEUE_SIZE, true, batchCallback7);
131 | 	}
132 | 
133 | 	/**
134 | 	 * Factory method to create an instance of a Delayed Batch Executor for two
135 | 	 * arguments (of types A,B,C,D and E) and return type Z <br>
136 | 	 * 
137 | 	 * @param <Z>              the return type
138 | 	 * @param <A>              the type of the first argument
139 | 	 * @param <B>              the type of the second argument
140 | 	 * @param <C>              the type of the third argument
141 | 	 * @param <D>              the type of the fourth argument
142 | 	 * @param <E>              the type of the fifth argument
143 | 	 * @param <F>              the type of the sixth argument
144 | 	 * @param duration         the time window, defined as {@link Duration }.
145 | 	 * @param size             the max collected size. As soon as the count of
146 | 	 *                         collected parameters reaches this size, the
147 | 	 *                         batchCallBack method is executed
148 | 	 * @param executorService  to define the pool of threads to executed the
149 | 	 *                         batchCallBack method in asynchronous mode
150 | 	 * @param bufferQueueSize  max size of the internal queue to buffer values.
151 | 	 * @param removeDuplicates if true then duplicated arguments from execute*(...)
152 | 	 *                         methods are not passed to the batchCallBack
153 | 	 *                         (considering same {@link Object#hashCode()} and being
154 | 	 *                         {@link Object#equals(Object)})
155 | 	 * @param batchCallback7   the method reference or lambda expression that
156 | 	 *                         receives a list of type A and returns a list of Type
157 | 	 *                         Z (see {@link BatchCallBack7})
158 | 	 * @return an instance of {@link DelayedBatchExecutor7}
159 | 	 *
160 | 	 */
161 | 
162 | 	public static <Z, A, B, C, D, E, F> DelayedBatchExecutor7<Z, A, B, C, D, E, F> create(Duration duration, int size,
163 | 			ExecutorService executorService, int bufferQueueSize, boolean removeDuplicates,
164 | 			BatchCallBack7<Z, A, B, C, D, E, F> batchCallback7) {
165 | 		return new DelayedBatchExecutor7<>(duration, size, executorService, bufferQueueSize, removeDuplicates,
166 | 				batchCallback7);
167 | 	}
168 | 
169 | 	private DelayedBatchExecutor7(Duration duration, int size, ExecutorService executorService, int bufferQueueSize,
170 | 			boolean removeDuplicates, BatchCallBack7<Z, A, B, C, D, E, F> batchCallBack) {
171 | 		super(duration, size, executorService, bufferQueueSize, removeDuplicates);
172 | 		this.batchCallBack = batchCallBack;
173 | 	}
174 | 
175 | 	/**
176 | 	 * Return the result of type Z (blocking the thread until the result is
177 | 	 * available), which is obtained from the returned list of the batchCallBack
178 | 	 * method for the given argument <br>
179 | 	 * <br>
180 | 	 * It will throw any {@link RuntimeException} thrown inside of the
181 | 	 * {@link BatchCallBack7 } <br>
182 | 	 * It will throw a {@link RuntimeException} if the internal buffer Queue of this
183 | 	 * Delayed Batch Executor is full. <br>
184 | 	 * <br>
185 | 	 * <img src="{@docRoot}/doc-files/blocking.svg" alt="blocking">
186 | 	 * 
187 | 	 * @param arg1 value of the first argument of type A defined for this Delayed
188 | 	 *             Batch Executor
189 | 	 * @param arg2 value of the second argument of type B defined for this Delayed
190 | 	 *             Batch Executor
191 | 	 * @param arg3 value of the third argument of type C defined for this Delayed
192 | 	 *             Batch Executor
193 | 	 * @param arg4 value of the fourth argument of type D defined for this Delayed
194 | 	 *             Batch Executor
195 | 	 * @param arg5 value of the fifth argument of type E defined for this Delayed
196 | 	 *             Batch Executor
197 | 	 * @param arg6 value of the sixth argument of type F defined for this Delayed
198 | 	 *             Batch Executor
199 | 	 * @return the result of type Z
200 | 	 *
201 | 	 *
202 | 	 */
203 | 	public Z execute(A arg1, B arg2, C arg3, D arg4, E arg5, F arg6) {
204 | 		TupleBlocking<Z> tupleBlocking = new TupleBlocking<>(arg1, arg2, arg3, arg4, arg5, arg6);
205 | 		enlistTuple(tupleBlocking);
206 | 		Z value = tupleBlocking.getValueBlocking();
207 | 		return value;
208 | 	}
209 | 
210 | 	/**
211 | 	 * Return a {@link Future } containing the corresponding value from the returned
212 | 	 * list of the batchCallBack method for the given argument <br>
213 | 	 * <br>
214 | 	 * The invoking thread is not blocked. The result will be available by invoking
215 | 	 * method {@link Future#get()} of the {@link Future }. This method will block
216 | 	 * the thread until the result is available <br>
217 | 	 * <br>
218 | 	 * <img src="{@docRoot}/doc-files/future.svg" alt ="future"> <br>
219 | 	 * It will throw a {@link RuntimeException} if the internal buffer Queue of this
220 | 	 * Delayed Batch Executor is full. <br>
221 | 	 * If a {@link RuntimeException} is thrown inside of the {@link BatchCallBack7
222 | 	 * }, then it will be the cause of the checked Exception
223 | 	 * {@link ExecutionException} thrown by {@link Future#get()} as per contract of
224 | 	 * {@link Future#get()} <br>
225 | 	 * <br>
226 | 	 * 
227 | 	 * @param arg1 value of the first argument of type A defined for this Delayed
228 | 	 *             Batch Executor
229 | 	 * @param arg2 value of the second argument of type B defined for this Delayed
230 | 	 *             Batch Executor
231 | 	 * @param arg3 value of the third argument of type C defined for this Delayed
232 | 	 *             Batch Executor
233 | 	 * @param arg4 value of the fourth argument of type D defined for this Delayed
234 | 	 *             Batch Executor
235 | 	 * @param arg5 value of the fifth argument of type E defined for this Delayed
236 | 	 *             Batch Executor
237 | 	 * @param arg6 value of the sixth argument of type F defined for this Delayed
238 | 	 *             Batch Executor
239 | 	 * @return a {@link Future } for the result of type Z
240 | 	 *
241 | 	 */
242 | 	public Future<Z> executeAsFuture(A arg1, B arg2, C arg3, D arg4, E arg5, F arg6) {
243 | 		TupleFuture<Z> tupleFuture = new TupleFuture<>(arg1, arg2, arg3, arg4, arg5, arg6);
244 | 		enlistTuple(tupleFuture);
245 | 		Future<Z> future = tupleFuture.getFuture();
246 | 		return future;
247 | 	}
248 | 
249 | 	/**
250 | 	 * Return a <a href=
251 | 	 * "https://projectreactor.io/docs/core/release/api/reactor/core/publisher/Mono.html">Mono</a>,
252 | 	 * publishing the value obtained from the returned list of the batchCallBack
253 | 	 * method for the given parameter. <br>
254 | 	 * <br>
255 | 	 * The invoking thread is not blocked <br>
256 | 	 * <br>
257 | 	 * <img src="{@docRoot}/doc-files/mono.svg" alt="mono"> <br>
258 | 	 * It will throw a {@link RuntimeException} if the internal buffer Queue of this
259 | 	 * Delayed Batch Executor is full. <br>
260 | 	 * If a {@link RuntimeException} is thrown inside of the {@link BatchCallBack7},
261 | 	 * then it will be the propagated as any {@link RuntimeException } thrown from
262 | 	 * <a href=
263 | 	 * "https://projectreactor.io/docs/core/release/api/reactor/core/publisher/Mono.html">Mono</a>
264 | 	 * <br>
265 | 	 * <br>
266 | 	 * 
267 | 	 * @param arg1 value of the first argument of type A defined for this Delayed
268 | 	 *             Batch Executor
269 | 	 * @param arg2 value of the second argument of type B defined for this Delayed
270 | 	 *             Batch Executor
271 | 	 * @param arg3 value of the third argument of type C defined for this Delayed
272 | 	 *             Batch Executor
273 | 	 * @param arg4 value of the fourth argument of type D defined for this Delayed
274 | 	 *             Batch Executor
275 | 	 * @param arg5 value of the fifth argument of type E defined for this Delayed
276 | 	 *             Batch Executor
277 | 	 * @param arg6 value of the sixth argument of type F defined for this Delayed
278 | 	 *             Batch Executor
279 | 	 * @return a <a href=
280 | 	 *         "https://projectreactor.io/docs/core/release/api/reactor/core/publisher/Mono.html">Mono</a>
281 | 	 *         for the result of type Z
282 | 	 *
283 | 	 *
284 | 	 */
285 | 	public Mono<Z> executeAsMono(A arg1, B arg2, C arg3, D arg4, E arg5, F arg6) {
286 | 		TupleMono<Z> tupleMono = new TupleMono<>(arg1, arg2, arg3, arg4, arg5, arg6);
287 | 		enlistTuple(tupleMono);
288 | 		Mono<Z> mono = tupleMono.getMono();
289 | 		return mono;
290 | 	}
291 | 
292 | 	@SuppressWarnings("unchecked")
293 | 	@Override
294 | 	protected List<Z> getResultListFromBatchCallBack(List<List<Object>> transposedTupleList) {
295 | 		return batchCallBack.apply((List<A>) transposedTupleList.get(0), (List<B>) transposedTupleList.get(1),
296 | 				(List<C>) transposedTupleList.get(2), (List<D>) transposedTupleList.get(3),
297 | 				(List<E>) transposedTupleList.get(4), (List<F>) transposedTupleList.get(5));
298 | 	}
299 | }


--------------------------------------------------------------------------------
/src/main/java/com/github/victormpcmun/delayedbatchexecutor/DelayedBatchExecutor.java:
--------------------------------------------------------------------------------
  1 | package com.github.victormpcmun.delayedbatchexecutor;
  2 | 
  3 | import java.time.Duration;
  4 | import java.util.ArrayList;
  5 | import java.util.Collections;
  6 | import java.util.List;
  7 | import java.util.Map;
  8 | import java.util.Queue;
  9 | import java.util.concurrent.ArrayBlockingQueue;
 10 | import java.util.concurrent.CompletableFuture;
 11 | import java.util.concurrent.ExecutorService;
 12 | import java.util.concurrent.Executors;
 13 | import java.util.concurrent.ThreadFactory;
 14 | import java.util.concurrent.atomic.AtomicInteger;
 15 | import java.util.concurrent.atomic.AtomicLong;
 16 | 
 17 | import reactor.core.publisher.UnicastProcessor;
 18 | 
 19 | abstract class DelayedBatchExecutor<Z> implements AutoCloseable {
 20 | 
 21 | 	private static final String TO_STRING_FORMAT = "DelayedBatchExecutor {invocationsCounter=%d, callBackExecutionsCounter=%d, duration=%d, size=%d, bufferQueueSize=%d}";
 22 | 
 23 | 	/**
 24 | 	 * {@value com.github.victormpcmun.delayedbatchexecutor.DelayedBatchExecutor#MIN_TIME_WINDOW_TIME_IN_MILLISECONDS}
 25 | 	 */
 26 | 	public static final int MIN_TIME_WINDOW_TIME_IN_MILLISECONDS = 1;
 27 | 
 28 | 	/**
 29 | 	 * {@value com.github.victormpcmun.delayedbatchexecutor.DelayedBatchExecutor#MAX_TIME_WINDOW_TIME_IN_MILLISECONDS}
 30 | 	 */
 31 | 	public static final int MAX_TIME_WINDOW_TIME_IN_MILLISECONDS = 60 * 60 * 1000;
 32 | 
 33 | 	/**
 34 | 	 * {@value com.github.victormpcmun.delayedbatchexecutor.DelayedBatchExecutor#DEFAULT_FIXED_THREAD_POOL_COUNTER}
 35 | 	 */
 36 | 	public static final int DEFAULT_FIXED_THREAD_POOL_COUNTER = 4;
 37 | 
 38 | 	/**
 39 | 	 * {@value com.github.victormpcmun.delayedbatchexecutor.DelayedBatchExecutor#DEFAULT_FIXED_THREAD_NAME_PREFIX}
 40 | 	 */
 41 | 	public static final String DEFAULT_FIXED_THREAD_NAME_PREFIX = "delayed-batch-executor-";
 42 | 
 43 | 	/**
 44 | 	 * {@value com.github.victormpcmun.delayedbatchexecutor.DelayedBatchExecutor#DEFAULT_BUFFER_QUEUE_SIZE}
 45 | 	 */
 46 | 	public static final int DEFAULT_BUFFER_QUEUE_SIZE = 8192;
 47 | 
 48 | 	private final AtomicLong invocationsCounter;
 49 | 	private final AtomicLong callBackExecutionsCounter;
 50 | 
 51 | 	private Duration duration;
 52 | 	private int maxSize;
 53 | 	private ExecutorService executorService;
 54 | 	private int bufferQueueSize;
 55 | 	private UnicastProcessor<Tuple<Z>> source;
 56 | 	private boolean removeDuplicates;
 57 | 
 58 | 	private final boolean defaultExecutorServiceCreated;
 59 | 
 60 | 	protected DelayedBatchExecutor(Duration duration, int maxSize, ExecutorService executorService, int bufferQueueSize,
 61 | 			boolean removeDuplicates) {
 62 | 		if (executorService == null) {
 63 | 			executorService = getDefaultExecutorService();
 64 | 			defaultExecutorServiceCreated = true;
 65 | 		} else {
 66 | 			defaultExecutorServiceCreated = false;
 67 | 		}
 68 | 		boolean configurationSuccessful = updateConfig(duration, maxSize, executorService, bufferQueueSize,
 69 | 				removeDuplicates);
 70 | 		if (!configurationSuccessful) {
 71 | 			throw new RuntimeException("Illegal configuration parameters");
 72 | 		}
 73 | 		this.invocationsCounter = new AtomicLong(0);
 74 | 		this.callBackExecutionsCounter = new AtomicLong(0);
 75 | 		this.removeDuplicates = removeDuplicates;
 76 | 	}
 77 | 
 78 | 	/**
 79 | 	 * Update the Duration and maxSize params of this Delayed Batch Executor,
 80 | 	 * keeping the current existing value for executorService, bufferQueueSize and
 81 | 	 * removeDuplicates <br>
 82 | 	 * <br>
 83 | 	 * This method is thread safe <br>
 84 | 	 * 
 85 | 	 * @param duration the new {@link Duration} for this Delayed Batch Executor
 86 | 	 * @param maxSize  the new maxsize for this Delayed Batch Executor
 87 | 	 * @return true if the configuration was successful updated, false otherwise
 88 | 	 *
 89 | 	 */
 90 | 	public boolean updateConfig(Duration duration, int maxSize) {
 91 | 		return updateConfig(duration, maxSize, executorService, bufferQueueSize, removeDuplicates);
 92 | 	}
 93 | 
 94 | 	/**
 95 | 	 * Update the Duration, maxsize, ExecutorService, bufferQueueSize and
 96 | 	 * removeDuplicates params of this Delayed Batch Executor <br>
 97 | 	 * <br>
 98 | 	 * This method is thread safe <br>
 99 | 	 * 
100 | 	 * @param duration         the new {@link Duration} for this Delayed Batch
101 | 	 *                         Executor
102 | 	 * @param maxSize          the new maxsize for this Delayed Batch Executor
103 | 	 * @param executorService  the new {@link ExecutorService} for this Delayed
104 | 	 *                         Batch Executor
105 | 	 * @param bufferQueueSize  max size of the internal queue to buffer values
106 | 	 * @param removeDuplicates if true then duplicated arguments from execute*(...)
107 | 	 *                         methods are not passed to the batchCallBack
108 | 	 *                         (considering same {@link Object#hashCode()} and being
109 | 	 *                         {@link Object#equals(Object)})
110 | 	 * @return true if the configuration was successful updated, false otherwise
111 | 	 *
112 | 	 */
113 | 	public synchronized boolean updateConfig(Duration duration, int maxSize, ExecutorService executorService,
114 | 			int bufferQueueSize, boolean removeDuplicates) {
115 | 		boolean validateConfig = validateConfigurationParameters(duration, maxSize, executorService, bufferQueueSize);
116 | 		if (validateConfig) {
117 | 			boolean parameterAreEqualToCurrentOnes = parameterAreEqualToCurrentOnes(duration, maxSize, executorService,
118 | 					bufferQueueSize);
119 | 			if (!parameterAreEqualToCurrentOnes) {
120 | 				this.maxSize = maxSize;
121 | 				this.duration = duration;
122 | 				this.executorService = executorService;
123 | 				this.bufferQueueSize = bufferQueueSize;
124 | 				this.source = createBufferedTimeoutUnicastProcessor(duration, maxSize, bufferQueueSize,
125 | 						removeDuplicates);
126 | 
127 | 			}
128 | 		}
129 | 		return validateConfig;
130 | 	}
131 | 
132 | 	/**
133 | 	 * The count of invocations of all of the execute methods of this Delayed Batch
134 | 	 * Executor: execute(...), executeAsFuture(...) or executeAsMono(...) since the
135 | 	 * creation of this Delayed Batch Executor
136 | 	 * 
137 | 	 * @return the count of invocations of all blocking, Future and Mono invocations
138 | 	 *         since the creation of this Delayed Batch Executor
139 | 	 *
140 | 	 */
141 | 	public Long getInvocationsCounter() {
142 | 		return invocationsCounter.get();
143 | 	}
144 | 
145 | 	/**
146 | 	 * The count of executions of the batchCallBack method since the creation of
147 | 	 * this Delayed Batch Executor
148 | 	 * 
149 | 	 * @return the count of executions of the batchCallBack method since the
150 | 	 *         creation of this Delayed Batch Executor
151 | 	 *
152 | 	 */
153 | 	public Long getCallBackExecutionsCounter() {
154 | 		return callBackExecutionsCounter.get();
155 | 	}
156 | 
157 | 	/**
158 | 	 * The current {@link Duration} of this Delayed Batch Executor
159 | 	 * 
160 | 	 * @return the current {@link Duration} of this Delayed Batch Executor
161 | 	 *
162 | 	 */
163 | 	public Duration getDuration() {
164 | 		return duration;
165 | 	}
166 | 
167 | 	/**
168 | 	 * The current size of this Delayed Batch Executor
169 | 	 * 
170 | 	 * @return the current size of this Delayed Batch Executor
171 | 	 *
172 | 	 */
173 | 	public Integer getMaxSize() {
174 | 		return maxSize;
175 | 	}
176 | 
177 | 	/**
178 | 	 * The current max size of the internal queue to buffer values
179 | 	 * 
180 | 	 * @return the current max size of the internal queue to buffer values
181 | 	 *
182 | 	 */
183 | 	public Integer getBufferQueueSize() {
184 | 		return bufferQueueSize;
185 | 	}
186 | 
187 | 	/**
188 | 	 * The current ExecutorService
189 | 	 * 
190 | 	 * @return the current ExecutorService
191 | 	 *
192 | 	 */
193 | 	public ExecutorService getExecutorService() {
194 | 		return executorService;
195 | 	}
196 | 
197 | 	/**
198 | 	 * The removeDuplicates behaviour flag
199 | 	 * 
200 | 	 * @return the removeDuplicates behaviour flag
201 | 	 *
202 | 	 */
203 | 
204 | 	public boolean isRemoveDuplicates() {
205 | 		return removeDuplicates;
206 | 	}
207 | 
208 | 	/**
209 | 	 * static method that creates the default Executor Service, which is a
210 | 	 * {@link java.util.concurrent.Executors#newFixedThreadPool(int)} with the
211 | 	 * following number of threads given by constant
212 | 	 * {@link #DEFAULT_FIXED_THREAD_POOL_COUNTER}
213 | 	 * 
214 | 	 * @return the default Executor Service
215 | 	 */
216 | 
217 | 	protected ExecutorService getDefaultExecutorService() {
218 | 		return getDefaultExecutorService(DEFAULT_FIXED_THREAD_POOL_COUNTER);
219 | 	}
220 | 
221 | 	/**
222 | 	 * static method that creates the default Executor Service, which is a
223 | 	 * {@link java.util.concurrent.Executors#newFixedThreadPool(int)} with the given
224 | 	 * number of threads
225 | 	 * 
226 | 	 * @param threads number of threads of the FixedThreadPool
227 | 	 * @return the default Executor Service
228 | 	 */
229 | 
230 | 	private ExecutorService getDefaultExecutorService(int threads) {
231 | 		return Executors.newFixedThreadPool(threads, new ThreadFactory() {
232 | 			private final AtomicInteger threadNumber = new AtomicInteger(1);
233 | 
234 | 			@Override
235 | 			public Thread newThread(Runnable runnable) {
236 | 				return new Thread(runnable, DEFAULT_FIXED_THREAD_NAME_PREFIX + threadNumber.getAndIncrement());
237 | 			}
238 | 		});
239 | 	}
240 | 
241 | 	@Override
242 | 	public void close() {
243 | 		if (defaultExecutorServiceCreated && !executorService.isShutdown()) {
244 | 			executorService.shutdown();
245 | 		}
246 | 	}
247 | 
248 | 	@Override
249 | 	public String toString() {
250 | 		return String.format(TO_STRING_FORMAT, invocationsCounter.get(), callBackExecutionsCounter.get(),
251 | 				duration.toMillis(), maxSize, bufferQueueSize);
252 | 	}
253 | 
254 | 	protected void enlistTuple(Tuple<Z> param) {
255 | 		invocationsCounter.incrementAndGet();
256 | 		source.onNext(param);
257 | 	}
258 | 
259 | 	protected abstract List<Z> getResultListFromBatchCallBack(List<List<Object>> transposedTupleList);
260 | 
261 | 	private void invokeBatchCallBackAndContinue(List<Tuple<Z>> tupleList) {
262 | 		List<Z> rawResultList = null;
263 | 		List<Z> resultFromCallBack;
264 | 		RuntimeException runtimeException = null;
265 | 		try {
266 | 			List<List<Object>> transposedTupleList = TupleListTransposer.transposeValuesAsListOfList(tupleList);
267 | 			rawResultList = getResultListFromBatchCallBack(transposedTupleList);
268 | 		} catch (RuntimeException re) {
269 | 			runtimeException = re;
270 | 		} finally {
271 | 			resultFromCallBack = resizeListFillingWithNullsIfNecessary(rawResultList, tupleList.size());
272 | 		}
273 | 
274 | 		for (int indexTuple = 0; indexTuple < tupleList.size(); indexTuple++) {
275 | 			Tuple<Z> tuple = tupleList.get(indexTuple);
276 | 			tuple.setResult(resultFromCallBack.get(indexTuple));
277 | 			tuple.setRuntimeException(runtimeException);
278 | 			tuple.continueIfIsWaiting();
279 | 		}
280 | 	}
281 | 
282 | 	private void assignValuesToDuplicatesAndContinue(TupleListDuplicatedFinder<Z> tupleListDuplicatedFinder) {
283 | 		Map<Integer, Integer> duplicatedMapIndex = tupleListDuplicatedFinder.getDuplicatedMapIndex();
284 | 		List<Tuple<Z>> allTupleList = tupleListDuplicatedFinder.getAllTupleList();
285 | 		for (Integer duplicatedIndex : duplicatedMapIndex.keySet()) {
286 | 			Tuple<Z> duplicatedTuple = allTupleList.get(duplicatedIndex);
287 | 			Tuple<Z> uniqueTuple = allTupleList.get(duplicatedMapIndex.get(duplicatedIndex));
288 | 			duplicatedTuple.copyResultAndRuntimeExceptionFromTuple(uniqueTuple);
289 | 			duplicatedTuple.continueIfIsWaiting();
290 | 		}
291 | 	}
292 | 
293 | 	private void executeBatchCallBackRemovingDuplicates(List<Tuple<Z>> tupleList) {
294 | 		callBackExecutionsCounter.incrementAndGet();
295 | 		CompletableFuture.runAsync(() -> {
296 | 			TupleListDuplicatedFinder<Z> tupleListDuplicatedFinder = new TupleListDuplicatedFinder<>(tupleList);
297 | 			List<Tuple<Z>> tupleListUnique = tupleListDuplicatedFinder.getTupleListUnique();
298 | 			invokeBatchCallBackAndContinue(tupleListUnique);
299 | 			assignValuesToDuplicatesAndContinue(tupleListDuplicatedFinder);
300 | 		}, this.executorService);
301 | 	}
302 | 
303 | 	private void executeBatchCallBackNotRemovingDuplicates(List<Tuple<Z>> tupleList) {
304 | 		callBackExecutionsCounter.incrementAndGet();
305 | 		CompletableFuture.runAsync(() -> {
306 | 			invokeBatchCallBackAndContinue(tupleList);
307 | 		}, this.executorService);
308 | 	}
309 | 
310 | 	private UnicastProcessor<Tuple<Z>> createBufferedTimeoutUnicastProcessor(Duration duration, int maxSize,
311 | 			int bufferQueueSize, boolean removeDuplicates) {
312 | 		Queue<Tuple<Z>> blockingQueue = new ArrayBlockingQueue<>(bufferQueueSize); // =>
313 | 																					// https://github.com/reactor/reactor-core/issues/469#issuecomment-286040390
314 | 		UnicastProcessor<Tuple<Z>> newSource = UnicastProcessor.create(blockingQueue);
315 | 		if (removeDuplicates) {
316 | 			newSource.publish().autoConnect().bufferTimeout(maxSize, duration)
317 | 					.subscribe(this::executeBatchCallBackRemovingDuplicates);
318 | 		} else {
319 | 			newSource.publish().autoConnect().bufferTimeout(maxSize, duration)
320 | 					.subscribe(this::executeBatchCallBackNotRemovingDuplicates);
321 | 		}
322 | 		return newSource;
323 | 	}
324 | 
325 | 	private boolean validateConfigurationParameters(Duration duration, int maxSize, ExecutorService executorService,
326 | 			int bufferQueueSize) {
327 | 		boolean sizeValidation = (maxSize >= 1);
328 | 		boolean durationValidation = duration != null && duration.toMillis() >= MIN_TIME_WINDOW_TIME_IN_MILLISECONDS
329 | 				&& duration.toMillis() <= MAX_TIME_WINDOW_TIME_IN_MILLISECONDS;
330 | 		boolean executorServiceValidation = (executorService != null);
331 | 		boolean bufferQueueSizeValidation = (bufferQueueSize >= 1);
332 | 		return sizeValidation && durationValidation && executorServiceValidation && bufferQueueSizeValidation;
333 | 	}
334 | 
335 | 	private boolean parameterAreEqualToCurrentOnes(Duration duration, int size, ExecutorService executorService,
336 | 			int bufferQueueSize) {
337 | 		boolean sameDuration = this.duration != null && this.duration.compareTo(duration) == 0;
338 | 		boolean sameSize = (this.maxSize == size);
339 | 		boolean sameExecutorService = this.executorService != null && this.executorService == executorService; // same
340 | 																												// reference
341 | 																												// is
342 | 																												// enough
343 | 		boolean sameBufferQueueSize = (this.bufferQueueSize == bufferQueueSize);
344 | 		return sameDuration && sameSize && sameExecutorService && sameBufferQueueSize;
345 | 	}
346 | 
347 | 	private <E> List<E> resizeListFillingWithNullsIfNecessary(List<E> list, int desiredSize) {
348 | 		if (list == null) {
349 | 			list = Collections.nCopies(desiredSize, null);
350 | 		} else if (list.size() < desiredSize) {
351 | 			list = new ArrayList<>(list); // make it mutable in case it isn't
352 | 			list.addAll(Collections.nCopies(desiredSize - list.size(), null));
353 | 		}
354 | 		return list;
355 | 	}
356 | }
357 | 


--------------------------------------------------------------------------------
/src/main/javadoc/doc-files/future.svg:
--------------------------------------------------------------------------------
1 | <?xml version="1.0" encoding="UTF-8"?>
2 | <!DOCTYPE svg PUBLIC "-//W3C//DTD SVG 1.1//EN" "http://www.w3.org/Graphics/SVG/1.1/DTD/svg11.dtd">
3 | <svg xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" version="1.1" width="741px" height="281px" viewBox="-0.5 -0.5 741 281" content="&lt;mxfile host=&quot;app.diagrams.net&quot; modified=&quot;2020-03-15T17:11:49.555Z&quot; agent=&quot;Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/80.0.3987.132 Safari/537.36&quot; etag=&quot;aG-Eq-E9233GHzxSYSZ5&quot; version=&quot;12.8.5&quot; type=&quot;device&quot;&gt;&lt;diagram name=&quot;Page-1&quot; id=&quot;13e1069c-82ec-6db2-03f1-153e76fe0fe0&quot;&gt;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&lt;/diagram&gt;&lt;/mxfile&gt;" style="background-color: rgb(255, 255, 255);"><defs><linearGradient x1="0%" y1="0%" x2="0%" y2="100%" id="mx-gradient-dae8fc-1-7ea6e0-1-s-0"><stop offset="0%" style="stop-color:#dae8fc"/><stop offset="100%" style="stop-color:#7ea6e0"/></linearGradient><linearGradient x1="0%" y1="0%" x2="0%" y2="100%" id="mx-gradient-fff2cc-1-ffd966-1-s-0"><stop offset="0%" style="stop-color:#fff2cc"/><stop offset="100%" style="stop-color:#ffd966"/></linearGradient><linearGradient x1="0%" y1="0%" x2="0%" y2="100%" id="mx-gradient-ffcd28-1-ffa500-1-s-0"><stop offset="0%" style="stop-color:#ffcd28"/><stop offset="100%" style="stop-color:#ffa500"/></linearGradient></defs><g><rect x="172" y="0" width="100" height="40" rx="6" ry="6" fill="url(#mx-gradient-dae8fc-1-7ea6e0-1-s-0)" stroke="#6c8ebf" pointer-events="all"/><path d="M 222 40 L 222 276" fill="none" stroke="#6c8ebf" stroke-miterlimit="10" stroke-dasharray="3 3" pointer-events="all"/><g transform="translate(-0.5 -0.5)"><switch><foreignObject style="overflow: visible; text-align: left;" pointer-events="none" width="100%" height="100%" requiredFeatures="http://www.w3.org/TR/SVG11/feature#Extensibility"><div xmlns="http://www.w3.org/1999/xhtml" style="display: flex; align-items: unsafe center; justify-content: unsafe center; width: 98px; height: 1px; padding-top: 20px; margin-left: 173px;"><div style="box-sizing: border-box; font-size: 0; text-align: center; "><div style="display: inline-block; font-size: 12px; font-family: Verdana; color: #000000; line-height: 1.2; pointer-events: all; white-space: normal; word-wrap: normal; "><font style="font-size: 14px">Thread 2</font></div></div></div></foreignObject><text x="222" y="24" fill="#000000" font-family="Verdana" font-size="12px" text-anchor="middle">Thread 2</text></switch></g><rect x="348" y="1" width="100" height="40" rx="6" ry="6" fill="url(#mx-gradient-dae8fc-1-7ea6e0-1-s-0)" stroke="#6c8ebf" pointer-events="all"/><path d="M 398 41 L 398 278" fill="none" stroke="#6c8ebf" stroke-miterlimit="10" stroke-dasharray="3 3" pointer-events="all"/><g transform="translate(-0.5 -0.5)"><switch><foreignObject style="overflow: visible; text-align: left;" pointer-events="none" width="100%" height="100%" requiredFeatures="http://www.w3.org/TR/SVG11/feature#Extensibility"><div xmlns="http://www.w3.org/1999/xhtml" style="display: flex; align-items: unsafe center; justify-content: unsafe center; width: 98px; height: 1px; padding-top: 21px; margin-left: 349px;"><div style="box-sizing: border-box; font-size: 0; text-align: center; "><div style="display: inline-block; font-size: 12px; font-family: Verdana; color: #000000; line-height: 1.2; pointer-events: all; white-space: normal; word-wrap: normal; "><font style="font-size: 14px">Thread n</font></div></div></div></foreignObject><text x="398" y="25" fill="#000000" font-family="Verdana" font-size="12px" text-anchor="middle">Thread n</text></switch></g><rect x="173" y="252" width="104" height="16" fill="#ffffff" stroke="none" pointer-events="all"/><rect x="353" y="250" width="104" height="16" fill="#ffffff" stroke="none" pointer-events="all"/><rect x="0" y="0" width="110" height="40" rx="6" ry="6" fill="url(#mx-gradient-dae8fc-1-7ea6e0-1-s-0)" stroke="#6c8ebf" pointer-events="all"/><path d="M 55 40 L 55 280" fill="none" stroke="#6c8ebf" stroke-miterlimit="10" stroke-dasharray="3 3" pointer-events="all"/><g transform="translate(-0.5 -0.5)"><switch><foreignObject style="overflow: visible; text-align: left;" pointer-events="none" width="100%" height="100%" requiredFeatures="http://www.w3.org/TR/SVG11/feature#Extensibility"><div xmlns="http://www.w3.org/1999/xhtml" style="display: flex; align-items: unsafe center; justify-content: unsafe center; width: 108px; height: 1px; padding-top: 20px; margin-left: 1px;"><div style="box-sizing: border-box; font-size: 0; text-align: center; "><div style="display: inline-block; font-size: 12px; font-family: Verdana; color: #000000; line-height: 1.2; pointer-events: all; white-space: normal; word-wrap: normal; "><font style="font-size: 14px">Thread 1</font></div></div></div></foreignObject><text x="55" y="24" fill="#000000" font-family="Verdana" font-size="12px" text-anchor="middle">Thread 1</text></switch></g><rect x="44.5" y="150.75" width="21" height="66.5" fill="#f8cecc" stroke="#b85450" pointer-events="all"/><rect x="32" y="174" width="40" height="20" fill="none" stroke="none" transform="rotate(-90,52,184)" pointer-events="all"/><g transform="translate(-0.5 -0.5)rotate(-90 52 184)"><switch><foreignObject style="overflow: visible; text-align: left;" pointer-events="none" width="100%" height="100%" requiredFeatures="http://www.w3.org/TR/SVG11/feature#Extensibility"><div xmlns="http://www.w3.org/1999/xhtml" style="display: flex; align-items: unsafe center; justify-content: unsafe center; width: 38px; height: 1px; padding-top: 184px; margin-left: 33px;"><div style="box-sizing: border-box; font-size: 0; text-align: center; "><div style="display: inline-block; font-size: 12px; font-family: Helvetica; color: #000000; line-height: 1.2; pointer-events: all; white-space: normal; word-wrap: normal; "><font face="Courier New" size="1"><b style="font-size: 12px">blocked</b></font></div></div></div></foreignObject><text x="52" y="188" fill="#000000" font-family="Helvetica" font-size="12px" text-anchor="middle">blocked</text></switch></g><rect x="12" y="132" width="104" height="16" fill="#ffffff" stroke="none" pointer-events="all"/><rect x="8" y="124" width="110" height="22" fill="none" stroke="none" pointer-events="all"/><g transform="translate(-0.5 -0.5)"><switch><foreignObject style="overflow: visible; text-align: left;" pointer-events="none" width="100%" height="100%" requiredFeatures="http://www.w3.org/TR/SVG11/feature#Extensibility"><div xmlns="http://www.w3.org/1999/xhtml" style="display: flex; align-items: unsafe flex-start; justify-content: unsafe flex-start; width: 1px; height: 1px; padding-top: 131px; margin-left: 10px;"><div style="box-sizing: border-box; font-size: 0; text-align: left; "><div style="display: inline-block; font-size: 12px; font-family: Helvetica; color: #000000; line-height: 1.2; pointer-events: all; white-space: nowrap; "><font face="Courier New" style="font-size: 11px">result = f.get()</font></div></div></div></foreignObject><text x="10" y="143" fill="#000000" font-family="Helvetica" font-size="12px">result = f.get()</text></switch></g><rect x="572" y="0" width="168" height="40" rx="6" ry="6" fill="url(#mx-gradient-dae8fc-1-7ea6e0-1-s-0)" stroke="#6c8ebf" pointer-events="all"/><path d="M 656 40 L 656 280" fill="none" stroke="#6c8ebf" stroke-miterlimit="10" stroke-dasharray="3 3" pointer-events="all"/><g transform="translate(-0.5 -0.5)"><switch><foreignObject style="overflow: visible; text-align: left;" pointer-events="none" width="100%" height="100%" requiredFeatures="http://www.w3.org/TR/SVG11/feature#Extensibility"><div xmlns="http://www.w3.org/1999/xhtml" style="display: flex; align-items: unsafe center; justify-content: unsafe center; width: 166px; height: 1px; padding-top: 20px; margin-left: 573px;"><div style="box-sizing: border-box; font-size: 0; text-align: center; "><div style="display: inline-block; font-size: 12px; font-family: Verdana; color: #000000; line-height: 1.2; pointer-events: all; white-space: normal; word-wrap: normal; "><font style="font-size: 14px">DelayedBatchExecutor</font></div></div></div></foreignObject><text x="656" y="24" fill="#000000" font-family="Verdana" font-size="12px" text-anchor="middle">DelayedBatchExecutor</text></switch></g><rect x="572" y="78" width="168" height="138" fill="url(#mx-gradient-fff2cc-1-ffd966-1-s-0)" stroke="#d6b656" pointer-events="all"/><rect x="636" y="90" width="40" height="72" fill="#f5f5f5" stroke="#666666" pointer-events="all"/><path d="M 636 125 L 676 125" fill="none" stroke="#000000" stroke-width="2" stroke-miterlimit="10" pointer-events="all"/><path d="M 636 105 L 676 105" fill="none" stroke="#000000" stroke-width="2" stroke-miterlimit="10" pointer-events="all"/><path d="M 636 143 L 676 143" fill="none" stroke="#000000" stroke-width="2" stroke-miterlimit="10" pointer-events="all"/><path d="M 652 127 L 666 122 L 666 125.5 L 708 125.5 L 708 122 L 722 127 L 708 132 L 708 128.5 L 666 128.5 L 666 132 Z" fill="url(#mx-gradient-ffcd28-1-ffa500-1-s-0)" stroke="#d79b00" stroke-miterlimit="10" transform="rotate(90,687,127)" pointer-events="all"/><rect x="658" y="116.5" width="78" height="21" fill="none" stroke="none" transform="rotate(-90,697,127)" pointer-events="all"/><g transform="translate(-0.5 -0.5)rotate(-90 697 127)"><switch><foreignObject style="overflow: visible; text-align: left;" pointer-events="none" width="100%" height="100%" requiredFeatures="http://www.w3.org/TR/SVG11/feature#Extensibility"><div xmlns="http://www.w3.org/1999/xhtml" style="display: flex; align-items: unsafe center; justify-content: unsafe center; width: 76px; height: 1px; padding-top: 127px; margin-left: 659px;"><div style="box-sizing: border-box; font-size: 0; text-align: center; "><div style="display: inline-block; font-size: 12px; font-family: Helvetica; color: #000000; line-height: 1.2; pointer-events: all; white-space: normal; word-wrap: normal; "><font style="font-size: 8px">Time Window</font></div></div></div></foreignObject><text x="697" y="131" fill="#000000" font-family="Helvetica" font-size="12px" text-anchor="middle">Time Window</text></switch></g><rect x="582" y="182" width="151" height="25" fill="#ffffff" stroke="#000000" pointer-events="all"/><g transform="translate(-0.5 -0.5)"><switch><foreignObject style="overflow: visible; text-align: left;" pointer-events="none" width="100%" height="100%" requiredFeatures="http://www.w3.org/TR/SVG11/feature#Extensibility"><div xmlns="http://www.w3.org/1999/xhtml" style="display: flex; align-items: unsafe center; justify-content: unsafe center; width: 149px; height: 1px; padding-top: 195px; margin-left: 583px;"><div style="box-sizing: border-box; font-size: 0; text-align: center; "><div style="display: inline-block; font-size: 12px; font-family: Helvetica; color: #000000; line-height: 1.2; pointer-events: all; white-space: normal; word-wrap: normal; "><i><font style="font-size: 11px" face="Courier New">batchCallback(args)</font></i></div></div></div></foreignObject><text x="658" y="198" fill="#000000" font-family="Helvetica" font-size="12px" text-anchor="middle">batchCallback(args)</text></switch></g><rect x="638" y="82" width="50" height="30" fill="none" stroke="none" pointer-events="all"/><g transform="translate(-0.5 -0.5)"><switch><foreignObject style="overflow: visible; text-align: left;" pointer-events="none" width="100%" height="100%" requiredFeatures="http://www.w3.org/TR/SVG11/feature#Extensibility"><div xmlns="http://www.w3.org/1999/xhtml" style="display: flex; align-items: unsafe flex-start; justify-content: unsafe flex-start; width: 1px; height: 1px; padding-top: 89px; margin-left: 640px;"><div style="box-sizing: border-box; font-size: 0; text-align: left; "><div style="display: inline-block; font-size: 12px; font-family: Helvetica; color: #000000; line-height: 1.2; pointer-events: all; white-space: nowrap; "><font face="Courier New">val1</font></div></div></div></foreignObject><text x="640" y="101" fill="#000000" font-family="Helvetica" font-size="12px">val1</text></switch></g><rect x="646" y="118" width="50" height="30" fill="none" stroke="none" pointer-events="all"/><g transform="translate(-0.5 -0.5)"><switch><foreignObject style="overflow: visible; text-align: left;" pointer-events="none" width="100%" height="100%" requiredFeatures="http://www.w3.org/TR/SVG11/feature#Extensibility"><div xmlns="http://www.w3.org/1999/xhtml" style="display: flex; align-items: unsafe flex-start; justify-content: unsafe flex-start; width: 1px; height: 1px; padding-top: 125px; margin-left: 648px;"><div style="box-sizing: border-box; font-size: 0; text-align: left; "><div style="display: inline-block; font-size: 12px; font-family: Helvetica; color: #000000; line-height: 1.2; pointer-events: all; white-space: nowrap; ">...</div></div></div></foreignObject><text x="648" y="137" fill="#000000" font-family="Helvetica" font-size="12px">...</text></switch></g><rect x="638" y="100" width="50" height="30" fill="none" stroke="none" pointer-events="all"/><g transform="translate(-0.5 -0.5)"><switch><foreignObject style="overflow: visible; text-align: left;" pointer-events="none" width="100%" height="100%" requiredFeatures="http://www.w3.org/TR/SVG11/feature#Extensibility"><div xmlns="http://www.w3.org/1999/xhtml" style="display: flex; align-items: unsafe flex-start; justify-content: unsafe flex-start; width: 1px; height: 1px; padding-top: 107px; margin-left: 640px;"><div style="box-sizing: border-box; font-size: 0; text-align: left; "><div style="display: inline-block; font-size: 12px; font-family: Helvetica; color: #000000; line-height: 1.2; pointer-events: all; white-space: nowrap; "><font face="Courier New">val2</font></div></div></div></foreignObject><text x="640" y="119" fill="#000000" font-family="Helvetica" font-size="12px">val2</text></switch></g><rect x="640" y="138" width="50" height="30" fill="none" stroke="none" pointer-events="all"/><g transform="translate(-0.5 -0.5)"><switch><foreignObject style="overflow: visible; text-align: left;" pointer-events="none" width="100%" height="100%" requiredFeatures="http://www.w3.org/TR/SVG11/feature#Extensibility"><div xmlns="http://www.w3.org/1999/xhtml" style="display: flex; align-items: unsafe flex-start; justify-content: unsafe flex-start; width: 1px; height: 1px; padding-top: 145px; margin-left: 642px;"><div style="box-sizing: border-box; font-size: 0; text-align: left; "><div style="display: inline-block; font-size: 12px; font-family: Helvetica; color: #000000; line-height: 1.2; pointer-events: all; white-space: nowrap; "><font face="Courier New">valn</font></div></div></div></foreignObject><text x="642" y="157" fill="#000000" font-family="Helvetica" font-size="12px">valn</text></switch></g><path d="M 656 162 L 656 166 Q 656 170 666 170 L 688 170 Q 698 170 698 176 L 698 179 Q 698 182 698 181.45 L 698 180.9" fill="none" stroke="#000000" stroke-width="3" stroke-miterlimit="10" pointer-events="stroke"/><path d="M 698 187.65 L 693.5 178.65 L 698 180.9 L 702.5 178.65 Z" fill="#000000" stroke="#000000" stroke-width="3" stroke-miterlimit="10" pointer-events="all"/><path d="M 61.71 91.33 L 629.63 90.01" fill="none" stroke="#000000" stroke-miterlimit="10" pointer-events="stroke"/><path d="M 56.46 91.34 L 63.45 87.82 L 61.71 91.33 L 63.47 94.82 Z" fill="#000000" stroke="#000000" stroke-miterlimit="10" pointer-events="all"/><path d="M 634.88 90 L 627.89 93.52 L 629.63 90.01 L 627.87 86.52 Z" fill="#000000" stroke="#000000" stroke-miterlimit="10" pointer-events="all"/><path d="M 397.83 146.81 L 627.63 146.81" fill="none" stroke="#000000" stroke-miterlimit="10" pointer-events="stroke"/><path d="M 632.88 146.81 L 625.88 150.31 L 627.63 146.81 L 625.88 143.31 Z" fill="#000000" stroke="#000000" stroke-miterlimit="10" pointer-events="all"/><path d="M 228.2 109 L 502 109 Q 512 109 522 108.92 L 629.63 108.05" fill="none" stroke="#000000" stroke-miterlimit="10" pointer-events="stroke"/><path d="M 222.95 109 L 229.95 105.5 L 228.2 109 L 229.95 112.5 Z" fill="#000000" stroke="#000000" stroke-miterlimit="10" pointer-events="all"/><path d="M 634.88 108.01 L 627.91 111.57 L 629.63 108.05 L 627.85 104.57 Z" fill="#000000" stroke="#000000" stroke-miterlimit="10" pointer-events="all"/><path d="M 657.5 207 L 507.98 215.44 Q 498 216 488 216 L 462 216 Q 452 216 442 216.07 L 168 217.93 Q 158 218 148 218 L 64.24 218" fill="none" stroke="#000000" stroke-miterlimit="10" stroke-dasharray="1 1" pointer-events="stroke"/><path d="M 72.12 213.5 L 63.12 218 L 72.12 222.5" fill="none" stroke="#000000" stroke-miterlimit="10" pointer-events="all"/><g transform="translate(-0.5 -0.5)"><switch><foreignObject style="overflow: visible; text-align: left;" pointer-events="none" width="100%" height="100%" requiredFeatures="http://www.w3.org/TR/SVG11/feature#Extensibility"><div xmlns="http://www.w3.org/1999/xhtml" style="display: flex; align-items: unsafe flex-end; justify-content: unsafe center; width: 1px; height: 1px; padding-top: 223px; margin-left: 318px;"><div style="box-sizing: border-box; font-size: 0; text-align: center; "><div style="display: inline-block; font-size: 11px; font-family: Helvetica; color: #000000; line-height: 1.2; pointer-events: all; background-color: #ffffff; white-space: nowrap; "><i style="font-family: &quot;verdana&quot;"><font style="font-size: 11px">Thread is unblocked and Future result is returned</font></i></div></div></div></foreignObject><text x="318" y="223" fill="#000000" font-family="Helvetica" font-size="11px" text-anchor="middle">Thread is unblocked and Future result is returned</text></switch></g><rect x="52" y="72" width="176" height="20" fill="none" stroke="none" pointer-events="all"/><g transform="translate(-0.5 -0.5)"><switch><foreignObject style="overflow: visible; text-align: left;" pointer-events="none" width="100%" height="100%" requiredFeatures="http://www.w3.org/TR/SVG11/feature#Extensibility"><div xmlns="http://www.w3.org/1999/xhtml" style="display: flex; align-items: unsafe center; justify-content: unsafe center; width: 174px; height: 1px; padding-top: 82px; margin-left: 53px;"><div style="box-sizing: border-box; font-size: 0; text-align: center; "><div style="display: inline-block; font-size: 12px; font-family: Helvetica; color: #000000; line-height: 1.2; pointer-events: all; white-space: normal; word-wrap: normal; "><font face="Courier New" style="font-size: 9px">Future f = executeAsFuture(val1)</font></div></div></div></foreignObject><text x="140" y="86" fill="#000000" font-family="Helvetica" font-size="12px" text-anchor="middle">Future f = executeAsFuture(va...</text></switch></g><rect x="398" y="124" width="192" height="22" fill="none" stroke="none" pointer-events="all"/><g transform="translate(-0.5 -0.5)"><switch><foreignObject style="overflow: visible; text-align: left;" pointer-events="none" width="100%" height="100%" requiredFeatures="http://www.w3.org/TR/SVG11/feature#Extensibility"><div xmlns="http://www.w3.org/1999/xhtml" style="display: flex; align-items: unsafe flex-start; justify-content: unsafe flex-start; width: 1px; height: 1px; padding-top: 131px; margin-left: 400px;"><div style="box-sizing: border-box; font-size: 0; text-align: left; "><div style="display: inline-block; font-size: 12px; font-family: Helvetica; color: #000000; line-height: 1.2; pointer-events: all; white-space: nowrap; "><font face="Courier New" style="font-size: 9px">Future f = executeAsFuture(valn)</font></div></div></div></foreignObject><text x="400" y="143" fill="#000000" font-family="Helvetica" font-size="12px">Future f = executeAsFuture(valn)</text></switch></g><rect x="222" y="88" width="192" height="22" fill="none" stroke="none" pointer-events="all"/><g transform="translate(-0.5 -0.5)"><switch><foreignObject style="overflow: visible; text-align: left;" pointer-events="none" width="100%" height="100%" requiredFeatures="http://www.w3.org/TR/SVG11/feature#Extensibility"><div xmlns="http://www.w3.org/1999/xhtml" style="display: flex; align-items: unsafe flex-start; justify-content: unsafe flex-start; width: 1px; height: 1px; padding-top: 95px; margin-left: 224px;"><div style="box-sizing: border-box; font-size: 0; text-align: left; "><div style="display: inline-block; font-size: 12px; font-family: Helvetica; color: #000000; line-height: 1.2; pointer-events: all; white-space: nowrap; "><font face="Courier New" style="font-size: 9px">Future f = executeAsFuture(val2)</font></div></div></div></foreignObject><text x="224" y="107" fill="#000000" font-family="Helvetica" font-size="12px">Future f = executeAsFuture(val2)</text></switch></g><rect x="170" y="244" width="110" height="22" fill="none" stroke="none" pointer-events="all"/><g transform="translate(-0.5 -0.5)"><switch><foreignObject style="overflow: visible; text-align: left;" pointer-events="none" width="100%" height="100%" requiredFeatures="http://www.w3.org/TR/SVG11/feature#Extensibility"><div xmlns="http://www.w3.org/1999/xhtml" style="display: flex; align-items: unsafe flex-start; justify-content: unsafe flex-start; width: 1px; height: 1px; padding-top: 251px; margin-left: 172px;"><div style="box-sizing: border-box; font-size: 0; text-align: left; "><div style="display: inline-block; font-size: 12px; font-family: Helvetica; color: #000000; line-height: 1.2; pointer-events: all; white-space: nowrap; "><font face="Courier New" style="font-size: 11px">result = f.get()</font></div></div></div></foreignObject><text x="172" y="263" fill="#000000" font-family="Helvetica" font-size="12px">result = f.get()</text></switch></g><rect x="348" y="244" width="110" height="22" fill="none" stroke="none" pointer-events="all"/><g transform="translate(-0.5 -0.5)"><switch><foreignObject style="overflow: visible; text-align: left;" pointer-events="none" width="100%" height="100%" requiredFeatures="http://www.w3.org/TR/SVG11/feature#Extensibility"><div xmlns="http://www.w3.org/1999/xhtml" style="display: flex; align-items: unsafe flex-start; justify-content: unsafe flex-start; width: 1px; height: 1px; padding-top: 251px; margin-left: 350px;"><div style="box-sizing: border-box; font-size: 0; text-align: left; "><div style="display: inline-block; font-size: 12px; font-family: Helvetica; color: #000000; line-height: 1.2; pointer-events: all; white-space: nowrap; "><font face="Courier New" style="font-size: 11px">result = f.get()</font></div></div></div></foreignObject><text x="350" y="263" fill="#000000" font-family="Helvetica" font-size="12px">result = f.get()</text></switch></g></g><switch><g requiredFeatures="http://www.w3.org/TR/SVG11/feature#Extensibility"/><a transform="translate(0,-5)" xlink:href="https://desk.draw.io/support/solutions/articles/16000042487" target="_blank"><text text-anchor="middle" font-size="10px" x="50%" y="100%">Viewer does not support full SVG 1.1</text></a></switch></svg>


--------------------------------------------------------------------------------
/src/main/javadoc/doc-files/blocking.svg:
--------------------------------------------------------------------------------
1 | <?xml version="1.0" encoding="UTF-8"?>
2 | <!DOCTYPE svg PUBLIC "-//W3C//DTD SVG 1.1//EN" "http://www.w3.org/Graphics/SVG/1.1/DTD/svg11.dtd">
3 | <svg xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" version="1.1" width="735px" height="303px" viewBox="-0.5 -0.5 735 303" content="&lt;mxfile host=&quot;app.diagrams.net&quot; modified=&quot;2020-03-15T17:06:35.709Z&quot; agent=&quot;Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/80.0.3987.132 Safari/537.36&quot; etag=&quot;mT9PmkyGzd-NnaKxJsko&quot; version=&quot;12.8.5&quot; type=&quot;device&quot;&gt;&lt;diagram name=&quot;Page-1&quot; id=&quot;13e1069c-82ec-6db2-03f1-153e76fe0fe0&quot;&gt;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&lt;/diagram&gt;&lt;/mxfile&gt;" style="background-color: rgb(255, 255, 255);"><defs><linearGradient x1="0%" y1="0%" x2="0%" y2="100%" id="mx-gradient-dae8fc-1-7ea6e0-1-s-0"><stop offset="0%" style="stop-color:#dae8fc"/><stop offset="100%" style="stop-color:#7ea6e0"/></linearGradient><linearGradient x1="0%" y1="0%" x2="0%" y2="100%" id="mx-gradient-fff2cc-1-ffd966-1-s-0"><stop offset="0%" style="stop-color:#fff2cc"/><stop offset="100%" style="stop-color:#ffd966"/></linearGradient><linearGradient x1="0%" y1="0%" x2="0%" y2="100%" id="mx-gradient-ffcd28-1-ffa500-1-s-0"><stop offset="0%" style="stop-color:#ffcd28"/><stop offset="100%" style="stop-color:#ffa500"/></linearGradient></defs><g><rect x="342" y="1" width="100" height="40" rx="6" ry="6" fill="url(#mx-gradient-dae8fc-1-7ea6e0-1-s-0)" stroke="#6c8ebf" pointer-events="all"/><path d="M 392 41 L 392 301" fill="none" stroke="#6c8ebf" stroke-miterlimit="10" stroke-dasharray="3 3" pointer-events="all"/><g transform="translate(-0.5 -0.5)"><switch><foreignObject style="overflow: visible; text-align: left;" pointer-events="none" width="100%" height="100%" requiredFeatures="http://www.w3.org/TR/SVG11/feature#Extensibility"><div xmlns="http://www.w3.org/1999/xhtml" style="display: flex; align-items: unsafe center; justify-content: unsafe center; width: 98px; height: 1px; padding-top: 21px; margin-left: 343px;"><div style="box-sizing: border-box; font-size: 0; text-align: center; "><div style="display: inline-block; font-size: 12px; font-family: Verdana; color: #000000; line-height: 1.2; pointer-events: all; white-space: normal; word-wrap: normal; "><font style="font-size: 14px">Thread n</font></div></div></div></foreignObject><text x="392" y="25" fill="#000000" font-family="Verdana" font-size="12px" text-anchor="middle">Thread n</text></switch></g><rect x="380" y="149" width="21.5" height="68" fill="#f8cecc" stroke="#b85450" pointer-events="all"/><rect x="370.75" y="170" width="40" height="20" fill="none" stroke="none" transform="rotate(-90,390.75,180)" pointer-events="all"/><g transform="translate(-0.5 -0.5)rotate(-90 390.75 180)"><switch><foreignObject style="overflow: visible; text-align: left;" pointer-events="none" width="100%" height="100%" requiredFeatures="http://www.w3.org/TR/SVG11/feature#Extensibility"><div xmlns="http://www.w3.org/1999/xhtml" style="display: flex; align-items: unsafe center; justify-content: unsafe center; width: 38px; height: 1px; padding-top: 180px; margin-left: 372px;"><div style="box-sizing: border-box; font-size: 0; text-align: center; "><div style="display: inline-block; font-size: 12px; font-family: Helvetica; color: #000000; line-height: 1.2; pointer-events: all; white-space: normal; word-wrap: normal; "><font face="Courier New" size="1"><b style="font-size: 12px">blocked</b></font></div></div></div></foreignObject><text x="391" y="184" fill="#000000" font-family="Helvetica" font-size="12px" text-anchor="middle">blocked</text></switch></g><rect x="566" y="0" width="168" height="40" rx="6" ry="6" fill="url(#mx-gradient-dae8fc-1-7ea6e0-1-s-0)" stroke="#6c8ebf" pointer-events="all"/><path d="M 650 40 L 650 302" fill="none" stroke="#6c8ebf" stroke-miterlimit="10" stroke-dasharray="3 3" pointer-events="all"/><g transform="translate(-0.5 -0.5)"><switch><foreignObject style="overflow: visible; text-align: left;" pointer-events="none" width="100%" height="100%" requiredFeatures="http://www.w3.org/TR/SVG11/feature#Extensibility"><div xmlns="http://www.w3.org/1999/xhtml" style="display: flex; align-items: unsafe center; justify-content: unsafe center; width: 166px; height: 1px; padding-top: 20px; margin-left: 567px;"><div style="box-sizing: border-box; font-size: 0; text-align: center; "><div style="display: inline-block; font-size: 12px; font-family: Verdana; color: #000000; line-height: 1.2; pointer-events: all; white-space: normal; word-wrap: normal; "><font style="font-size: 14px">DelayedBatchExecutor</font></div></div></div></foreignObject><text x="650" y="24" fill="#000000" font-family="Verdana" font-size="12px" text-anchor="middle">DelayedBatchExecutor</text></switch></g><rect x="566" y="78" width="168" height="138" fill="url(#mx-gradient-fff2cc-1-ffd966-1-s-0)" stroke="#d6b656" pointer-events="all"/><rect x="630" y="90" width="40" height="72" fill="#f5f5f5" stroke="#666666" pointer-events="all"/><path d="M 630 125 L 670 125" fill="none" stroke="#000000" stroke-width="2" stroke-miterlimit="10" pointer-events="all"/><path d="M 630 105 L 670 105" fill="none" stroke="#000000" stroke-width="2" stroke-miterlimit="10" pointer-events="all"/><path d="M 630 143 L 670 143" fill="none" stroke="#000000" stroke-width="2" stroke-miterlimit="10" pointer-events="all"/><path d="M 646 127 L 660 122 L 660 125.5 L 702 125.5 L 702 122 L 716 127 L 702 132 L 702 128.5 L 660 128.5 L 660 132 Z" fill="url(#mx-gradient-ffcd28-1-ffa500-1-s-0)" stroke="#d79b00" stroke-miterlimit="10" transform="rotate(90,681,127)" pointer-events="all"/><rect x="652" y="116.5" width="78" height="21" fill="none" stroke="none" transform="rotate(-90,691,127)" pointer-events="all"/><g transform="translate(-0.5 -0.5)rotate(-90 691 127)"><switch><foreignObject style="overflow: visible; text-align: left;" pointer-events="none" width="100%" height="100%" requiredFeatures="http://www.w3.org/TR/SVG11/feature#Extensibility"><div xmlns="http://www.w3.org/1999/xhtml" style="display: flex; align-items: unsafe center; justify-content: unsafe center; width: 76px; height: 1px; padding-top: 127px; margin-left: 653px;"><div style="box-sizing: border-box; font-size: 0; text-align: center; "><div style="display: inline-block; font-size: 12px; font-family: Helvetica; color: #000000; line-height: 1.2; pointer-events: all; white-space: normal; word-wrap: normal; "><font style="font-size: 8px">Time Window</font></div></div></div></foreignObject><text x="691" y="131" fill="#000000" font-family="Helvetica" font-size="12px" text-anchor="middle">Time Window</text></switch></g><rect x="576" y="182" width="151" height="25" fill="#ffffff" stroke="#000000" pointer-events="all"/><g transform="translate(-0.5 -0.5)"><switch><foreignObject style="overflow: visible; text-align: left;" pointer-events="none" width="100%" height="100%" requiredFeatures="http://www.w3.org/TR/SVG11/feature#Extensibility"><div xmlns="http://www.w3.org/1999/xhtml" style="display: flex; align-items: unsafe center; justify-content: unsafe center; width: 149px; height: 1px; padding-top: 195px; margin-left: 577px;"><div style="box-sizing: border-box; font-size: 0; text-align: center; "><div style="display: inline-block; font-size: 12px; font-family: Helvetica; color: #000000; line-height: 1.2; pointer-events: all; white-space: normal; word-wrap: normal; "><i><font style="font-size: 11px" face="Courier New">batchCallback(args)</font></i></div></div></div></foreignObject><text x="652" y="198" fill="#000000" font-family="Helvetica" font-size="12px" text-anchor="middle">batchCallback(args)</text></switch></g><rect x="632" y="82" width="50" height="30" fill="none" stroke="none" pointer-events="all"/><g transform="translate(-0.5 -0.5)"><switch><foreignObject style="overflow: visible; text-align: left;" pointer-events="none" width="100%" height="100%" requiredFeatures="http://www.w3.org/TR/SVG11/feature#Extensibility"><div xmlns="http://www.w3.org/1999/xhtml" style="display: flex; align-items: unsafe flex-start; justify-content: unsafe flex-start; width: 1px; height: 1px; padding-top: 89px; margin-left: 634px;"><div style="box-sizing: border-box; font-size: 0; text-align: left; "><div style="display: inline-block; font-size: 12px; font-family: Helvetica; color: #000000; line-height: 1.2; pointer-events: all; white-space: nowrap; "><font face="Courier New">val1</font></div></div></div></foreignObject><text x="634" y="101" fill="#000000" font-family="Helvetica" font-size="12px">val1</text></switch></g><rect x="640" y="118" width="50" height="30" fill="none" stroke="none" pointer-events="all"/><g transform="translate(-0.5 -0.5)"><switch><foreignObject style="overflow: visible; text-align: left;" pointer-events="none" width="100%" height="100%" requiredFeatures="http://www.w3.org/TR/SVG11/feature#Extensibility"><div xmlns="http://www.w3.org/1999/xhtml" style="display: flex; align-items: unsafe flex-start; justify-content: unsafe flex-start; width: 1px; height: 1px; padding-top: 125px; margin-left: 642px;"><div style="box-sizing: border-box; font-size: 0; text-align: left; "><div style="display: inline-block; font-size: 12px; font-family: Helvetica; color: #000000; line-height: 1.2; pointer-events: all; white-space: nowrap; ">...</div></div></div></foreignObject><text x="642" y="137" fill="#000000" font-family="Helvetica" font-size="12px">...</text></switch></g><rect x="632" y="100" width="50" height="30" fill="none" stroke="none" pointer-events="all"/><g transform="translate(-0.5 -0.5)"><switch><foreignObject style="overflow: visible; text-align: left;" pointer-events="none" width="100%" height="100%" requiredFeatures="http://www.w3.org/TR/SVG11/feature#Extensibility"><div xmlns="http://www.w3.org/1999/xhtml" style="display: flex; align-items: unsafe flex-start; justify-content: unsafe flex-start; width: 1px; height: 1px; padding-top: 107px; margin-left: 634px;"><div style="box-sizing: border-box; font-size: 0; text-align: left; "><div style="display: inline-block; font-size: 12px; font-family: Helvetica; color: #000000; line-height: 1.2; pointer-events: all; white-space: nowrap; "><font face="Courier New">val2</font></div></div></div></foreignObject><text x="634" y="119" fill="#000000" font-family="Helvetica" font-size="12px">val2</text></switch></g><rect x="634" y="138" width="50" height="30" fill="none" stroke="none" pointer-events="all"/><g transform="translate(-0.5 -0.5)"><switch><foreignObject style="overflow: visible; text-align: left;" pointer-events="none" width="100%" height="100%" requiredFeatures="http://www.w3.org/TR/SVG11/feature#Extensibility"><div xmlns="http://www.w3.org/1999/xhtml" style="display: flex; align-items: unsafe flex-start; justify-content: unsafe flex-start; width: 1px; height: 1px; padding-top: 145px; margin-left: 636px;"><div style="box-sizing: border-box; font-size: 0; text-align: left; "><div style="display: inline-block; font-size: 12px; font-family: Helvetica; color: #000000; line-height: 1.2; pointer-events: all; white-space: nowrap; "><font face="Courier New">val3</font></div></div></div></foreignObject><text x="636" y="157" fill="#000000" font-family="Helvetica" font-size="12px">val3</text></switch></g><path d="M 650 162 L 650 166 Q 650 170 660 170 L 682 170 Q 692 170 692 176 L 692 179 Q 692 182 692 181.45 L 692 180.9" fill="none" stroke="#000000" stroke-width="3" stroke-miterlimit="10" pointer-events="stroke"/><path d="M 692 187.65 L 687.5 178.65 L 692 180.9 L 696.5 178.65 Z" fill="#000000" stroke="#000000" stroke-width="3" stroke-miterlimit="10" pointer-events="all"/><rect x="0" y="0" width="100" height="40" rx="6" ry="6" fill="url(#mx-gradient-dae8fc-1-7ea6e0-1-s-0)" stroke="#6c8ebf" pointer-events="all"/><path d="M 50 40 L 50 300" fill="none" stroke="#6c8ebf" stroke-miterlimit="10" stroke-dasharray="3 3" pointer-events="all"/><g transform="translate(-0.5 -0.5)"><switch><foreignObject style="overflow: visible; text-align: left;" pointer-events="none" width="100%" height="100%" requiredFeatures="http://www.w3.org/TR/SVG11/feature#Extensibility"><div xmlns="http://www.w3.org/1999/xhtml" style="display: flex; align-items: unsafe center; justify-content: unsafe center; width: 98px; height: 1px; padding-top: 20px; margin-left: 1px;"><div style="box-sizing: border-box; font-size: 0; text-align: center; "><div style="display: inline-block; font-size: 12px; font-family: Verdana; color: #000000; line-height: 1.2; pointer-events: all; white-space: normal; word-wrap: normal; "><font style="font-size: 14px">Thread 1</font></div></div></div></foreignObject><text x="50" y="24" fill="#000000" font-family="Verdana" font-size="12px" text-anchor="middle">Thread 1</text></switch></g><rect x="40" y="91" width="21" height="126" fill="#f8cecc" stroke="#b85450" pointer-events="all"/><rect x="30" y="144" width="40" height="20" fill="none" stroke="none" transform="rotate(-90,50,154)" pointer-events="all"/><g transform="translate(-0.5 -0.5)rotate(-90 50 154)"><switch><foreignObject style="overflow: visible; text-align: left;" pointer-events="none" width="100%" height="100%" requiredFeatures="http://www.w3.org/TR/SVG11/feature#Extensibility"><div xmlns="http://www.w3.org/1999/xhtml" style="display: flex; align-items: unsafe center; justify-content: unsafe center; width: 38px; height: 1px; padding-top: 154px; margin-left: 31px;"><div style="box-sizing: border-box; font-size: 0; text-align: center; "><div style="display: inline-block; font-size: 12px; font-family: Helvetica; color: #000000; line-height: 1.2; pointer-events: all; white-space: normal; word-wrap: normal; "><font face="Courier New" size="1"><b style="font-size: 12px">blocked</b></font></div></div></div></foreignObject><text x="50" y="158" fill="#000000" font-family="Helvetica" font-size="12px" text-anchor="middle">blocked</text></switch></g><rect x="166" y="0" width="100" height="40" rx="6" ry="6" fill="url(#mx-gradient-dae8fc-1-7ea6e0-1-s-0)" stroke="#6c8ebf" pointer-events="all"/><path d="M 216 40 L 216 300" fill="none" stroke="#6c8ebf" stroke-miterlimit="10" stroke-dasharray="3 3" pointer-events="all"/><g transform="translate(-0.5 -0.5)"><switch><foreignObject style="overflow: visible; text-align: left;" pointer-events="none" width="100%" height="100%" requiredFeatures="http://www.w3.org/TR/SVG11/feature#Extensibility"><div xmlns="http://www.w3.org/1999/xhtml" style="display: flex; align-items: unsafe center; justify-content: unsafe center; width: 98px; height: 1px; padding-top: 20px; margin-left: 167px;"><div style="box-sizing: border-box; font-size: 0; text-align: center; "><div style="display: inline-block; font-size: 12px; font-family: Verdana; color: #000000; line-height: 1.2; pointer-events: all; white-space: normal; word-wrap: normal; "><font style="font-size: 14px">Thread 2</font></div></div></div></foreignObject><text x="216" y="24" fill="#000000" font-family="Verdana" font-size="12px" text-anchor="middle">Thread 2</text></switch></g><rect x="207.5" y="110" width="20.5" height="105" fill="#f8cecc" stroke="#b85450" pointer-events="all"/><rect x="196" y="148" width="40" height="20" fill="none" stroke="none" transform="rotate(-90,216,158)" pointer-events="all"/><g transform="translate(-0.5 -0.5)rotate(-90 216 158)"><switch><foreignObject style="overflow: visible; text-align: left;" pointer-events="none" width="100%" height="100%" requiredFeatures="http://www.w3.org/TR/SVG11/feature#Extensibility"><div xmlns="http://www.w3.org/1999/xhtml" style="display: flex; align-items: unsafe center; justify-content: unsafe center; width: 38px; height: 1px; padding-top: 158px; margin-left: 197px;"><div style="box-sizing: border-box; font-size: 0; text-align: center; "><div style="display: inline-block; font-size: 12px; font-family: Helvetica; color: #000000; line-height: 1.2; pointer-events: all; white-space: normal; word-wrap: normal; "><font face="Courier New" size="1"><b style="font-size: 12px">blocked</b></font></div></div></div></foreignObject><text x="216" y="162" fill="#000000" font-family="Helvetica" font-size="12px" text-anchor="middle">blocked</text></switch></g><path d="M 58.38 91 L 623.63 90.01" fill="none" stroke="#000000" stroke-miterlimit="10" pointer-events="stroke"/><path d="M 628.88 90 L 621.89 93.51 L 623.63 90.01 L 621.88 86.51 Z" fill="#000000" stroke="#000000" stroke-miterlimit="10" pointer-events="all"/><path d="M 397.2 149 L 621.63 146.87" fill="none" stroke="#000000" stroke-miterlimit="10" pointer-events="stroke"/><path d="M 626.88 146.82 L 619.92 150.38 L 621.63 146.87 L 619.85 143.39 Z" fill="#000000" stroke="#000000" stroke-miterlimit="10" pointer-events="all"/><path d="M 212.5 110 L 496 109.03 Q 506 109 516 108.92 L 623.63 108.05" fill="none" stroke="#000000" stroke-miterlimit="10" pointer-events="stroke"/><path d="M 628.88 108.01 L 621.91 111.57 L 623.63 108.05 L 621.85 104.57 Z" fill="#000000" stroke="#000000" stroke-miterlimit="10" pointer-events="all"/><path d="M 647.88 207.9 L 517.98 216.35 Q 508 217 498 217 L 422 217 Q 412 217 406.12 217 L 400.24 217" fill="none" stroke="#000000" stroke-miterlimit="10" stroke-dasharray="1 1" pointer-events="stroke"/><path d="M 408.12 212.5 L 399.12 217 L 408.12 221.5" fill="none" stroke="#000000" stroke-miterlimit="10" pointer-events="all"/><g transform="translate(-0.5 -0.5)"><switch><foreignObject style="overflow: visible; text-align: left;" pointer-events="none" width="100%" height="100%" requiredFeatures="http://www.w3.org/TR/SVG11/feature#Extensibility"><div xmlns="http://www.w3.org/1999/xhtml" style="display: flex; align-items: unsafe flex-end; justify-content: unsafe center; width: 1px; height: 1px; padding-top: 212px; margin-left: 480px;"><div style="box-sizing: border-box; font-size: 0; text-align: center; "><div style="display: inline-block; font-size: 11px; font-family: Helvetica; color: #000000; line-height: 1.2; pointer-events: all; background-color: #ffffff; white-space: nowrap; "><font style="font-size: 11px" face="Verdana"><i>Thread is unblocked and <br />result is returned</i><br /></font></div></div></div></foreignObject><text x="480" y="212" fill="#000000" font-family="Helvetica" font-size="11px" text-anchor="middle">Thread is unblocked and...</text></switch></g><path d="M 652 207 L 503.31 265.35 Q 494 269 484 269 L 296 269 Q 286 269 276 269 L 246 269 Q 236 269 232.71 259.56 L 217.46 215.85" fill="none" stroke="#000000" stroke-miterlimit="10" stroke-dasharray="1 1" pointer-events="stroke"/><path d="M 224.31 221.81 L 217.09 214.8 L 215.81 224.78" fill="none" stroke="#000000" stroke-miterlimit="10" pointer-events="all"/><g transform="translate(-0.5 -0.5)"><switch><foreignObject style="overflow: visible; text-align: left;" pointer-events="none" width="100%" height="100%" requiredFeatures="http://www.w3.org/TR/SVG11/feature#Extensibility"><div xmlns="http://www.w3.org/1999/xhtml" style="display: flex; align-items: unsafe flex-end; justify-content: unsafe center; width: 1px; height: 1px; padding-top: 272px; margin-left: 366px;"><div style="box-sizing: border-box; font-size: 0; text-align: center; "><div style="display: inline-block; font-size: 11px; font-family: Helvetica; color: #000000; line-height: 1.2; pointer-events: all; background-color: #ffffff; white-space: nowrap; "><i style="font-family: &quot;verdana&quot;"><font style="font-size: 11px">Thread is unblocked and result is returned</font></i></div></div></div></foreignObject><text x="366" y="272" fill="#000000" font-family="Helvetica" font-size="11px" text-anchor="middle">Thread is unblocked and result is returned</text></switch></g><path d="M 651.5 207 L 487.04 284.73 Q 478 289 468 289 L 226 289 Q 216 289 206 289 L 114 289 Q 104 289 98.08 280.94 L 52.82 219.3" fill="none" stroke="#000000" stroke-miterlimit="10" stroke-dasharray="1 1" pointer-events="stroke"/><path d="M 61.12 222.99 L 52.16 218.4 L 53.86 228.32" fill="none" stroke="#000000" stroke-miterlimit="10" pointer-events="all"/><g transform="translate(-0.5 -0.5)"><switch><foreignObject style="overflow: visible; text-align: left;" pointer-events="none" width="100%" height="100%" requiredFeatures="http://www.w3.org/TR/SVG11/feature#Extensibility"><div xmlns="http://www.w3.org/1999/xhtml" style="display: flex; align-items: unsafe flex-end; justify-content: unsafe center; width: 1px; height: 1px; padding-top: 294px; margin-left: 295px;"><div style="box-sizing: border-box; font-size: 0; text-align: center; "><div style="display: inline-block; font-size: 11px; font-family: Helvetica; color: #000000; line-height: 1.2; pointer-events: all; background-color: #ffffff; white-space: nowrap; "><i style="font-family: &quot;verdana&quot;"><font style="font-size: 11px">Thread is unblocked and result is returned</font></i></div></div></div></foreignObject><text x="295" y="294" fill="#000000" font-family="Helvetica" font-size="11px" text-anchor="middle">Thread is unblocked and result is returned</text></switch></g><rect x="46" y="73" width="170" height="20" fill="none" stroke="none" pointer-events="all"/><g transform="translate(-0.5 -0.5)"><switch><foreignObject style="overflow: visible; text-align: left;" pointer-events="none" width="100%" height="100%" requiredFeatures="http://www.w3.org/TR/SVG11/feature#Extensibility"><div xmlns="http://www.w3.org/1999/xhtml" style="display: flex; align-items: unsafe center; justify-content: unsafe center; width: 168px; height: 1px; padding-top: 83px; margin-left: 47px;"><div style="box-sizing: border-box; font-size: 0; text-align: center; "><div style="display: inline-block; font-size: 12px; font-family: Helvetica; color: #000000; line-height: 1.2; pointer-events: all; white-space: normal; word-wrap: normal; "><font face="Courier New" style="font-size: 12px">result = execute(val1)</font></div></div></div></foreignObject><text x="131" y="87" fill="#000000" font-family="Helvetica" font-size="12px" text-anchor="middle">result = execute(val1)</text></switch></g><rect x="402" y="127" width="130" height="22" fill="none" stroke="none" pointer-events="all"/><g transform="translate(-0.5 -0.5)"><switch><foreignObject style="overflow: visible; text-align: left;" pointer-events="none" width="100%" height="100%" requiredFeatures="http://www.w3.org/TR/SVG11/feature#Extensibility"><div xmlns="http://www.w3.org/1999/xhtml" style="display: flex; align-items: unsafe flex-start; justify-content: unsafe flex-start; width: 1px; height: 1px; padding-top: 134px; margin-left: 404px;"><div style="box-sizing: border-box; font-size: 0; text-align: left; "><div style="display: inline-block; font-size: 12px; font-family: Helvetica; color: #000000; line-height: 1.2; pointer-events: all; white-space: nowrap; "><font face="Courier New" style="font-size: 12px">result = execute(val3)</font></div></div></div></foreignObject><text x="404" y="146" fill="#000000" font-family="Helvetica" font-size="12px">result = execute(val3)</text></switch></g><rect x="228" y="89" width="138" height="22" fill="none" stroke="none" pointer-events="all"/><g transform="translate(-0.5 -0.5)"><switch><foreignObject style="overflow: visible; text-align: left;" pointer-events="none" width="100%" height="100%" requiredFeatures="http://www.w3.org/TR/SVG11/feature#Extensibility"><div xmlns="http://www.w3.org/1999/xhtml" style="display: flex; align-items: unsafe flex-start; justify-content: unsafe flex-start; width: 1px; height: 1px; padding-top: 96px; margin-left: 230px;"><div style="box-sizing: border-box; font-size: 0; text-align: left; "><div style="display: inline-block; font-size: 12px; font-family: Helvetica; color: #000000; line-height: 1.2; pointer-events: all; white-space: nowrap; "><font face="Courier New" style="font-size: 12px">result = execute(val2)</font></div></div></div></foreignObject><text x="230" y="108" fill="#000000" font-family="Helvetica" font-size="12px">result = execute(val2)</text></switch></g></g><switch><g requiredFeatures="http://www.w3.org/TR/SVG11/feature#Extensibility"/><a transform="translate(0,-5)" xlink:href="https://desk.draw.io/support/solutions/articles/16000042487" target="_blank"><text text-anchor="middle" font-size="10px" x="50%" y="100%">Viewer does not support full SVG 1.1</text></a></switch></svg>


--------------------------------------------------------------------------------
/src/main/javadoc/doc-files/mono.svg:
--------------------------------------------------------------------------------
1 | <?xml version="1.0" encoding="UTF-8"?>
2 | <!DOCTYPE svg PUBLIC "-//W3C//DTD SVG 1.1//EN" "http://www.w3.org/Graphics/SVG/1.1/DTD/svg11.dtd">
3 | <svg xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" version="1.1" width="755px" height="303px" viewBox="-0.5 -0.5 755 303" content="&lt;mxfile host=&quot;app.diagrams.net&quot; modified=&quot;2020-03-15T17:15:00.491Z&quot; agent=&quot;Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/80.0.3987.132 Safari/537.36&quot; etag=&quot;6GxAXyq0bkiNTtLbpCox&quot; version=&quot;12.8.5&quot; type=&quot;device&quot;&gt;&lt;diagram name=&quot;Page-1&quot; id=&quot;13e1069c-82ec-6db2-03f1-153e76fe0fe0&quot;&gt;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&lt;/diagram&gt;&lt;/mxfile&gt;" style="background-color: rgb(255, 255, 255);"><defs><linearGradient x1="0%" y1="0%" x2="0%" y2="100%" id="mx-gradient-dae8fc-1-7ea6e0-1-s-0"><stop offset="0%" style="stop-color:#dae8fc"/><stop offset="100%" style="stop-color:#7ea6e0"/></linearGradient><linearGradient x1="0%" y1="0%" x2="0%" y2="100%" id="mx-gradient-fff2cc-1-ffd966-1-s-0"><stop offset="0%" style="stop-color:#fff2cc"/><stop offset="100%" style="stop-color:#ffd966"/></linearGradient><linearGradient x1="0%" y1="0%" x2="0%" y2="100%" id="mx-gradient-ffcd28-1-ffa500-1-s-0"><stop offset="0%" style="stop-color:#ffcd28"/><stop offset="100%" style="stop-color:#ffa500"/></linearGradient></defs><g><rect x="186" y="0" width="100" height="40" rx="6" ry="6" fill="url(#mx-gradient-dae8fc-1-7ea6e0-1-s-0)" stroke="#6c8ebf" pointer-events="all"/><path d="M 236 40 L 236 276" fill="none" stroke="#6c8ebf" stroke-miterlimit="10" stroke-dasharray="3 3" pointer-events="all"/><g transform="translate(-0.5 -0.5)"><switch><foreignObject style="overflow: visible; text-align: left;" pointer-events="none" width="100%" height="100%" requiredFeatures="http://www.w3.org/TR/SVG11/feature#Extensibility"><div xmlns="http://www.w3.org/1999/xhtml" style="display: flex; align-items: unsafe center; justify-content: unsafe center; width: 98px; height: 1px; padding-top: 20px; margin-left: 187px;"><div style="box-sizing: border-box; font-size: 0; text-align: center; "><div style="display: inline-block; font-size: 12px; font-family: Verdana; color: #000000; line-height: 1.2; pointer-events: all; white-space: normal; word-wrap: normal; "><font style="font-size: 14px">Thread 2</font></div></div></div></foreignObject><text x="236" y="24" fill="#000000" font-family="Verdana" font-size="12px" text-anchor="middle">Thread 2</text></switch></g><rect x="362" y="1" width="100" height="40" rx="6" ry="6" fill="url(#mx-gradient-dae8fc-1-7ea6e0-1-s-0)" stroke="#6c8ebf" pointer-events="all"/><path d="M 412 41 L 412 278" fill="none" stroke="#6c8ebf" stroke-miterlimit="10" stroke-dasharray="3 3" pointer-events="all"/><g transform="translate(-0.5 -0.5)"><switch><foreignObject style="overflow: visible; text-align: left;" pointer-events="none" width="100%" height="100%" requiredFeatures="http://www.w3.org/TR/SVG11/feature#Extensibility"><div xmlns="http://www.w3.org/1999/xhtml" style="display: flex; align-items: unsafe center; justify-content: unsafe center; width: 98px; height: 1px; padding-top: 21px; margin-left: 363px;"><div style="box-sizing: border-box; font-size: 0; text-align: center; "><div style="display: inline-block; font-size: 12px; font-family: Verdana; color: #000000; line-height: 1.2; pointer-events: all; white-space: normal; word-wrap: normal; "><font style="font-size: 14px">Thread n</font></div></div></div></foreignObject><text x="412" y="25" fill="#000000" font-family="Verdana" font-size="12px" text-anchor="middle">Thread n</text></switch></g><rect x="187" y="252" width="104" height="16" fill="#ffffff" stroke="none" pointer-events="all"/><rect x="358" y="174" width="104" height="16" fill="#ffffff" stroke="none" pointer-events="all"/><rect x="14" y="0" width="110" height="40" rx="6" ry="6" fill="url(#mx-gradient-dae8fc-1-7ea6e0-1-s-0)" stroke="#6c8ebf" pointer-events="all"/><path d="M 69 40 L 69 280" fill="none" stroke="#6c8ebf" stroke-miterlimit="10" stroke-dasharray="3 3" pointer-events="all"/><g transform="translate(-0.5 -0.5)"><switch><foreignObject style="overflow: visible; text-align: left;" pointer-events="none" width="100%" height="100%" requiredFeatures="http://www.w3.org/TR/SVG11/feature#Extensibility"><div xmlns="http://www.w3.org/1999/xhtml" style="display: flex; align-items: unsafe center; justify-content: unsafe center; width: 108px; height: 1px; padding-top: 20px; margin-left: 15px;"><div style="box-sizing: border-box; font-size: 0; text-align: center; "><div style="display: inline-block; font-size: 12px; font-family: Verdana; color: #000000; line-height: 1.2; pointer-events: all; white-space: normal; word-wrap: normal; "><font style="font-size: 14px">Thread 1</font></div></div></div></foreignObject><text x="69" y="24" fill="#000000" font-family="Verdana" font-size="12px" text-anchor="middle">Thread 1</text></switch></g><rect x="26" y="132" width="104" height="16" fill="#ffffff" stroke="none" pointer-events="all"/><rect x="0" y="126" width="120" height="20" fill="none" stroke="none" pointer-events="all"/><g transform="translate(-0.5 -0.5)"><switch><foreignObject style="overflow: visible; text-align: left;" pointer-events="none" width="100%" height="100%" requiredFeatures="http://www.w3.org/TR/SVG11/feature#Extensibility"><div xmlns="http://www.w3.org/1999/xhtml" style="display: flex; align-items: unsafe flex-start; justify-content: unsafe flex-start; width: 1px; height: 1px; padding-top: 133px; margin-left: 2px;"><div style="box-sizing: border-box; font-size: 0; text-align: left; "><div style="display: inline-block; font-size: 12px; font-family: Helvetica; color: #000000; line-height: 1.2; pointer-events: all; white-space: nowrap; "><font face="Courier New" style="font-size: 11px">   m.subscribe(result-&gt;{..})</font></div></div></div></foreignObject><text x="2" y="145" fill="#000000" font-family="Helvetica" font-size="12px">m.subscribe(resul...</text></switch></g><rect x="586" y="0" width="168" height="40" rx="6" ry="6" fill="url(#mx-gradient-dae8fc-1-7ea6e0-1-s-0)" stroke="#6c8ebf" pointer-events="all"/><path d="M 670 40 L 670 302" fill="none" stroke="#6c8ebf" stroke-miterlimit="10" stroke-dasharray="3 3" pointer-events="all"/><g transform="translate(-0.5 -0.5)"><switch><foreignObject style="overflow: visible; text-align: left;" pointer-events="none" width="100%" height="100%" requiredFeatures="http://www.w3.org/TR/SVG11/feature#Extensibility"><div xmlns="http://www.w3.org/1999/xhtml" style="display: flex; align-items: unsafe center; justify-content: unsafe center; width: 166px; height: 1px; padding-top: 20px; margin-left: 587px;"><div style="box-sizing: border-box; font-size: 0; text-align: center; "><div style="display: inline-block; font-size: 12px; font-family: Verdana; color: #000000; line-height: 1.2; pointer-events: all; white-space: normal; word-wrap: normal; "><font style="font-size: 14px">DelayedBatchExecutor</font></div></div></div></foreignObject><text x="670" y="24" fill="#000000" font-family="Verdana" font-size="12px" text-anchor="middle">DelayedBatchExecutor</text></switch></g><rect x="586" y="78" width="168" height="138" fill="url(#mx-gradient-fff2cc-1-ffd966-1-s-0)" stroke="#d6b656" pointer-events="all"/><rect x="650" y="90" width="40" height="72" fill="#f5f5f5" stroke="#666666" pointer-events="all"/><path d="M 650 125 L 690 125" fill="none" stroke="#000000" stroke-width="2" stroke-miterlimit="10" pointer-events="all"/><path d="M 650 105 L 690 105" fill="none" stroke="#000000" stroke-width="2" stroke-miterlimit="10" pointer-events="all"/><path d="M 650 143 L 690 143" fill="none" stroke="#000000" stroke-width="2" stroke-miterlimit="10" pointer-events="all"/><path d="M 666 127 L 680 122 L 680 125.5 L 722 125.5 L 722 122 L 736 127 L 722 132 L 722 128.5 L 680 128.5 L 680 132 Z" fill="url(#mx-gradient-ffcd28-1-ffa500-1-s-0)" stroke="#d79b00" stroke-miterlimit="10" transform="rotate(90,701,127)" pointer-events="all"/><rect x="672" y="116.5" width="78" height="21" fill="none" stroke="none" transform="rotate(-90,711,127)" pointer-events="all"/><g transform="translate(-0.5 -0.5)rotate(-90 711 127)"><switch><foreignObject style="overflow: visible; text-align: left;" pointer-events="none" width="100%" height="100%" requiredFeatures="http://www.w3.org/TR/SVG11/feature#Extensibility"><div xmlns="http://www.w3.org/1999/xhtml" style="display: flex; align-items: unsafe center; justify-content: unsafe center; width: 76px; height: 1px; padding-top: 127px; margin-left: 673px;"><div style="box-sizing: border-box; font-size: 0; text-align: center; "><div style="display: inline-block; font-size: 12px; font-family: Helvetica; color: #000000; line-height: 1.2; pointer-events: all; white-space: normal; word-wrap: normal; "><font style="font-size: 8px">Time Window</font></div></div></div></foreignObject><text x="711" y="131" fill="#000000" font-family="Helvetica" font-size="12px" text-anchor="middle">Time Window</text></switch></g><rect x="596" y="182" width="151" height="25" fill="#ffffff" stroke="#000000" pointer-events="all"/><g transform="translate(-0.5 -0.5)"><switch><foreignObject style="overflow: visible; text-align: left;" pointer-events="none" width="100%" height="100%" requiredFeatures="http://www.w3.org/TR/SVG11/feature#Extensibility"><div xmlns="http://www.w3.org/1999/xhtml" style="display: flex; align-items: unsafe center; justify-content: unsafe center; width: 149px; height: 1px; padding-top: 195px; margin-left: 597px;"><div style="box-sizing: border-box; font-size: 0; text-align: center; "><div style="display: inline-block; font-size: 12px; font-family: Helvetica; color: #000000; line-height: 1.2; pointer-events: all; white-space: normal; word-wrap: normal; "><i><font style="font-size: 11px" face="Courier New">batchCallback(args)</font></i></div></div></div></foreignObject><text x="672" y="198" fill="#000000" font-family="Helvetica" font-size="12px" text-anchor="middle">batchCallback(args)</text></switch></g><rect x="652" y="82" width="50" height="30" fill="none" stroke="none" pointer-events="all"/><g transform="translate(-0.5 -0.5)"><switch><foreignObject style="overflow: visible; text-align: left;" pointer-events="none" width="100%" height="100%" requiredFeatures="http://www.w3.org/TR/SVG11/feature#Extensibility"><div xmlns="http://www.w3.org/1999/xhtml" style="display: flex; align-items: unsafe flex-start; justify-content: unsafe flex-start; width: 1px; height: 1px; padding-top: 89px; margin-left: 654px;"><div style="box-sizing: border-box; font-size: 0; text-align: left; "><div style="display: inline-block; font-size: 12px; font-family: Helvetica; color: #000000; line-height: 1.2; pointer-events: all; white-space: nowrap; "><font face="Courier New">val1</font></div></div></div></foreignObject><text x="654" y="101" fill="#000000" font-family="Helvetica" font-size="12px">val1</text></switch></g><rect x="660" y="118" width="50" height="30" fill="none" stroke="none" pointer-events="all"/><g transform="translate(-0.5 -0.5)"><switch><foreignObject style="overflow: visible; text-align: left;" pointer-events="none" width="100%" height="100%" requiredFeatures="http://www.w3.org/TR/SVG11/feature#Extensibility"><div xmlns="http://www.w3.org/1999/xhtml" style="display: flex; align-items: unsafe flex-start; justify-content: unsafe flex-start; width: 1px; height: 1px; padding-top: 125px; margin-left: 662px;"><div style="box-sizing: border-box; font-size: 0; text-align: left; "><div style="display: inline-block; font-size: 12px; font-family: Helvetica; color: #000000; line-height: 1.2; pointer-events: all; white-space: nowrap; ">...</div></div></div></foreignObject><text x="662" y="137" fill="#000000" font-family="Helvetica" font-size="12px">...</text></switch></g><rect x="652" y="100" width="50" height="30" fill="none" stroke="none" pointer-events="all"/><g transform="translate(-0.5 -0.5)"><switch><foreignObject style="overflow: visible; text-align: left;" pointer-events="none" width="100%" height="100%" requiredFeatures="http://www.w3.org/TR/SVG11/feature#Extensibility"><div xmlns="http://www.w3.org/1999/xhtml" style="display: flex; align-items: unsafe flex-start; justify-content: unsafe flex-start; width: 1px; height: 1px; padding-top: 107px; margin-left: 654px;"><div style="box-sizing: border-box; font-size: 0; text-align: left; "><div style="display: inline-block; font-size: 12px; font-family: Helvetica; color: #000000; line-height: 1.2; pointer-events: all; white-space: nowrap; "><font face="Courier New">val2</font></div></div></div></foreignObject><text x="654" y="119" fill="#000000" font-family="Helvetica" font-size="12px">val2</text></switch></g><rect x="654" y="138" width="50" height="30" fill="none" stroke="none" pointer-events="all"/><g transform="translate(-0.5 -0.5)"><switch><foreignObject style="overflow: visible; text-align: left;" pointer-events="none" width="100%" height="100%" requiredFeatures="http://www.w3.org/TR/SVG11/feature#Extensibility"><div xmlns="http://www.w3.org/1999/xhtml" style="display: flex; align-items: unsafe flex-start; justify-content: unsafe flex-start; width: 1px; height: 1px; padding-top: 145px; margin-left: 656px;"><div style="box-sizing: border-box; font-size: 0; text-align: left; "><div style="display: inline-block; font-size: 12px; font-family: Helvetica; color: #000000; line-height: 1.2; pointer-events: all; white-space: nowrap; "><font face="Courier New">valn</font></div></div></div></foreignObject><text x="656" y="157" fill="#000000" font-family="Helvetica" font-size="12px">valn</text></switch></g><path d="M 670 162 L 670 166 Q 670 170 680 170 L 702 170 Q 712 170 712 176 L 712 179 Q 712 182 712 181.45 L 712 180.9" fill="none" stroke="#000000" stroke-width="3" stroke-miterlimit="10" pointer-events="stroke"/><path d="M 712 187.65 L 707.5 178.65 L 712 180.9 L 716.5 178.65 Z" fill="#000000" stroke="#000000" stroke-width="3" stroke-miterlimit="10" pointer-events="all"/><path d="M 75.71 91.33 L 643.63 90.01" fill="none" stroke="#000000" stroke-miterlimit="10" pointer-events="stroke"/><path d="M 70.46 91.34 L 77.45 87.82 L 75.71 91.33 L 77.47 94.82 Z" fill="#000000" stroke="#000000" stroke-miterlimit="10" pointer-events="all"/><path d="M 648.88 90 L 641.89 93.52 L 643.63 90.01 L 641.87 86.52 Z" fill="#000000" stroke="#000000" stroke-miterlimit="10" pointer-events="all"/><path d="M 418.53 146.81 L 641.63 146.81" fill="none" stroke="#000000" stroke-miterlimit="10" pointer-events="stroke"/><path d="M 413.28 146.81 L 420.28 143.31 L 418.53 146.81 L 420.28 150.31 Z" fill="#000000" stroke="#000000" stroke-miterlimit="10" pointer-events="all"/><path d="M 646.88 146.81 L 639.88 150.31 L 641.63 146.81 L 639.88 143.31 Z" fill="#000000" stroke="#000000" stroke-miterlimit="10" pointer-events="all"/><path d="M 242.53 109 L 516 109 Q 526 109 536 108.92 L 643.63 108.05" fill="none" stroke="#000000" stroke-miterlimit="10" pointer-events="stroke"/><path d="M 237.28 109 L 244.28 105.5 L 242.53 109 L 244.28 112.5 Z" fill="#000000" stroke="#000000" stroke-miterlimit="10" pointer-events="all"/><path d="M 648.88 108.01 L 641.91 111.57 L 643.63 108.05 L 641.85 104.57 Z" fill="#000000" stroke="#000000" stroke-miterlimit="10" pointer-events="all"/><path d="M 671.5 207 L 521.98 215.44 Q 512 216 502 216 L 476 216 Q 466 216 456 216.07 L 182 217.93 Q 172 218 166.57 209.6 L 129.86 152.89" fill="none" stroke="#000000" stroke-miterlimit="10" stroke-dasharray="1 1" pointer-events="stroke"/><path d="M 137.92 157.06 L 129.26 151.95 L 130.37 161.95" fill="none" stroke="#000000" stroke-miterlimit="10" pointer-events="all"/><g transform="translate(-0.5 -0.5)"><switch><foreignObject style="overflow: visible; text-align: left;" pointer-events="none" width="100%" height="100%" requiredFeatures="http://www.w3.org/TR/SVG11/feature#Extensibility"><div xmlns="http://www.w3.org/1999/xhtml" style="display: flex; align-items: unsafe flex-end; justify-content: unsafe center; width: 1px; height: 1px; padding-top: 223px; margin-left: 341px;"><div style="box-sizing: border-box; font-size: 0; text-align: center; "><div style="display: inline-block; font-size: 11px; font-family: Helvetica; color: #000000; line-height: 1.2; pointer-events: all; background-color: #ffffff; white-space: nowrap; "><i style="font-family: &quot;verdana&quot;"><font style="font-size: 11px">result is emitted</font></i></div></div></div></foreignObject><text x="341" y="223" fill="#000000" font-family="Helvetica" font-size="11px" text-anchor="middle">result is emitted</text></switch></g><rect x="66" y="72" width="176" height="20" fill="none" stroke="none" pointer-events="all"/><g transform="translate(-0.5 -0.5)"><switch><foreignObject style="overflow: visible; text-align: left;" pointer-events="none" width="100%" height="100%" requiredFeatures="http://www.w3.org/TR/SVG11/feature#Extensibility"><div xmlns="http://www.w3.org/1999/xhtml" style="display: flex; align-items: unsafe center; justify-content: unsafe center; width: 174px; height: 1px; padding-top: 82px; margin-left: 67px;"><div style="box-sizing: border-box; font-size: 0; text-align: center; "><div style="display: inline-block; font-size: 12px; font-family: Helvetica; color: #000000; line-height: 1.2; pointer-events: all; white-space: normal; word-wrap: normal; "><font face="Courier New" style="font-size: 9px">Mono m = executeAsMono(val1)</font></div></div></div></foreignObject><text x="154" y="86" fill="#000000" font-family="Helvetica" font-size="12px" text-anchor="middle">Mono m = executeAsMono(val1)</text></switch></g><rect x="412" y="124" width="192" height="22" fill="none" stroke="none" pointer-events="all"/><g transform="translate(-0.5 -0.5)"><switch><foreignObject style="overflow: visible; text-align: left;" pointer-events="none" width="100%" height="100%" requiredFeatures="http://www.w3.org/TR/SVG11/feature#Extensibility"><div xmlns="http://www.w3.org/1999/xhtml" style="display: flex; align-items: unsafe flex-start; justify-content: unsafe flex-start; width: 1px; height: 1px; padding-top: 131px; margin-left: 414px;"><div style="box-sizing: border-box; font-size: 0; text-align: left; "><div style="display: inline-block; font-size: 12px; font-family: Helvetica; color: #000000; line-height: 1.2; pointer-events: all; white-space: nowrap; "><font face="Courier New" style="font-size: 9px">Mono m = executeAsMono(valn)</font></div></div></div></foreignObject><text x="414" y="143" fill="#000000" font-family="Helvetica" font-size="12px">Mono m = executeAsMono(valn)</text></switch></g><rect x="246" y="88" width="192" height="22" fill="none" stroke="none" pointer-events="all"/><g transform="translate(-0.5 -0.5)"><switch><foreignObject style="overflow: visible; text-align: left;" pointer-events="none" width="100%" height="100%" requiredFeatures="http://www.w3.org/TR/SVG11/feature#Extensibility"><div xmlns="http://www.w3.org/1999/xhtml" style="display: flex; align-items: unsafe flex-start; justify-content: unsafe flex-start; width: 1px; height: 1px; padding-top: 95px; margin-left: 248px;"><div style="box-sizing: border-box; font-size: 0; text-align: left; "><div style="display: inline-block; font-size: 12px; font-family: Helvetica; color: #000000; line-height: 1.2; pointer-events: all; white-space: nowrap; "><font face="Courier New" style="font-size: 9px">Mono m = executeAsMono(val2)</font></div></div></div></foreignObject><text x="248" y="107" fill="#000000" font-family="Helvetica" font-size="12px">Mono m = executeAsMono(val2)</text></switch></g><rect x="138" y="244" width="110" height="22" fill="none" stroke="none" pointer-events="all"/><g transform="translate(-0.5 -0.5)"><switch><foreignObject style="overflow: visible; text-align: left;" pointer-events="none" width="100%" height="100%" requiredFeatures="http://www.w3.org/TR/SVG11/feature#Extensibility"><div xmlns="http://www.w3.org/1999/xhtml" style="display: flex; align-items: unsafe flex-start; justify-content: unsafe flex-start; width: 1px; height: 1px; padding-top: 251px; margin-left: 140px;"><div style="box-sizing: border-box; font-size: 0; text-align: left; "><div style="display: inline-block; font-size: 12px; font-family: Helvetica; color: #000000; line-height: 1.2; pointer-events: all; white-space: nowrap; "><span style="font-family: &quot;courier new&quot; ; font-size: 11px">   m.subscribe(result-&gt;{..})</span></div></div></div></foreignObject><text x="140" y="263" fill="#000000" font-family="Helvetica" font-size="12px">m.subscribe(res...</text></switch></g><rect x="322" y="166" width="110" height="22" fill="none" stroke="none" pointer-events="all"/><g transform="translate(-0.5 -0.5)"><switch><foreignObject style="overflow: visible; text-align: left;" pointer-events="none" width="100%" height="100%" requiredFeatures="http://www.w3.org/TR/SVG11/feature#Extensibility"><div xmlns="http://www.w3.org/1999/xhtml" style="display: flex; align-items: unsafe flex-start; justify-content: unsafe flex-start; width: 1px; height: 1px; padding-top: 173px; margin-left: 324px;"><div style="box-sizing: border-box; font-size: 0; text-align: left; "><div style="display: inline-block; font-size: 12px; font-family: Helvetica; color: #000000; line-height: 1.2; pointer-events: all; white-space: nowrap; "><span style="font-family: &quot;courier new&quot; ; font-size: 11px">   m.subscribe(result-&gt;{..})</span></div></div></div></foreignObject><text x="324" y="185" fill="#000000" font-family="Helvetica" font-size="12px">m.subscribe(res...</text></switch></g><path d="M 672 208 L 601.99 211.5 Q 592 212 582.16 210.21 L 535.84 201.79 Q 526 200 524.21 190.16 L 519.79 165.84 Q 518 156 508 156 L 480 156 Q 470 156 470 161.88 L 470 167.76" fill="none" stroke="#000000" stroke-miterlimit="10" stroke-dasharray="1 1" pointer-events="stroke"/><path d="M 465.5 159.88 L 470 168.88 L 474.5 159.88" fill="none" stroke="#000000" stroke-miterlimit="10" pointer-events="all"/><g transform="translate(-0.5 -0.5)"><switch><foreignObject style="overflow: visible; text-align: left;" pointer-events="none" width="100%" height="100%" requiredFeatures="http://www.w3.org/TR/SVG11/feature#Extensibility"><div xmlns="http://www.w3.org/1999/xhtml" style="display: flex; align-items: unsafe flex-end; justify-content: unsafe center; width: 1px; height: 1px; padding-top: 202px; margin-left: 532px;"><div style="box-sizing: border-box; font-size: 0; text-align: center; "><div style="display: inline-block; font-size: 11px; font-family: Helvetica; color: #000000; line-height: 1.2; pointer-events: all; background-color: #ffffff; white-space: nowrap; "><i style="font-family: &quot;verdana&quot;"><font style="font-size: 11px">result is emitted</font></i></div></div></div></foreignObject><text x="532" y="202" fill="#000000" font-family="Helvetica" font-size="11px" text-anchor="middle">result is emitted</text></switch></g><path d="M 670 208 L 581.62 233.25 Q 572 236 562 236.16 L 460 237.84 Q 450 238 440 238 L 298 238 Q 288 238 288 242.88 L 288 247.76" fill="none" stroke="#000000" stroke-miterlimit="10" stroke-dasharray="1 1" pointer-events="stroke"/><path d="M 283.5 239.88 L 288 248.88 L 292.5 239.88" fill="none" stroke="#000000" stroke-miterlimit="10" pointer-events="all"/><g transform="translate(-0.5 -0.5)"><switch><foreignObject style="overflow: visible; text-align: left;" pointer-events="none" width="100%" height="100%" requiredFeatures="http://www.w3.org/TR/SVG11/feature#Extensibility"><div xmlns="http://www.w3.org/1999/xhtml" style="display: flex; align-items: unsafe flex-end; justify-content: unsafe center; width: 1px; height: 1px; padding-top: 244px; margin-left: 447px;"><div style="box-sizing: border-box; font-size: 0; text-align: center; "><div style="display: inline-block; font-size: 11px; font-family: Helvetica; color: #000000; line-height: 1.2; pointer-events: all; background-color: #ffffff; white-space: nowrap; "><i style="font-family: &quot;verdana&quot;"><font style="font-size: 11px">result is emitted</font></i></div></div></div></foreignObject><text x="447" y="244" fill="#000000" font-family="Helvetica" font-size="11px" text-anchor="middle">result is emitted</text></switch></g></g><switch><g requiredFeatures="http://www.w3.org/TR/SVG11/feature#Extensibility"/><a transform="translate(0,-5)" xlink:href="https://desk.draw.io/support/solutions/articles/16000042487" target="_blank"><text text-anchor="middle" font-size="10px" x="50%" y="100%">Viewer does not support full SVG 1.1</text></a></switch></svg>


--------------------------------------------------------------------------------