Hacktoberfest 2026：维护者为十月标记出来的 issue，仍然开放、适合新手。 浏览 Hacktoberfest issue

[Feature]: Custom subtype for step, callback, and child context operations

未关闭
  • 哪里不对？
#757 0 条评论 0 个 reaction 已指派 0 人 在 GitHub 查看

维护者通常 1 天内回复

还没有人认领这个 Issue。

评估

难度
4/5
预计耗时
3-5 天
新手友好度
55/100
Issue 类型
功能
描述清晰度
描述清楚
活跃度
活跃
技术栈
java
领域
backend-api-design

调研方向

Start with the StepConfig, CallbackConfig, and RunInChildContextConfig builders, then trace OperationIdentifier through checkpoint updates, replay validation, OperationInfo, and PluginInfoConverter. Implement optional subtype propagation and validation while preserving existing defaults, and verify that custom values appear consistently in execution history and plugin information. Check the sdk-testing local runner only if that optional validation is included.

由索引模型根据 Issue 内容生成。

描述

enhancement pkg:sdk
What would you like?

Let a caller set a custom subtype on a step, a callback, and a child context.

  1. A function can compose several durable operations into one larger operation. #571 proposes a public API for such extension operations.
  2. Every operation records a subtype in its checkpoint. Execution history and plugins read it.
  3. In Java, the subtype always comes from the OperationSubType enum. StepConfig, CallbackConfig, and RunInChildContextConfig have no subtype option. The overload of runInChildContextAsync that takes a subtype is private.
  4. So the parts of an extension operation all record Step, Callback, or RunInChildContext. History and plugins can tell them apart only by parsing their names.

The JS SDK supports this today: ChildConfig.subType, and since aws/aws-durable-execution-sdk-js#939, StepConfig.subType and CreateCallbackConfig.subType. The Go SDK has WithChildSubType.

Possible Implementation
  1. Add an optional subType(String) to the builders of StepConfig, CallbackConfig, and RunInChildContextConfig.
  2. OperationIdentifier holds an OperationSubType, and derives the operation type from it. A custom subtype is a string with no enum value. So the identifier needs the operation type and the subtype string as separate fields. The enum stays as the source of the default subtypes.
  3. Use the custom subtype everywhere the default is used today: checkpoint updates, replay validation, and plugin info (OperationInfo and the classes built by PluginInfoConverter).
  4. Validate the value before the operation is created:
    • A null or empty value selects the default.
    • The service accepts 1 to 32 characters from [a-zA-Z0-9-_]. It rejects any other subtype with HTTP 400 ValidationException, and the execution then fails. So the SDK should reject such a value with a clear error.
    • Optionally reject the values the SDK uses for its own operations, as the Go SDK does.
  5. Optionally, make the local runner in sdk-testing reject an invalid subtype with the service's message, as the JS testing SDK does since aws/aws-durable-execution-sdk-js#939.

Nothing in the SDK decides how to suspend or retry from the subtype. So no other logic needs to change.

Is this a breaking change?

No. Without the option, the SDK records the same subtypes as today. The OperationIdentifier change in step 2 touches internal types only.

Does this require an RFC?

No.

Additional Context
  • Replay compares the subtype with the checkpoint. So changing a subtype is a breaking change for executions in flight. The option's Javadoc should say this.
  • #396 added fixed subtypes to every operation. This issue adds caller-chosen ones on top.
主要语言
Java
星标
28
派生
15
平均合并
1 天 13 小时
30 天内合并 PR
41

环境准备

从这里开始

  1. 先读完整个 Issue，再读项目的贡献指南。
  2. 在 Issue 下留言说明你要接手 —— 这能避免两个人做同样的事。
  3. Fork 仓库，在一个分支上完成修改。
  4. 提交 Pull Request，并在描述里引用这个 Issue 编号。

aws/aws-durable-execution-sdk-java 的其他 Issue

查看 aws/aws-durable-execution-sdk-java 的全部 Issue

相似的 Issue

更多 Java Issue

把新 issue 发到你的邮箱

精选适合新手参与的 GitHub issue 摘要。