Skip to main content

Cadence Java Client Releases

The Cadence Java client follows semantic versioning. See the Java client's GitHub Releases for changes and migration notes.

Most recently published GA release

v3.13.5 published on 2026-09-09

Java release lines

Java 4.x is the current gRPC-only major line. Java 3.x remains a separate release line that supports both gRPC and TChannel. The project does not publish an end-of-life date for the 3.x line. Check GitHub Releases for the latest patch in each line.

Java Compatibility

Java versions 21, 17 and 11 are supported at this time.

Due to backward compatibility, Java versions 17+ require the following JVM flag

--add-opens java.base/java.lang=ALL-UNNAMED

Major Releases​

v4.0.x​

v3.13.x​

v3.12.x​

v3.11.x​

v3.10.x​

v3.9.x​

v3.8.x​

v3.7.x​

v3.6.x​

v3.5.x​

v3.4.x​

v3.3.x​

v3.2.x​

v3.1.x​

v3.0.x​

v2.7.x​

v2.6.x​

v2.5.x​

v2.4.x​

v2.3.x​

v2.2.x​

v2.1.x​

v2.0.x​

v1.0.x​

Recent release notes​

Release v3.13.5 published by c-warren on 9/9/2026​

What's Changed

Full Changelog: https://github.com/cadence-workflow/cadence-java-client/compare/v3.13.4...v3.13.5


Release v3.13.4 published by shijiesheng on 8/20/2026​

What's Changed

Full Changelog: https://github.com/cadence-workflow/cadence-java-client/compare/v3.13.3...v3.13.4


Release v3.13.3 published by shijiesheng on 8/18/2026​

What's Changed

Full Changelog: https://github.com/cadence-workflow/cadence-java-client/compare/v3.13.2...v3.13.3


Release v3.13.2 published by shijiesheng on 8/18/2026​

What's Changed

Full Changelog: https://github.com/cadence-workflow/cadence-java-client/compare/v3.13.1...v3.13.2


Release v3.13.1 published by natemort on 12/19/2025​

What's Changed

Full Changelog: https://github.com/cadence-workflow/cadence-java-client/compare/v3.13.0...v3.13.1


Release v3.13.0 published by natemort on 11/19/2025​

This is a release for the 3.x branch, which still supports Thrift. It addresses minor bugs in the gRPC support to help with the migration toward 4.x.

What's Changed

New Contributors

Full Changelog: https://github.com/cadence-workflow/cadence-java-client/compare/v3.12.7...v3.13.0


Release v4.0.0 published by shijiesheng on 10/14/2025​

Highlights

Thrift Deprecation

Thrift support is now fully removed in Java client. (See why https://github.com/cadence-workflow/cadence-java-client/issues/985 ).

Migration Guide from V3

User facing APIs on workflow operations are mostly unchanged. But there are some BREAKING changes as list below.

Thrift to new Entities in API calls

For users to migrate easily, we generate a new set of entities with the same import path and similar interfaces.

  1. you can no longer access fields directly but instead have to use getter and setter explicitly.
  2. IWorkflowService will no longer throw TException but instead CadenceError; all other exceptions thrown are kept the same extended from CadenceError
  3. IWorkflowService uses com.uber.cadence.serviceclient.AsyncMethodCallback instead of org.apache.thrift.async.AsyncMethodCallback in callback methods.

Data Converter

If your workflow's input or output contains Thrift entities that extended from TBase, TEnum, TException. This is a BREAKING change. You'll need to add back the thrift adapters in your custom dataconverters. We no longer support them by default.

  1. We removed special TBase and TEnum adapter (first introduced to reduce payload size https://github.com/cadence-workflow/cadence-java-client/pull/263).
  2. We removed the ability to convert TException but instead you'll get a fallback type com.uber.cadence.client.ApplicationFailureException

Construct your client

  1. WorkflowServiceTChannel is now removed and replaced by WorkflowServiceGrpc
  2. If you use Grpc before, instead of new Thrift2ProtoAdapter(IGrpcServiceStubs.newInstance()) you can now use WorkflowServiceGrpc() directly.

What's Changed

New Contributors

Full Changelog: https://github.com/cadence-workflow/cadence-java-client/compare/v3.12.7...v4.0.0


Release v3.12.4 published by shijiesheng on 6/12/2024​

3.12.4

  • Fix incorrect span activation for local activities

Release v3.12.3 published by shijiesheng on 6/4/2024​

3.12.3

  • Remove unused direct dependency of com.google.http-client
  • Fix context propagation bug that would link two parents in some cases

Release v3.12.2 published by shijiesheng on 5/22/2024​

What's Changed

  • downgrade java-jwt dependency to 3.10.2

For a comprehensive list of changes and detailed release notes, please visit the Cadence Java Client GitHub Releases page.