com.uber.cadence.worker

Class Worker.Factory

java.lang.Object

com.uber.cadence.worker.Worker.Factory

Enclosing class:

Worker

public static final class Worker.Factory
extends java.lang.Object

Maintains worker creation and lifecycle.

Constructor Summary

Constructors

Constructor and Description
Factory(IWorkflowService workflowService, java.lang.String domain) Creates a factory.
Factory(IWorkflowService workflowService, java.lang.String domain, Worker.FactoryOptions factoryOptions) Creates a factory.
Factory(java.lang.String domain) Creates a factory.
Factory(java.lang.String host, int port, java.lang.String domain) Creates a factory.
Factory(java.lang.String host, int port, java.lang.String domain, Worker.FactoryOptions factoryOptions) Creates a factory.
Factory(java.lang.String domain, Worker.FactoryOptions factoryOptions) Creates a factory connected to a local deployment of cadence-server.

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.
IWorkflowService	getWorkflowService()
boolean	isShutdown() Was shutdown() or shutdownNow() called.
boolean	isStarted() Was start() called.
boolean	isTerminated() Returns true if all tasks have completed following shut down.
Worker	newWorker(java.lang.String taskList) Creates worker that connects to an instance of the Cadence Service.
Worker	newWorker(java.lang.String taskList, WorkerOptions options) Creates worker that connects to an instance of the Cadence Service.
void	resumePolling()
void	shutdown() Initiates an orderly shutdown in which polls are stopped and already received decision and activity tasks are executed.
void	shutdownNow() Initiates an orderly shutdown in which polls are stopped and already received decision 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

Constructor Detail

Factory

public Factory(java.lang.String domain)

Creates a factory. Workers will be connected to a local deployment of cadence-server

Parameters:

domain - Domain used by workers to poll for workflows.

Factory

public Factory(java.lang.String host,
               int port,
               java.lang.String domain)

Creates a factory. Workers will be connected to the cadence-server at the specific host and port.

Parameters:

host - host used by the underlying workflowServiceClient to connect to.

port - port used by the underlying workflowServiceClient to connect to.

domain - Domain used by workers to poll for workflows.

Factory

public Factory(java.lang.String domain,
               Worker.FactoryOptions factoryOptions)

Creates a factory connected to a local deployment of cadence-server.

Parameters:

domain - Domain used by workers to poll for workflows.

factoryOptions - Options used to configure factory settings

Factory

public Factory(java.lang.String host,
               int port,
               java.lang.String domain,
               Worker.FactoryOptions factoryOptions)

Creates a factory. Workers will be connected to the cadence-server at the specific host and port.

Parameters:

host - host used by the underlying workflowServiceClient to connect to.

port - port used by the underlying workflowServiceClient to connect to.

domain - Domain used by workers to poll for workflows.

factoryOptions - Options used to configure factory settings

Factory

public Factory(IWorkflowService workflowService,
               java.lang.String domain)

Creates a factory. Workers will be connect to the cadence-server using the workflowService client passed in.

Parameters:

workflowService - client to the Cadence Service endpoint.

domain - Domain used by workers to poll for workflows.

Factory

public Factory(IWorkflowService workflowService,
               java.lang.String domain,
               Worker.FactoryOptions factoryOptions)

Creates a factory. Workers will be connect to the cadence-server using the workflowService client passed in.

Parameters:

workflowService - client to the Cadence Service endpoint.

domain - Domain used by workers to poll for workflows.

factoryOptions - Options used to configure factory settings

Method Detail

newWorker

public Worker newWorker(java.lang.String taskList)

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

Parameters:

taskList - task list name worker uses to poll. It uses this name for both decision and activity task list polls.

Returns:

Worker

newWorker

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

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

Parameters:

taskList - task list name worker uses to poll. It uses this name for both decision and activity task list 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.

getWorkflowService

public IWorkflowService getWorkflowService()

Returns:

instance of the cadence client that this worker uses.

shutdown

public void shutdown()

Initiates an orderly shutdown in which polls are stopped and already received decision and activity tasks are executed. After the shutdown calls to Activity.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 decision 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 Activity.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()