Java Executors callable() Method

🎓 Top 15 Udemy Courses (80-90% Discount): My Udemy Courses - Ramesh Fadatare — All my Udemy courses are real-time and project oriented courses.

▶️ Subscribe to My YouTube Channel (178K+ subscribers): Java Guides on YouTube

▶️ For AI, ChatGPT, Web, Tech, and Generative AI, subscribe to another channel: Ramesh Fadatare on YouTube

The Executors class in Java provides factory methods to create Callable objects. These methods are useful for wrapping tasks that implement the Runnable interface or for tasks that return a result. This guide will cover the usage of Executors.callable() methods, explain how they work, and provide concise examples to demonstrate their functionality in real-world use cases.

Introduction

The Executors.callable() methods are used to create Callable objects from various types of tasks, including Runnable tasks and tasks that return a specific result. These methods provide flexibility in converting tasks to Callable instances, which can be used with an ExecutorService for concurrent execution.

Overloaded Methods

1. callable(Runnable task)

This method wraps a Runnable task into a Callable that returns null upon completion.

Syntax

public static Callable<Object> callable(Runnable task)

2. callable(Runnable task, T result)

This method wraps a Runnable task into a Callable that returns a specified result upon completion.

Syntax

public static <T> Callable<T> callable(Runnable task, T result)

3. callable(PrivilegedAction<T> action)

This method wraps a PrivilegedAction task into a Callable that returns the result of the action.

Syntax

public static <T> Callable<T> callable(PrivilegedAction<T> action)

4. callable(PrivilegedExceptionAction<T> action)

This method wraps a PrivilegedExceptionAction task into a Callable that returns the result of the action and can throw checked exceptions.

Syntax

public static <T> Callable<T> callable(PrivilegedExceptionAction<T> action)

Examples

Example 1: Wrapping a Runnable Task

In this example, we wrap a Runnable task into a Callable that returns null upon completion.

import java.util.concurrent.Callable;
import java.util.concurrent.ExecutionException;
import java.util.concurrent.ExecutorService;
import java.util.concurrent.Executors;
import java.util.concurrent.Future;

public class CallableExample {
    public static void main(String[] args) {
        ExecutorService executor = Executors.newFixedThreadPool(1);

        Runnable task = () -> System.out.println("Executing runnable task");

        Callable<Object> callableTask = Executors.callable(task);

        Future<Object> future = executor.submit(callableTask);

        try {
            future.get();
            System.out.println("Task completed successfully");
        } catch (InterruptedException | ExecutionException e) {
            e.printStackTrace();
        } finally {
            executor.shutdown();
        }
    }
}

Output:

Executing runnable task
Task completed successfully

Example 2: Wrapping a Runnable Task with a Result

In this example, we wrap a Runnable task into a Callable that returns a specified result upon completion.

import java.util.concurrent.Callable;
import java.util.concurrent.ExecutionException;
import java.util.concurrent.ExecutorService;
import java.util.concurrent.Executors;
import java.util.concurrent.Future;

public class CallableWithResultExample {
    public static void main(String[] args) {
        ExecutorService executor = Executors.newFixedThreadPool(1);

        Runnable task = () -> System.out.println("Executing runnable task with result");

        Callable<String> callableTask = Executors.callable(task, "Task result");

        Future<String> future = executor.submit(callableTask);

        try {
            String result = future.get();
            System.out.println("Result: " + result);
        } catch (InterruptedException | ExecutionException e) {
            e.printStackTrace();
        } finally {
            executor.shutdown();
        }
    }
}

Output:

Executing runnable task with result
Result: Task result

Example 3: Wrapping a PrivilegedAction Task

In this example, we wrap a PrivilegedAction task into a Callable that returns the result of the action.

import java.security.PrivilegedAction;
import java.util.concurrent.Callable;
import java.util.concurrent.ExecutionException;
import java.util.concurrent.ExecutorService;
import java.util.concurrent.Executors;
import java.util.concurrent.Future;

public class PrivilegedActionExample {
    public static void main(String[] args) {
        ExecutorService executor = Executors.newFixedThreadPool(1);

        PrivilegedAction<String> action = () -> "Privileged action result";

        Callable<String> callableTask = Executors.callable(action);

        Future<String> future = executor.submit(callableTask);

        try {
            String result = future.get();
            System.out.println("Result: " + result);
        } catch (InterruptedException | ExecutionException e) {
            e.printStackTrace();
        } finally {
            executor.shutdown();
        }
    }
}

Output:

Result: Privileged action result

Example 4: Wrapping a PrivilegedExceptionAction Task

In this example, we wrap a PrivilegedExceptionAction task into a Callable that returns the result of the action and can throw checked exceptions.

import java.security.PrivilegedExceptionAction;
import java.util.concurrent.Callable;
import java.util.concurrent.ExecutionException;
import java.util.concurrent.ExecutorService;
import java.util.concurrent.Executors;
import java.util.concurrent.Future;

public class PrivilegedExceptionActionExample {
    public static void main(String[] args) {
        ExecutorService executor = Executors.newFixedThreadPool(1);

        PrivilegedExceptionAction<String> action = () -> "Privileged exception action result";

        Callable<String> callableTask = Executors.callable(action);

        Future<String> future = executor.submit(callableTask);

        try {
            String result = future.get();
            System.out.println("Result: " + result);
        } catch (InterruptedException | ExecutionException e) {
            e.printStackTrace();
        } finally {
            executor.shutdown();
        }
    }
}

Output:

Result: Privileged exception action result

Conclusion

The Executors.callable() methods in Java are useful for wrapping different types of tasks into Callable objects. These methods provide flexibility in converting Runnable, PrivilegedAction, and PrivilegedExceptionAction tasks into Callable instances, making them suitable for concurrent execution with an ExecutorService.

My Top and Bestseller Udemy Courses. The sale is going on with a 70 - 80% discount. The discount coupon has been added to each course below:

Build REST APIs with Spring Boot 4, Spring Security 7, and JWT

🆕 High-Demand 80–90% OFF

[NEW] Learn Apache Maven with IntelliJ IDEA and Java 25

🆕 High-Demand 80–90% OFF

ChatGPT + Generative AI + Prompt Engineering for Beginners

🚀 Trending Now 80–90% OFF

Spring 7 and Spring Boot 4 for Beginners (Includes 8 Projects)

🔥 Bestseller 80–90% OFF
Available in Udemy for Business

Building Real-Time REST APIs with Spring Boot - Blog App

🔥 Bestseller 80–90% OFF
Available in Udemy for Business

Building Microservices with Spring Boot and Spring Cloud

🌟 Top Rated 80–90% OFF
Available in Udemy for Business

Java Full-Stack Developer Course with Spring Boot and React JS

🔥 Bestseller 80–90% OFF
Available in Udemy for Business

Build 5 Spring Boot Projects with Java: Line-by-Line Coding

🌟 Top Rated 80–90% OFF

Testing Spring Boot Application with JUnit and Mockito

🔥 Bestseller 80–90% OFF
Available in Udemy for Business

Spring Boot Thymeleaf Real-Time Web Application - Blog App

🔥 Bestseller 80–90% OFF
Available in Udemy for Business

Master Spring Data JPA with Hibernate

🔥 Bestseller 80–90% OFF
Available in Udemy for Business

Spring Boot + Apache Kafka Course - The Practical Guide

🎓 Student Favorite 80–90% OFF
Available in Udemy for Business

Java Testing: Mastering JUnit 5 Framework

🆕 New 80–90% OFF

Reactive Programming in Java: Spring WebFlux and Testing

🌟 Top Rated 80–90% OFF

Spring Boot + RabbitMQ Course - The Practical Guide

🌟 Top Rated 80–90% OFF
Available in Udemy for Business

Functional Programming in Java (Includes Java Collections)

🎓 Student Favorite 80–90% OFF

ChatGPT for Java Developers: Boost Your Productivity with AI

🚀 Trending Now 80–90% OFF