什么是 RESTful API
RESTful API 是一种设计风格，用于构建现代 Web 应用程序。它是基于 HTTP 协议而设计的，包括 HTTP 动词 GET、POST、PUT 和 DELETE。
在 RESTful API 中，每个 URL 都代表着一个资源，并且使用 HTTP 动词来定义操作，例如 GET（获取资源）、POST（创建资源）、PUT（更新资源）和 DELETE（删除资源）。
RESTful API 是一种简单灵活、易于扩展的编程模型，通常用于创建用于 Web 应用程序的后端服务。
什么是数据分页
在 Web 应用程序中，通常需要从数据库中获取大量数据，并将其呈现在前端页面上。如果一次性返回所有数据，会导致页面加载缓慢，甚至崩溃。
为此，我们需要将数据分页，每次只返回一定数量的数据。这样可以减轻服务器负担，提高页面加载速度，并提高用户体验。
数据分页通常通过 API 请求参数来实现，其中包括：
- page：当前页数
- per_page：每页数量
在 RESTful API 中，数据分页可以使用 HTTP 头部信息（Header）、请求参数（Query Parameter）和响应内容（Response Body）来实现。
HTTP 头部信息
使用 HTTP 头部信息来实现数据分页，通常使用 Range 和 Content-Range 头部。
- Range：请求头部，指定返回数据的范围。格式为 bytes=start-end，例如：Range: bytes=0-999。
- Content-Range：响应头部，指定服务器返回数据的范围。格式为 bytes start-end/total，例如：Content-Range: bytes 0-999/5000。
使用 HTTP 头部信息的优点在于，可以将数据范围信息以二进制形式直接返回给客户端。这样客户端就可以根据数据范围来处理分页操作，而无需单独的请求参数或响应内容。
请求参数
使用请求参数来实现数据分页，通常使用 page 和 per_page 参数。
- page：当前页数，默认为 1。
- per_page：每页数量，默认为 20。
这种方式的好处在于，请求参数简单易用，客户端可以根据自己的需要来调整分页参数。缺点是需要进行多次请求，才能获取到完整的数据。
响应内容
使用响应内容来实现数据分页，通常使用一个包含全部数据的数组，以及当前页数和每页数量等信息。
例如，下面是一个返回数据的 JSON 结构体：
-- -------------------- ---- -------
-
-------- -----
------- --
----------- ---
------- -
- ----- -- ------- ------- --
- ----- -- ------- -------- --
- ----- -- ------- -------- --
---
-
-其中，total 表示数据总数，page 表示当前页数，per_page 表示每页数量。data 数组包含了当前页的数据。
示例代码
下面是一个简单的 Node.js RESTful API 示例，用于获取用户列表并进行分页操作：
-- -------------------- ---- -------
----- ------- - -------------------
----- --- - ----------
----- ---- - ---------------- -- -----
-- ----
----- ----- - -
- --- -- ----- ------- --
- --- -- ----- ----- --
- --- -- ----- --------- --
-- ---
--
-- ------
--------------------- ----- ---- ----- -- -
-- --
----- ---- - ------------------------ -- --
-- ----
----- ------- - ---------------------------- -- ---
-- ---------
----- ----- - ----- - -- - --------
----- --- - ----- - --------
-- ------
----- ---------- - ------------------ -----
-- ----
----------
------ -------------
-----
--------- --------
----- ----------
---
---
-- -----
---------------- -- -- -
------------------- --------- -- ----------
---此示例使用请求参数来实现数据分页，当没有指定 page 和 per_page 参数时，默认使用常量值。
总结
在 RESTful API 中，数据分页可以通过多种方式来实现，包括 HTTP 头部信息、请求参数和响应内容等。
客户端可以根据自己的需要来发起分页请求，并根据服务器返回的数据范围来对数据进行处理。
良好的数据分页设计能够减少服务器负担，提高页面加载速度，并提高用户体验。
来源：JavaScript中文网 ，转载请注明来源 https://www.javascriptcn.com/post/646c8b66968c7c53b0b819ae