feat: Implement Thread-Pool Executor pattern (#3271)

- Add implementation of Thread-Pool Executor pattern using hotel front desk example
- Include unit tests
- Create detailed README with pattern explanation and examples
- Add Java source code with appropriate Javadoc comments

Closes #3226
This commit is contained in:
yoobin_mion
2025-05-16 03:53:37 +09:00
committed by GitHub
parent 3ac1a36b05
commit 8529017e02
13 changed files with 1041 additions and 0 deletions
+1
View File
@@ -231,6 +231,7 @@
<module>table-module</module>
<module>template-method</module>
<module>templateview</module>
<module>thread-pool-executor</module>
<module>throttling</module>
<module>tolerant-reader</module>
<module>trampoline</module>
+200
View File
@@ -0,0 +1,200 @@
---
title: "Thread-Pool Executor Pattern in Java: Efficient Concurrent Task Management"
shortTitle: Thread-Pool Executor
description: "Learn the Thread-Pool Executor pattern in Java with practical examples, class
diagrams, and implementation details. Understand how to manage concurrent tasks efficiently,
improving resource utilization and application performance."
category: Concurrency
language: en
tag:
- Performance
- Resource Management
- Concurrency
- Multithreading
- Scalability
---
## Intent of Thread-Pool Executor Design Pattern
The Thread-Pool Executor pattern maintains a pool of worker threads to execute tasks concurrently,
optimizing resource usage by reusing existing threads instead of creating new ones for each task.
## Detailed Explanation of Thread-Pool Executor Pattern with Real-World Examples
### Real-world example
> Imagine a busy airport security checkpoint where instead of opening a new lane for each traveler,
> a fixed number of security lanes (threads) are open to process all passengers. Each security
> officer (thread) processes one passenger (task) at a time, and when finished, immediately calls the
> next passenger in line. During peak travel times, passengers wait in a queue, but the system is much
> more efficient than trying to open a new security lane for each individual traveler. The airport can
> handle fluctuating passenger traffic throughout the day with consistent staffing, optimizing both
> resource utilization and passenger throughput.
### In plain words
> Thread-Pool Executor keeps a set of reusable threads that process multiple tasks throughout their
> lifecycle, rather than creating a new thread for each task.
### Wikipedia says
> A thread pool is a software design pattern for achieving concurrency of execution in a computer
> program. Often also called a replicated workers or worker-crew model, a thread pool maintains
> multiple threads waiting for tasks to be allocated for concurrent execution by the supervising
> program.
### Class diagram
![Thread-pool-executor Class diagram](./etc/thread-pool-executor.urm.png)
## Programmatic Example of Thread-Pool Executor Pattern in Java
Imagine a hotel front desk.
The number of employees (thread pool) is limited, but guests (tasks) keep arriving endlessly.
The Thread-Pool Executor pattern efficiently handles a large number of requests by reusing a small
set of threads.
```java
@Slf4j
public class HotelFrontDesk {
public static void main(String[] args) throws InterruptedException, ExecutionException {
// Hire 3 front desk employees (threads)
ExecutorService frontDesk = Executors.newFixedThreadPool(3);
LOGGER.info("Hotel front desk operation started!");
// 7 regular guests checking in (Runnable)
for (int i = 1; i <= 7; i++) {
String guestName = "Guest-" + i;
frontDesk.submit(() -> {
String employeeName = Thread.currentThread().getName();
LOGGER.info("{} is checking in {}...", employeeName, guestName);
try {
Thread.sleep(2000); // Simulate check-in time
} catch (InterruptedException e) {
Thread.currentThread().interrupt();
}
LOGGER.info("{} has been successfully checked in!", guestName);
});
}
// 3 VIP guests checking in (Callable with result)
Callable<String> vipGuest1 = createVipGuest("VIP-Guest-1");
Callable<String> vipGuest2 = createVipGuest("VIP-Guest-2");
Callable<String> vipGuest3 = createVipGuest("VIP-Guest-3");
Future<String> vipResult1 = frontDesk.submit(vipGuest1);
Future<String> vipResult2 = frontDesk.submit(vipGuest2);
Future<String> vipResult3 = frontDesk.submit(vipGuest3);
// Shutdown after submitting all tasks
frontDesk.shutdown();
if (frontDesk.awaitTermination(1, TimeUnit.HOURS)) {
// Print VIP guests' check-in results
LOGGER.info("VIP Check-in Results:");
LOGGER.info(vipResult1.get());
LOGGER.info(vipResult2.get());
LOGGER.info(vipResult3.get());
LOGGER.info("All guests have been successfully checked in. Front desk is now closed.");
} else {
LOGGER.info("Check-in timeout. Forcefully shutting down the front desk.");
}
}
private static Callable<String> createVipGuest(String vipGuestName) {
return () -> {
String employeeName = Thread.currentThread().getName();
LOGGER.info("{} is checking in VIP guest {}...", employeeName, vipGuestName);
Thread.sleep(1000); // VIPs are faster to check in
return vipGuestName + " has been successfully checked in!";
};
}
}
```
Here's the console output:
```markdown
Hotel front desk operation started!
pool-1-thread-3 is checking in Guest-3...
pool-1-thread-2 is checking in Guest-2...
pool-1-thread-1 is checking in Guest-1...
Guest-2 has been successfully checked in!
Guest-1 has been successfully checked in!
Guest-3 has been successfully checked in!
pool-1-thread-2 is checking in Guest-5...
pool-1-thread-3 is checking in Guest-4...
pool-1-thread-1 is checking in Guest-6...
Guest-5 has been successfully checked in!
pool-1-thread-2 is checking in Guest-7...
Guest-4 has been successfully checked in!
pool-1-thread-3 is checking in VIP guest VIP-Guest-1...
Guest-6 has been successfully checked in!
pool-1-thread-1 is checking in VIP guest VIP-Guest-2...
pool-1-thread-3 is checking in VIP guest VIP-Guest-3...
Guest-7 has been successfully checked in!
VIP Check-in Results:
VIP-Guest-1 has been successfully checked in!
VIP-Guest-2 has been successfully checked in!
VIP-Guest-3 has been successfully checked in!
All guests have been successfully checked in. Front desk is now closed.
```
**Note:** Since this example demonstrates asynchronous thread execution, **the actual output may vary between runs**. The order of execution and timing can differ due to thread scheduling, system load, and other factors that affect concurrent processing. The core behavior of the thread pool (limiting concurrent tasks to the number of threads and reusing threads) will remain consistent, but the exact sequence of log messages may change with each execution.
## When to Use the Thread-Pool Executor Pattern in Java
* When you need to limit the number of threads running simultaneously to avoid resource exhaustion
* For applications that process a large number of short-lived independent tasks
* To improve performance by reducing thread creation/destruction overhead
* When implementing server applications that handle multiple client requests concurrently
* To execute recurring tasks at fixed rates or with fixed delays
## Thread-Pool Executor Pattern Java Tutorial
* [Thread-Pool Executor Pattern Tutorial (Baeldung)](https://www.baeldung.com/thread-pool-java-and-guava)
## Real-World Applications of Thread-Pool Executor Pattern in Java
* Application servers like Tomcat and Jetty use thread pools to handle HTTP requests
* Database connection pools in JDBC implementations
* Background job processing frameworks like Spring Batch
* Task scheduling systems like Quartz Scheduler
* Java EE's Managed Executor Service for enterprise applications
## Benefits and Trade-offs of Thread-Pool Executor Pattern
### Benefits
* Improves performance by reusing existing threads instead of creating new ones
* Provides better resource management by limiting the number of active threads
* Simplifies thread lifecycle management and cleanup
* Facilitates easy implementation of task prioritization and scheduling
* Enhances application stability by preventing resource exhaustion
### Trade-offs
* May lead to thread starvation if improperly configured (too few threads)
* Potential for resource underutilization if improperly sized (too many threads)
* Requires careful shutdown handling to prevent task loss or resource leaks
## Related Java Design Patterns
* [Master-Worker Pattern](https://java-design-patterns.com/patterns/master-worker/): Tasks between a
master and multiple workers.
* [Producer-Consumer Pattern](https://java-design-patterns.com/patterns/producer-consumer/):
Separates task production and task consumption, typically using a blocking queue.
* [Object Pool Pattern](https://java-design-patterns.com/patterns/object-pool/): Reuses a set of
objects (e.g., threads) instead of creating/destroying them repeatedly.
## References and Credits
* [Java Documentation for ThreadPoolExecutor](https://docs.oracle.com/en/java/javase/11/docs/api/java.base/java/util/concurrent/ThreadPoolExecutor.html)
* [Java Concurrency in Practice](https://jcip.net/) by Brian Goetz
* [Effective Java](https://www.oreilly.com/library/view/effective-java-3rd/9780134686097/) by Joshua
Bloch
Binary file not shown.

After

Width:  |  Height:  |  Size: 84 KiB

@@ -0,0 +1,66 @@
@startuml
interface Runnable {
+run(): void
}
interface Callable<T> {
+call(): T
}
interface ExecutorService {
+submit(task: Runnable): Future<?>
+submit(task: Callable<T>): Future<T>
+shutdown(): void
+awaitTermination(timeout: long, unit: TimeUnit): boolean
}
class ThreadPoolExecutor {
-corePoolSize: int
-maximumPoolSize: int
-keepAliveTime: long
-workQueue: BlockingQueue<Runnable>
+execute(task: Runnable): void
+submit(task: Callable<T>): Future<T>
}
class ThreadPoolManager {
-executorService: ExecutorService
+ThreadPoolManager(numThreads: int)
+submitTask(task: Runnable): void
+submitCallable(task: Callable<T>): Future<T>
+shutdown(): void
+awaitTermination(timeout: long, unit: TimeUnit): boolean
}
class Task {
-id: int
-name: String
-processingTime: long
+Task(id: int, name: String, processingTime: long)
+run(): void
+call(): TaskResult
}
class TaskResult {
-taskId: int
-taskName: String
-executionTime: long
+TaskResult(taskId: int, taskName: String, executionTime: long)
}
class App {
+main(args: String[]): void
-executeRunnableTasks(poolManager: ThreadPoolManager): void
-executeCallableTasks(poolManager: ThreadPoolManager): void
}
ExecutorService <|-- ThreadPoolExecutor : implements
Task ..|> Runnable : implements
Task ..|> Callable : implements
Task --> TaskResult : produces
ThreadPoolManager --> ExecutorService : wraps
App --> ThreadPoolManager : uses
App --> Task : creates
@enduml
+83
View File
@@ -0,0 +1,83 @@
<?xml version="1.0" encoding="UTF-8"?>
<!--
This project is licensed under the MIT license. Module model-view-viewmodel is using ZK framework licensed under LGPL (see lgpl-3.0.txt).
The MIT License
Copyright © 2014-2022 Ilkka Seppälä
Permission is hereby granted, free of charge, to any person obtaining a copy
of this software and associated documentation files (the "Software"), to deal
in the Software without restriction, including without limitation the rights
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
copies of the Software, and to permit persons to whom the Software is
furnished to do so, subject to the following conditions:
The above copyright notice and this permission notice shall be included in
all copies or substantial portions of the Software.
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
THE SOFTWARE.
-->
<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">
<modelVersion>4.0.0</modelVersion>
<parent>
<groupId>com.iluwatar</groupId>
<artifactId>java-design-patterns</artifactId>
<version>1.26.0-SNAPSHOT</version>
</parent>
<artifactId>thread-pool-executor</artifactId>
<dependencies>
<dependency>
<groupId>org.slf4j</groupId>
<artifactId>slf4j-api</artifactId>
</dependency>
<dependency>
<groupId>ch.qos.logback</groupId>
<artifactId>logback-classic</artifactId>
</dependency>
<dependency>
<groupId>org.junit.jupiter</groupId>
<artifactId>junit-jupiter-engine</artifactId>
<scope>test</scope>
</dependency>
<dependency>
<groupId>org.mockito</groupId>
<artifactId>mockito-core</artifactId>
<scope>test</scope>
</dependency>
</dependencies>
<build>
<plugins>
<plugin>
<groupId>org.apache.maven.plugins</groupId>
<artifactId>maven-assembly-plugin</artifactId>
<executions>
<execution>
<configuration>
<archive>
<manifest>
<mainClass>com.iluwatar.threadpoolexecutor.App</mainClass>
</manifest>
</archive>
</configuration>
</execution>
</executions>
</plugin>
</plugins>
</build>
</project>
@@ -0,0 +1,90 @@
/*
* This project is licensed under the MIT license. Module model-view-viewmodel is using ZK framework licensed under LGPL (see lgpl-3.0.txt).
*
* The MIT License
* Copyright © 2014-2022 Ilkka Seppälä
*
* Permission is hereby granted, free of charge, to any person obtaining a copy
* of this software and associated documentation files (the "Software"), to deal
* in the Software without restriction, including without limitation the rights
* to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
* copies of the Software, and to permit persons to whom the Software is
* furnished to do so, subject to the following conditions:
*
* The above copyright notice and this permission notice shall be included in
* all copies or substantial portions of the Software.
*
* THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
* IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
* FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
* AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
* LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
* OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
* THE SOFTWARE.
*/
package com.iluwatar.threadpoolexecutor;
import java.util.ArrayList;
import java.util.List;
import java.util.concurrent.ExecutionException;
import java.util.concurrent.Future;
import java.util.concurrent.TimeUnit;
import lombok.extern.slf4j.Slf4j;
/**
* The Thread-Pool Executor pattern demonstrates how a pool of worker threads can be used to execute
* tasks concurrently. This pattern is particularly useful in scenarios where you need to execute a
* large number of independent tasks and want to limit the number of threads used.
*
* <p>In this example, a hotel front desk with a fixed number of employees processes guest
* check-ins. Each employee is represented by a thread, and each check-in is a task.
*
* <p>Key benefits demonstrated:
*
* <ul>
* <li>Resource management - Limiting the number of concurrent threads
* <li>Efficiency - Reusing threads instead of creating new ones for each task
* <li>Responsiveness - Handling many requests with limited resources
* </ul>
*/
@Slf4j
public class App {
/**
* Program main entry point.
*
* @param args program runtime arguments
*/
public static void main(String[] args) throws InterruptedException, ExecutionException {
FrontDeskService frontDesk = new FrontDeskService(5);
LOGGER.info("Hotel front desk operation started!");
LOGGER.info("Processing 30 regular guest check-ins...");
for (int i = 1; i <= 30; i++) {
frontDesk.submitGuestCheckIn(new GuestCheckInTask("Guest-" + i));
Thread.sleep(100);
}
LOGGER.info("Processing 3 VIP guest check-ins...");
List<Future<String>> vipResults = new ArrayList<>();
for (int i = 1; i <= 3; i++) {
Future<String> result =
frontDesk.submitVipGuestCheckIn(new VipGuestCheckInTask("VIP-Guest-" + i));
vipResults.add(result);
}
frontDesk.shutdown();
if (frontDesk.awaitTermination(1, TimeUnit.HOURS)) {
LOGGER.info("VIP Check-in Results:");
for (Future<String> result : vipResults) {
LOGGER.info(result.get());
}
LOGGER.info("All guests have been successfully checked in. Front desk is now closed.");
} else {
LOGGER.warn("Check-in timeout. Forcefully shutting down the front desk.");
}
}
}
@@ -0,0 +1,108 @@
/*
* This project is licensed under the MIT license. Module model-view-viewmodel is using ZK framework licensed under LGPL (see lgpl-3.0.txt).
*
* The MIT License
* Copyright © 2014-2022 Ilkka Seppälä
*
* Permission is hereby granted, free of charge, to any person obtaining a copy
* of this software and associated documentation files (the "Software"), to deal
* in the Software without restriction, including without limitation the rights
* to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
* copies of the Software, and to permit persons to whom the Software is
* furnished to do so, subject to the following conditions:
*
* The above copyright notice and this permission notice shall be included in
* all copies or substantial portions of the Software.
*
* THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
* IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
* FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
* AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
* LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
* OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
* THE SOFTWARE.
*/
package com.iluwatar.threadpoolexecutor;
import java.util.concurrent.Callable;
import java.util.concurrent.ExecutorService;
import java.util.concurrent.Executors;
import java.util.concurrent.Future;
import java.util.concurrent.TimeUnit;
import lombok.extern.slf4j.Slf4j;
/**
* FrontDeskService represents the hotel's front desk with a fixed number of employees. This class
* demonstrates the Thread-Pool Executor pattern using Java's ExecutorService.
*/
@Slf4j
public class FrontDeskService {
private final ExecutorService executorService;
private final int numberOfEmployees;
/**
* Creates a new front desk with the specified number of employees.
*
* @param numberOfEmployees the number of employees (threads) at the front desk
*/
public FrontDeskService(int numberOfEmployees) {
this.numberOfEmployees = numberOfEmployees;
this.executorService = Executors.newFixedThreadPool(numberOfEmployees);
LOGGER.info("Front desk initialized with {} employees.", numberOfEmployees);
}
/**
* Submits a regular guest check-in task to an available employee.
*
* @param task the check-in task to submit
* @return a Future representing pending completion of the task
*/
public Future<Void> submitGuestCheckIn(Runnable task) {
LOGGER.debug("Submitting regular guest check-in task");
return executorService.submit(task, null);
}
/**
* Submits a VIP guest check-in task to an available employee.
*
* @param task the VIP check-in task to submit
* @param <T> the type of the task's result
* @return a Future representing pending completion of the task
*/
public <T> Future<T> submitVipGuestCheckIn(Callable<T> task) {
LOGGER.debug("Submitting VIP guest check-in task");
return executorService.submit(task);
}
/**
* Closes the front desk after all currently checked-in guests are processed. No new check-ins
* will be accepted.
*/
public void shutdown() {
LOGGER.info("Front desk is closing - no new guests will be accepted.");
executorService.shutdown();
}
/**
* Waits for all check-in processes to complete or until timeout.
*
* @param timeout the maximum time to wait
* @param unit the time unit of the timeout argument
* @return true if all tasks completed, false if timeout elapsed
* @throws InterruptedException if interrupted while waiting
*/
public boolean awaitTermination(long timeout, TimeUnit unit) throws InterruptedException {
LOGGER.info("Waiting for all check-ins to complete (max wait: {} {})", timeout, unit);
return executorService.awaitTermination(timeout, unit);
}
/**
* Gets the number of employees at the front desk.
*
* @return the number of employees
*/
public int getNumberOfEmployees() {
return numberOfEmployees;
}
}
@@ -0,0 +1,52 @@
/*
* This project is licensed under the MIT license. Module model-view-viewmodel is using ZK framework licensed under LGPL (see lgpl-3.0.txt).
*
* The MIT License
* Copyright © 2014-2022 Ilkka Seppälä
*
* Permission is hereby granted, free of charge, to any person obtaining a copy
* of this software and associated documentation files (the "Software"), to deal
* in the Software without restriction, including without limitation the rights
* to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
* copies of the Software, and to permit persons to whom the Software is
* furnished to do so, subject to the following conditions:
*
* The above copyright notice and this permission notice shall be included in
* all copies or substantial portions of the Software.
*
* THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
* IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
* FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
* AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
* LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
* OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
* THE SOFTWARE.
*/
package com.iluwatar.threadpoolexecutor;
import lombok.AllArgsConstructor;
import lombok.extern.slf4j.Slf4j;
/**
* GuestCheckInTask represents a regular guest check-in process. Implements Runnable because it
* performs an action without returning a result.
*/
@Slf4j
@AllArgsConstructor
public class GuestCheckInTask implements Runnable {
private final String guestName;
@Override
public void run() {
String employeeName = Thread.currentThread().getName();
LOGGER.info("{} is checking in {}...", employeeName, guestName);
try {
Thread.sleep(2000);
} catch (InterruptedException e) {
Thread.currentThread().interrupt();
LOGGER.error("Check-in for {} was interrupted", guestName);
}
LOGGER.info("{} has been successfully checked in!", guestName);
}
}
@@ -0,0 +1,52 @@
/*
* This project is licensed under the MIT license. Module model-view-viewmodel is using ZK framework licensed under LGPL (see lgpl-3.0.txt).
*
* The MIT License
* Copyright © 2014-2022 Ilkka Seppälä
*
* Permission is hereby granted, free of charge, to any person obtaining a copy
* of this software and associated documentation files (the "Software"), to deal
* in the Software without restriction, including without limitation the rights
* to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
* copies of the Software, and to permit persons to whom the Software is
* furnished to do so, subject to the following conditions:
*
* The above copyright notice and this permission notice shall be included in
* all copies or substantial portions of the Software.
*
* THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
* IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
* FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
* AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
* LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
* OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
* THE SOFTWARE.
*/
package com.iluwatar.threadpoolexecutor;
import java.util.concurrent.Callable;
import lombok.AllArgsConstructor;
import lombok.extern.slf4j.Slf4j;
/**
* VipGuestCheckInTask represents a VIP guest check-in process. Implements Callable because it
* returns a result (check-in confirmation).
*/
@Slf4j
@AllArgsConstructor
public class VipGuestCheckInTask implements Callable<String> {
private final String vipGuestName;
@Override
public String call() throws Exception {
String employeeName = Thread.currentThread().getName();
LOGGER.info("{} is checking in VIP guest {}...", employeeName, vipGuestName);
Thread.sleep(1000);
String result = vipGuestName + " has been successfully checked in!";
LOGGER.info("VIP check-in completed: {}", result);
return result;
}
}
@@ -0,0 +1,38 @@
/*
* This project is licensed under the MIT license. Module model-view-viewmodel is using ZK framework licensed under LGPL (see lgpl-3.0.txt).
*
* The MIT License
* Copyright © 2014-2022 Ilkka Seppälä
*
* Permission is hereby granted, free of charge, to any person obtaining a copy
* of this software and associated documentation files (the "Software"), to deal
* in the Software without restriction, including without limitation the rights
* to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
* copies of the Software, and to permit persons to whom the Software is
* furnished to do so, subject to the following conditions:
*
* The above copyright notice and this permission notice shall be included in
* all copies or substantial portions of the Software.
*
* THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
* IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
* FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
* AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
* LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
* OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
* THE SOFTWARE.
*/
package com.iluwatar.threadpoolexecutor;
import static org.junit.jupiter.api.Assertions.assertDoesNotThrow;
import org.junit.jupiter.api.Test;
class AppTest {
@Test
void appStartsWithoutException() {
assertDoesNotThrow(() -> App.main(new String[] {}));
}
}
@@ -0,0 +1,248 @@
/*
* This project is licensed under the MIT license. Module model-view-viewmodel is using ZK framework licensed under LGPL (see lgpl-3.0.txt).
*
* The MIT License
* Copyright © 2014-2022 Ilkka Seppälä
*
* Permission is hereby granted, free of charge, to any person obtaining a copy
* of this software and associated documentation files (the "Software"), to deal
* in the Software without restriction, including without limitation the rights
* to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
* copies of the Software, and to permit persons to whom the Software is
* furnished to do so, subject to the following conditions:
*
* The above copyright notice and this permission notice shall be included in
* all copies or substantial portions of the Software.
*
* THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
* IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
* FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
* AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
* LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
* OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
* THE SOFTWARE.
*/
package com.iluwatar.threadpoolexecutor;
import static org.junit.jupiter.api.Assertions.assertEquals;
import static org.junit.jupiter.api.Assertions.assertNotNull;
import static org.junit.jupiter.api.Assertions.assertThrows;
import static org.junit.jupiter.api.Assertions.assertTrue;
import java.util.ArrayList;
import java.util.List;
import java.util.concurrent.Callable;
import java.util.concurrent.CountDownLatch;
import java.util.concurrent.Future;
import java.util.concurrent.RejectedExecutionException;
import java.util.concurrent.TimeUnit;
import java.util.concurrent.atomic.AtomicInteger;
import org.junit.jupiter.api.Test;
class FrontDeskServiceTest {
/**
* Tests that the constructor correctly sets the number of employees (threads). This verifies the
* basic initialization of the thread pool.
*/
@Test
void testConstructorSetsCorrectNumberOfEmployees() {
int expectedEmployees = 3;
FrontDeskService frontDesk = new FrontDeskService(expectedEmployees);
assertEquals(expectedEmployees, frontDesk.getNumberOfEmployees());
}
/**
* Tests that the submitGuestCheckIn method returns a non-null Future object. This verifies the
* basic task submission functionality.
*/
@Test
void testSubmitGuestCheckInReturnsNonNullFuture() {
FrontDeskService frontDesk = new FrontDeskService(1);
Runnable task =
() -> {
// Task that completes quickly
};
Future<?> future = frontDesk.submitGuestCheckIn(task);
assertNotNull(future);
}
/**
* Tests that the submitVipGuestCheckIn method returns a non-null Future object. This verifies
* that tasks with return values can be submitted correctly.
*/
@Test
void testSubmitVipGuestCheckInReturnsNonNullFuture() {
FrontDeskService frontDesk = new FrontDeskService(1);
Callable<String> task = () -> "VIP Check-in complete";
Future<String> future = frontDesk.submitVipGuestCheckIn(task);
assertNotNull(future);
}
/**
* Tests that the shutdown and awaitTermination methods work correctly. This verifies the basic
* shutdown functionality of the thread pool.
*/
@Test
void testShutdownAndAwaitTermination() throws InterruptedException {
FrontDeskService frontDesk = new FrontDeskService(2);
CountDownLatch taskLatch = new CountDownLatch(1);
Runnable task = taskLatch::countDown;
frontDesk.submitGuestCheckIn(task);
frontDesk.shutdown();
boolean terminated = frontDesk.awaitTermination(1, TimeUnit.SECONDS);
assertTrue(terminated);
assertTrue(taskLatch.await(100, TimeUnit.MILLISECONDS));
}
/**
* Tests the thread pool's behavior under load with multiple tasks. This verifies that the thread
* pool limits concurrent execution to the number of threads, all submitted tasks are eventually
* completed, and threads are reused for multiple tasks.
*/
@Test
void testMultipleTasksUnderLoad() throws InterruptedException {
FrontDeskService frontDesk = new FrontDeskService(2);
int taskCount = 10;
CountDownLatch tasksCompletedLatch = new CountDownLatch(taskCount);
AtomicInteger concurrentTasks = new AtomicInteger(0);
AtomicInteger maxConcurrentTasks = new AtomicInteger(0);
for (int i = 0; i < taskCount; i++) {
frontDesk.submitGuestCheckIn(
() -> {
try {
int current = concurrentTasks.incrementAndGet();
maxConcurrentTasks.updateAndGet(max -> Math.max(max, current));
Thread.sleep(100);
concurrentTasks.decrementAndGet();
tasksCompletedLatch.countDown();
} catch (InterruptedException e) {
Thread.currentThread().interrupt();
}
});
}
boolean allTasksCompleted = tasksCompletedLatch.await(2, TimeUnit.SECONDS);
frontDesk.shutdown();
frontDesk.awaitTermination(1, TimeUnit.SECONDS);
assertTrue(allTasksCompleted);
assertEquals(2, maxConcurrentTasks.get());
assertEquals(0, concurrentTasks.get());
}
/**
* Tests proper shutdown behavior under load. This verifies that after shutdown no new tasks are
* accepted, all previously submitted tasks are completed, and the executor terminates properly
* after all tasks complete.
*/
@Test
void testProperShutdownUnderLoad() throws InterruptedException {
FrontDeskService frontDesk = new FrontDeskService(2);
int taskCount = 5;
CountDownLatch startedTasksLatch = new CountDownLatch(2);
CountDownLatch tasksCompletionLatch = new CountDownLatch(taskCount);
for (int i = 0; i < taskCount; i++) {
frontDesk.submitGuestCheckIn(
() -> {
try {
startedTasksLatch.countDown();
Thread.sleep(100);
tasksCompletionLatch.countDown();
} catch (InterruptedException e) {
Thread.currentThread().interrupt();
}
});
}
assertTrue(startedTasksLatch.await(1, TimeUnit.SECONDS));
frontDesk.shutdown();
assertThrows(
RejectedExecutionException.class,
() -> {
frontDesk.submitGuestCheckIn(() -> {});
});
boolean allTasksCompleted = tasksCompletionLatch.await(2, TimeUnit.SECONDS);
boolean terminated = frontDesk.awaitTermination(1, TimeUnit.SECONDS);
assertTrue(allTasksCompleted);
assertTrue(terminated);
}
/**
* Tests concurrent execution of different task types (regular and VIP). This verifies that both
* Runnable and Callable tasks can be processed concurrently, all tasks complete successfully, and
* Callable tasks return their results correctly.
*/
@Test
void testConcurrentRegularAndVipTasks() throws Exception {
FrontDeskService frontDesk = new FrontDeskService(3);
int regularTaskCount = 4;
int vipTaskCount = 3;
CountDownLatch allTasksLatch = new CountDownLatch(regularTaskCount + vipTaskCount);
List<Future<?>> regularResults = new ArrayList<>();
for (int i = 0; i < regularTaskCount; i++) {
Future<?> result =
frontDesk.submitGuestCheckIn(
() -> {
try {
Thread.sleep(50);
allTasksLatch.countDown();
} catch (InterruptedException e) {
Thread.currentThread().interrupt();
}
});
regularResults.add(result);
}
List<Future<String>> vipResults = new ArrayList<>();
for (int i = 0; i < vipTaskCount; i++) {
final int guestNum = i;
Future<String> result =
frontDesk.submitVipGuestCheckIn(
() -> {
Thread.sleep(25);
allTasksLatch.countDown();
return "VIP-" + guestNum + " checked in";
});
vipResults.add(result);
}
boolean allCompleted = allTasksLatch.await(2, TimeUnit.SECONDS);
frontDesk.shutdown();
frontDesk.awaitTermination(1, TimeUnit.SECONDS);
assertTrue(allCompleted);
for (Future<?> result : regularResults) {
assertTrue(result.isDone());
}
for (int i = 0; i < vipTaskCount; i++) {
Future<String> result = vipResults.get(i);
assertTrue(result.isDone());
assertEquals("VIP-" + i + " checked in", result.get());
}
}
}
@@ -0,0 +1,55 @@
/*
* This project is licensed under the MIT license. Module model-view-viewmodel is using ZK framework licensed under LGPL (see lgpl-3.0.txt).
*
* The MIT License
* Copyright © 2014-2022 Ilkka Seppälä
*
* Permission is hereby granted, free of charge, to any person obtaining a copy
* of this software and associated documentation files (the "Software"), to deal
* in the Software without restriction, including without limitation the rights
* to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
* copies of the Software, and to permit persons to whom the Software is
* furnished to do so, subject to the following conditions:
*
* The above copyright notice and this permission notice shall be included in
* all copies or substantial portions of the Software.
*
* THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
* IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
* FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
* AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
* LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
* OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
* THE SOFTWARE.
*/
package com.iluwatar.threadpoolexecutor;
import static org.junit.jupiter.api.Assertions.assertEquals;
import java.util.concurrent.atomic.AtomicReference;
import org.junit.jupiter.api.Test;
class GuestCheckInTaskTest {
/**
* Tests that the task executes in the current thread when called directly. This verifies that the
* thread name inside the task matches the calling thread.
*/
@Test
void testThreadNameInTask() {
String guestName = "TestGuest";
AtomicReference<String> capturedThreadName = new AtomicReference<>();
GuestCheckInTask task =
new GuestCheckInTask(guestName) {
@Override
public void run() {
capturedThreadName.set(Thread.currentThread().getName());
}
};
task.run();
assertEquals(Thread.currentThread().getName(), capturedThreadName.get());
}
}
@@ -0,0 +1,48 @@
/*
* This project is licensed under the MIT license. Module model-view-viewmodel is using ZK framework licensed under LGPL (see lgpl-3.0.txt).
*
* The MIT License
* Copyright © 2014-2022 Ilkka Seppälä
*
* Permission is hereby granted, free of charge, to any person obtaining a copy
* of this software and associated documentation files (the "Software"), to deal
* in the Software without restriction, including without limitation the rights
* to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
* copies of the Software, and to permit persons to whom the Software is
* furnished to do so, subject to the following conditions:
*
* The above copyright notice and this permission notice shall be included in
* all copies or substantial portions of the Software.
*
* THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
* IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
* FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
* AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
* LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
* OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
* THE SOFTWARE.
*/
package com.iluwatar.threadpoolexecutor;
import static org.junit.jupiter.api.Assertions.assertEquals;
import static org.junit.jupiter.api.Assertions.assertNotNull;
import org.junit.jupiter.api.Test;
class VipGuestCheckInTaskTest {
/**
* Tests that the call method returns the expected result string. This verifies that the VIP
* check-in task correctly formats its result message.
*/
@Test
void testCallReturnsExpectedResult() throws Exception {
String vipGuestName = "TestVipGuest";
VipGuestCheckInTask task = new VipGuestCheckInTask(vipGuestName);
String result = task.call();
assertNotNull(result);
assertEquals("TestVipGuest has been successfully checked in!", result);
}
}