restful现在非常流行,所以很有必要提一下

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更加简洁,性能和开发效率也有突出的优势。现在越来越多的web服务开始采用REST风格设计和实现。

什么是REST

REST,即Representational State Transfer,表征性状态转移。这里所说的表征性,其实指的就是资源。通常我们称为资源状态转移

什么是资源

任何事物,只要有被引用到的必要,它就是一个资源。在浏览器中看到的文本,视频,图片等等都是资源。这些都是实实在在存在的实体。

资源可以是一个实体,也可以是抽象概念。

比如:

  你的基本信息

  你的手机号

  你和女朋友的关系

这些都是资源,可以是实体比如个人信息,手机号。也可以是抽象的概念,比如两个人的关系,那么在我们的网络中,我们要引用资源,资源一定要有一个标识,在web中的唯一标识就是URI,而我们经常听到的是URL

什么是URI,URL

URI 统一资源标志符

URL 统一资源定位符

URI是给我们的资源进行标识的,URL是描述我们资源地址的。比如说我们每个人都有名字和身份证,名字可能重名,但是身份证是唯一的,那么身份证号就可以是我们的URI,标识我们每个人,也可以说标识我们每个资源。

可以通过身份证号(URI)找到你

也可以通过下面这种方式找到你(URL):

  你的住址协议://地球/中国/xx省/xx市/xx县/xx镇/xx村/xx号街道/xx号/你

URL可以说是URI的子集,通过定位的方式实现的URI

这是我们资源的定位,有了资源的地址,就可以访问(找到)资源了

统一资源接口

顾名思义,就是把与这个接口相关的操作(功能)统一到一个接口上

根据常识URL去访问到资源,可以对其增删改查,以前我们可能会为了每个单项的功能都新设计一个URL,

比如:

  • /baidu.com/user/list/
  • /baidu.com/user/add/
  • /baidu.com/user/edit/(?P<id>\d+)/
  • /baidu.com/user/del/(?P<id>\d+)/

上面的每一个URL就是对数据进行增删改查的,而现在就只有一个URL——/baidu.com/user/list/ ,根据HTTP请求方式的不同,对资源进行不同的操作,这个就是是统一资源接口,但必须要遵守HTTP的相关协议

资源的表述

这其实就是资源的展现形式,我们客户端和服务端传输的都是资源的表述,而不是资源本身。例如文本资源可以采用html、xml、json等格式,图片可以使用PNG或JPG展现出来。那么客户端如何知道服务端提供哪种表述形式呢,可以通过HTTP内容协商,客户端可以通过Accept头请求一种特定格式的表述,服务端则通过Content-Type告诉客户端资源的表述形式。这些资源的表述呈现在页面上,就是我们说的资源状态。

状态转移

我们在看页面的时候,从当前资源的表述(也可以说状态或者表现层)会跳转到其他的资源状态。服务端通过超媒体告诉客户端当前状态有哪些后续状态可以进入。这些类似"下一页"之类的链接起的就是这种推进状态的作用——指引你如何从当前状态进入下一个可能的状态。

总结:

  • 在web中,只要有被引用的必要都叫资源。
  • 每个URI代表一个资源,独一无二的。
  • 客户端通过HTTP的方法,对服务器端资源进行操作;
  • 客户端和服务器之间,传递这种资源的某种表现层;
  • 通过超链接的指引,实现"表现层状态转移"。

RESTFUL

如果一个架构符合REST的约束条件和原则,我们就称它为RESTful架构。

一种软件的架构风格,设计风格,  为客户端和服务端的交互提供一组设计原则和约束条件。

同样的,restful只是一个规范或者约束条件,并不是硬性规定,但建议遵守这项在程序开发界都遵守的规则。

有哪些规范

一  面向资源编程

  每个URL代表一种资源,URL中尽量不要用动词,要用名词,比如:/baidu.com/user/list/

二  根据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=2&keyword=test

六  尽量使用HTTPS

  https://www.bootcss.com/v1/mycss

七  响应时设置状态码

  • 1**:信息,服务器收到请求,需要请求者继续执行操作
  • 2**:成功,操作被成功接收并处理
  • 3**:重定向,需要进一步的操作以完成请求
  • 4**:客户端错误,请求包含语法错误或无法完成请求
  • 5**:服务器错误,服务器在处理请求的过程中发生了错误

八  返回值

  GET请求 返回查到所有或单条数据

  POST请求  返回新增的数据

  PUT请求  返回更新数据

  PATCH请求  局部更新  返回更新整条数据

  DELETE请求  返回值为空

九  返回错误信息

  返回值携带错误信息

十   Hypermedia API

  如果遇到需要跳转的情况 携带调转接口的URL

  ret = {
                code: 1000,
                data:{
                    id:1,
                    name:'小明',
                    content_id:http://www.xxx.com/api/v1/content/8/
                }
            }

  

前后端分离djangorestframework——restful规范的更多相关文章

  1. 前后端分离djangorestframework——视图组件

    CBV与FBV CBV之前说过就是在view.py里写视图类,在序列化时用过,FBV就是常用的视图函数,两者的功能都可以实现功能,但是在restful规范方面的话,CBV更方便,FBV还要用reque ...

  2. 前后端分离djangorestframework—— 在线视频平台接入第三方加密防盗录视频

    加密视频 在以后的开发项目中,很可能有做在线视频的,而在线视频就有个问题,因为在线播放,就很有可能视频数据被抓包,如果这个在线视频平台有付费视频的话,这样就会有人做点倒卖视频的生意了,针对这个问题,目 ...

  3. 前后端分离djangorestframework—— 接入第三方的验证码平台

    关于验证码部分,在我这篇文章里说的挺详细的了:Python高级应用(3)—— 为你的项目添加验证码 这里还是再给一个前后端分离的实例,因为极验官网给的是用session作为验证的,而我们做前后端分离的 ...

  4. 前后端分离djangorestframework——分页组件

    Pagination 为什么要分页也不用多说了,大家都懂,DRF也自带了分页组件 这次用  前后端分离djangorestframework——序列化与反序列化数据  文章里用到的数据,数据库用的my ...

  5. 前后端分离djangorestframework——路由组件

    在文章前后端分离djangorestframework——视图组件 中,见识了DRF的视图组件强大,其实里面那个url也是可以自动生成的,就是这么屌 DefaultRouter urls文件作如下调整 ...

  6. 前后端分离和restful开发规范

    一.web开发的两种模式 1.前后端不分离 在前后端不分离的应用模式中,前端页面看到的效果都是由后端控制,由后端渲染页面或重定向,也就是后端需要控制前端的展示,前端与后端的耦合度很高. 这种应用模式比 ...

  7. 前后端分离djangorestframework——序列化与反序列化数据

    我们写好后端的代码,要把数据交给前端的展示的,这个数据以什么类型给前端呢?学到这里,我们已经知道这个数据最好是json字符串才行,因为网络间的传输,只认字符串或者二进制,字符串就是我们的数据,二进制就 ...

  8. 前后端分离与 restful api

    为什么要前后端分离(优点): PC,APP,PAD 多端适应 单页面应用(Single Page Application)SPA开发模式开始流行 前后端开发职责不清 开发效率问题,前后端互相等待 前端 ...

  9. 前后端分离djangorestframework——认证组件

    authentication 认证是干嘛的已经不需要多说.而前后端未分离的认证基本是用cookie或者session,前后端分离的一般用token 全局认证 先创建一个django项目,项目名为drf ...

随机推荐

  1. 10分钟学会使用YOLO及Opencv实现目标检测(下)|附源码

    将YOLO应用于视频流对象检测 首先打开 yolo_video.py文件并插入以下代码: # import the necessary packages import numpy as np impo ...

  2. Tomcat他山之石.可以攻玉(一)Server组件

    Server组件 Server组件作用: 采用观察者模式,又叫源-收听者的设计模式,提供了可以动态添加.删除的监听器,作用是在Server组件的不同生命周期中完成不同的功能.逻辑: Tomcat容器的 ...

  3. 教你用Python创建瀑布图

    介绍 对于绘制某些类型的数据来说,瀑布图是一种十分有用的工具.不足为奇的是,我们可以使用Pandas和matplotlib创建一个可重复的瀑布图. 在往下进行之前,我想先告诉大家我指代的是哪种类型的图 ...

  4. 十分钟了解ZAB(Zookeeper Atomic Broadcast)协议

    Zookeeper基于ZAB(Zookeeper Atomic Broadcast),实现了主备模式下的系统架构,保持集群中各个副本之间的数据一致性. ZAB协议定义了选举(election).发现( ...

  5. .NET CORE 实践(3)--Visual Studio 2015 Update 3更新之后DotNetCore.1.0.1-VS2015Tools.Preview2.0.2.exe无法正确安装

    打开 https://www.microsoft.com/net/core#windows,点击 https://go.microsoft.com/fwlink/?LinkId=691129下载vs2 ...

  6. C#委托。

    什么是委托. 委托是一种数据类型. 委托的作用. 把变化的东西封装起来. 委托是引用变量,声明后不赋值为null   所以使用前校验非空. class Program { static void Ma ...

  7. 数据库 'xxxx' 的事务日志已满。若要查明无法重用日志中的空间的原因

    一.出现的背景: 在SQL server中执行SQL语句出现如下图: 二.出现的原因: 我到数据库的服务器看了一下硬盘空间发现此数据库所在的D盘空间几乎已经用尽.如图: 三.解决方法: 第一种方法:直 ...

  8. IE6不兼容问题

    IE6不兼容问题 一.选择器兼容问题          1.交集选择器从IE7以上兼容(div.special): 2.儿子选择器(>):IE7开始兼容,IE6不兼容. 3.序选择器(first ...

  9. springboot 整合 redis

    jedis 和 lettuce 都是用来连接 redis 的客户端,jedis 如果不使用连接池是非线程安全的,lettuce 使用 netty 线程安全且并发性能更好: springboot 2.x ...

  10. saltstack部署配置

    共计使用三台虚拟机进行部署实验,系统环境:centos7.3 在master上进行部署配置: 配置主机名 [root@localhost ~]# hostname salt-master [root@ ...