REST:如何创建一个依赖于三个或更多不同类型资源的资源?

宁静的, hypertext-driven

• 订单:要发货的产品组。[有一批货]
• 目的地:发货目的地。[有许多货物]
• 发货:将产品发送给客户的行为。[属于目的地、订单和包装商]
• 包装工:员工实际准备订单进行装运。[有许多货物]

订单发货时,客户端需要通过在服务器上创建新发货来记录此事件。装运需要参考目的地、订单和包装商。

为了实现新发货的创建,我可以想到三种方法,但我不喜欢其中任何一种:

1. 使用发货介质类型发送到/发货。发货介质类型有三个字段:“order\u uri”;“packer_uri”;和“destination_uri”。每个URI分别用作发货中涉及的订单、包装商和目的地的唯一标识符。
2. 使用发货介质类型发送到/orders/{order\u id}/packers/{packer\u id}/destinations/{destination\u id}/ships。
3. 向系统中添加一个名为“ShipmentBuilder”的新资源。使用ShipmentBuilder媒体类型中包含的“packer\u uri”、“destination\u uri”和“order\u uri”将邮件发送到/发货构建器。

我不喜欢选项1,因为发货介质类型额外定义了到订单、包装器和目的地的链接。这里,“链接”是一个JSON哈希,由人类可读的名称、URI和媒体类型组成。将“order\u uri”、“packer\u uri”和“destination\u uri”添加到媒体类型似乎不是很枯燥,因为它复制了相关资源的uri。

选项2使用深度嵌套的URI,这些URI看起来不太可维护,也无法捕获任何有意义的层次信息。

选项3在客户端和发货创建之间放置了另一个抽象级别,这使得系统更难学习。

如果发货只依赖于一种其他资源,那么选项2会更有意义,但在这种情况下就没有了。就目前而言,我支持选项3,但更喜欢更好的。

在本例中,创建新发货的URI和媒体类型的最佳组合是什么?还应考虑哪些其他方法?

{
  "shipment":{
    "created_at": "Wed Sep 09 18:38:31 -0700 2009",
    "order_uri":"http://example.com/orders/815",
    "packer_uri":"http://example.com/packers/42",
    "destination_uri":"http://example.com/destinations/666"
  },
  "order":{
    "name":"the order to which this shipment belongs",
    "uri":"http://example.com/orders/815",
    "media_type":"application/vnd.com.example.store.Order+json"
  },
  "packer":{
    "name":"the person who packed this shipment",
    "uri":"http://example.com/packers/42",
    "media_type":"application/vnd.com.example.store.Packer+json"
  },
  "destination":{
    "name":"the destination of this shipment",
    "uri":"http://example.com/destinations/666",
    "media_type":"application/vnd.com.example.store.Destination+json"
  }
}

“发货”散列的内容(减去“created\u at”字段)将被过账。使用GET时,将发送上面的完整发货表示。