Title: Wrap gRPC StatusRuntimeException across all client and worker gRPC calls · Issue #274 · microsoft/durabletask-java · GitHub
Open Graph Title: Wrap gRPC StatusRuntimeException across all client and worker gRPC calls · Issue #274 · microsoft/durabletask-java
X Title: Wrap gRPC StatusRuntimeException across all client and worker gRPC calls · Issue #274 · microsoft/durabletask-java
Description: Summary Most gRPC calls in the Java SDK let raw io.grpc.StatusRuntimeException escape to callers. The .NET SDK wraps RpcException (at minimum StatusCode.Cancelled → OperationCanceledException) for all entity client methods. The Java SDK ...
Open Graph Description: Summary Most gRPC calls in the Java SDK let raw io.grpc.StatusRuntimeException escape to callers. The .NET SDK wraps RpcException (at minimum StatusCode.Cancelled → OperationCanceledException) for ...
X Description: Summary Most gRPC calls in the Java SDK let raw io.grpc.StatusRuntimeException escape to callers. The .NET SDK wraps RpcException (at minimum StatusCode.Cancelled → OperationCanceledException) for ...
Opengraph URL: https://github.com/microsoft/durabletask-java/issues/274
X: @github
Domain: github.com
{"@context":"https://schema.org","@type":"DiscussionForumPosting","headline":"Wrap gRPC StatusRuntimeException across all client and worker gRPC calls","articleBody":"## Summary\n\nMost gRPC calls in the Java SDK let raw `io.grpc.StatusRuntimeException` escape to callers. The .NET SDK wraps `RpcException` (at minimum `StatusCode.Cancelled` → `OperationCanceledException`) for all entity client methods. The Java SDK should provide consistent domain-level exception wrapping so callers don't need to depend on gRPC types and so we can have .NET feature parity.\n\n## Current Behavior\n\nThe majority of gRPC methods across `DurableTaskGrpcClient`, `GrpcDurableEntityClient`, and `DurableTaskGrpcWorker` let `StatusRuntimeException` propagate unwrapped:\n\n**`DurableTaskGrpcClient` — no wrapping:**\n- `suspendInstance()`\n- `resumeInstance()`\n- `terminate()`\n- `raiseEvent()`\n- `createInstanceWithRaise()`\n- `getInstanceMetadata()`\n\n**`DurableTaskGrpcClient` — wraps specific codes only:**\n- `waitForInstanceStart()` — `DEADLINE_EXCEEDED` → `TimeoutException`\n- `waitForInstanceCompletion()` — `DEADLINE_EXCEEDED` → `TimeoutException`\n- `purgeInstances()` — `DEADLINE_EXCEEDED` → `TimeoutException`\n- `rewindInstance()` — `NOT_FOUND` → `IllegalArgumentException`, `FAILED_PRECONDITION` → `IllegalStateException`\n\n**`GrpcDurableEntityClient` — no wrapping:**\n- `signalEntity()`\n- `getEntityMetadata()`\n- `queryEntities()`\n- `cleanEntityStorage()`\n\n**`DurableTaskGrpcWorker` — no wrapping:**\n- `completeActivityTask()`\n- `completeOrchestratorTask()`\n- `completeEntityTask()`\n\n## Expected Behavior\n\ngRPC transport exceptions should be translated into SDK-level exceptions. At minimum:\n- `CANCELLED` → `CancellationException` (closest Java equivalent to .NET's `OperationCanceledException`)\n- `NOT_FOUND` → `IllegalArgumentException` or a dedicated not-found exception\n- `DEADLINE_EXCEEDED` → `TimeoutException` (already done for some methods)\n\n## .NET SDK Reference\n\nThe .NET `GrpcDurableEntityClient` wraps `RpcException` for every entity method:\n\n```csharp\ncatch (RpcException e) when (e.StatusCode == StatusCode.Cancelled)\n{\n throw new OperationCanceledException(\n $\"The {nameof(this.SignalEntityAsync)} operation was canceled.\", e, cancellation);\n}","author":{"url":"https://github.com/bachuv","@type":"Person","name":"bachuv"},"datePublished":"2026-03-25T23:13:38Z","url":"https://github.com/microsoft/durabletask-java/issues/274"}
| react-profiling | 0 |
| react-import-map | react,react-dom,react-dom/client,react-dom/profiling,react-is,react/compiler-runtime,react/jsx-dev-runtime,react/jsx-runtime,scheduler@b8488ee2c322 |
| route-pattern | /_view_fragments/issues/show/:user_id/:repository/:id/issue_layout(.:format) |
| route-controller | voltron_issues_fragments |
| route-action | issue_layout |
| fetch-nonce | v2:01013b98-8462-9553-ea8d-3807654c985c |
| current-catalog-service-hash | 81bb79d38c15960b92d99bca9288a9108c7a47b18f2423d0f6438c5b7bcd2114 |
| request-id | B5C4:39556A:58617:749AF:6AFE31C5 |
| html-safe-nonce | de37010f4a106953ec9ee39839b3fb5468e219573042c0229efa9afaf63704e5 |
| visitor-payload | eyJyZWZlcnJlciI6IiIsInJlcXVlc3RfaWQiOiJCNUM0OjM5NTU2QTo1ODYxNzo3NDlBRjo2QUZFMzFDNSIsInZpc2l0b3JfaWQiOiIyMzYzNTI3MjM0OTk3NTk2NjEzIiwicmVnaW9uX2VkZ2UiOiJpYWQiLCJyZWdpb25fcmVuZGVyIjoiaWFkIn0= |
| visitor-hmac | b74c3d1792647eacc8289899662e1512743fb5607d7f7b4ff4982b134cddf751 |
| hovercard-subject-tag | issue:4139193804 |
| github-keyboard-shortcuts | repository,issues,copilot |
| google-site-verification | Apib7-x98H0j5cPqHWwSMm6dNU4GmODRoqxLiDzdx9I |
| octolytics-url | https://collector.github.com/github/collect |
| analytics-location | / |
| fb:app_id | 1401488693436528 |
| apple-itunes-app | app-id=1477376905, app-argument=https://github.com/_view_fragments/issues/show/microsoft/durabletask-java/274/issue_layout |
| twitter:image | https://opengraph.githubassets.com/6de579379125406f1bef7ee9553bb4610e566b3e57ee8e9726cc8ef772aeefbf/microsoft/durabletask-java/issues/274 |
| twitter:card | summary_large_image |
| og:image | https://opengraph.githubassets.com/6de579379125406f1bef7ee9553bb4610e566b3e57ee8e9726cc8ef772aeefbf/microsoft/durabletask-java/issues/274 |
| og:image:alt | Summary Most gRPC calls in the Java SDK let raw io.grpc.StatusRuntimeException escape to callers. The .NET SDK wraps RpcException (at minimum StatusCode.Cancelled → OperationCanceledException) for ... |
| og:image:width | 1200 |
| og:image:height | 600 |
| og:site_name | GitHub |
| og:type | object |
| og:author:username | bachuv |
| hostname | github.com |
| expected-hostname | github.com |
| None | d70e31220a67f6376c108d2416fa8e7df854c1065b1672ab7a88ab6dc3a809e2 |
| turbo-cache-control | no-preview |
| go-import | github.com/microsoft/durabletask-java git https://github.com/microsoft/durabletask-java.git |
| octolytics-dimension-user_id | 6154722 |
| octolytics-dimension-user_login | microsoft |
| octolytics-dimension-repository_id | 452823832 |
| octolytics-dimension-repository_nwo | microsoft/durabletask-java |
| octolytics-dimension-repository_public | true |
| octolytics-dimension-repository_is_fork | false |
| octolytics-dimension-repository_network_root_id | 452823832 |
| octolytics-dimension-repository_network_root_nwo | microsoft/durabletask-java |
| turbo-body-classes | logged-out env-production page-responsive |
| disable-turbo | false |
| browser-stats-url | https://api.github.com/_private/browser/stats |
| browser-errors-url | https://api.github.com/_private/browser/errors |
| release | ccb88d9c92abe69245b429398c8a57ae87070c7c |
| ui-target | full |
| theme-color | #1e2327 |
| color-scheme | light dark |
| react-app-name | issues |
Links:
Viewport: width=device-width