json - Http API 响应 : List Vs Map

Question

我有一个 Price 对象，它包含一个唯一的 Item Id、Mrp、Discount、卖家价格。

有一个公开的 Http Api，给定项目 ID 列表返回它们的数据。现在有两种方法可以做到这一点。例如:如果某人对 A,B,C 执行 GET，则响应:

方法 1:返回价格对象列表:

[
    { "ItemId" : "A",
      "Mrp" : 55.0,
      "Discount" : 0.0,
      "Seller Price" : 55.0
    },
    { "ItemId" : "B",
      "Mrp" : 100.0,
      "Discount" : 10.0,
      "Seller Price" : 90.0
    },
    { "ItemId" : "C",
      "Mrp" : 75.0,
      "Discount" : 0.0,
      "Seller Price" : 75.0
    }
]

方法 2:返回价格对象的映射:

{
    "A" :{ "ItemId" : "A",
           "Mrp" : 55.0,
           "Discount" : 0.0,
           "Seller Price" : 55.0
         },
    "B" :{ "ItemId" : "B",
           "Mrp" : 100.0,
           "Discount" : 10.0,
           "Seller Price" : 90.0
         },
    "C" :{ "ItemId" : "C",
           "Mrp" : 75.0,
           "Discount" : 0.0,
           "Seller Price" : 75.0
         }
}

方法 2 优于方法 1 的一个优势是它为客户端提供了迭代和查找的灵 active ，但代价是额外的数据通过网络传输。现在我不想从实体内部移出 Item Id，因为没有它实体就失去了意义，而且客户必须插入 Item Id 来完成对象，然后将它传递给其他一些客户。

这方面的最佳做法是什么。执行此操作的任何其他方法。

由于Api处于设计阶段，任何东西都可以容纳。

谢谢

Answer 1

我不会选择第二个选项，除非有一个明确的用例，客户几乎总是希望立即使用 map 并且我的数据已经是 map 的形式。

对于内部 api，只要您访问一致，它就会成为一个合理的约定，我认为其他开发人员看到它不会感到惊讶。

把列表变成 map 真的不是很难。

除非您在非常不寻常的环境中工作，否则我不会担心通过网络发送额外数据。