本文为稀土技能社区首发签约文章，30天内制止转载，30天后未获授权制止转载，侵权必究！

背景介绍

在微服务架构的演进进程中，咱们不难发现，服务间的调用办法正悄然发生革新，逐渐从传统的RPC调用向HTTP调用过渡。在日常工作中，经常听闻搭档提及为其他体系供给微服务并暴露Restful接口。但是，关于许多初学者来说，RESTful接口这一概念仍显得含糊，其与REST的联系更是令人费解。

问题分析

为了深化大家对Rest和Restful架构的了解，咱们精心策划了一系列问题，旨在为大家供给一个更具针对性和目的性的学习途径，希望这些问题能够引导您更有用地探索本篇文章的精华。

作者引荐 | 一文深度解读 — 彻底知道与了解微服务技能之Rest与Restful架构精华

Rest

Rest，本质上是一种架构范式，而非某种特定的协议。它更像是一座灯塔，为构建稳健体系的航行者指明方向。

跟着Web技能的不断发展，REST架构已经成为了构建分布式体系的一种主流办法。它以其简练、明晰和可扩展的特性，赢得了广大开发者的喜爱。经过REST，咱们能够愈加灵敏地规划体系，完成客户端和服务器之间的松耦合，进步体系的可保护性和可扩展性。

Rest界说

Rest，其全称是Representational State Transfer，咱们能够将其视为“资源状况转化”。在分布式体系的规划中，Rest以其共同的架构办法占有了一席之地，这一理念的开创者Roy Fielding，在博士论文中首次提出了这一思维。

Rest协议

Rest一种关于怎么构建高效、可靠、可扩展的分布式体系的思考办法，它鼓舞咱们重视资源的状况变化，并经过HTTP等协议进行状况转化。这种转化进程中，资源的表征（如JSON、XML等格局）扮演着重要人物，使得客户端和服务器之间的通讯变得明晰和高效。

Rest和Restful API

在了解了REST之后，咱们自然会进一步思考：REST与RESTful API之间终究有何种千丝万缕的联络？为了解答这个问题，咱们首先要明确API的界说以及Restful API的内涵。

API

API，即运用程序接口，它充当着不同软件组件间交互的桥梁，使得各种服务能够无缝衔接，完成数据的同享与功用的集成。作为服务与服务之间、客户端与服务端之间沟通的桥梁，扮演着至关重要的人物。

作者引荐 | 一文深度解读 — 彻底知道与了解微服务技能之Rest与Restful架构精华
经过API的调用，能够快捷地从服务器获取所需的资源信息。当咱们谈及RESTful API时，咱们实际上是指那些严厉遵从REST架构准则的API。

Restful API

Restful API，则是依据Rest（Representational State Transfer，表述性状况搬运）架构风格规划的API，它着重资源的内容、状况的搬运以及客户端与服务端之间的无状况通讯。其规划准则使得网络服务愈加简练、明晰和易于了解，然后提高了网络运用的交互性和可保护性。

留意，并非一切选用HTTP协议的API都能够被称作RESTful API。这一称谓的前提是，你的体系必须是依据REST架构构建的。只要契合REST架构理念的API，才能真正称之为RESTful API。因而，RESTful API不只是一个技能标签，更是对体系规划和完成办法的一种认可和必定。

Restful API特色和优势

Restful API具有6大中心特质，它们共同构筑Rest架构的精华与优势。让咱们一起深入分析这些特质，以便全面地知道Rest架构的魅力所在。

作者引荐 | 一文深度解读 — 彻底知道与了解微服务技能之Rest与Restful架构精华

一致资源标识符（Uniform interface）

Restful体系高度重视资源的明确标识与快捷拜访，每一个资源都享有其独一无二的URI（一致资源标识符），这保证了资源在体系中的可寻址性和可拜访性。

作者引荐 | 一文深度解读 — 彻底知道与了解微服务技能之Rest与Restful架构精华

在上图中的每一个服务端内部的小方块无疑是最为要害的元素。咱们将资源视作一个个独立的实体，并为它们分配了共同的URI。这种规划使得每一个资源都能经过一个独立且仅有的URI进行表明，然后完成了资源的准确定位与高效拜访。

Restful恳求处理

经过URI，咱们能够轻松地识别、定位和操作资源，不管是进行数据的读取、更新仍是删去等操作，都能经过相应的URI来完成。这种规划办法使得Restful体系能够愈加灵敏地应对各种事务场景，为用户供给愈加快捷、高效的服务。

作者引荐 | 一文深度解读 — 彻底知道与了解微服务技能之Rest与Restful架构精华
单个的资源不能太大也不能太小，它表明的是一个独立的能够操作的单位。这些资源经过通用的获取办法来进行获取和操作。比如对资源的CURD能够别离用不同的HTTP method来表明（PUT，POST，GET，DELETE）。

Restful资源操作

在REST架构中，PUT、POST、GET和DELETE是四种常见的HTTP办法，它们各自具有特定的运用含义和适用场景，同时需要对资源进行一致的命名，界说一致的link格局和数据格局。

作者引荐 | 一文深度解读 — 彻底知道与了解微服务技能之Rest与Restful架构精华

PUT办法

PUT办法用于更新资源，它是幂等的，即屡次履行PUT操作具有相同的效果。

当需要彻底替换或更新某个资源时，能够运用PUT办法。例如，在更新用户信息时，能够运用PUT办法将新的用户信息发送到服务器，服务器将用新的信息替换原有的用户资源。

POST办法

POST办法用于创立新的资源，它对错幂等的，即屡次履行POST操作将导致多个资源的创立。

当需要在服务器上创立新的资源时，能够运用POST办法。例如，在创立新用户时，能够运用POST办法将用户信息发送到服务器，服务器将依据这些信息创立新的用户资源。此外，POST办法也能够用于提交表单数据或上传文件等操作。

GET办法

GET办法用于从服务器获取资源，它是安全的和幂等的，即不管履行多少次GET操作，都不会对资源形成任何影响，成果始终相同。

当需要从服务器获取数据时，能够运用GET办法。例如，在查询用户列表或获取文章详情时，能够经过GET办法发送恳求到服务器，服务器将回来相应的资源数据。

DELETE办法

DELETE办法用于删去资源，它也是安全的和幂等的，即不管履行多少次DELETE操作，成果都是相同的，即删去指定的资源。

当需要删去服务器上的某个资源时，能够运用DELETE办法。例如，在删去用户或文章时，能够运用DELETE办法发送恳求到服务器，服务器将删去指定的用户或文章资源。

客户端/服务端责任别离

在上面已经提到了，在Restful服务中，客户端与服务器端各自独立运转，责任别离，相互之间的仅有桥梁就是经过API进行交互。

  • 客户端：无需深入了解服务器端的完成细节，只需经过API调用获取所需的资源。
  • 服务端：无需重视客户端怎么运用这些API，只需保证接口的稳定性和可用性。

这一准则在当时很多前后端别离的架构中得到了广泛运用，完成了客户端与服务器端的解耦，进步了体系的灵敏性和可保护性。

无状况化处理

在Restful服务中，API调用与HTTP协议一样，均遵从无状况准则。这意味着服务器在处理恳求时，不会保留API调用的历史记载，也不会存储任何关于客户端的特定信息。从服务器的视角来看，每个恳求都是全新且独立的。

作者引荐 | 一文深度解读 — 彻底知道与了解微服务技能之Rest与Restful架构精华
因而，用户的状况信息被规划为在客户端进行管理和保护。为了保证服务器能够准确识别并认证用户，客户端在发起每个接口恳求时，都需要带着能够仅有标识用户的符号。

可缓存的资源

缓存作为提高体系功能的要害手法，在Restful服务中同样发挥着不可或缺的效果。关于Rest中的可缓存资源，明确标识其可缓存性至关重要。

作者引荐 | 一文深度解读 — 彻底知道与了解微服务技能之Rest与Restful架构精华
经过这一标识，相关的调用方能够将这些资源进行有用缓存，进而明显进步体系的运转功率，这种缓存机制不只减少了不必要的网络恳求，还降低了服务器的负载压力，然后为用户带来愈加流通和高效的体验。

分层架构方法

在现今的体系中，分层规划已成为一种遍及实践，Restful服务亦不例外。只要保证对外供给的资源URI保持一致性，架构本身并不局限于特定层数的构建办法。

作者引荐 | 一文深度解读 — 彻底知道与了解微服务技能之Rest与Restful架构精华

编码和解码

在Restful服务中，各个服务间的交互一般依赖于JSON或XML这类数据格局。在数据传输的进程中，为保证数据的完整性和安全性，客户端与服务端均须精心规划编码与解码操作。这一环节至关重要，它不只能够保证数据在传输进程中的准确性，还能有用抵挡潜在的安全要挟，为整个通讯进程供给坚实的保障。

作者引荐 | 一文深度解读 — 彻底知道与了解微服务技能之Rest与Restful架构精华
经过这一规划，咱们能够构建一个愈加稳健、安全的数据传输环境，提高体系的整体功能与可靠性。

Restful API获取资源

Restful服务中，资源的位置无足轻重，其中心理念与运作机制皆围绕资源打开。那么，终究何为资源？怎么为其命名并作出精准界说？接下来，让咱们共同探寻这其间的奥妙。

资源的界说

资源是信息的载体，是对信息的中心笼统。在Rest的语境中，任何具有明确命名并承载信息的实体，不管是具体的目标、文档、图像，仍是笼统的实体调集、服务等，均可被视作资源。此外，资源是和状况相关的，任何一个特定时间点的资源都有归于自己的资源状况。这些状况是由数据、描绘数据的元数据和超媒体链接组成。

资源命名规则

在命名资源时，咱们引荐遵从一套总体的标准：尽量运用小写字母，以保证命名的一致性和可读性。

层级联系规则

在Restful服务中，咱们选用/这一符号来明晰地展示资源之间的层级联系。举例来说，经过特定的途径组合，咱们能够准确地定位到所需的资源，然后完成对资源的有用管理和操作。

/榜首层级/第二层级/第三层次/......

例如：

// 获取国家基本信息，依据国家称号
/country/{countryName}
// 获取国家基本信息，查询对应省的基本信息，依据省的称号
/country/province/{provinceName}
// 当然假如呈现了不同国家之间有相同的省，则能够参加国家的称号作为准确定位，如下所示
/country/{cityName}/province/{provinceName}
/country/province/{cityName}{provinceName}

留意，不要在资源的最终加上/，如/country/province/{cityName}{provinceName}/，不是特别契合Rest的界说标准和阐明。

分隔符-

为了更精细地划分和命名资源，咱们能够选用-分隔符来进行资源途径的细化，不要运用下划线 。

举例来说，原本的/country/province/{cityName}{provinceName}途径能够优化为/country-province-city/{cityName}，这种写法不只更为简练，还增强了途径的可读性。

不同数据量操作

在Restful架构中，任何具有命名条件的信息均可被视为资源，它们既能够指代单一的个别，也能够代表一个调集。

  • item：指向单一的元素个别，能够用/items/{itemID}来表明特定的某个元素。
  • items：它就是一个调集资源，涵盖了很多元素个别，能够运用/items来表明数据的调集资源。
  • /items/{itemID}/elements：单个资源也或许包括调集数据，比如一个item或许有很多个元素，咱们用elements来表明。

这样的命名办法不只要助于咱们更明晰地了解和安排资源，还能提高Restful架构的易用性和扩展性。

不要在恳求途径上参加CRUD操作

在Restful服务中，CRUD（创立、读取、更新、删去）操作应当经过恳求资源时所运用的HTTP办法来区别，而非直接在资源命名中体现。

以获取items信息为例

HTTP GET /items

咱们应将资源界说为/items，而非/get-items。经过选用适当的HTTP恳求办法，如GET恳求，即可明确表明所需的操作类型。

查询过滤条件数据

在实际运用中，咱们经常需要依据某些特定资源的属性进行排序、过滤或限制调集的回来，更引荐在已有的资源调集API中集成排序、过滤和分页功用，并将相关的输入参数作为查询参数进行传递。

//查询对应的称号为name的数据
/users?queryName=name
//查询对应的称号为name的数据，而且依据age年纪进行正序排序，而且依据id进行desc倒序
/users?queryName=name&orderAge=asc&id=desc
//查询对应的称号为name的数据，而且依据age年纪进行正序排序，而且依据id进行desc倒序，而且分页为10，当时页数为2
/users?queryName=name&orderAge=asc&id=desc&pageSize=10&pageNum=2

经过在API恳求中顺便特定的查询参数，咱们能够轻松地完成对资源的准确筛选和排序，然后满意各种杂乱的事务需求。这种规划办法不只减少了API的数量和保护本钱，还进步了体系的灵敏性和可扩展性。

资源操作类型
作者引荐 | 一文深度解读 — 彻底知道与了解微服务技能之Rest与Restful架构精华
加载资源

在Restful服务中，加载资源这一动作，实则是对单个目标实例或数据库记载的拜访与提取。咱们能够将其视作从资源调集中精准定位并提取出的单一资源。

// 加载轿车信息，在轿车体系里边，因为内部会由很多轿车，因而选用的cars的前缀途径
/cars/{car-id} 
// 加载人群中某一个人的信息，依据这个人的id标识。
/users/{user-id}
// 咱们假定使命体系里边只要一个关于root用户，因而直接用此表明直接获取root用户的信息
/users/root
查询资源

查询资源这一概念在Restful服务中，实际上可视为服务器所保护的资源调集，其内蕴含着很多资源项。客户端在交互进程中，或许会有向此调集添加新资源的需求。咱们关于查询调集资源一般用在资源目标后边参加s来表明。

// 查询轿车调集，在轿车体系里边，查询一切的轿车数据组成一个调集，回来给客户端
/cars
// 查询用户调集，在职工体系里边，查询一切的用户数据组成一个调集，回来给客户端
/users
// 查询用户调集，在职工体系里边，查询一切这个人物的账号信息组成的一个调集，回来给客户端
/users/{roles}/accounts
存储资源

Restful服务中存储扮演着客户端管理的资源库的重要人物。关于这一资源库的增删改查操作，彻底取决于API客户端怎么调用相应的接口。

// 更新对应的用户对应的轿车数据
HTTP PUT /users/{id}/cars
// 新增对应的用户对应的铅笔数据
HTTP POST /users/{id}/pencils

留意，为了更准确地表达资源的调集性质，一般运用复数方法来表明存储。

操作资源

操作资源实际上代表的是一个进程或行为的履行。它类似于一个可履行的函数，具有参数和回来值，涉及到输入和输出的概念。

// 将这个用户的车退出到车库外
/users/{id}/cars/exit
// 将这个用户的车进入到车库里
/users/{id}/cars/enter

一般运用动词来描绘这些操作资源，以更直观地表达其履行的动作和行为，这样的命名办法有助于咱们更明晰地了解资源的操作办法。

最终总结

最终总结，本篇文章主要分析了Rest与Restful架构的中心概念，特别是关于资源怎么被界说和命名的问题。在Restful架构中，资源占有着无足轻重的位置，怎么对其进行精准界说和命名，直接联系到整个别系的稳定性和易用性。