Skip to content

Commit

Permalink
Release v1.28.0 (#2431)
Browse files Browse the repository at this point in the history
  • Loading branch information
Quinn-With-Two-Ns authored Feb 26, 2025
1 parent 7cd4932 commit 6b05cd8
Showing 1 changed file with 79 additions and 0 deletions.
79 changes: 79 additions & 0 deletions releases/v1.28.0
Original file line number Diff line number Diff line change
@@ -0,0 +1,79 @@
# **💥 BREAKING CHANGES**

### Nexus (Public Preview)

- ⚠️ **IMPORTANT** ⚠️ This SDK release requires server `>=1.27.0` to properly support the full set of changes from the previous SDK release. Most notably the built-in error translation logic changed in a way that may cause Nexus tasks to retry until the caller specified schedule-to-close timeout on certain failures, see more below.
- Setting `WorkflowIDConflictPolicy` to `WORKFLOW_ID_CONFLICT_POLICY_USE_EXISTING` has been temporarily disabled, and will fail requests with a retryable internal error.
- This is to protect users from making a false assumption that the same workflow can be used to back multiple operations. This capability will be enabled in a follow up release.
- `WorkflowClientOperationHandlers` was renamed to `WorkflowRunOperation`
- `OperationId` was renamed to `OperationToken` and the content for a `WorkflowRunOperation` of it was changed to a structured token instead of copying the workflow ID directly.
- Removed `WorkflowClient` from the input of all Temporal nexus handlers, a client can now be accessed by calling `Nexus.getOperationContext().getWorkflowClient()`
- `FailureConverter` now supports serializing and deserializing `HandlerException` . Previously these may have been deserialized as `ApplicationFailure` .
- Note: This is can potentially cause Non-Determinism exceptions if users were handling `ApplicationFailure` .
- The promise returned from `NexusOperationHandle.getExecution()` now correctly will return the appropriate exception if the underlying nexus fails in a synchronous manner
- Note: This is can potentially cause Non-Determinism exceptions if users called `NexusOperationHandle.getExecution()`

### Failure Converter

The `FailureConverter` interface was changed. `FailureConverter.failureToException` now can return any type implementing `RuntimeException` instead of just types implementing `TemporalFailure`

### Java Protobuf 3/4 Support

The Temporal Java SDK now supports `protobuf-java` 3.x and 4.x. To support these, the Temporal Java SDK allows any protobuf library >= 3.25. Temporal strongly recommends using the latest `protobuf-java` 4.x library unless you absolutely cannot. If you cannot use protobuf-java 3.25 >=, you can try `temporal-shaded` which includes a shaded version of the `protobuf-java` library.

# **Highlights**

### Spring Boot API Key support

The Java SDK Spring Boot integration now directly supports API key authentication.

For documentation see: https://github.com/temporalio/sdk-java/tree/master/temporal-spring-boot-autoconfigure#api-keys

### Spring Boot Multi-Namespace support (Experimental)

The Java SDK Spring Boot integration now has experimental support for running multiple none-root namespace along side the root namespace.

For documentation see: https://github.com/temporalio/sdk-java/tree/master/temporal-spring-boot-autoconfigure#running-multiple-name-space-experimental

# What's Changed

2024-12-09 - e1bef897 - Update protocloud submodule (#2344)
2024-12-12 - 53a8af7e - Remove Experimental annotations from Update APIs (#2347)
2024-12-27 - c3e0e779 - Set request Id on SignalWorkflowExecutionRequest (#2352)
2025-01-06 - 82d3c93d - Update Java SDK for Temporal Sever v1.26.2 (#2357)
2025-01-06 - 9a8894af - Set LastHeartbeatDetails on activity failure (#2354)
2025-01-06 - ff333ca7 - Add javadocs for ActivityCompletionClient (#2353)
2025-01-08 - cf061311 - Test server support for Nexus operation complete before start (#2348)
2025-01-15 - 35e390ea - Add method to get workflow client from an activity (#2369)
2025-01-16 - 90e51259 - Fix NDE caused by removing Workflow.getVersion with a succeeding Work… (#2370)
2025-01-16 - b187644b - Add details to manifest (#2355)
2025-01-16 - b593b35b - [OpenTracing] Wrap returned promises in OutboundCallsInterceptor (#2366)
2025-01-17 - 3ad0b0e6 - Avoid lock up on unexpected ExecutorService errors while executing Local Activities (#2371)
2025-01-22 - b471e13e - Access to workflow/activity instance from context (#2384)
2025-01-22 - c51e5d19 - Upgrade some test dependencies (#2382)
2025-01-22 - cdbc520a - Split up & use more appropriate timeouts for parallel LAs test (#2385)
2025-01-28 - 8b17a526 - Support Proto 3 and 4 (#2383)
2025-01-28 - ce90d24e - Enable speculative workflow tasks (#2390)
2025-01-28 - f93910b1 - Make sure GetVersion never yields (#2376)
2025-02-03 - de33b3ad - Update docs for max workflow task timeout (#2396)
2025-02-04 - fd65ea97 - Inject namespace header (#2400)
2025-02-07 - 32df8d4b - Remove Nexus sync client handler (#2403)
2025-02-07 - 76630fef - Update max task timeout (#2407)
2025-02-10 - 32fbf020 - Fix kotlin child workflow execute varargs (#2395)
2025-02-10 - f9a9cad9 - Rename WorkflowClientOperationHandlers->WorkflowRunOperation (#2405)
2025-02-10 - fc4d714b - Update proto v1.44.0 (#2406)
2025-02-11 - 00f7dd02 - Add API key property to Springboot (#2408)
2025-02-11 - 24f225c7 - Java test server support for attaching links to signal and signal with start requests (#2411)
2025-02-12 - c6e0306a - Special behavior for Temporal built-in prefixes (#2409)
2025-02-17 - c6375d67 - feat: multi namespace support (#2378)
2025-02-18 - 436d0800 - Add Graal reflection config for UwS (#2363)
2025-02-18 - 6f4621de - Update readme for multi namespace support (#2416)
2025-02-18 - a2455aff - Make sure workflow_task_execution_failed always has a failure_reason (#2419)
2025-02-18 - a643a799 - Add nexus configuration to spring boot readme (#2417)
2025-02-20 - f92b53c2 - 💥 Nexus error rehydration (#2365)
2025-02-21 - 963ea9ff - Add sdk name/version to task completions when unset or changed (#2422)
2025-02-24 - 49bd366a - Add support for operation timeout header (#2427)
2025-02-24 - 729e25e3 - Workflow run token (#2421)
2025-02-24 - d0cf3f37 - Add support for attaching to a running workflow (#2424)
2025-02-25 - 7cd49327 - fix documentation in CapacityConfigurationProperties (#2429)
2025-02-25 - f90c57b5 - Block using conflict policy UseExisting for Nexus WorkflowRunOperation (#2428)

0 comments on commit 6b05cd8

Please sign in to comment.