RESTful及其特点

最新推荐文章于 2024-04-01 10:24:52 发布
最新推荐文章于 2024-04-01 10:24:52 发布
阅读量5.5k 收藏 17
点赞数 4
分类专栏： java js 文章标签： rest
版权声明：本文为博主原创文章，遵循 CC 4.0 BY-SA 版权协议，转载请附上原文出处链接和本声明。
本文链接：https://blog.csdn.net/xiong9999/article/details/89316694
版权
java 同时被 2 个专栏收录
65 篇文章 0 订阅
订阅专栏
js
8 篇文章 0 订阅
订阅专栏

RESTful及其特点

什么是RESTful

REST（Resource Representational State Transfer）是Roy Thomas Fielding在他2000年的博士论文中提出的。如果一个架构符合REST原则，就称为RESTful架构，是一种面向资源的软件架构风格
。

REST即Representational State Transfer的缩写，可译为"表现层状态转化”。REST最大的几个特点为：资源、统一接口、URI和无状态。

如何设计RESTful

  1. 域名：
    将api部署在专用域名下：http://api.example.com
    或者将api放在主域名下：http://www.example.com/api/

  2. 版本
    将API的版本号放在url中：http://www.example.com/api/v1.0

  3. 路径
    路径表示API的具体网址。每个网址代表一种资源。 资源作为网址，网址中不能有动词只能有名词，一般名词要与数据库的表名对应。而且名词要使用复数。
    正确示例： http://www.example.com/api/v1.0/goods
    错误示例： http://www.example.com/app/getgoods # 包含动词

  4. 状态码（前后端分离的开发都要用到状态码）
    服务器向用户返回的状态码和提示信息，常用的有：
    200 OK ：服务器成功返回用户请求的数据
    201 CREATED ：用户新建或修改数据成功。
    202 Accepted：表示请求已进入后台排队。
    400 INVALID REQUEST ：用户发出的请求有错误。
    401 Unauthorized ：用户没有权限。
    403 Forbidden ：访问被禁止。
    404 NOT FOUND ：请求针对的是不存在的记录。
    406 Not Acceptable ：用户请求的的格式不正确。
    500 INTERNAL SERVER ERROR ：服务器发生错误。

  5. 自定义错误信息
    一般来说，服务器返回的错误信息，以键值对的形式返回。
    {
    error:‘Invalid API KEY’
    }

  6. 响应结果
    服务器返回的数据格式，应该尽量使用JSON

特点

  1. 资源：网络上的一个实体，或者说是网络上的一个具体信息。它可以是一段文本、一张图片、一首歌曲、一种服务，总之就是一个具体的实在。资源总要通过某种载体反应其内容，文本可以用txt格式表现，也可以用HTML格式、XML格式表现，甚至可以采用二进制格式；图片可以用JPG格式表现，也可以用PNG格式表现；JSON是现在最常用的资源表示格式。

网络上的实体！

  1. 统一接口：数据的元操作，即CRUD(create, read, update和delete,即数据的增删查改)操作，分别对应于HTTP方法：GET用来获取资源，POST用来新建资源（也可以用于更新资源），PUT用来更新资源，DELETE用来删除资源，这样就统一了数据操作的接口，仅通过HTTP方法，就可以完成对数据的所有增删查改工作。

通过HTTP方法来确定并完成对实体的操作！

  1. URI：可以用一个URI（Universal Resource Identifier，统一资源定位符）指向资源，即每个URI都对应一个特定的资源。要获取这个资源，访问它的URI就可以，因此URI就成了每一个资源的地址或识别符。一般的，每个资源至少有一个URI与之对应，最典型的URI即URL。

通过URI来识别不同的资源（实体）！

  1. 无状态：所有的资源，都可以通过URI定位，而且这个定位与其他资源无关，也不会因为其他资源的变化而改变。
  • WebSocket是有状态的

通过URI对资源（实体）操作时，无状态，没有上下文的影响！

在这里插入图片描述
URI = Universal Resource Identifier统一资源标识符
URL = Universal Resource Locator统一资源定位符
URN = Uniform Resource Name统一资源名称

URI属于父类，而URL属于URI的子类。URL是URI的一个子集。
URI表示请求服务器的路径，定义这么一个资源。
URL同时说明要如何访问这个资源（http://）。

URL 的格式由下列三部分组成 :
第一部分是协议 ( 或称为服务方式 );
第二部分是存有该资源的主机 IP 地址 ( 有时也包括端口号 );
第三部分是主机资源的具体地址。
URI 一般由三部分组成 :
访问资源的命名机制。
存放资源的主机名。
资源自身的名称，由路径表示

优点

  1. pc/app/pad 多端适应
  2. SPA开发模式的开始流行（SPA：单页Web应用（single page web application，SPA））
  3. 前后端基本完全独立
  4. 无状态，在调用接口时，不需要考虑上下文流程或者状态
  5. 简单、低耦合
  6. 是典型的ROA（Resource Oriented Architecture）架构

缺点

  1. 前后端学习门槛增加（前端要处理的数据变多了，后端传递数据要满足新的接口规范）
  2. 数据依赖导致文档重要性增加
  3. 前端工作量加大
  4. SEO的难度加大(SEO：搜索引擎优化（Search Engine Optimization）)

总结

web service早期为RPC(remote procedure call)，后来渐渐被SOAP协议（简单对象访问协议（Simple Object Access Protocol））取代，而RESTful API（也称RESTful Web服务）逐渐超越SOAP成为实现SOA（Service Oriented Ambiguity）的重要手段之一。

本真REST与hybrid风格

通常开发者做服务相关的客户端开发时，使用的所谓RESTful服务，基本可分为本真REST和hybrid风格两类。本真REST即我上文阐述的RESTful架构风格，具有上述的4个特点，是真正意义上的RESTful风格；而hybrid风格，只是借鉴了RESTful的一些优点，具有一部分RESTful的特点，但对外依然宣称是RESTful风格的服务。（窃以为，正是由于hybrid风格服务混淆了RESTful的概念，才在RESTful架构风格提出了本真REST的概念，以为了划分界限 ?）
hybrid风格的最主流的用法是，使用GET方法获取资源，用POST方法实现资源的创建、修改和删除。hybrid风格之所以存在，据我了解有两种来源：一种情况是因为，某些开发者并没有真正理解何为RESTful架构风格，导致开发的服务貌合神离；而主流的原因是由于历史包袱 —— 服务本来是RPC风格的，由于上文提到的RPC的劣势及RESTful的优势，开发者在RPC风格的服务上又包装了一层RESTful的外壳，通常这层外壳只为获取资源服务，因此会按RESTful风格实现GET方法，如果客户端提出一些简单的创建、修改或删除数据的需求，则通过HTTP协议中最常用的POST方法实现相应功能。
因此，开发RESTful 服务，如果没有历史包袱，不建议使用hybrid风格。

权限认证

由于RESTful风格的服务是无状态的，认证机制尤为重要。

  • 认证机制解决的问题是，确定访问资源的用户是谁；认证机制基本上是通用的，本真REST + OAuth是RESTful 是微服务的标配。
  • 权限机制解决的问题是，确定用户是否被许可使用、修改、删除或创建资源。权限机制通常与服务的业务逻辑绑定，因此权限机制需要在每个系统内部定制。
一代小雄
关注
  • 4
    点赞
  • 踩
  • 17
    收藏
    觉得还不错? 一键收藏
  • 0
    评论
专栏目录
RESTful简介与C/C++实现
笔者从事电信媒体开发多年，愿意将多年的开发经验分享给同行
12-21 2906
RESTful，全称为Representational State Transfer，是一种软件架构风格和设计理念，而不是一种标准。它主要用于Web服务的设计和开发，强调资源的状态表示和状态转移。RESTful风格的设计使得Web服务更加简洁、清晰和易于理解。本文结合RESTful、HTTP及C++进行了简单介绍。
Elasticsearch基础及RESTful方式操作
清沙
07-24 633
http//127.0.0.19200/newsindex/news/s8OxK4IBouFOjM8f3Mc2，用Postman工具PUT方式提交，选择Body->raw、JSON。http//127.0.0.19200/newsindex/news/tMO-K4IBouFOjM8fUsdT，用Postman工具Delete方式。http//127.0.0.19200/newsindex/news/_search，用Postman工具GET方式。能用较快的速度去处理大规模数据。......
restful风格的接口
qq_42000871的博客
03-13 335
一、协议 API与用户的通信协议，总是使用HTTPs协议。 二、域名 应该尽量将API部署在专用域名之下。 https://api.example.com 如果确定API很简单，不会有进一步扩展，可以考虑放在主域名下。 https://example.org/api/ 三、版本（Versioning） 应该将API的版本号放入URL。 https://a...
Restful特点
柠檬树
06-30 892
HTTP就是该框架风格的一个典型应用。一方面，随着云计算和移动计算的兴起，很多企业愿意在互联网上共享自己的数据另一方面，在企业中，Restful API已经逐渐超越SOAP成为实现SOA的主要手段之一。 REST即Representaional State Transfer的缩写，可翻译为“（资源）表现层状态转化”。Rest最大的的几个特点为：资源、统一接口、URI和无状态 1、资源 所谓资
restful的特点
weixin_30369087的博客
02-20 122
1.资源（Resources） REST的名称”表现层状态转化”中，省略了主语。”表现层”其实指的是”资源”（Resources）的”表现层”。 所谓”资源”，就是网络上的一个实体，或者说是网络上的一个具体信息。 它可以是一段文本、一张图片、一首歌曲、一种服务，总之就是一个具体的实在。 ...
RESTful接口设计原则和优点
weixin_33819479的博客
03-19 147
RESTful架构优点： 前后端分离，减少流量 安全问题集中在接口上，由于接受json格式，防止了注入型等安全问题 前端无关化，后端只负责数据处理，前端表现方式可以是任何前端语言（android，ios,html5） 前端和后端人员更加专注于各自开发，只需接口文档便可完成前后端交互，无需过多相互了解 服务器性能优化：由于前端是静态页面，通过nginx便可获取，服务器主要压力放在了接口...
RESTFUL架构的特点
匆匆321
10-24 1721
1.每一个URL代表1种资源； 2.客户端使用GET、POST、PUT、DELETE4个表示操作方式的动词对服务端资源进行操作；get用来获取资源，post用来新建资源（也可以用于更新资源），put用来更新资源，DELETE用来删除资源； 3.通过操作资源的表现形式来操作资源； 4.资源的表现形式是XML或者HTML; 5.客户端与服务端之间的交互在请求之间是无状态的， RESTful架构是对MV...
RESTful
qq_43389371的博客
10-25 236
REST 是什么 REST 全称 Representational State Transfer ，它不是业界哪个组织规定的规范，它是一种万维网软件架构的风格 ，它是用来创建网路服务的。 Representational ：这里的含义是 数据的表现形式 （JSON、XML…），常用 JSON 数据格式 State ：当前状态或者数据，描述当前处于那种状态（增、删、改、查） Transfer ：数据传输，数据在互联网上传输，（服务器传到客户端） REST 6 个限制 客户-服务器（Client-Serve
restful
qq_47759220的博客
02-04 117
转自：https://blog.csdn.net/qq_27026603/article/details/82012277 概念 一种软件架构风格、设计风格，而不是标准，只是提供了一组设计原则和约束条件。它主要用于客户端和服务器交互类的软件。基于这个风格设计的软件可以更简洁，更有层次，更易于实现缓存等机制。 URL定义 资源：互联网所有的事物都可以被抽象为资源 资源操作：使用POST、DELETE、PUT、GET，使用不同方法对资源进行操作。 分别对应 添加、 删除、修改...
计算机-restful-基于Restful服务的专利数据分析及可视化系统.pdf
07-07
计算机-Restful-基于Restful服务的专利数据分析及可视化系统 本文设计和实现了一个基于Restful服务的专利数据分析及可视化系统，旨在提供一个统一的平台，用于收集、分析和可视化专利数据。该系统通过在线专利数据...
【RESTful API】RESTful API的身份验证与权限控制
weixin_52553215的博客
11-10 285
RESTful API是一种常用的互联网应用程序接口设计风格。在实际开发中，为了保护API的安全性，我们通常需要对用户进行身份验证。RESTful 服务客户端必须向服务器证明其身份才能确立信任。RESTful Web 服务必须首先对请求进行身份验证，然后才能发送响应。
RESTful 架构特点
resilient的博客
11-27 266
RESTfulAPI是目前比较成熟的一套互联网应用程序的API设计理论。 REST 从资源的角度来观察整个网络，分布在各处的资源由URI确定，而客户端的应用通过URI来获取资源的表征。获得这些表征致使这些应用程序转变了其状态。随着不断获取资源的表征，客户端应用不断地在转变着其状态，所谓表征状态转移（Representational State Transfer） Restful基于“资源”，数据也好、服务也好，在Restful设计里一切都是资源。 ...
RESTful的特点分析
weixin_51914719的博客
11-30 1183
RESTful架构特点 1、统一的接口：http（s）????/服务器地址：端口号【项目名称/版本-可选】资源 - http://为我们http协议的访问头标准 - 服务器地址：为我们项目服务器ip地址 - 端口号：为我们服务器内项目访问的指定编号 - 项目名称/版本】：可选 - 资源：互联网-图片、音乐、视频、文本、数据 2、http请求方法 get：从服务器取出资源 一个或者多个 post:在服务器新建一个资源 单个或者多个 put:在服务器更新资源（客户端提供改变后的完整资源） delete:从服务器
RESTful风格接口和特性
情非得已小猿猿
12-29 1042
1、RESTful的特性 资源： 可以用一个URI（统一资源定位符）指向它，每种资源对应一个特性的URI。 表现层： 把资源具体呈现出来的形式。 比如，文本可以用txt格式表现，也可以用HTML格式、XML格式、JSON格式表现，甚至可以采用二进制格式。 状态转换： 每发出一个请求，就代表了客户端和服务器的一次交互过程，是服务器端发生“状态转换”。 HTTP协议里面，四个表示操作方式的动词：...
RESTful的优点
最新发布
qq_57676486的博客
04-01 490
5.通过HTTP状态码反映服务器端的处理结果，统一错误处理机制；2.通过HTTP谓词表示不同的操作，接口自描述；3.可以对GET、PUT、DELETE请求重试；1.通过url对资源定位，语义清晰；6.网关等可以分析请求处理结果。4.可以对GET请求做缓存；
restFul结构特点
rlk512974883的博客
08-30 411
restFul结构特点： 1.restFul结构参数用{}包裹 2.参数与参数之间用“/”分割 3.接收参数和变量应该一直，若不一致@PathVariable(value="restFul结构参数名") 4.使用@PathVariable 实现数据传参  ...
Restful架构特点
weixin_30322405的博客
08-13 127
1.请求方法：对于资源的具体操作类型，由HTTP动词表示。 比如： GET（SELECT）：从服务器取出资源（一项或多项）。 POST（CREATE）：在服务器新建一个资源。 PUT（UPDATE）：在服务器更新资源（客户端提供改变后的完整资源）。 PATCH（UPDATE）：在服务器更新资源（客户端提供改变的属性）。 DELETE（DELETE）：从服务器删除资源。 2.U...
理解RESTful架构
it_man的专栏
07-27 8392
越来越多的人开始意识到，网站即软件，而且是一种新型的软件。 　　这种"互联网软件"采用客户端/服务器模式，建立在分布式体系上，通过互联网通信，具有高延时（high latency）、高并发等特点。 　　网站开发，完全可以采用软件开发的模式。但是传统上，软件和网络是两个不同的领域，很少有交集；软件开发主要针对单机环境，网络则主要研究系统之间的通信。互联网的兴起，使得这两个领域开始融合，现在我们必
restful面试题及答案
05-29
1. 什么是 RESTful 架构风格？它有哪些特点？ 回答：RESTful 是一种设计风格或架构模式，用于构建基于网络的应用程序和服务。它基于 HTTP 协议，通过提供统一的接口和标准的方式来处理资源和操作，实现了分布式系统中的数据交互和通信。RESTful 架构风格强调资源的概念，每个资源都有一个唯一的标识符（URI）和一组操作（HTTP 方法）来处理它们。常见的 HTTP 方法包括 GET、POST、PUT 和 DELETE。RESTful 架构风格被广泛应用于 Web 应用程序、移动应用程序和云服务等领域。 2. 谈谈你对 HTTP 方法的理解，以及它们在 RESTful 架构中的作用？ 回答：HTTP 方法是用于表示客户端对服务器资源的操作类型的一种机制。常见的 HTTP 方法包括 GET、POST、PUT 和 DELETE 等。在 RESTful 架构中，HTTP 方法用于表示对资源的不同操作类型，例如 GET 用于获取资源，POST 用于新增资源，PUT 用于更新资源，DELETE 用于删除资源等。 3. RESTful 架构中的资源是什么？它们如何被标识和访问？ 回答：RESTful 架构中的资源是指应用程序中的一些实体或对象，例如用户、订单、商品等。每个资源都有一个唯一的标识符（URI），用于标识和访问该资源。URI 应该是有意义的和易于理解的，例如 /users，/users/1 等。 4. 什么是 URI？在 RESTful 架构中有什么作用？ 回答：URI（Uniform Resource Identifier）是用于标识和访问 Web 上的资源的一种标识符。在 RESTful 架构中，URI 是用于标识和访问资源的唯一标识符，每个资源都有一个对应的 URI。URI 应该是有意义的和易于理解的，例如 /users，/users/1 等。 5. RESTful 架构中的状态转移是什么？有哪些状态转移？ 回答：RESTful 架构中，状态转移是指客户端通过 HTTP 方法对资源进行操作的过程。常见的状态转移包括： - GET：用于获取资源的信息，不会对资源进行修改。 - POST：用于新增资源或提交数据，对资源进行修改。 - PUT：用于更新资源，通常需要提供完整的资源信息。 - DELETE：用于删除资源。 6. RESTful 架构中的资源表示是什么？它有哪些常见的格式？ 回答：RESTful 架构中的资源表示是指客户端和服务器之间传输的资源表现形式。常见的资源表示格式包括： - JSON：一种轻量级的数据交换格式。 - XML：一种标记语言，用于描述数据结构。 - HTML：一种用于 Web 页面的标记语言。 - 文本：一种纯文本格式。 7. 什么是 HATEOAS？在 RESTful 架构中有什么作用？ 回答：HATEOAS（Hypermedia As The Engine Of Application State）是一种 RESTful 架构中的概念，强调资源之间的关系和状态转移的动态性。HATEOAS 要求每个资源都包含有关其自身的信息以及如何与其他资源进行交互的信息。通过 HATEOAS，客户端可以在访问资源时自动获取其相关资源的 URI，从而实现资源之间的自动导航和状态转移。 8. RESTful 架构相对于传统的 RPC 和 SOAP 有哪些优势？ 回答：相对于传统的 RPC 和 SOAP，RESTful 架构具有以下优势： - 可伸缩性：RESTful 架构基于 HTTP 协议，可以使用现有的 Web 技术和基础设施，具有更好的可伸缩性。 - 简单性：RESTful 架构采用统一的接口和标准的方式来处理资源和操作，具有更好的可读性和易用性。 - 松耦合性：RESTful 架构强调资源的概念，客户端和服务器之间不需要共享任何状态信息，具有更好的松耦合性。 - 可见性：RESTful 架构中的资源和操作都是可见的，客户端可以很容易地了解应用程序的结构和功能。 - 缓存性：RESTful 架构中的资源可以使用 HTTP 协议的缓存机制，可以提高性能和可用性。 9. RESTful 架构中如何处理错误和异常？ 回答：在 RESTful 架构中，错误和异常应该以标准的 HTTP 状态码来表示。常见的 HTTP 状态码包括： - 200 OK：表示请求成功。 - 201 Created：表示资源创建成功。 - 204 No Content：表示请求成功，但响应中没有返回任何内容。 - 400 Bad Request：表示客户端请求有误。 - 401 Unauthorized：表示客户端未经授权。 - 404 Not Found：表示请求的资源不存在。 - 500 Internal Server Error：表示服务器内部错误。 10. 谈谈你对 RESTful API 设计的经验和实践。你最近设计的一个 RESTful API 是什么？它的设计有哪些值得称道的特点？ 回答：这个问题需要回答者根据自己的实际经验和设计情况来回答。一般来说，一个好的 RESTful API 应该具有以下特点： - 符合 RESTful 架构风格的设计原则。 - 使用清晰、简洁、易于理解的 URI 来标识和访问资源。 - 使用恰当的 HTTP 方法来表示不同的状态转移。 - 使用恰当的 HTTP 状态码来表示错误和异常。 - 使用恰当的资源表示格式和内容协商机制。 - 提供良好的文档和测试工具。 - 提供安全和身份认证机制。 - 具有良好的性能和可伸缩性。 例如，一个简单的 RESTful API 可以是一个用户管理系统，包括获取用户列表、获取单个用户、新增用户、更新用户和删除用户等操作。其 URI 可以如下所示： - GET /users：获取用户列表。 - GET /users/{id}：获取单个用户。 - POST /users：新增用户。 - PUT /users/{id}：更新用户。 - DELETE /users/{id}：删除用户。 该 API 的设计遵循 RESTful 架构风格的设计原则，使用清晰、简洁、易于理解的 URI 来标识和访问资源，使用恰当的 HTTP 方法来表示不同的状态转移，并提供了良好的文档和测试工具。
评论
添加红包

请填写红包祝福语或标题

个

红包个数最小为10个

元

红包金额最低5元

当前余额3.43元 前往充值 >
需支付：10.00元
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付元
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明：

1.余额是钱包充值的虚拟货币，按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载，可以购买VIP、付费专栏及课程。

余额充值