Java 8 has reached end of support and will be deprecated on January 31, 2026. After deprecation, you won't be able to deploy Java 8 applications, even if your organization previously used an organization policy to re-enable deployments of legacy runtimes. Your existing Java 8 applications will continue to run and receive traffic after their deprecation date . We recommend that you migrate to the latest supported version of Java .

ThreadManager (Google App Engine API for Java)

java.lang.Object
- com.google.appengine.api.ThreadManager

```
public final class ThreadManager 
extends java.lang.Object
```
ThreadManager exposes a ThreadFactory that allows App Engine applications to spawn new threads. Refer to this discussion of threads for drawbacks of thread usage and possible alternatives.

Constructor Summary

Constructor and Description

Constructors

ThreadManager ()

Method Summary

All Methods Static Methods Concrete Methods
Modifier and Type	Method and Description
`static java.util.concurrent.ThreadFactory`	`backgroundThreadFactory ()` Returns a `ThreadFactory` that will create threads that are independent of the current request.
`static java.lang.Thread`	`createBackgroundThread (java.lang.Runnable runnable)` Create a new `Thread` that executes `runnable` independent of the current request.
`static java.lang.Thread`	`createThreadForCurrentRequest (java.lang.Runnable runnable)` Create a new `Thread` that executes `runnable` for the duration of the current request.
`static java.util.concurrent.ThreadFactory`	`currentRequestThreadFactory ()` Returns a `ThreadFactory` that will create threads scoped to the current request.

Methods inherited from class java.lang.Object
equals, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

- Constructor Detail
  - ThreadManager
```
public ThreadManager()
```
- Method Detail
  - currentRequestThreadFactory
```
public static java.util.concurrent.ThreadFactory currentRequestThreadFactory()
```
    Returns a ThreadFactory that will create threads scoped to the current request. These threads will be interrupted at the end of the current request and must complete within the request deadline.
    Your code has limited access to the threads created by this ThreadFactory . For example, you can call Thread.setUncaughtExceptionHandler(java.lang.Thread.UncaughtExceptionHandler) and Thread.interrupt() , but not Thread.stop() or any other methods that require RuntimePermission("modifyThread") .
    
    The Java runtime will throw java.lang.IllegalStateException if you try to create more than 50 threads in a single request.
    
    Note that calling ThreadFactory.newThread(java.lang.Runnable) on the returned instance may throw any of the unchecked exceptions mentioned by createBackgroundThread(java.lang.Runnable) .
    
    Throws:
    
    java.lang.NullPointerException - if the calling thread is not associated with a request.
  - createThreadForCurrentRequest
```
public static java.lang.Thread createThreadForCurrentRequest(java.lang.Runnable runnable)
```
    Create a new Thread that executes runnable for the duration of the current request. Calling this method is equivalent to invoking ThreadFactory.newThread(java.lang.Runnable) on the ThreadFactory returned from currentRequestThreadFactory() . This thread will be interrupted at the end of the current request and must complete within the request deadline.
    
    Throws:
    
    java.lang.IllegalStateException - if you try to create more than 50 threads in a single request.
    
    java.lang.NullPointerException - if the calling thread is not associated with a request.
    
    ApiProxy.FeatureNotEnabledException - If this application cannot use this feature.
  - backgroundThreadFactory
```
public static java.util.concurrent.ThreadFactory backgroundThreadFactory()
```
    Returns a ThreadFactory that will create threads that are independent of the current request.
    This ThreadFactory can currently only be used by backends.
    
    Note that calling ThreadFactory.newThread(java.lang.Runnable) on the returned instance may throw any of the unchecked exceptions mentioned by createBackgroundThread(java.lang.Runnable) .
  - createBackgroundThread
```
public static java.lang.Thread createBackgroundThread(java.lang.Runnable runnable)
```
    Create a new Thread that executes runnable independent of the current request. Calling this method is equivalent to invoking ThreadFactory.newThread(java.lang.Runnable) on the ThreadFactory returned from backgroundThreadFactory() .
    This method can currently only be used by backends.
    
    Throws:
    
    ApiProxy.FeatureNotEnabledException - If this application cannot use this feature.
    
    ApiProxy.CancelledException - If the request was interrupted while creating the new thread.
    
    ApiProxy.ApiDeadlineExceededException - If creation of the new thread took too long.

Except as otherwise noted, the content of this page is licensed under the Creative Commons Attribution 4.0 License , and code samples are licensed under the Apache 2.0 License . For details, see the Google Developers Site Policies . Java is a registered trademark of Oracle and/or its affiliates.

Last updated 2025-06-16 UTC.

ThreadManager (Google App Engine API for Java) Stay organized with collections Save and categorize content based on your preferences.

Class ThreadManager

Constructor Summary

Method Summary

Methods inherited from class java.lang.Object

Constructor Detail

ThreadManager

Method Detail

currentRequestThreadFactory

createThreadForCurrentRequest

backgroundThreadFactory

createBackgroundThread

ThreadManager (Google App Engine API for Java)