REST API 设计：链接资源

Question

7

假设我有两个顶级资源Foo和Bar。现在Foo需要链接到一些Bar。在Java类中，这可能看起来像这样：

public class Foo {

  Set<Bar> bars;
}

public class Bar { … }

我希望你能帮我将Foo的XML表示形式改成这样：

GET /foos/1

<foo>
  …
  <atom:link rel="self" href="/foos/1" />
  <atom:link rel="bars" href="/foos/1/bars" />
</foo>

因此，我将所有分配给Foo的Bar作为嵌套资源公开。这意味着Bar资源具有独立的生命周期（组合而非聚合）。然后，嵌套的资源可能会公开所有链接的Bar，如下所示：

GET /foos/1/bars

<bars>
  <atom:link rel="bar" href="/foos/1/bars/1" />
  <atom:link rel="bar" href="/foos/1/bars/2" />
</bars>

另一种方法是提前将集合内联到<foo>元素中。但是我仍然有一些问题:虽然这使我可以通过触发对例如/foos/1/bars/1的DELETE请求来很好地从Foo中删除一个Bar，但如何将一个Bar分配给一个Foo呢？假设客户端访问/bars得到:

GET /bars

<bars>
  <bar>
    …
    <atom:link rel="self" href="/bars/4711" />
  </bar>
</bars>

决定将/bars/1 分配到 /foo/1/bars。我考虑使用POST 请求 /foo/1/bars，但不确定实际提交什么内容。例如下面的指向 Bar 资源的link元素？

POST /foos/1/bars

<atom:link href="/bars/4711" />

这似乎还可以，因为客户端不需要创建URL，同时我们仍然满足REST约束条件。但是，将链接POST到服务器感觉有点奇怪。是否有更好的解决方案呢？

- Oliver Drotbohm

1

我毫不犹豫地会POST一个链接来建立两个资源之间的关系。有些人认为你应该检索资源，然后将其POST以实现自描述，但我并不认为这是必要的。 - Darrel Miller

这也是我感觉到的，因为你 a) 创建了不必要的聊天气氛，b) 实际上并不需要在服务器端使用整个表示来创建链接。 - Oliver Drotbohm

1个回答

网页内容由stack overflow 提供, 点击上面的

可以查看英文原文，
原文链接

- djna · Accepted Answer

我认为这个问题应该从服务器理解的资源角度出发，而不是仅仅从XML表示角度来看（例如）GET请求响应时返回的内容。我的RESTful服务可以返回JSON或XML，也可能返回其他格式。

所以，我同意您的POST或PUT请求。

 /foos/{fooId}/bars

要么指定完整的酒吧列表，要么添加一些酒吧。

发布负载的格式可以是您使用的媒体类型的自然序列化形式。在我的情况下，它通常是一个JSON字符串，因此在我的服务实现中，我会反序列化并查看资源引用URL字符串数组。

如果您的

<atom:link href="/bars/4711" />

如果反序列化后能够漂亮地呈现，那么即使序列化形式有点“装饰性”，也不应该成为问题。

总结：按照你的（反）序列化器自然的方式去处理即可。