• 前后端分离djangorestframework——restful规范


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

      

     

  • 相关阅读:
    数据仓库系列之ETL过程和ETL工具
    大数据从入门到精通
    Mysql误删表中数据与误删表的恢复方法(转)
    Vscode 小白使用介绍
    Window 通过cmd查看端口占用,杀死进程方法
    Python基础教程,Python入门教程(非常详细)
    tuxedo安装与配置入门
    Win10系统Ping端口及利用telnet命令Ping 端口
    Tuxedo 介绍
    hibernate框架的简单入门
  • 原文地址:https://www.cnblogs.com/Eeyhan/p/10413040.html
Copyright © 2020-2023  润新知