Skip to main content
You are viewing 1.37.x. The latest is 1.45.x.

Change log

View as Markdown

This page lists user-visible changes to the Java SDK, newest first; each section covers the changes since the previous release of this component.

1.37​

Released 2026-11-06 as sdk-java/v1.37.0. Reference: 1.37.x.

Added​

  • FlowServiceTlsOptions and flowServiceTls on Client and Worker option builders enable verified TLS, with optional extra root CAs and a server-name override. Omitting the option keeps plaintext connections. API reference.

1.35​

Released 2026-11-06 as sdk-java/v1.35.0. Reference: 1.35.x.

Breaking​

  • Workers and the Client’s first call now require server-zd 0.1.17 or later (protocol version 4). Upgrade all server processes before upgrading the SDK. Reference.
  • Worker startup fails when maxConcurrentTasks exceeds matching.maxConcurrentTasksCap (256 by default). Lower the Worker setting or raise the server cap and matching.maxStreams first. Reference.
  • RetryPolicy.Builder.totalDuration now starts at the first hand-out and only gates scheduling another retry. Set method timeouts to bound running attempts. API reference.
  • A Step with no available or supporting Worker waits durably without consuming a retry. Set a Flow timeout to bound that wait. Reference.
  • A Step attempt interrupted after its hand-out was committed fails with NOT_COMPLETED and consumes a retry. Review retry policies and side effects before upgrading. Reference.

Added​

  • RecoveryErrorInfo.getAttemptProgress() distinguishes a failed Step method that never started from one that may have run. API reference.

Changed​

  • Workers open one execution stream per slot; reservedRpcTasks selects RPC-only slots. By default, a Worker with at least two slots reserves one for RPCs. Reference.
  • stop drains running handlers and returns tasks that did not start without consuming a retry. Reference.

Deprecated​

  • idleStreamsPerQueue is accepted but ignored, and getPullReservedRpcDeclines() always reports zero. Use execution-slot capacity and queue metrics instead. Reference.

1.32​

Released 2026-11-01 as sdk-java/v1.32.0. Reference: 1.32.x.

Added​

  • Generated protocol bindings include AdminService, with DescribeActiveNode and StepDownActiveNode for inspecting and stepping down the active server process. Release notes.

1.31​

Released 2026-10-31 as sdk-java/v1.31.0. Reference: 1.31.x.

Added​

  • Client.getAttributes reads committed Attributes and AttributeMap instances in one request without a Worker. AttributeMap.instance selects an instance, and AttributeValues.get returns an Optional value. API reference.

1.30​

Released 2026-10-31 as sdk-java/v1.30.0. Reference: 1.30.x.

Added​

  • Generated protocol bindings add ERROR_SUB_STATUS_ATTRIBUTE_INDEX_CAPACITY_EXCEEDED and ERROR_SUB_STATUS_INDEXED_KEYWORD_TOO_LONG for Attribute index admission errors. Release notes.

Older releases: GitHub releases.