24、可重运行作业与单例子资源的API设计解析

可重运行作业与单例子资源的API设计解析

可重运行作业

可重运行作业是一种非常实用的概念，它能有效隔离具备配置任务能力的用户和具备执行相同任务能力的用户。在资源布局方面，执行资源应作为作业资源的子资源存在，因为执行是针对单一作业类型设计和限定范围的，且常见需求是查询特定作业的执行情况。

以下是分析聊天室消息的最终API定义代码：

abstract class ChatRoomApi {
  @post("/analyzeChatRoomJobs")
  CreateAnalyzeChatRoomJob(req: CreateAnalyzeChatRoomJobRequest):
    AnalyzeChatRoomJob;
  @get("/analyzeChatRoomJobs")
  ListAnalyzeChatRoomJobs(req: ListAnalyzeChatRoomJobsRequest):
    ListAnalyzeChatRoomJobsResponse;
  @get("/{id=analyzeChatRoomJobs/*}")
  GetAnalyzeChatRoomJob(req: GetAnalyzeChatRoomJobRequest):
    AnalyzeChatRoomJob;
  @patch("/{resource.id=analyzeChatRoomJobs/*}")
  UpdateAnalyzeChatRoomJob(req: UpdateAnalyzeChatRoomJobRequest):
    AnalyzeChatRoomJob;
  @post