Skip to main content

Build a Java Task Worker

This guide provides introduction to building Task Workers in Java.


Conductor provides java client libraries, which we will use to build a simple task worker.

Maven Dependency



implementation group: '', name: 'conductor-client', version: '3.3.4'

Implementing a Task a Worker

To create a worker, implement the Worker interface.

public class SampleWorker implements Worker {

private final String taskDefName;

public SampleWorker(String taskDefName) {
this.taskDefName = taskDefName;

public String getTaskDefName() {
return taskDefName;

public TaskResult execute(Task task) {
TaskResult result = new TaskResult(task);

//Register the output of the task
result.getOutputData().put("outputKey1", "value");
result.getOutputData().put("oddEven", 1);
result.getOutputData().put("mod", 4);

return result;

Implementing worker's logic

Worker's core implementation logic goes in the execute method. Upon completion, set the TaskResult with status as one of the following:

  1. COMPLETED: If the task has completed successfully.
  2. FAILED: If there are failures - business or system failures. Based on the task's configuration, when a task fails, it maybe retried.

getTaskDefName() method returns the name of the task for which this worker provides the execution logic.

See for the complete example.

Configuring polling using TaskRunnerConfigurer

The TaskRunnerConfigurer can be used to register the worker(s) and initialize the polling loop. Manages the task workers thread pool and server communication (poll and task update).

Use the Builder to create an instance of the TaskRunnerConfigurer. The builder accepts the following parameters:

 TaskClient taskClient = new TaskClient();
taskClient.setRootURI("http://localhost:8080/api/"); //Point this to the server API

int threadCount = 2; //number of threads used to execute workers. To avoid starvation, should be same or more than number of workers

Worker worker1 = new SampleWorker("task_1");
Worker worker2 = new SampleWorker("task_5");

// Create TaskRunnerConfigurer
TaskRunnerConfigurer configurer = new TaskRunnerConfigurer.Builder(taskClient, Arrays.asList(worker1, worker2))

// Start the polling and execution of tasks

See Sample for full example.

Configuration Details

Initialize the Builder with the following: TaskClient | TaskClient used to communicate to the Conductor server | | Workers | Workers that will be used for polling work and task execution. |

withEurekaClientEurekaClient is used to identify if the server is in discovery or not. When the server goes out of discovery, the polling is stopped unless pollOutOfDiscovery is set to true. If passed null, discovery check is not done.provided by platform
withThreadCountNumber of threads assigned to the workers. Should be at-least the size of taskWorkers to avoid starvation in a busy system.Number of registered workers
withSleepWhenRetryTime in milliseconds, for which the thread should sleep when task update call fails, before retrying the operation.500
withUpdateRetryCountNumber of attempts to be made when updating task status when update status call fails.3
withWorkerNamePrefixString prefix that will be used for all the workers.workflow-worker-

Once an instance is created, call init() method to initialize the TaskPollExecutor and begin the polling and execution of tasks.

!!! tip "Note" To ensure that the TaskRunnerConfigurer stops polling for tasks when the instance becomes unhealthy, call the provided shutdown() hook in a PreDestroy block.

Properties The worker behavior can be further controlled by using these properties:

pausedbooleanIf set to true, the worker stops polling.false
pollIntervalintInterval in milliseconds at which the server should be polled for tasks.1000
pollOutOfDiscoverybooleanIf set to true, the instance will poll for tasks regardless of the discovery
status. This is useful while running on a dev machine.

Further, these properties can be set either by Worker implementation or by setting the following system properties in the JVM:

conductor.worker.<property>Applies to ALL the workers in the JVM.
conductor.worker.<taskDefName>.<property>Applies to the specified worker. Overrides the global property.