您当前的位置:首页 > 电脑百科 > 网络技术 > 网络知识

什么是REST?什么是RESTful?

时间:2020-01-02 15:25:15  来源:  作者:

什么是REST?什么是RESTful?

 

一、REST来源

REST:是一组架构约束条件和原则,REST是Roy Thomas Fielding在他2000年的博士论文中提出的。 Roy Thomas Fielding是HTTP协议(1.0版和1.1版)的主要设计者、Apache服务器作者之一、Apache基金会第一任主席

二、什么是REST

REST(Representational State Transfer):表现层状态转移,一种软件架构风格,不是标准。既然不是标准,我可以遵守,也可以不遵守!!! 什么是表现层状态转移:

Representational (表现层) 
State Transfer(状态转移):通过HTTP动词实现。
  • 总结:URL定位资源,HTTP动词(GET,POST,PUT,DELETE)描述操作。

三、什么是RESTful

基于REST构建的API就是RESTful风格

四、如何设计RESTful风格的API

1.路径设计

在RESTful架构中,每个网址代表一种资源(resource),所以网址中不能有动词,只能有名词,而且所用的名词往往与数据库的表名对应,一般来说,数据库中的表都是同种记录的”集合”(collection),所以API中的名词也应该使用复数。 举例来说,有一个API提供动物园(zoo)的信息,还包括各种动物和雇员的信息,则它的路径应该设计成下面这样。

https://api.example.com/v1/zoos 
https://api.example.com/v1/animals 
https://api.example.com/v1/employees

2.HTTP动词设计

对于资源的具体操作类型,由HTTP动词表示,常用的HTTP动词如下:

请求方式	含义
GET	获取资源(一项或多项)
POST	新建资源
PUT	更新资源(客户端提供改变后的完整资源)
DELETE	删除资源

如何通过URL和http动词获悉要调用的功能:

请求方式	含义
GET	/zoos	列出所有动物园
POST	/zoos	新建一个动物园
GET	/zoos/ID	获取某个指定动物园的信息
PUT	/zoos/ID	更新某个指定动物园的信息(提供该动物园的全部信息)
DELETE	/zoos/ID	删除某个动物园
GET	/zoos/ID/animals	列出某个指定动物园的所有动物
DELETE	/zoos/ID/animals/ID	删除某个指定动物园的指定动物

RESTFul API的一些最佳实践原则:

  1. 使用HTTP动词表示增删改查资源, GET:查询,POST:新增,PUT:更新,DELETE:删除
  2. 返回结果必须使用JSON
  3. HTTP状态码,在REST中都有特定的意义:200,201,202,204,400,401,403。比如401表示用户身份认证失败,403表示你验证身份通过了,但这个资源你不能操作。
  4. 如果出现错误,返回一个错误码: 10000=通用参数错误10001=资源未找到
  5. API 必须有版本的概念, v1, v2
  6. 使用Token令牌来做用户身份的校验与权限分级
  7. url中大小写不敏感,不要出现大写字母
  8. 使用中划线而不是使用下划线做URL路径中字符串连接
  9. 有一份漂亮的文档

RESTFul API好用吗?

某些情况好用,某些情况不好用。什么情况好用,什么情况不好用呢?

  1. 一个经验性的总结:对于开放的API,比如豆瓣、新浪微博、GitHub,好用,非常合适
  2. 对于内部开发,不好用
  3. REST是一种软件架构风格,不是标准。既然不是标准,可以遵守,也可以不遵守!

结论

实践过程中开发人员灵活把握



Tags:REST   点击:()  评论:()
声明:本站部分内容及图片来自互联网,转载是出于传递更多信息之目的,内容观点仅代表作者本人,如有任何标注错误或版权侵犯请与我们联系(Email:2595517585@qq.com),我们将及时更正、删除,谢谢。
▌相关推荐
RPC远程过程调用(Remote Procedure Call,RPC)框架作为架构微服务化的基础组件,能大大降低架构微服务化的成本,提高服务调用方与服务提供方的开发效率,屏蔽跨进程调用函数(服务)的各...【详细内容】
2021-08-31  Tags: REST  点击:(78)  评论:(0)  加入收藏
1 restTemplate — spring 提供特点:1、RestOperations 提供了各种封装方法,非常方便直接将返回转成实体类。2、默认使用JDK 的HttpURLConnection进行通信,但是可以通过Re...【详细内容】
2021-08-19  Tags: REST  点击:(83)  评论:(0)  加入收藏
在此前写的文章“从零基础入门进行小程序开发实战”中,已经介绍过背单词的小程序,因为没有备案的服务器资源只能使用系统后台提供的缓存功能存储用户数据。缓存有大小限制,而且...【详细内容】
2021-07-27  Tags: REST  点击:(109)  评论:(0)  加入收藏
两个独立的应用程序需要中介程序才能相互通信。 因此,开发人员经常建立桥梁-应用程序编程接口-来允许一个系统访问另一个系统的信息或功能。为了快速,大规模地集成应用程序,使...【详细内容】
2020-12-01  Tags: REST  点击:(180)  评论:(0)  加入收藏
免责声明:尽管标题有争议,但本文并不是试图证明RPC比REST更好,或者GraphQL比RPC更好。相反,本文的目的是向你介绍这些方法的大致情况以及它们的优缺点。最终的选择将会是一个权...【详细内容】
2020-11-30  Tags: REST  点击:(89)  评论:(0)  加入收藏
一、Presto简介Presto是Facebook开发的数据查询引擎,可对250PB以上的数据进行快速地交互式分析。该项目始于 2012 年秋季开始开发,该项目已经在超过 1000 名 Facebook 雇员中...【详细内容】
2020-09-21  Tags: REST  点击:(262)  评论:(0)  加入收藏
Facebook、GitHub、Google以及其他许多巨头都需要一种服务和消费数据的方式。在当今的开发环境中,RESTful API仍然是服务和消费数据的最佳选择之一。 但是你是否考虑过学习行...【详细内容】
2020-08-30  Tags: REST  点击:(71)  评论:(0)  加入收藏
通过管理一套图书的完整代码示例,来探索轻量级的 RESTful 服务。• 来源:linux.cn • 作者:Marty Kalin • 译者:MCGA •(本文字数:24337,阅读时长大约:28 分钟)Web...【详细内容】
2020-08-27  Tags: REST  点击:(43)  评论:(0)  加入收藏
此次文章介绍如何用Spring WebFlux来构建响应式REST API,在了解这个之前,必须先对系统的开发、传统REST的常见问题和API的普遍需求有一定的了解基础,我在网上找到了关于介绍传...【详细内容】
2020-07-30  Tags: REST  点击:(87)  评论:(0)  加入收藏
近日,Github公布了一项无服务器计算调查,有近600位Github用户参与了这项调查。结果显示,AWS是最受关注的无服务器选择,部署REST API是无服务器计算最普遍的用例。 通过无服务器...【详细内容】
2020-07-20  Tags: REST  点击:(110)  评论:(0)  加入收藏
▌简易百科推荐
以京训钉开发平台接口文档为例,使用HttpClient类请求调用其接口,对数据进行增删改查等操作。 文档地址: https://www.yuque.com/bjjnts/jxd/bo1oszusing System;using System.C...【详细内容】
2021-12-28  Wednes    Tags:HttpClient   点击:(1)  评论:(0)  加入收藏
阿里云与爱快路由安装组网教程一、开通好阿里云轻量服务器之后在服务器运维-远程连接处进行远程 二、进入控制台后在root权限下根据需要安装的固件位数复制下面命令。32位:wg...【详细内容】
2021-12-28  ikuai    Tags:组网   点击:(1)  评论:(0)  加入收藏
HTTP 报文是在应用程序之间发送的数据块,这些数据块将通过以文本形式的元信息开头,用于 HTTP 协议交互。请求端(客户端)的 HTTP 报文叫做请求报文,响应端(服务器端)的叫做响应...【详细内容】
2021-12-27  程序员蛋蛋    Tags:HTTP 报文   点击:(5)  评论:(0)  加入收藏
一 网络概念:1.带宽: 标识网卡的最大传输速率,单位为 b/s,比如 1Gbps,10Gbps,相当于马路多宽2.吞吐量: 单位时间内传输数据量大小单位为 b/s 或 B/s ,吞吐量/带宽,就是网络的使用率...【详细内容】
2021-12-27  码农世界    Tags:网络   点击:(3)  评论:(0)  加入收藏
1.TCP/IP 网络模型有几层?分别有什么用? TCP/IP网络模型总共有五层 1.应用层:我们能接触到的就是应用层了,手机,电脑这些这些设备都属于应用层。 2.传输层:就是为应用层提供网络...【详细内容】
2021-12-22  憨猪哥08    Tags:TCP/IP   点击:(35)  评论:(0)  加入收藏
TCP握手的时候维护的队列 半连接队列(SYN队列) 全连接队列(accepted队列)半连接队列是什么?服务器收到客户端SYN数据包后,Linux内核会把该连接存储到半连接队列中,并响应SYN+ACK报...【详细内容】
2021-12-21  DifferentJava    Tags:TCP   点击:(10)  评论:(0)  加入收藏
你好,这里是科技前哨。 随着“元宇宙”概念的爆火,下一代互联网即将到来,也成了互联网前沿热议的话题,12月9日美国众议院的听证会上,共和党议员Patrick McHenry甚至宣称,要调整现...【详细内容】
2021-12-17  王煜全    Tags:Web3   点击:(14)  评论:(0)  加入收藏
一、demopublic static void main(String[] args) throws Exception { RetryPolicy retryPolicy = new ExponentialBackoffRetry( 1000, 3);...【详细内容】
2021-12-15  程序员阿龙    Tags:Curator   点击:(22)  评论:(0)  加入收藏
一、计算机网络概述 1.1 计算机网络的分类按照网络的作用范围:广域网(WAN)、城域网(MAN)、局域网(LAN);按照网络使用者:公用网络、专用网络。1.2 计算机网络的层次结构 TCP/IP四层模...【详细内容】
2021-12-14  一口Linux    Tags:网络知识   点击:(31)  评论:(0)  加入收藏
无论是在外面还是在家里,许多人都习惯了用手机连接 WiFi 进行上网。不知道大家有没有遇到过这样一种情况, 明明已经显示成功连接 WiFi,却仍然提示“网络不可用”或“不可上网”...【详细内容】
2021-12-14  UGREEN绿联    Tags:WiFi   点击:(25)  评论:(0)  加入收藏
最新更新
栏目热门
栏目头条