https://github.com/temporalio/sdk-java

Temporal Java SDK
https://github.com/temporalio/sdk-java

framework java java-sdk microservices open-source orchestration workflow-automation workflow-engine workflow-tool

Last synced: 3 months ago
JSON representation

Temporal Java SDK

• Host: GitHub
• URL: https://github.com/temporalio/sdk-java
• Owner: temporalio
• License: apache-2.0
• Created: 2019-10-17T16:42:32.000Z (over 5 years ago)
• Default Branch: master
• Last Pushed: 2024-08-02T16:36:28.000Z (6 months ago)
• Last Synced: 2024-08-02T22:14:09.711Z (6 months ago)
• Topics: framework, java, java-sdk, microservices, open-source, orchestration, workflow-automation, workflow-engine, workflow-tool
• Language: Java
• Homepage: https://temporal.io
• Size: 9.69 MB
• Stars: 202
• Watchers: 23
• Forks: 136
• Open Issues: 308
• Metadata Files:
  • Readme: README.md
  • Contributing: CONTRIBUTING.md
  • License: LICENSE
  • Codeowners: .github/CODEOWNERS

Awesome Lists containing this project

• awesome-temporal - Java SDK

README

        
# Temporal Java SDK  [![Build status](https://github.com/temporalio/sdk-java/actions/workflows/ci.yml/badge.svg?event=push)](https://github.com/temporalio/sdk-java/actions/workflows/ci.yml) [![Coverage Status](https://coveralls.io/repos/github/temporalio/sdk-java/badge.svg?branch=master)](https://coveralls.io/github/temporalio/sdk-java?branch=master)

[Temporal](https://github.com/temporalio/temporal) is a Workflow-as-Code platform for building and operating

resilient applications using developer-friendly primitives, instead of constantly fighting your infrastructure.

The Java SDK is the framework for authoring Workflows and Activities in Java. (For other languages, see [Temporal SDKs](https://docs.temporal.io/application-development).)

Java SDK:

- [Java SDK documentation](https://docs.temporal.io/docs/java/introduction)

- [Javadoc API reference](https://www.javadoc.io/doc/io.temporal/temporal-sdk/latest/index.html)

- [Sample applications](https://github.com/temporalio/samples-java#samples-directory)

Temporal:

- [Temporal docs](https://docs.temporal.io/)

- [Install Temporal Server](https://docs.temporal.io/docs/server/quick-install)

- [Temporal CLI](https://docs.temporal.io/docs/devtools/tctl/)

## Supported Java runtimes

- Java 1.8+

- [GraalVM native-image](docs/AOT-native-image.md)

## Build configuration

[Find the latest release](https://search.maven.org/artifact/io.temporal/temporal-sdk) of the Temporal Java SDK at maven central.

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

    

      io.temporal

      temporal-sdk

      N.N.N

    

or to *build.gradle*:

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

## Contributing

We'd love your help in improving the Temporal Java SDK. Please review our [contribution guidelines](CONTRIBUTING.md).

## Snapshot release

We also publish snapshot releases during SDK development often under the version `1.x.0-SNAPSHOT`. This allows users to test out new SDK features before an official SDK release.

[Snapshot releases](https://oss.sonatype.org/content/repositories/snapshots/io/temporal/temporal-sdk/) Find the latest snapsphot release.

To add Sonatype snapshot repository to your *pom.xml*:

    

        

            oss-sonatype

            oss-sonatype

            https://oss.sonatype.org/content/repositories/snapshots/

            

                true

            

        

    

Or to *build.gradle*:

    repositories {

        maven {

            url "https://oss.sonatype.org/content/repositories/snapshots/"

        }

      ...

    }

Note: Snapshot releases are not official release and normal backwards compatibility, stability or support

does not apply

## License

Copyright (C) 2022 Temporal Technologies, Inc. All Rights Reserved.

Copyright (C) 2012-2016 Amazon.com, Inc. or its affiliates. All Rights Reserved.

Modifications copyright (C) 2017 Uber Technologies, Inc.

Licensed under the Apache License, Version 2.0 (the "License");

you may not use this material except in compliance with the License.

You may obtain a copy of the License at

  http://www.apache.org/licenses/LICENSE-2.0

Unless required by applicable law or agreed to in writing, software

distributed under the License is distributed on an "AS IS" BASIS,

WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.

See the License for the specific language governing permissions and

limitations under the License.