Package io.camunda.zeebe.client.impl

Class ZeebeClientCloudBuilderImpl

java.lang.Object

io.camunda.zeebe.client.impl.ZeebeClientCloudBuilderImpl

All Implemented Interfaces:

ZeebeClientBuilder, ZeebeClientCloudBuilderStep1, ZeebeClientCloudBuilderStep1.ZeebeClientCloudBuilderStep2, ZeebeClientCloudBuilderStep1.ZeebeClientCloudBuilderStep2.ZeebeClientCloudBuilderStep3, ZeebeClientCloudBuilderStep1.ZeebeClientCloudBuilderStep2.ZeebeClientCloudBuilderStep3.ZeebeClientCloudBuilderStep4

public class ZeebeClientCloudBuilderImpl
extends Object
implements ZeebeClientCloudBuilderStep1, ZeebeClientCloudBuilderStep1.ZeebeClientCloudBuilderStep2, ZeebeClientCloudBuilderStep1.ZeebeClientCloudBuilderStep2.ZeebeClientCloudBuilderStep3, ZeebeClientCloudBuilderStep1.ZeebeClientCloudBuilderStep2.ZeebeClientCloudBuilderStep3.ZeebeClientCloudBuilderStep4

Nested Class Summary

Nested classes/interfaces inherited from interface io.camunda.zeebe.client.ZeebeClientCloudBuilderStep1

ZeebeClientCloudBuilderStep1.ZeebeClientCloudBuilderStep2

Nested classes/interfaces inherited from interface io.camunda.zeebe.client.ZeebeClientCloudBuilderStep1.ZeebeClientCloudBuilderStep2

ZeebeClientCloudBuilderStep1.ZeebeClientCloudBuilderStep2.ZeebeClientCloudBuilderStep3

Nested classes/interfaces inherited from interface io.camunda.zeebe.client.ZeebeClientCloudBuilderStep1.ZeebeClientCloudBuilderStep2.ZeebeClientCloudBuilderStep3

ZeebeClientCloudBuilderStep1.ZeebeClientCloudBuilderStep2.ZeebeClientCloudBuilderStep3.ZeebeClientCloudBuilderStep4

Constructor Summary

Constructors

Constructor	Description
ZeebeClientCloudBuilderImpl()

Method Summary

Modifier and Type	Method	Description
ZeebeClientBuilder	applyEnvironmentVariableOverrides(boolean applyEnvironmentVariableOverrides)	Allows to disable the mechanism to override some properties by ENVIRONMENT VARIABLES.
ZeebeClient	build()
ZeebeClientCloudBuilderStep1.ZeebeClientCloudBuilderStep2.ZeebeClientCloudBuilderStep3.ZeebeClientCloudBuilderStep4	caCertificatePath(String certificatePath)	Path to a root CA certificate to be used instead of the certificate in the default default store.
ZeebeClientCloudBuilderStep1.ZeebeClientCloudBuilderStep2.ZeebeClientCloudBuilderStep3.ZeebeClientCloudBuilderStep4	credentialsProvider(CredentialsProvider credentialsProvider)	A custom CredentialsProvider which will be used to apply authentication credentials to requests.
ZeebeClientCloudBuilderStep1.ZeebeClientCloudBuilderStep2.ZeebeClientCloudBuilderStep3.ZeebeClientCloudBuilderStep4	defaultJobPollInterval(Duration pollInterval)	The interval which a job worker is periodically polling for new jobs.
ZeebeClientCloudBuilderStep1.ZeebeClientCloudBuilderStep2.ZeebeClientCloudBuilderStep3.ZeebeClientCloudBuilderStep4	defaultJobTimeout(Duration timeout)	The timeout which is used when none is provided for a job worker.
ZeebeClientCloudBuilderStep1.ZeebeClientCloudBuilderStep2.ZeebeClientCloudBuilderStep3.ZeebeClientCloudBuilderStep4	defaultJobWorkerMaxJobsActive(int maxJobsActive)
ZeebeClientCloudBuilderStep1.ZeebeClientCloudBuilderStep2.ZeebeClientCloudBuilderStep3.ZeebeClientCloudBuilderStep4	defaultJobWorkerName(String workerName)	The name of the worker which is used when none is set for a job worker.
ZeebeClientBuilder	defaultJobWorkerStreamEnabled(boolean streamEnabled)	A custom streamEnabled allows the client to use job stream instead of job poll.
ZeebeClientBuilder	defaultJobWorkerTenantIds(List<String> tenantIds)
ZeebeClientCloudBuilderStep1.ZeebeClientCloudBuilderStep2.ZeebeClientCloudBuilderStep3.ZeebeClientCloudBuilderStep4	defaultMessageTimeToLive(Duration timeToLive)	The time-to-live which is used when none is provided for a message.
ZeebeClientCloudBuilderStep1.ZeebeClientCloudBuilderStep2.ZeebeClientCloudBuilderStep3.ZeebeClientCloudBuilderStep4	defaultRequestTimeout(Duration requestTimeout)	The request timeout used if not overridden by the command.
ZeebeClientCloudBuilderStep1.ZeebeClientCloudBuilderStep2.ZeebeClientCloudBuilderStep3.ZeebeClientCloudBuilderStep4	defaultTenantId(String tenantId)
ZeebeClientCloudBuilderStep1.ZeebeClientCloudBuilderStep2.ZeebeClientCloudBuilderStep3.ZeebeClientCloudBuilderStep4	gatewayAddress(String gatewayAddress)
ZeebeClientCloudBuilderStep1.ZeebeClientCloudBuilderStep2.ZeebeClientCloudBuilderStep3.ZeebeClientCloudBuilderStep4	jobWorkerExecutor(ScheduledExecutorService executor, boolean takeOwnership)	Allows passing a custom executor service that will be shared by all job workers created via this client.
ZeebeClientCloudBuilderStep1.ZeebeClientCloudBuilderStep2.ZeebeClientCloudBuilderStep3.ZeebeClientCloudBuilderStep4	keepAlive(Duration keepAlive)	Time interval between keep alive messages sent to the gateway.
ZeebeClientBuilder	maxMessageSize(int maxMessageSize)	A custom maxMessageSize allows the client to receive larger or smaller responses from Zeebe.
ZeebeClientCloudBuilderStep1.ZeebeClientCloudBuilderStep2.ZeebeClientCloudBuilderStep3.ZeebeClientCloudBuilderStep4	numJobWorkerExecutionThreads(int numThreads)
ZeebeClientBuilder	overrideAuthority(String authority)	Overrides the authority used with TLS virtual hosting.
String	toString()
ZeebeClientCloudBuilderStep1.ZeebeClientCloudBuilderStep2.ZeebeClientCloudBuilderStep3.ZeebeClientCloudBuilderStep4	usePlaintext()	Use a plaintext connection between the client and the gateway.
ZeebeClientCloudBuilderStep1.ZeebeClientCloudBuilderStep2.ZeebeClientCloudBuilderStep3	withClientId(String clientId)	Sets the client id that will be used to authenticate against the Camunda Cloud cluster.
ZeebeClientCloudBuilderStep1.ZeebeClientCloudBuilderStep2.ZeebeClientCloudBuilderStep3.ZeebeClientCloudBuilderStep4	withClientSecret(String clientSecret)	Sets the client secret that will be used to authenticate against the Camunda Cloud cluster.
ZeebeClientCloudBuilderStep1.ZeebeClientCloudBuilderStep2	withClusterId(String clusterId)	Sets the cluster id of the Camunda Cloud cluster.
ZeebeClientCloudBuilderStep1.ZeebeClientCloudBuilderStep2.ZeebeClientCloudBuilderStep3.ZeebeClientCloudBuilderStep4	withInterceptors(io.grpc.ClientInterceptor... interceptor)
ZeebeClientCloudBuilderStep1.ZeebeClientCloudBuilderStep2.ZeebeClientCloudBuilderStep3.ZeebeClientCloudBuilderStep4	withJsonMapper(JsonMapper jsonMapper)
ZeebeClientCloudBuilderStep1.ZeebeClientCloudBuilderStep2.ZeebeClientCloudBuilderStep3.ZeebeClientCloudBuilderStep4	withProperties(Properties properties)	Sets all the properties from a Properties object.
ZeebeClientCloudBuilderStep1.ZeebeClientCloudBuilderStep2.ZeebeClientCloudBuilderStep3.ZeebeClientCloudBuilderStep4	withRegion(String region)	Sets the region of the Camunda Cloud cluster.

Methods inherited from class java.lang.Object

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

Methods inherited from interface io.camunda.zeebe.client.ZeebeClientBuilder

jobWorkerExecutor

Constructor Details

ZeebeClientCloudBuilderImpl

public ZeebeClientCloudBuilderImpl()

Method Details

withClusterId

public ZeebeClientCloudBuilderStep1.ZeebeClientCloudBuilderStep2 withClusterId(String clusterId)

Description copied from interface: ZeebeClientCloudBuilderStep1

Sets the cluster id of the Camunda Cloud cluster. This parameter is mandatory.

Specified by:

withClusterId in interface ZeebeClientCloudBuilderStep1

Parameters:

clusterId - cluster id of the Camunda Cloud cluster.

withClientId

public ZeebeClientCloudBuilderStep1.ZeebeClientCloudBuilderStep2.ZeebeClientCloudBuilderStep3 withClientId(String clientId)

Description copied from interface: ZeebeClientCloudBuilderStep1.ZeebeClientCloudBuilderStep2

Sets the client id that will be used to authenticate against the Camunda Cloud cluster. This parameter is mandatory.

Specified by:

withClientId in interface ZeebeClientCloudBuilderStep1.ZeebeClientCloudBuilderStep2

Parameters:

clientId - client id that will be used in the authentication.

withClientSecret

public ZeebeClientCloudBuilderStep1.ZeebeClientCloudBuilderStep2.ZeebeClientCloudBuilderStep3.ZeebeClientCloudBuilderStep4 withClientSecret(String clientSecret)

Description copied from interface: ZeebeClientCloudBuilderStep1.ZeebeClientCloudBuilderStep2.ZeebeClientCloudBuilderStep3

Sets the client secret that will be used to authenticate against the Camunda Cloud cluster. This parameter is mandatory.

Specified by:

withClientSecret in interface ZeebeClientCloudBuilderStep1.ZeebeClientCloudBuilderStep2.ZeebeClientCloudBuilderStep3

Parameters:

clientSecret - client secret that will be used in the authentication.

withRegion

public ZeebeClientCloudBuilderStep1.ZeebeClientCloudBuilderStep2.ZeebeClientCloudBuilderStep3.ZeebeClientCloudBuilderStep4 withRegion(String region)

Description copied from interface: ZeebeClientCloudBuilderStep1.ZeebeClientCloudBuilderStep2.ZeebeClientCloudBuilderStep3.ZeebeClientCloudBuilderStep4

Sets the region of the Camunda Cloud cluster. Default is 'bru-2'.

Specified by:

withRegion in interface ZeebeClientCloudBuilderStep1.ZeebeClientCloudBuilderStep2.ZeebeClientCloudBuilderStep3.ZeebeClientCloudBuilderStep4

Parameters:

region - region of the Camunda Cloud cluster

withProperties

public ZeebeClientCloudBuilderStep1.ZeebeClientCloudBuilderStep2.ZeebeClientCloudBuilderStep3.ZeebeClientCloudBuilderStep4 withProperties(Properties properties)

Description copied from interface: ZeebeClientBuilder

Sets all the properties from a Properties object. Can be used to configure the client from a properties file.

See ClientProperties for valid property names.

Specified by:

withProperties in interface ZeebeClientBuilder

applyEnvironmentVariableOverrides

public ZeebeClientBuilder applyEnvironmentVariableOverrides(boolean applyEnvironmentVariableOverrides)

Description copied from interface: ZeebeClientBuilder

Allows to disable the mechanism to override some properties by ENVIRONMENT VARIABLES. This is useful if a client shall be constructed for test cases or in an environment that wants to fully control properties (like Spring Boot).

The default value is true.

Specified by:

applyEnvironmentVariableOverrides in interface ZeebeClientBuilder

gatewayAddress

public ZeebeClientCloudBuilderStep1.ZeebeClientCloudBuilderStep2.ZeebeClientCloudBuilderStep3.ZeebeClientCloudBuilderStep4 gatewayAddress(String gatewayAddress)

Specified by:

gatewayAddress in interface ZeebeClientBuilder

Parameters:

gatewayAddress - the IP socket address of a gateway that the client can initially connect to. Must be in format host:port. The default value is 0.0.0.0:26500 .

defaultTenantId

@ExperimentalApi("https://github.com/camunda/zeebe/issues/14106")
public ZeebeClientCloudBuilderStep1.ZeebeClientCloudBuilderStep2.ZeebeClientCloudBuilderStep3.ZeebeClientCloudBuilderStep4 defaultTenantId(String tenantId)

Specified by:

defaultTenantId in interface ZeebeClientBuilder

Parameters:

tenantId - the tenant identifier which is used for tenant-aware commands when no tenant identifier is set. The default value is CommandWithTenantStep.DEFAULT_TENANT_IDENTIFIER.

defaultJobWorkerTenantIds

@ExperimentalApi("https://github.com/camunda/zeebe/issues/14106")
public ZeebeClientBuilder defaultJobWorkerTenantIds(List<String> tenantIds)

Specified by:

defaultJobWorkerTenantIds in interface ZeebeClientBuilder

Parameters:

tenantIds - the tenant identifiers which are used for job-activation commands when no tenant identifiers are set. The default value contains only CommandWithTenantStep.DEFAULT_TENANT_IDENTIFIER.

defaultJobWorkerMaxJobsActive

public ZeebeClientCloudBuilderStep1.ZeebeClientCloudBuilderStep2.ZeebeClientCloudBuilderStep3.ZeebeClientCloudBuilderStep4 defaultJobWorkerMaxJobsActive(int maxJobsActive)

Specified by:

defaultJobWorkerMaxJobsActive in interface ZeebeClientBuilder

Parameters:

maxJobsActive - Default value for JobWorkerBuilderStep1.JobWorkerBuilderStep3.maxJobsActive(int). Default value is 32.

numJobWorkerExecutionThreads

public ZeebeClientCloudBuilderStep1.ZeebeClientCloudBuilderStep2.ZeebeClientCloudBuilderStep3.ZeebeClientCloudBuilderStep4 numJobWorkerExecutionThreads(int numThreads)

Specified by:

numJobWorkerExecutionThreads in interface ZeebeClientBuilder

Parameters:

numThreads - The number of threads for invocation of job workers. Setting this value to 0 effectively disables subscriptions and workers. Default value is 1.

jobWorkerExecutor

public ZeebeClientCloudBuilderStep1.ZeebeClientCloudBuilderStep2.ZeebeClientCloudBuilderStep3.ZeebeClientCloudBuilderStep4 jobWorkerExecutor(ScheduledExecutorService executor,
 boolean takeOwnership)

Description copied from interface: ZeebeClientBuilder

Allows passing a custom executor service that will be shared by all job workers created via this client.

Polling and handling jobs (e.g. via JobHandler will all be invoked on this executor.

When non-null, this setting override ZeebeClientBuilder.numJobWorkerExecutionThreads(int).

Specified by:

jobWorkerExecutor in interface ZeebeClientBuilder

Parameters:

executor - an executor service to use when invoking job workers

takeOwnership - if true, the executor will be closed when the client is closed. otherwise, it's up to the caller to manage its lifecycle

defaultJobWorkerName

public ZeebeClientCloudBuilderStep1.ZeebeClientCloudBuilderStep2.ZeebeClientCloudBuilderStep3.ZeebeClientCloudBuilderStep4 defaultJobWorkerName(String workerName)

Description copied from interface: ZeebeClientBuilder

The name of the worker which is used when none is set for a job worker. Default is 'default'.

Specified by:

defaultJobWorkerName in interface ZeebeClientBuilder

defaultJobTimeout

public ZeebeClientCloudBuilderStep1.ZeebeClientCloudBuilderStep2.ZeebeClientCloudBuilderStep3.ZeebeClientCloudBuilderStep4 defaultJobTimeout(Duration timeout)

Description copied from interface: ZeebeClientBuilder

The timeout which is used when none is provided for a job worker. Default is 5 minutes.

Specified by:

defaultJobTimeout in interface ZeebeClientBuilder

defaultJobPollInterval

public ZeebeClientCloudBuilderStep1.ZeebeClientCloudBuilderStep2.ZeebeClientCloudBuilderStep3.ZeebeClientCloudBuilderStep4 defaultJobPollInterval(Duration pollInterval)

Description copied from interface: ZeebeClientBuilder

The interval which a job worker is periodically polling for new jobs. Default is 100 milliseconds.

Specified by:

defaultJobPollInterval in interface ZeebeClientBuilder

defaultMessageTimeToLive

public ZeebeClientCloudBuilderStep1.ZeebeClientCloudBuilderStep2.ZeebeClientCloudBuilderStep3.ZeebeClientCloudBuilderStep4 defaultMessageTimeToLive(Duration timeToLive)

Description copied from interface: ZeebeClientBuilder

The time-to-live which is used when none is provided for a message. Default is 1 hour.

Specified by:

defaultMessageTimeToLive in interface ZeebeClientBuilder

defaultRequestTimeout

public ZeebeClientCloudBuilderStep1.ZeebeClientCloudBuilderStep2.ZeebeClientCloudBuilderStep3.ZeebeClientCloudBuilderStep4 defaultRequestTimeout(Duration requestTimeout)

Description copied from interface: ZeebeClientBuilder

The request timeout used if not overridden by the command. Default is 10 seconds.

Specified by:

defaultRequestTimeout in interface ZeebeClientBuilder

usePlaintext

public ZeebeClientCloudBuilderStep1.ZeebeClientCloudBuilderStep2.ZeebeClientCloudBuilderStep3.ZeebeClientCloudBuilderStep4 usePlaintext()

Description copied from interface: ZeebeClientBuilder

Use a plaintext connection between the client and the gateway.

Specified by:

usePlaintext in interface ZeebeClientBuilder

caCertificatePath

public ZeebeClientCloudBuilderStep1.ZeebeClientCloudBuilderStep2.ZeebeClientCloudBuilderStep3.ZeebeClientCloudBuilderStep4 caCertificatePath(String certificatePath)

Description copied from interface: ZeebeClientBuilder

Path to a root CA certificate to be used instead of the certificate in the default default store.

Specified by:

caCertificatePath in interface ZeebeClientBuilder

credentialsProvider

public ZeebeClientCloudBuilderStep1.ZeebeClientCloudBuilderStep2.ZeebeClientCloudBuilderStep3.ZeebeClientCloudBuilderStep4 credentialsProvider(CredentialsProvider credentialsProvider)

Description copied from interface: ZeebeClientBuilder

A custom CredentialsProvider which will be used to apply authentication credentials to requests.

Specified by:

credentialsProvider in interface ZeebeClientBuilder

keepAlive

public ZeebeClientCloudBuilderStep1.ZeebeClientCloudBuilderStep2.ZeebeClientCloudBuilderStep3.ZeebeClientCloudBuilderStep4 keepAlive(Duration keepAlive)

Description copied from interface: ZeebeClientBuilder

Time interval between keep alive messages sent to the gateway. The default is 45 seconds.

Specified by:

keepAlive in interface ZeebeClientBuilder

withInterceptors

public ZeebeClientCloudBuilderStep1.ZeebeClientCloudBuilderStep2.ZeebeClientCloudBuilderStep3.ZeebeClientCloudBuilderStep4 withInterceptors(io.grpc.ClientInterceptor... interceptor)

Specified by:

withInterceptors in interface ZeebeClientBuilder

withJsonMapper

public ZeebeClientCloudBuilderStep1.ZeebeClientCloudBuilderStep2.ZeebeClientCloudBuilderStep3.ZeebeClientCloudBuilderStep4 withJsonMapper(JsonMapper jsonMapper)

Specified by:

withJsonMapper in interface ZeebeClientBuilder

overrideAuthority

public ZeebeClientBuilder overrideAuthority(String authority)

Description copied from interface: ZeebeClientBuilder

Overrides the authority used with TLS virtual hosting. Specifically, to override hostname verification in the TLS handshake. It does not change what host is actually connected to.

This method is intended for testing, but may safely be used outside of tests as an alternative to DNS overrides.

This setting does nothing if a plaintext connection is used.

Specified by:

overrideAuthority in interface ZeebeClientBuilder

Parameters:

authority - The alternative authority to use, commonly in the form host or host:port

maxMessageSize

public ZeebeClientBuilder maxMessageSize(int maxMessageSize)

Description copied from interface: ZeebeClientBuilder

A custom maxMessageSize allows the client to receive larger or smaller responses from Zeebe. Technically, it specifies the maxInboundMessageSize of the gRPC channel. The default is 4194304 = 4MB.

Specified by:

maxMessageSize in interface ZeebeClientBuilder

defaultJobWorkerStreamEnabled

public ZeebeClientBuilder defaultJobWorkerStreamEnabled(boolean streamEnabled)

Description copied from interface: ZeebeClientBuilder

A custom streamEnabled allows the client to use job stream instead of job poll. The default value is set as enabled.

Specified by:

defaultJobWorkerStreamEnabled in interface ZeebeClientBuilder

build

public ZeebeClient build()

Specified by:

build in interface ZeebeClientBuilder

Returns:

a new ZeebeClient with the provided configuration options.

toString

public String toString()

Overrides:

toString in class Object