pom/spring-zeebe-client

This pom defines the required plugins and profiles to allow a camunda release build. Inherit this pom when you want to release your project into the camunda nexus and/or maven central.

License

License

Apache License
Categories

Categories

CLI User Interface
GroupId

GroupId

io.zeebe.spring.root
ArtifactId

ArtifactId

spring-zeebe-client-root
Last Version

Last Version

1.0.0-rc1
Release Date

Release Date

Type

Type

pom
Description

Description

pom/spring-zeebe-client
This pom defines the required plugins and profiles to allow a camunda release build. Inherit this pom when you want to release your project into the camunda nexus and/or maven central.
Project Organization

Project Organization

Camunda Services GmbH

Download spring-zeebe-client-root

How to add to project

<!-- https://jarcasting.com/artifacts/io.zeebe.spring.root/spring-zeebe-client-root/ -->
<dependency>
    <groupId>io.zeebe.spring.root</groupId>
    <artifactId>spring-zeebe-client-root</artifactId>
    <version>1.0.0-rc1</version>
    <type>pom</type>
</dependency>
// https://jarcasting.com/artifacts/io.zeebe.spring.root/spring-zeebe-client-root/
implementation 'io.zeebe.spring.root:spring-zeebe-client-root:1.0.0-rc1'
// https://jarcasting.com/artifacts/io.zeebe.spring.root/spring-zeebe-client-root/
implementation ("io.zeebe.spring.root:spring-zeebe-client-root:1.0.0-rc1")
'io.zeebe.spring.root:spring-zeebe-client-root:pom:1.0.0-rc1'
<dependency org="io.zeebe.spring.root" name="spring-zeebe-client-root" rev="1.0.0-rc1">
  <artifact name="spring-zeebe-client-root" type="pom" />
</dependency>
@Grapes(
@Grab(group='io.zeebe.spring.root', module='spring-zeebe-client-root', version='1.0.0-rc1')
)
libraryDependencies += "io.zeebe.spring.root" % "spring-zeebe-client-root" % "1.0.0-rc1"
[io.zeebe.spring.root/spring-zeebe-client-root "1.0.0-rc1"]

Dependencies

There are no dependencies for this project. It is a standalone project that does not depend on any other jars.

Project Modules

  • spring-zeebe
  • spring-zeebe-starter

Spring Zeebe

Maven Central

Build Status codecov Project Stats

This project allows to leverage Zeebe within your Spring or Spring Boot environment easily. It is basically a wrapper around the Zeebe Java Client.

How to use

Connect to Zeebe Broker

Just add the @EnableZeebeClient annotation to your Spring Boot Application:

@SpringBootApplication
@EnableZeebeClient
public class MySpringBootApplication {

Now you can inject the ZeebeClient and work with it, e.g. to create new workflow instances:

@Autowired
private ZeebeClient client;

Deploy Workflow Models

Use the @ZeebeDeployment annotation:

@SpringBootApplication
@EnableZeebeClient
@ZeebeDeployment(classPathResources = "demoProcess.bpmn")
public class MySpringBootApplication {

You can also deploy multiple files at once:

@ZeebeDeployment(classPathResources ={"demoProcess.bpmn", "demoProcess2.bpmn"})

Implement Job Worker

@ZeebeWorker(type = "foo")
public void handleJobFoo(final JobClient client, final ActivatedJob job) {
  // do whatever you need to do
  client.newCompleteCommand(job.getKey()) 
     .variables("{\"fooResult\": 1}")
     .send()
     .exceptionally( throwable -> { throw new RuntimeException("Could not complete job " + job, throwable); });
}

Configuring Camunda Cloud Connection

Connections to the Camunda Cloud can be easily configured:

zeebe.client.cloud.clusterId=xxx
zeebe.client.cloud.clientId=xxx
zeebe.client.cloud.clientSecret=xxx

If you don't connect to the Camunda Cloud production environment you might have to also adjust these two properties:

zeebe.client.cloud.baseUrl=zeebe.camunda.io
zeebe.client.cloud.port=443
zeebe.client.cloud.authUrl=https://login.cloud.camunda.io/oauth/token

As an alternative you can use the Zeebe Client environment variables.

Configuring Self-managed Zeebe Connection

zeebe.client.broker.gatewayAddress=127.0.0.1:26500
zeebe.client.security.plaintext=true

Additional Configuration Options

If you build a worker that only serves one thing, it might also be handy to define the worker job type globally - and not in the annotation:

zeebe.client.worker.defaultType=foo

For a full set of configuration options please see ZeebeClientConfigurationProperties.java

ObjectMapper customization

If you need to customize the ObjectMapper that the Zeebe client uses to work with variables, you can declare a bean with type io.camunda.zeebe.client.api.JsonMapper like this:

@Configuration
class MyConfiguration {
  @Bean
  public JsonMapper jsonMapper() {
    new ZeebeObjectMapper().enable(DeserializationFeature.ACCEPT_EMPTY_ARRAY_AS_NULL_OBJECT);
  }
}

Add Spring Boot Starter to Your Project

Just add the following Maven dependency to your Spring Boot Starter project:

<dependency>
	<groupId>io.camunda</groupId>
	<artifactId>spring-zeebe-starter</artifactId>
	<version>${CURRENT_VERSION}</version>
</dependency>

Examples

Have a look into the examples/ folder for working Maven projects that might serve as inspiration.

Code of Conduct

This project adheres to the Contributor Covenant Code of Conduct. By participating, you are expected to uphold this code. Please report unacceptable behavior to [email protected].

io.zeebe.spring.root
This organization contains the internal repositories of the Zeebe development team. Please visit https://github.com/camunda-cloud/zeebe for the Zeebe repository

Versions

Version
1.0.0-rc1
1.0.0-alpha5
0.26.2
0.25.0
0.24.0
0.23.0
0.22.0
0.7.1
0.7.0
0.6.0
0.5.0
0.4.0
0.3.0
0.2.0
0.1.0