-
Notifications
You must be signed in to change notification settings - Fork 151
Commit
This commit does not belong to any branch on this repository, and may belong to a fork outside of the repository.
- Loading branch information
1 parent
7cd4932
commit 6b05cd8
Showing
1 changed file
with
79 additions
and
0 deletions.
There are no files selected for viewing
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
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) |