RESTful规范

RESTful

      web服务交互                   

咱们在浏览器中能看到的每一个网站,都是一个web服务。那么咱们在提供每一个web服务的时候,css

都须要先后端交互,先后端交互就必定有一些实现方案,咱们一般叫web服务交互方案。web

目前主流的三种web服务交互方案:编程

    -- REST ( Representational State Transfer)表述性状态转移后端

    -- SOAP (Simple Object Access Protocol)  简单的对象访问协议api

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

什么是资源

  任何事物,只要有被引用到的必要,它就是一个资源。

  咱们在浏览器中看到的文本,视频,图片等等都是资源。这些都是实实在在存在的实体。

  资源能够是一个实体,也能够是抽象概念。

什么是URI,URL

  URI 统一资源标志符。

  URL 统一资源定位符。

  URI是给咱们的资源进行标识的,URL是描述咱们资源地址的。

统一资源接口

      如今咱们能够经过URL去访问到资源,那么咱们对资源会有不少不一样的操做,增删改查,

  之前咱们可能会为了这个增长新设计一个URL,而后这个URL就是对数据进行增长的,

  还会为了更新和删除分别设计一个URL,如今咱们不用了,咱们只有一个URL,

  而后根据HTTP请求方式的不一样,对资源进行不一样的操做,这个就是是统一资源接口。

  咱们必定要遵循HTTP请求方法的语义,也就是说POST请求就在新增数据等....

资源的表述

  资源的表述其实就是资源的展示形式,咱们客户端和服务端传输的都是资源的表述,而不是资源自己。

状态转移

  咱们在看页面的时候,从当前资源的表述(也能够说状态或者表现层)会跳转到其余的资源状态。

  服务端经过超媒体告诉客户端当前状态有哪些后续状态能够进入。

  这些相似"下一页"之类的连接起的就是这种推动状态的做用——指引你如何从当前状态进入下一个可能的状态。

总结

  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

相关文章
相关标签/搜索