io.temporal.worker

Class WorkerFactory

java.lang.Object

io.temporal.worker.WorkerFactory

public final class WorkerFactory
extends java.lang.Object

Maintains worker creation and lifecycle.

Method Summary

Modifier and Type	Method and Description
void	awaitTermination(long timeout, java.util.concurrent.TimeUnit unit) Blocks until all tasks have completed execution after a shutdown request, or the timeout occurs, or the current thread is interrupted, whichever happens first.
WorkflowClient	getWorkflowClient()
boolean	isShutdown() Was shutdown() or shutdownNow() called.
boolean	isStarted() Was start() called.
boolean	isTerminated() Returns true if all tasks have completed following shut down.
static WorkerFactory	newInstance(WorkflowClient workflowClient)
static WorkerFactory	newInstance(WorkflowClient workflowClient, WorkerFactoryOptions options)
Worker	newWorker(java.lang.String taskQueue) Creates worker that connects to an instance of the Temporal Service.
Worker	newWorker(java.lang.String taskQueue, WorkerOptions options) Creates worker that connects to an instance of the Temporal Service.
void	resumePolling()
void	shutdown() Initiates an orderly shutdown in which polls are stopped and already received workflow and activity tasks are executed.
void	shutdownNow() Initiates an orderly shutdown in which polls are stopped and already received workflow and activity tasks are attempted to be stopped.
void	start() Starts all the workers created by this factory.
void	suspendPolling()

Methods inherited from class java.lang.Object

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

Method Detail

newInstance

public static WorkerFactory newInstance(WorkflowClient workflowClient)

newInstance

public static WorkerFactory newInstance(WorkflowClient workflowClient,
                                        WorkerFactoryOptions options)

newWorker

public Worker newWorker(java.lang.String taskQueue)

Creates worker that connects to an instance of the Temporal Service. It uses the namespace configured at the Factory level. New workers cannot be created after the start() has been called

Parameters:

taskQueue - task queue name worker uses to poll. It uses this name for both workflow and activity task queue polls.

Returns:

Worker

newWorker

public Worker newWorker(java.lang.String taskQueue,
                        WorkerOptions options)

Creates worker that connects to an instance of the Temporal Service. It uses the namespace configured at the Factory level. New workers cannot be created after the start() has been called

Parameters:

taskQueue - task queue name worker uses to poll. It uses this name for both workflow and activity task queue polls.

options - Options (like DataConverter override) for configuring worker.

Returns:

Worker

start

public void start()

Starts all the workers created by this factory.

isStarted

public boolean isStarted()

Was start() called.

isShutdown

public boolean isShutdown()

Was shutdown() or shutdownNow() called.

isTerminated

public boolean isTerminated()

Returns true if all tasks have completed following shut down. Note that isTerminated is never true unless either shutdown or shutdownNow was called first.

getWorkflowClient

public WorkflowClient getWorkflowClient()

Returns:

instance of the Temporal client that this worker uses.

shutdown

public void shutdown()

Initiates an orderly shutdown in which polls are stopped and already received workflow and activity tasks are executed. After the shutdown calls to ActivityExecutionContext.heartbeat(Object) start throwing ActivityWorkerShutdownException. Invocation has no additional effect if already shut down. This method does not wait for previously received tasks to complete execution. Use awaitTermination(long, TimeUnit) to do that.

shutdownNow

public void shutdownNow()

Initiates an orderly shutdown in which polls are stopped and already received workflow and activity tasks are attempted to be stopped. This implementation cancels tasks via Thread.interrupt(), so any task that fails to respond to interrupts may never terminate. Also after the shutdownNow calls to ActivityExecutionContext.heartbeat(Object) start throwing ActivityWorkerShutdownException. Invocation has no additional effect if already shut down. This method does not wait for previously received tasks to complete execution. Use awaitTermination(long, TimeUnit) to do that.

awaitTermination

public void awaitTermination(long timeout,
                             java.util.concurrent.TimeUnit unit)

Blocks until all tasks have completed execution after a shutdown request, or the timeout occurs, or the current thread is interrupted, whichever happens first.

suspendPolling

public void suspendPolling()

resumePolling

public void resumePolling()