Package dev.restate.sdk

Class HandlerRunner.Options

java.lang.Object

dev.restate.sdk.HandlerRunner.Options

All Implemented Interfaces:

HandlerRunner.Options

Enclosing class:

HandlerRunner<REQ,RES>

public static final class HandlerRunner.Options
extends Object
implements HandlerRunner.Options

HandlerRunner options. You can override the default options to configure the executor where to run the handlers.

You can run on virtual threads by using the executor Executors.newVirtualThreadPerTaskExecutor().

Field Summary

Fields

Modifier and Type	Field	Description
static final HandlerRunner.Options	DEFAULT	Default options will use virtual threads on Java 21+, or fallback to Executors.newCachedThreadPool() for Java < 21.

Method Summary

Modifier and Type	Method	Description
static HandlerRunner.Options	withExecutor(Executor executor)	Create an instance of HandlerRunner.Options with the given executor.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Field Details

DEFAULT

public static final HandlerRunner.Options DEFAULT

Default options will use virtual threads on Java 21+, or fallback to Executors.newCachedThreadPool() for Java < 21. The bounded pool is shared among all HandlerRunner instances, and is used by Restate.run(java.lang.String, java.lang.Class<T>, dev.restate.common.function.ThrowingSupplier<T>)/Context.run(java.lang.String, java.lang.Class<T>, dev.restate.common.function.ThrowingSupplier<T>) as well.

Method Details

withExecutor

public static HandlerRunner.Options withExecutor(Executor executor)

Create an instance of HandlerRunner.Options with the given executor.

The given executor is used for running the handler code, and Restate.run(java.lang.String, java.lang.Class<T>, dev.restate.common.function.ThrowingSupplier<T>)/Context.run(java.lang.String, java.lang.Class<T>, dev.restate.common.function.ThrowingSupplier<T>) as well.