Package io.camunda.spring.client.annotation

Annotation Interface JobWorker

@Target(METHOD) @Retention(RUNTIME) @Documented public @interface JobWorker

  • Optional Element Summary

    Optional Elements
    Modifier and Type
    Optional Element
    Description
    boolean
    autoComplete
    If set to true, the job is automatically completed after the worker code has finished.
    boolean
    enabled
    If set to true, the worker will actually be subscribing.
    boolean
    fetchAllVariables
    If set to true, all variables are fetched
    String[]
    fetchVariables
    Set a list of variable names which should be fetched on job activation.
    int
    maxJobsActive
    Set the maximum number of jobs which will be exclusively activated for this worker at the same time.
    int
    maxRetries
    Set the max number of retries for a job
    String
    name
    set to empty string which leads to default from CamundaClientBuilderImpl being used in JobWorkerAnnotationProcessor
    long
    pollInterval
    Set the maximal interval (in milliseconds) between polling for new jobs.
    long
    requestTimeout
    Set the request timeout (in seconds) for activate job request used to poll for new jobs.
    boolean
    streamEnabled
    Whether job streaming should be enabled for this job type.
    long
    streamTimeout
    Stream timeout in ms
    String[]
    tenantIds
    A list of tenants for this job will be worked on.
    long
    timeout
    Set the time (in milliseconds) for how long a job is exclusively assigned for this worker.
    String
    type
    Set to empty string which leads to the method name being used (if not ${camunda.client.worker.defaults.type} is configured) Implemented in JobWorkerAnnotationProcessor

  • Element Details

    • type

      String type
      Set to empty string which leads to the method name being used (if not ${camunda.client.worker.defaults.type} is configured) Implemented in JobWorkerAnnotationProcessor
      Default:
      ""

    • name

      String name
      set to empty string which leads to default from CamundaClientBuilderImpl being used in JobWorkerAnnotationProcessor
      Default:
      ""

    • timeout

      long timeout
      Set the time (in milliseconds) for how long a job is exclusively assigned for this worker. During this time, the job cannot be assigned by other workers to ensure that only one worker works on the job. When the time is over, then the job can be assigned again by this or other worker if it's not completed yet. If no timeout is set, then the default is used from the CamundaClientConfiguration
      Default:
      -1L

    • maxJobsActive

      int maxJobsActive
      Set the maximum number of jobs which will be exclusively activated for this worker at the same time. This is used to control the backpressure of the worker. When the maximum is reached, then the worker will stop activating new jobs to not overwhelm the client and give other workers the chance to work on the jobs. The worker will try to activate new jobs again when jobs are completed (or marked as failed). If no maximum is set, then the default from the CamundaClientConfiguration, is used.

      Considerations: A greater value can avoid situations in which the client waits idle for the broker to provide more jobs. This can improve the worker's throughput. The memory used by the worker is linear with respect to this value. The job's timeout starts to run down as soon as the broker pushes the job. Keep in mind that the following must hold to ensure fluent job handling: 
      time spent in queue + time job handler needs until job completion invalid input: '<' job timeout
      Default:
      -1

    • requestTimeout

      long requestTimeout
      Set the request timeout (in seconds) for activate job request used to poll for new jobs. If no request timeout is set then the default is used from the CamundaClientConfiguration
      Default:
      -1L

    • pollInterval

      long pollInterval
      Set the maximal interval (in milliseconds) between polling for new jobs. A job worker will automatically try to always activate new jobs after completing jobs. If no jobs can be activated after completing, the worker will periodically poll for new jobs. If no poll interval is set then the default is used from the CamundaClientConfiguration
      Default:
      -1L

    • fetchVariables

      String[] fetchVariables
      Set a list of variable names which should be fetched on job activation. The jobs which are activated by this worker will only contain variables from this list. This can be used to limit the number of variables of the activated jobs.
      Default:
      {}

    • fetchAllVariables

      boolean fetchAllVariables
      If set to true, all variables are fetched
      Default:
      false

    • autoComplete

      boolean autoComplete
      If set to true, the job is automatically completed after the worker code has finished. In this case, your worker code is not allowed to complete the job itself.

      You can still throw exceptions if you want to raise a problem instead of job completion. To control the retry behavior or submit variables, you can use the JobError. You could also raise a BPMN error throwing a BpmnError

      Default:
      true

    • enabled

      boolean enabled
      If set to true, the worker will actually be subscribing.
      Default:
      true

    • tenantIds

      String[] tenantIds
      A list of tenants for this job will be worked on.
      Default:
      {}

    • streamEnabled

      boolean streamEnabled
      Whether job streaming should be enabled for this job type. Useful in high-performance setups but can only be used with a gRPC connection.
      Default:
      false

    • streamTimeout

      long streamTimeout
      Stream timeout in ms
      Default:
      3600000L

    • maxRetries

      int maxRetries
      Set the max number of retries for a job
      Default:
      -1