【REST详述及RESTful规范】
"RESTful是一种软件的架构风格、设计风格,为客户端和服务端的交互提供了一组设计原则和约束条件.
如果一个架构符合REST的约束条件和原则,那么我们将称它为RESTful架构.
@
***
Web服务交互
我们在浏览器中能看到的每个网站,都是一个web服务。那么我们在提供每个web服务的时候,都需要前后端交互,前后端交互就一定有一些实现方案,我们通常叫web服务交互方案。
目前主流的三种web服务交互方案:
1. REST
(Respresentational State Transfer)表述性状态转移.
2. SOAP
(Simple Object Access Protocol) 简单的对象访问协议.
3. 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
如果我们想要理解restful,就得先理解Representational State Transfer这个词组的意思——==表征性状态转移==.
所谓的表征性状态转移,其实指的就是资源,通常我们称之为==资源状态转移==.
什么是资源?
任何事物,只要有被引用的必要,那么它就是一个资源.
我们在浏览器中看到的文本、图片、视频等等都是资源,这些都是实实在在存在的实体.
资源可以是一个实体,也可以是抽象概念,比如:
- 锦觅的个人信息
- 火神的琉璃净火
- 锦觅跟火神的关系
==在网络中,我们要引用的资源,一定要有一个标识,在Web中的唯一标识就是URI.==
URI我们不常听说,我们经常用的是URL,两者的区别如下.
什么是URI、URL?
==URI 统一资源标志符==
==URL 统一资源定位符==
没错,URI是给我们的资源进行标识的,URL是描述我们的资源地址的.
比如,我们每个人都有名字和身份证,名字可能会重复,但身份证是唯一的.
那么身份证号就可以是我们的URI,标识我们每个人,也可以说是标识我们每个人的资源.
我们可以通过身份证号找到嫦娥,也可以通过下面这种方式找到她...
嫦娥的住址:某某世界->银河系->猎户臂->太阳系->月亮...
这就是我们的URL.
我们通过这两种方式都可以找到我们的资源.
==其实我们的URL可以说是URI的子集,通过定位的方式实现的URI.==
这便是我们的资源定位,有了资源的地址后,我们是要去访问资源的.
那么我们如何访问资源呢?如下.
统一资源接口
我们通过URL去访问到资源,我们对资源会有很多不同的操作——增删改查.
以前我们可能会为了"增加"的功能,而设计一个新的URL,然后这个URL就只负责对数据的增加,还会为了更新和删除再分别设计一个URL.
现在我们不用了,==我们只需一个URL,然后根据HTTP请求方式的不同,对资源进行不同的操作,这个就是统一资源接口.==
我们一定要遵循HTTP请求方式的语义,也就是说POST请求就在新增数据等...
资源的表述
==资源的表述其实就是资源的展现形式,我们客户端和服务端传输的都是资源的表述,而不是资源本身.==
例如文本资源可以采用html、xml、json等格式,图片可以使用PNG或JPG展现出来.
那么客户端如何知道服务端提供哪种表述形式呢?
可以通过HTTP内容协商,客户端可以通过Accept头请求一种特定格式的表述,服务端则通过Content-Type告诉客户端资源的表述形式。
这些资源的表述呈现在页面上,就是我们说的资源状态.
状态转移
我们在看页面的时候,从当前资源的表述(也可以说状态或者表现层)会跳转到其他的资源状态。
服务端通过超媒体协议告诉客户端当前状态有哪些后续状态可以进入。
这些类似"下一页"之类的链接起的就是这种推进状态的作用——指引你如何从当前状态进入下一个可能的状态。
小结
总结下来,REST风格的特点如下:
- 在Web中,只要有被引用的必要,都叫资源.
- 每个URI代表一个资源,独一无二的.
- 客户端通过HTTP的方法,对服务器端资源进行操作.
- 客户端和服务器之间,传递这种资源的某种表现层.
通过超链接的指引,实现"表现层状态转移".
***RESTful规范
面向资源编程
: 每个URL代表一种资源,URL中尽量不要用动词,要用名词.
根据请求方式的不同,对资源进行不同的操作
: GET/POST/PUT/DELETE/PATCH
在URL中体现版本
: ·
在URL中体现是否是API
: ·
在URL中的过滤条件
: 比如:https:/ /www.bootcss.com/v1/mycss?page=3
尽量使用HTTPS协议
: 比如:https:/ /www.bootcss.com/v1/mycss
响应时设置状态码
: 100 信息,服务器收到请求,需要请求者继续执行操作.
: 200 成功,操作被成功接收并处理.
: 300 重定向,需要进一步的操作以完成请求.
: 400 客户端错误,请求包含语法错误或无法完成请求.
: 500 服务器错误,服务器在处理请求的过程中发生了错误.
: 也可以是自定义的状态码.
返回值
: get 返回查看的所有或单条数据
: post 返回更新的某条数据
: put/patch 返回更新的某条数据
: delete 返回值为空
Hypermedia API
: 如果遇到需要跳转的情况,请携带跳转接口的URL.
is ok.
***
"
【REST详述及RESTful规范】的更多相关文章
- RESTful规范
一. 什么是RESTful REST与技术无关,代表的是一种软件架构风格,REST是Representational State Transfer的简称,中文翻译为“表征状态转移” REST从资源的角 ...
- RESTful 规范
RESTful 规范 前言 rest 是一种软件架构风格,如果使用的是 rest 接口,那么就可以说你的接口是 restful. rest接口是围绕''资源''展开的,利用 HTTP 的协议,其实 r ...
- DjangoRestFramework 学习之restful规范 APIview 解析器组件 Postman等
DjangoRestFramework学习一之restful规范.APIview.解析器组件.Postman等 本节目录 一 预备知识 二 restful规范 三 DRF的APIView和解析器组件 ...
- RESTful规范1
RESTful规范 一 什么是RESTful REST与技术无关,代表的是一种软件架构风格,REST是Representational State Transfer的简称,中文翻译为"表征状 ...
- Django restful 规范
一.REST Frame Work REST与技术无关,代表的是一种软件架构风格,REST是Representational State Transfer的简称,中文翻译为"表征状态转移&q ...
- restful 规范(建议)
需求:开发cmdb,对用户进行管理. 做前后端分离,后端写api(URL),对用户表进行增删改查,应该写四个URL(还要给文档(返回值,返回,请求成功,干嘛,失败,干嘛)),然后分别写视图函数. ht ...
- restful规范快速记忆
restful规范: 十个规则: 用户发来请求,url必须: 1.因为是面向资源编程,所以每个URL代表一种资源,URL中尽量不要用动词,要用名词 2.尽量使用HTTPS,https代替http 3. ...
- 一、restful规范 二、CBV(View)源代码执行流程 三、drf框架安装和简单使用
一.restful规范 ''' 它是一个规范,面向资源架构 十条规范 1.API与用户的通讯协议,总是使用HTTPs协议,确保了网络传输的安全性 2.域名 --https://api.example. ...
- drf1 rest & restful规范
web服务交互 我们在浏览器中能看到的每个网站,都是一个web服务.那么我们在提供每个web服务的时候,都需要前后端交互,前后端交互就一定有一些实现方案,我们通常叫web服务交互方案. 目前主流的三种 ...
随机推荐
- 番外:可刷新PDB的管理操作(如何切换PDB Switching Over)
基于版本:19c (12.2.0.3) AskScuti 主题:可刷新PDB如何进行切换操作 内容说明:本篇延续如何克隆可刷新的PDB(Refreshable PDB)一文,进行切换实验. 具体请参考 ...
- <软件工程基础>
我是JX_Z,学习信息安全方向 //(怎么在这头不头尾不尾的地方弄个自我介绍这么尴尬呢) 之前也写过一些随笔记录自己的学习过程 软件工程基础课程中遇到的问题和学习心得都会记录在这篇文章中不断更新. 谢 ...
- msfconsole启动失败并报错`not_after=': bignum too big to convert into `long'的解决方法
1.启动msfconsole失败并报如下错误: /usr/share/metasploit-framework/lib/msf/core/payload/android.rb:86:in `not_a ...
- 浏览器缓存信息(Autocomplete )
Autocomplete HTML Attribute Not Disabled for Password Field 漏洞详细Web系统被识别到支持自动完成功能,这样通过浏览器可以获取到敏感信息. ...
- 《NVM-Express-1_4-2019.06.10-Ratified》学习笔记(8.21)-- Host Operation with Asymmetric Namespace Access Reporting
8.21 使用ANA报告的主机操作 8.21.1 主机ANA普通操作 主机通过在Identify Controller数据结构中CMIC域的第3位来判断是否支持ANA.NSID或标识(参考第7.10章 ...
- Python调用libsvm
# -*- coding: utf-8 -*- import os, sys path = r"D:\Program Files (x86)\libsvm-3.22\python" ...
- Shell脚本查询磁盘数量
之前帮朋友写的脚本,运维大数据服务器时候用的. #!/bin/bash ##磁盘数量 Disk=$( fdisk -l |grep 'Disk' |grep 'sd' |awk -F , '{prin ...
- 在多租户(容器)数据库中如何创建PDB:方法5 DBCA远程克隆PDB
基于版本:19c (12.2.0.3) AskScuti 创建方法:DBCA静默远程克隆PDB.将 CDB1 中的 PDB1 克隆为 CDB2 中的 ERP2 对应路径:Creating a PDB ...
- 【模板】堆优化的dijkstra
生命算法,以防忘记 #include<bits/stdc++.h> using namespace std; int head[200005],dis[200005],n,m,s,f,g, ...
- js -- 操作sqlite数据库
最近看到一个使用js来操作sqlite数据库的,测试了一下,具体使用的是 js操作类: https://github.com/kripken/sql.js/(sqlite js 驱动) 异步请求:ht ...