REST架构与实现

最新推荐文章于 2025-11-19 13:34:52 发布

原创

最新推荐文章于 2025-11-19 13:34:52 发布 · 1k 阅读

5 ·

CC 4.0 BY-SA版权

文章标签：

#架构 #restful #webapi

一、REST 架构风格

基本概念
- REST（Representational State Transfer），即表述性状态转移，是一种软件架构风格。它通过使用标准的 HTTP 方法操作网络上的资源来实现信息交互。在 REST 架构风格中，网络上的一切都被抽象成资源，例如，在一个在线购物系统中，商品、订单、用户信息等都是资源。
核心元素
- 资源（Resource）：是 REST 架构中的核心概念，是可被标识的任何事物。如上述购物系统中的商品就是资源，它可能被赋予一个唯一的标识，如 “/products/123”，其中 “123” 可以是的 ID。
- 资源标识符（Resource Identifier）：通常以 URI（Uniform Resource Identifier）的形式呈现，用于唯一地标识资源。例如，在一个新闻网站中，一篇新闻文章的 URI 可能是 “/news/articles/456”，通过这个 URI 就能定位到特定的新闻资源。
- 表述（Representation）：资源的具体表现形式，一般采用常见的数据格式，如 JSON、XML 等。例如，当客户端请求获取一个商品资源时，服务器可能以 JSON 格式返回该商品的详细信息，包括价格、名称、描述等，这个 JSON 数据就是商品资源的一种表述。
- 状态转移（State Transfer）：客户端通过与服务器交互来改变资源的状态。这种交互是通过 HTTP 方法来实现的，比如，使用 POST 方法创建一个新的订单资源，使用 PUT 方法更新一个已存在的商品资源的信息。

二、REST 架构风格的原则

无状态（Statelessness）
- 服务器不保存客户端的状态信息。每一次请求都必须包含足够的信息让服务器理解请求。例如，在用户登录后浏览商品的场景中，服务器不会记住用户当前浏览的是第几页商品，每次用户请求获取下一页商品时，都要在请求中明确地传递相关参数（如页码等）。
统一接口（Uniform Interface）
- 使用标准的 HTTP 方法来操作资源。
  - GET 方法：用于获取资源。例如，在一个图书馆管理系统中，使用 GET 方法访问 “/books” 可以获取所有图书的列表，访问 “/books/789” 可以获取 ID 为 789 的图书的详细信息。
  - POST 方法：用于创建资源。比如，向 “/books” 发送 POST 请求，并在请求体中包含图书的信息（如书名、作者等），可以在系统中创建一本新书。
  - PUT 方法：用于更新整个资源。如果要更新 ID 为 789 的图书的所有信息，就可以向 “/books/789” 发送 PUT 请求，并在请求体中包含更新后的图书信息。
  - PAT