restfull规范
web服务交互
我们在浏览器中能看到的每个网站,都是一个web服务。那么我们在提供每个web服务的时候,
都需要前后端交互,前后端交互就一定有一些实现方案,我们通常叫web服务交互方案。
目前主流的三种web服务交互方案:
-- REST ( Representational State Transfer)表述性状态转移
-- SOAP (Simple Object Access Protocol) 简单的对象访问协议
-- XML-RPC (XML Remote Procedure Call)基于XML的远程过程调用
XML-RPC是通过XML将调用函数封装,并使用HTTP协议作为传送机制。
后来在新的功能不断被引入下,这个标准慢慢演变成为今日的SOAP协定。
SOAP服务则是以本身所定义的操作集,来访问网络上的资源。
SOAP也是基于XML的,但是它不只限于HTTP协议的传输,包括TCP协议,UDP协议都可以传输。
REST是Roy Thomas Fielding博士于2000年在他的博士论文里提出来的。
REST相比SOAP更加简洁,性能和开发效率也有突出的优势。
我们今天主要说一下这个REST,现在越来越多的web服务开始采用REST风格设计和实现。
例如,amazon.com提供接近REST风格的Web服务进行图书查找;雅虎提供的Web服务也是REST风格的。
我们接下来要学的框架也是遵循REST风格的,那么我们来看下它到底是个什么样的风格,
了解了它是什么后,我们看下它的优点是什么,我们为什么用它。
理解REST
如果我们想要理解restful,就要理解Representational State Transfer这个词组的意思,表征性状态转移。
这里所说的表征性,其实指的就是资源。通常我们称为资源状态转移。
什么是资源
任何事物,只要有被引用到的必要,它就是一个资源。
我们在浏览器中看到的文本,视频,图片等等都是资源。这些都是实实在在存在的实体。
资源可以是一个实体,也可以是抽象概念。
比如说吧:
-- Alex的个人信息
-- 沛齐的手机号
-- Alex跟沛齐的潜在关系
这些都是资源,可以是实体比如个人信息,手机号。也可以是抽象的概念,比如两个人的关系......
那么在我们的网络中,我们要引用资源,资源一定要有一个标识,在web中的唯一标识就是URI,
URI我们不常听说,我们经常用URL,那么两者区别是什么呢~
什么是URI,URL
URI 统一资源标志符。
URL 统一资源定位符。
URI是给我们的资源进行标识的,URL是描述我们资源地址的。
比如说我们每个人都有名字和身份证,名字可能重名,但是身份证是唯一的,
那么身份证号就可以是我们的URI,标识我们每个人,也可以说标识我们每个资源。
我们可以通过身份证号找到Alex,也可以通过下面这种方式找到他.....
Alex的住址协议://地球/中国/屌丝省/屌丝市/寡妇村/250号街道/250号/Alex
这个就是我们的URL,我们通过这两种方式都可以找到我们的资源,
其实我们的URL可以说是URI的子集,通过定位的方式实现的URI。
这是我们资源的定位~~有了资源的地址后,我们要去访问资源,那么我们要通过什么方式去访问呢~~
统一资源接口
现在我们可以通过URL去访问到资源,那么我们对资源会有很多不同的操作,增删改查,
以前我们可能会为了这个增加新设计一个URL,然后这个URL就是对数据进行增加的,
还会为了更新和删除分别设计一个URL,现在我们不用了,我们只有一个URL,
然后根据HTTP请求方式的不同,对资源进行不同的操作,这个就是是统一资源接口。
我们一定要遵循HTTP请求方法的语义,也就是说POST请求就在新增数据等....
资源的表述
资源的表述其实就是资源的展现形式,我们客户端和服务端传输的都是资源的表述,而不是资源本身。
例如文本资源可以采用html、xml、json等格式,图片可以使用PNG或JPG展现出来。
那么客户端如何知道服务端提供哪种表述形式呢?
可以通过HTTP内容协商,客户端可以通过Accept头请求一种特定格式的表述,服务端则通过Content-Type告诉客户端资源的表述形式。
这些资源的表述呈现在页面上,就是我们说的资源状态。
状态转移
我们在看页面的时候,从当前资源的表述(也可以说状态或者表现层)会跳转到其他的资源状态。
服务端通过超媒体告诉客户端当前状态有哪些后续状态可以进入。
这些类似"下一页"之类的链接起的就是这种推进状态的作用——指引你如何从当前状态进入下一个可能的状态。
总结
可以得知REST风格的特点如下:
(1)在web中,只要有被引用的必要都叫资源。
(2)每个URI代表一个资源,独一无二的。
(3)客户端通过HTTP的方法,对服务器端资源进行操作;
(4)客户端和服务器之间,传递这种资源的某种表现层;
(5)通过超链接的指引,实现"表现层状态转移"。
RESTful
如果一个架构符合REST的约束条件和原则,我们就称它为RESTful架构。
一种软件的架构风格,设计风格, 为客户端和服务端的交互提供一组设计原则和约束条件。
restful规范
一 面向资源编程
每个URL代表一种资源,URL中尽量不要用动词,要用名词。
二 根据method不同,进行不同的操作
GET/POST/PUT/DELETE/PATCH
三 在URL中体现版本
https://www.bootcss.com/v1/mycss
https://v1.bootcss.com/mycss
四 在URL中体现是否是API
https://www.bootcss.com/api/mycss
https://api.bootcss.com/mycss
五 在URL中的过滤条件
https://www.bootcss.com/v1/mycss?page=3
六 尽量使用HTTPS
https://www.bootcss.com/v1/mycss
七 响应时设置状态码
1** 信息,服务器收到请求,需要请求者继续执行操作
2** 成功,操作被成功接收并处理
3** 重定向,需要进一步的操作以完成请求
4** 客户端错误,请求包含语法错误或无法完成请求
5** 服务器错误,服务器在处理请求的过程中发生了错误
八 返回值
GET请求 返回查到所有或单条数据
POST请求 返回新增的数据
PUT请求 返回更新数据
PATCH请求 局部更新 返回更新整条数据
DELETE请求 返回值为空
九 返回错误信息
返回值携带错误信息
十 Hypermedia API
如果遇到需要跳转的情况 携带调转接口的URL
restfull规范的更多相关文章
- restfull规范、DRF视图和路由
一.restfull规范的简单介绍 1.介绍 REST:表述性状态转移,是一种web交互方案 资源:在web中只要有被引用的必要都是资源 URI: URI 统一资源标识符 URL 统一资源定位符 统一 ...
- Django restfull规范
一. 什么是RESTful REST与技术无关,代表的是一种软件架构风格,REST是Representational State Transfer的简称,中文翻译为“表征状态转移” REST从资源的角 ...
- 【DRF框架】restfull规范
零:核心思想: 1.面对资源编程 2.根据HTTP请求方式的不同对资源进行不同的操作 一.协议 API与用户的通信协议,总是使用HTTPs协议. 二.域名 应该尽量将API部署在专用域名之下. htt ...
- ASP.Net WebAPI与Ajax进行跨域数据交互时Cookies数据的传递
前言 最近公司项目进行架构调整,由原来的三层架构改进升级到微服务架构(准确的说是服务化,还没完全做到微的程度,颗粒度没那么细),遵循RESTFull规范,使前后端完全分离,实现大前端思想.由于是初次尝 ...
- 初识RESTful
前言:两个月没写博客了,我真是太贱了哈哈.先简单说下我这两个月做了啥吧.8月26号从BIGO离职,回学校准备秋招.9月初时才发现已经错过秋招内推时间,其实秋招内推拿offer是有较大概率的.9月才开始 ...
- 不吹不擂,你想要的Python面试都在这里了【315+道题】
写在前面 近日恰逢老男孩全栈8期毕业季,课程后期大家“期待+苦逼”的时刻莫过于每天早上内容回顾和面试题问答部分[临近毕业每天课前用40-60分钟对之前内容回顾.提问和补充,专挑班里不爱说话就的同学回答 ...
- Python 经典面试题汇总之框架篇
前端和框架 1.谈谈你对http协议的认识 浏览器本质,socket客户端遵循Http协议 HTTP协议本质:通过\r\n分割的规范,请求响应之后断开链接 ==> 短连接.无状态 具体: Htt ...
- python面试题---收藏的笔记
第一部分 Python基础篇(80题) 为什么学习Python? 通过什么途径学习的Python? Python和Java.PHP.C.C#.C++等其他语言的对比? 简述解释型和编译型编程语言? P ...
- restful设计规范
什么是restful? REST与技术无关,代表的是一种软件架构风格,REST是Representational State Transfer的简称,中文翻译为“表征状态转移” REST从资源的角度类 ...
随机推荐
- ashx上传姿势
很多情况下网上流传的cer,asa,cdx……等等来上传,其实很多时候是不行的.但是ashx会好一些. PS:其实这个姿势也蛮老了,但是还是相当一大部分站点存在.也是一个姿势所以写博文记住它.免得忘了 ...
- 【sql绕过】Bypass waf notepad of def
文章是通过阅读<[独家连载]我的WafBypass之道 (SQL注入篇)>写的阅读笔记. Waf的类型 1.云waf云waf通常是CDN包含的waf,DNS在解析的时候要解析到cdn上面制 ...
- Groovy学习()起步
安装Groovy 在Windows环境下安装Groovy 下载安装包,傻瓜安装,设置环境目录,就这样搞定. 另外还需要安装Java并且设置JAVA_HOME环境变量. 两分钟搞定. 使用groovys ...
- ad7888 linux driver
/* ADCCONVERT.c : Generate ADC signals from SPI ports, as the A/D control signals. Author: Aaron Fu ...
- NAT and Traversal NAT(TURN/STUN/ICE)
http://www.cnblogs.com/whyandinside/archive/2010/12/08/1900492.html -------------------------------- ...
- 精心收集的Hadoop学习资料(持续更新)
转自:http://blog.csdn.net/wypblog/article/details/17528851 最近发现自己收集到的Hadoop学习资料有很多本,想想放在那里也浪费,所以觉得贴出来给 ...
- 在函数体的“出口处”,对 return 语句的正确性和效率进行检查
在函数体的“出口处”,对 return 语句的正确性和效率进行检查. 如果函数有返回值,那么函数的“出口处”是 return 语句. 我们不要轻视 return 语 句.如果 return 语句写得不 ...
- Struts2的拦截器是如何使用AOP工作的
拦截器(interceptor)是Struts2最强大的特性之一,也可以说是struts2的核心,拦截器可以让你在Action和result被执行之前或之后进行一些处理.同时,拦截器也可以让你将通用的 ...
- (转)directx中丢失的设备(lost device)
directx中丢失的设备(lost device) 丢失的设备 一个Microsoft? Direct3D?可以处于操作状态或丢失状态.操作状态是设备的正常状态,设备按预期运行并present所 ...
- 经典SQL基础回顾
孔子有云:温故而知新,可以为师矣.既然孔老圣人都云了,咱今天就一起来重温一下MS SQL吧.开篇声明一下:大部分都是基础内容,SQL非常熟练的就别浪费您的时间了,因为这年头,大家时间都挺宝贵的.但是如 ...