io.zeebe.client.impl.job

Class ActivateJobsCommandImpl

java.lang.Object

io.zeebe.client.impl.job.ActivateJobsCommandImpl

All Implemented Interfaces:

ActivateJobsCommandStep1, ActivateJobsCommandStep1.ActivateJobsCommandStep2, ActivateJobsCommandStep1.ActivateJobsCommandStep3, FinalCommandStep<ActivateJobsResponse>

public class ActivateJobsCommandImpl
extends Object
implements ActivateJobsCommandStep1, ActivateJobsCommandStep1.ActivateJobsCommandStep2, ActivateJobsCommandStep1.ActivateJobsCommandStep3

Nested Class Summary

Nested classes/interfaces inherited from interface io.zeebe.client.api.commands.ActivateJobsCommandStep1

ActivateJobsCommandStep1.ActivateJobsCommandStep2, ActivateJobsCommandStep1.ActivateJobsCommandStep3

Constructor Summary

Constructors

Constructor and Description
ActivateJobsCommandImpl(GatewayGrpc.GatewayStub asyncStub, ZeebeClientConfiguration config, ZeebeObjectMapper objectMapper)

Method Summary

Modifier and Type	Method and Description
ActivateJobsCommandStep1.ActivateJobsCommandStep3	amount(int amount) Set the maximal amount of jobs to activate.
ActivateJobsCommandStep1.ActivateJobsCommandStep2	jobType(String jobType) Set the type of jobs to work on.
ZeebeFuture<ActivateJobsResponse>	send() Sends the command to the Zeebe broker.
ActivateJobsCommandStep1.ActivateJobsCommandStep3	timeout(java.time.Duration timeout) Set the time for how long a job is exclusively assigned for this subscription.
ActivateJobsCommandStep1.ActivateJobsCommandStep3	timeout(long timeout) Set the time for how long a job is exclusively assigned for this subscription.
ActivateJobsCommandStep1.ActivateJobsCommandStep3	workerName(String workerName) Set the name of the job worker.

Methods inherited from class java.lang.Object

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

Constructor Detail

ActivateJobsCommandImpl

public ActivateJobsCommandImpl(GatewayGrpc.GatewayStub asyncStub,
                               ZeebeClientConfiguration config,
                               ZeebeObjectMapper objectMapper)

Method Detail

jobType

public ActivateJobsCommandStep1.ActivateJobsCommandStep2 jobType(String jobType)

Description copied from interface: ActivateJobsCommandStep1

Set the type of jobs to work on.

Specified by:

jobType in interface ActivateJobsCommandStep1

Parameters:

jobType - the type of jobs (e.g. "payment")

Returns:

the builder for this command

amount

public ActivateJobsCommandStep1.ActivateJobsCommandStep3 amount(int amount)

Description copied from interface: ActivateJobsCommandStep1.ActivateJobsCommandStep2

Set the maximal amount of jobs to activate. If less jobs are avaiable for activation the command will return a list with fewer jobs.

Specified by:

amount in interface ActivateJobsCommandStep1.ActivateJobsCommandStep2

Parameters:

amount - the maximal number of jobs to activate

Returns:

the builder for this command

timeout

public ActivateJobsCommandStep1.ActivateJobsCommandStep3 timeout(long timeout)

Description copied from interface: ActivateJobsCommandStep1.ActivateJobsCommandStep3

Set the time for how long a job is exclusively assigned for this subscription.

In this time, the job can not be assigned by other subscriptions to ensure that only one subscription work on the job. When the time is over then the job can be assigned again by this or other subscription if it's not completed yet.

If no timeout is set, then the default is used from the configuration.

Specified by:

timeout in interface ActivateJobsCommandStep1.ActivateJobsCommandStep3

Parameters:

timeout - the time in milliseconds

Returns:

the builder for this command. Call FinalCommandStep.send() to complete the command and send it to the broker.

timeout

public ActivateJobsCommandStep1.ActivateJobsCommandStep3 timeout(java.time.Duration timeout)

Description copied from interface: ActivateJobsCommandStep1.ActivateJobsCommandStep3

Set the time for how long a job is exclusively assigned for this subscription.

In this time, the job can not be assigned by other subscriptions to ensure that only one subscription work on the job. When the time is over then the job can be assigned again by this or other subscription if it's not completed yet.

If no time is set then the default is used from the configuration.

Specified by:

timeout in interface ActivateJobsCommandStep1.ActivateJobsCommandStep3

Parameters:

timeout - the time as duration (e.g. "Duration.ofMinutes(5)")

Returns:

the builder for this command. Call FinalCommandStep.send() to complete the command and send it to the broker.

workerName

public ActivateJobsCommandStep1.ActivateJobsCommandStep3 workerName(String workerName)

Description copied from interface: ActivateJobsCommandStep1.ActivateJobsCommandStep3

Set the name of the job worker.

This name is used to identify the worker which activated the jobs. Its main purpose is for monitoring and auditing. Commands on activated jobs do not check the worker name, i.e. complete or fail job.

If no name is set then the default is used from the configuration.

Specified by:

workerName in interface ActivateJobsCommandStep1.ActivateJobsCommandStep3

Parameters:

workerName - the name of the worker (e.g. "payment-service")

Returns:

the builder for this command. Call FinalCommandStep.send() to complete the command and send it to the broker.

send

public ZeebeFuture<ActivateJobsResponse> send()

Description copied from interface: FinalCommandStep

Sends the command to the Zeebe broker. This operation is asynchronous. In case of success, the future returns the event that was generated by the Zeebe broker in response to the command.

Call ZeebeFuture.join() to wait until the response is available.

 Future<JobEvent> future = command.send();
 JobEvent event = future.join();
 

Specified by:

send in interface FinalCommandStep<ActivateJobsResponse>

Returns:

a future tracking state of success/failure of the command.