REST web应用程序中的分页

这是这个问题的一个更通用的重新表述(消除了Rails特定的部分)

我不确定如何在RESTful web应用程序中实现资源分页。假设我有一个叫做产品的资源，你认为以下哪一个是最好的方法，为什么:

1. 只使用查询字符串

如。http://application/products?page=2&sort_by=date&sort_how=asc 这里的问题是，我不能使用全页缓存，而且URL不是很干净，容易记住。

2. 使用页面作为资源和查询字符串进行排序

如。http://application/products/page/2?sort_by=date&sort_how=asc 在这种情况下，我们看到的问题是http://application/products/pages/1不是唯一的资源，因为使用sort_by=price可以产生完全不同的结果，我仍然不能使用页面缓存。

3.使用页面作为资源，并使用URL段进行排序

如。http://application/products/by-date/page/2 我个人认为使用这种方法没有问题，但有人警告我这不是一个好的方法(他没有给出理由，所以如果你知道为什么不推荐，请告诉我)

任何建议，意见，批评都是非常欢迎的。谢谢。

当前回答

我以前用过解决方案3(我写了很多django应用程序)。我不认为这有什么问题。它就像其他两个一样可生成(以防你需要做一些大规模的刮擦或类似的事情)，它看起来更干净。另外，你的用户可以猜网址(如果它是一个面向公众的应用程序)，人们喜欢能够直接去他们想去的地方，猜网址感觉很强大。

2009-04-22 11:41:57

其他回答

HTTP有很好的范围头，也适合分页。你可以发送

Range: pages=1

只有第一页。这可能会迫使您重新考虑什么是页面。也许客户想要不同范围的产品。Range头也可以用于声明订单:

Range: products-by-date=2009_03_27-

让所有的产品更新日期或

Range: products-by-date=0-2009_11_30

让所有的产品都比这个日期更老。'0'可能不是最好的解决方案，但RFC似乎想要一些范围开始。可能部署的HTTP解析器不会解析units=-range_end。

如果标题不是一个(可接受的)选项，我认为第一个解决方案(所有在查询字符串)是一种处理页面的方式。但是，请规范化查询字符串(按字母顺序排序(键=值)对)。这就解决了?A =1&b=x" and "?B =x&a=1"的微分问题。

2009-12-04 19:55:40

2009-04-22 11:41:57

我同意Fionn的观点，但我还要进一步说明，对我来说Page不是资源，而是请求的属性。这使得我只选择选项1查询字符串。感觉很好。我真的很喜欢Twitter API的结构。不太简单，也不太复杂，有很好的文档。无论是好是坏，这是我的“go to”设计，当我在做某件事的一种方式和另一种方式之间犹豫不决时。

2009-04-22 11:14:14

我更喜欢使用查询参数offset和limit。

偏移量:用于集合中项目的索引。

限制:为项目的数量。

客户端可以简单地继续更新偏移量，如下所示