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)通过超链接的指引,实现"表现层状态转移"。

rest规范:

一  面向资源编程

  每个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

  ret = {

code: 1000,

data:{

id:1,

name:‘小强‘,

depart_id:http://www.luffycity.com/api/v1/depart/8/

}

}

原文地址:https://www.cnblogs.com/duanhaoxin/p/9911505.html

时间: 2024-10-11 17:07:52

Restfull规范的相关文章

Django restfull规范

一. 什么是RESTful REST与技术无关,代表的是一种软件架构风格,REST是Representational State Transfer的简称,中文翻译为"表征状态转移" REST从资源的角度类审视整个网络,它将分布在网络中某个节点的资源通过URL进行标识,客户端应用通过URL来获取资源的表征,获得这些表征致使这些应用转变状态 REST与技术无关,代表的是一种软件架构风格,REST是Representational State Transfer的简称,中文翻译为"表

ASP.Net WebAPI与Ajax进行跨域数据交互时Cookies数据的传递

前言 最近公司项目进行架构调整,由原来的三层架构改进升级到微服务架构(准确的说是服务化,还没完全做到微的程度,颗粒度没那么细),遵循RESTFull规范,使前后端完全分离,实现大前端思想.由于是初次尝试,中途也遇到了不少问题.今天就来讨论一下其中之一的问题,WebAPI与前端Ajax 进行跨域数据交互时,由于都在不同的二级域名下(一级域名相同),导致Cookies数据无法获取. 最开始通过头部(Header)将Cookies传输到其WebAPI,也能解决问题. 下面讲述另外一种解决方案. 解决过

Restful API设计

理解RESTful架构 越来越多的人开始意识到,网站即软件,而且是一种新型的软件. 这种"互联网软件"采用客户端/服务器模式,建立在分布式体系上,通过互联网通信,具有高延时(high latency).高并发等特点. 网站开发,完全可以采用软件开发的模式.但是传统上,软件和网络是两个不同的领域,很少有交集:软件开发主要针对单机环境,网络则主要研究系统之间的通信.互联网的兴起,使得这两个领域开始融合,现在我们必须考虑,如何开发在互联网环境中使用的软件. RESTful架构,就是目前最流行

ASP.Net中关于WebAPI与Ajax进行跨域数据交互时Cookies数据的传递

本文主要介绍了ASP.Net WebAPI与Ajax进行跨域数据交互时Cookies数据传递的相关知识.具有很好的参考价值.下面跟着小编一起来看下吧 前言 最近公司项目进行架构调整,由原来的三层架构改进升级到微服务架构(准确的说是服务化,还没完全做到微的程度,颗粒度没那么细),遵循RESTFull规范,使前后端完全分离,实现大前端思想.由于是初次尝试,中途也遇到了不少问题.今天就来讨论一下其中之一的问题,WebAPI与前端Ajax 进行跨域数据交互时,由于都在不同的二级域名下(一级域名相同),导

面试题 315

近日恰逢老男孩全栈8期毕业季,课程后期大家"期待+苦逼"的时刻莫过于每天早上内容回顾和面试题问答部分[临近毕业每天课前用40-60分钟对之前内容回顾.提问和补充,专挑班里不爱说话就的同学回答]. 期待的是可以检验自己学习的成功:苦逼的是怎么又有东西没记住,但我们依然每天坚持一遍.一遍又一遍指导记住为止. 原本以为大家会把讲过的都记录下来,以便日后毕业复习,事实证明18岁的我还是太年轻. 一切想象的太美好,三番五次督促整理到自己笔记上,可是这群小子们就有不照干的呢. 最后同学们获胜,我还

Python面试题之前端和框架之155问 python开发

1. 谈谈你对http协议的认识. 2. 谈谈你对websocket协议的认识. 3. 什么是magic string ? 4. 如何创建响应式布局? 5. 你曾经使用过哪些前端框架? 6. 什么是ajax请求?并使用jQuery和XMLHttpRequest对象实现一个ajax请求. 7. 如何在前端实现轮训? 8. 如何在前端实现长轮训? 9. vuex的作用? 10. vue中的路由的拦截器的作用? 11. axios的作用? 12. 列举vue的常见指令. 13. 简述jsonp及实现原

不吹不擂,你想要的Python面试都在这里了【315+道题】

https://www.cnblogs.com/wupeiqi/p/9078770.html 近日恰逢学生毕业季,课程后期大家"期待+苦逼"的时刻莫过于每天早上内容回顾和面试题问答部分[临近毕业每天课前用40-60分钟对之前内容回顾.提问和补充,专挑班里不爱说话就的同学回答]. 期待的是可以检验自己学习的成功:苦逼的是怎么又有东西没记住,但我们依然每天坚持一遍.一遍又一遍指导记住为止. 原本以为大家会把讲过的都记录下来,以便日后毕业复习,事实证明18岁的我还是太年轻. 一切想象的太美好

python面试315问

转自:https://www.cnblogs.com/wupeiqi/p/9078770.html 写在前面 近日恰逢学生毕业季,课程后期大家"期待+苦逼"的时刻莫过于每天早上内容回顾和面试题问答部分[临近毕业每天课前用40-60分钟对之前内容回顾.提问和补充,专挑班里不爱说话就的同学回答]. 期待的是可以检验自己学习的成功:苦逼的是怎么又有东西没记住,但我们依然每天坚持一遍.一遍又一遍指导记住为止. 原本以为大家会把讲过的都记录下来,以便日后毕业复习,事实证明18岁的我还是太年轻.

python 前端、框架和其他(155题)

1 谈谈你对http协议的认识.2 谈谈你对websocket协议的认识.3 什么是magic string?4 如何创建响应式布局?5 你曾经使用过哪些前端框架?6 什么是ajax请求?并使用jQuery和XMLHttpRequest对象实现一个ajax请求.7 如何在前端实现轮训?8 如何在前端实现长轮训?9 vuex的作用?10 vue中的路由的拦截器的作用?11 axios的作用?12 列举vue的常见指令.13 简述jsonp及实现原理?14 是什么cors ?15 列举Http请求中