问REST:如何创建依赖于三种或三种以上不同类型的资源的资源？

EN

RESTful、超文本驱动系统需要使客户端能够创建依赖于三种或三种以上不同类型的资源的新资源。公开此功能的最佳方法是什么？

举个例子，假设我经营一家网上商店。服务器知道四个资源：

• 订单:将装运的产品组。有一批货
• 目的地:要运送到的地点。有很多货
• 装运:向客户发送产品的行为。属于目的地、订单和封隔器
• 包装工:雇员亲自准备装船订单。有很多货

当订单发出时，客户端需要通过在服务器上创建一个新货件来记录此事件。这批货物将需要对目的地、订单和包装的参考。

为了实现新发货的创建，我可以想到三种方法，但我不喜欢它们中的任何一种：

1. 使用托运媒体类型将邮件发送到/shipments。托运媒体类型有三个字段：“order_uri”、“packer_uri”和"destination_uri“。每个URI分别用作装运中涉及的订单、封隔器和目的地的唯一标识符。
2. 使用托运媒体类型将邮件发送到/orders/{order_id}/packers/{packer_id}/destinations/{destination_id}/shipments。
3. 向系统添加一个名为"ShipmentBuilder“的新资源。使用包含在/shipment_builders媒体类型中的"packer_uri“、"destination_uri”和"order_uri“发送到ShipmentBuilder。

我不喜欢选项1，因为装运媒体类型还定义了指向订单、封隔器和目的地的链接。在这里，"link“是一个JSON散列，由一个人类可读的名称、一个URI和一个媒体类型组成。在媒体类型中添加"order_uri“、"packer_uri”和"destination_uri“似乎不太枯燥，因为它重复了相关资源的URI。

选项2使用了深度嵌套的URI，它既不能很好地维护，也不能捕获任何有意义的层次信息。

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

如果一批货物只依赖于另一种资源，那么选项2就更有意义了，但在这种情况下就不是了。就目前情况而言，我赞成备选案文3，但更倾向于更好的选择。

在本例中，创建新托运的URI和媒体类型的最佳组合是什么？还应考虑采取哪些其他办法？

更新:下面是装运资源的JSON示例表示，显示订单、封隔器和目的地的链接。选项1所要求的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_at“字段)的内容将得到POSTed。使用GET时，将发送上述完整的货件表示。