Temporal Java SDK

Temporal is a Workflow as Code platform used to build and operate resilient applications using developer friendly primitives, instead of constantly fighting your infrastructure.

temporal-java-sdk is the framework for authoring workflows and activities in Java.

If you are authoring in Go, see Temporal Go SDK.

Samples

For samples, see Samples for the Temporal Java SDK.

Run Temporal Server

Follow the Quick install guide to run the Temporal Server locally. Additional information is available in the Temporal Server docker-compose repo.

Get CLI

CLI is avaialable as an executable or as a docker image

Build a configuration

Find the latest release of the Temporal Java SDK at maven central.

Add temporal-sdk as a dependency to your pom.xml:

<dependency>
  <groupId>io.temporal</groupId>
  <artifactId>temporal-sdk</artifactId>
  <version>N.N.N</version>
</dependency>

or to build.gradle:

compile group: 'io.temporal', name: 'temporal-sdk', version: 'N.N.N'

Documentation

The documentation on how to use the Temporal Java client is here.

Javadocs for the client API are located here.

macOS Users

Due to issues with default hostname resolution (see this StackOverflow question for more details), macOS Users may see gRPC DEADLINE_EXCEEDED errors and other slowdowns when running the SDK.

To solve the problem add the following entries to your /etc/hosts file (where my-macbook is your hostname):

127.0.0.1   my-macbook
::1         my-macbook

Contributing

We'd love your help in making the Temporal Java SDKL great. Please review our contribution guidelines.

License

Apache License, please see LICENSE for details.