通过REST（RESTful）API进行批量收集操作

6 回答

• 61

  您可能希望将更改任务视为资源本身 . 所以你真的要投入一个对象，这是一个批量数据更新对象 . 也许它有一个名称，所有者，以及需要解析和执行的大量CSV，XML等 . 对于CSV，您可能还想确定CSV数据中表示的对象类型 .

  列出作业，添加作业，查看作业状态，更新作业（可能是为了启动/停止它），删除作业（如果正在运行则停止作业）等 . 这些操作可以轻松映射到REST API设计 .

  完成此操作后，您可以轻松添加批量数据更新程序可以处理的不同数据类型，甚至可以在同一任务中混合使用 . 换句话说，对于要导入的每种类型的东西，不需要在整个应用程序中复制相同的API .

  这也很容易适用于后台任务实现 . 在这种情况下，您可能希望向各个任务对象添加字段，以允许API客户端指定他们希望如何通知他们（他们希望您在完成时获取的URL，或向他们发送电子邮件等） .

  回复于 2024-05-08T06:53:06+08:00
• 2

  是的，PUT创建/覆盖，但不会部分更新 .

  如果需要部分更新语义，请使用PATCH . 见http://greenbytes.de/tech/webdav/draft-dusseault-http-patch-14.html .

  回复于 2024-05-08T06:53:06+08:00
• 1

  你应该使用AtomPub . 它专门用于通过HTTP管理集合 . 甚至可能有您选择的语言的实现 .

  回复于 2024-05-08T06:53:06+08:00
• 0

  对于POST，至少，您似乎应该能够POST到列表URL并让请求的主体包含新资源列表而不是单个新资源 .

  回复于 2024-05-08T06:53:06+08:00
• 2

  据我所知，REST表示REpresentational State Transfer，因此您应该将状态从客户端转移到服务器 .

  如果这意味着来回传递太多数据，您可能需要更改您的表示 . 一个collectionChange结构可以工作，有一系列删除（通过id）和添加（带有嵌入的完整xml表示），POST到处理接口URL . 接口实现可以选择自己的删除方法和服务器端添加方法 .

  最纯粹的版本可能是按URL定义项目，集合包含一系列URL . 新的集合可以在客户端更改后进行PUT，然后是一系列正在添加的项目的PUT，如果您想要从服务器中实际删除项目而不是仅从该列表中删除它们，则可能会进行一系列删除 .

  回复于 2024-05-08T06:53:06+08:00
• 9

  您可以引入现有集合元素的元表示，这些元素不需要传输整个状态，因此在某些抽象代码中，您的更新可能如下所示：

  {existing elements 1-100}
  {new element foo with values "bar", "baz"}
  {existing element 105}
  {new element foobar with values "bar", "foo"}
  {existing elements 110-200}
  

  添加（和修改）元素是通过定义它们的值来完成的，删除元素是通过不提及新集合来完成的，并且通过指定新订单（如果订单完全存储）来完成重新排序元素 .

  这样，您可以轻松地表示整个新集合，而无需重新传输整个内容 . 使用 If-Unmodified-Since 标头确保您对内容的想法确实存在匹配服务器的想法（这样你就不知道提交请求的时间） .

  回复于 2024-05-08T06:53:06+08:00