zoukankan      html  css  js  c++  java
  • 01: RestfulAPI与HTTP

    1.1 RestfulAPI与HTTP简介

      1、什么是RestfulAPI

          1、REST直接翻译:表现层状态转移,实质就是一种面向资源编程的方法
          2、REST描述的是在网络中client和server的一种交互形式;REST本身不实用,实用的是如何设计 RESTful API(REST风格的网络接口)
          3、RestfulAPI中认为网络上所有的东西都是一种资源,对这些资源操作时无非就是增删改查
          4、网络上的资源一般都用一段url代替,比如:http://www.chnsys.com/asset 代替资产资源
          5、根据发送请求的method方法判断如何操作这些资源
            GET(SELECT):             从服务器取出资源(一项或多项)。
            POST(CREATE):           在服务器新建一个资源。
            PUT(UPDATE):             在服务器更新资源(客户端提供改变后的完整资源)。
            DELETE(DELETE):       从服务器删除资源。
            PATCH(UPDATE):         在服务器更新资源(客户端提供改变的属性)。

       2、HTTP的第一行包含三个信息:谓词URLHTTP协议版本。三个数据使用空格隔开

            POST http://comet.chouti.com/comet/connect HTTP/1.1

        1、谓词(POST)

            1. WEB API就是使用谓词作为默认的路由方式,最常用的谓词有:POSTDELETEPUTGET,这四个谓词对应了“增、删、改、查”四个动作
            2. 其中,GET,DELETE不包含BODY,PUT,POST可以包含BODY

        2、URl

            1. 网络上的资源一般都用一段url代替,比如:http://www.chnsys.com/asset 代替资产资源

        3、HTTP协议版本

            1. HTTP的第一行内容就是这些: POST http://comet.chouti.com/comet/connect HTTP/1.1
            2. 接下来会有一个 来进行换行,接下来就是HTTP HEAD部分,HTTP HEAD描述了HTTP请求和响应。
            3. HTTP HEAD即为HTTP协议中最重要的部分,他包含了编码、BODY长度、内容协商等信息,你也可以包含一些自定义信息

      3、RestFul API中常用的HEAD信息   

          1. User-Agent:用户代理,是什么客户端发出的请求,如IE、Chrome、Fiddler等
          2. HOST:域名
          3. Authorization:验证信息
          4. Accept:接受何种序列化方式返回的数据,用MIME表示,用于对响应数据的内容协商,
              可以包含多个MIME,按优先顺序排列,如application/json,application/xml,text/html
          5. Content-Type:使用一个MIME表示,表示所发送请求的Body的序列化方式,常见的如application/json,
              还有WEB交互最常使用的application/x-www-form-urlencoded,都表示了你的body部分的序列化方式,在请求、响应中都会出现
          6. HTTP HEAD部分是HTTP协议中最核心的部分,可配置向非常多这里就不列举了
          7. 响应部分也分为头部和Body,响应头部和请求头部最大的不同在于响应首行存在一个HTTP Code
              HTTP Code作为API的调用状态的展示,也很重要,在REST API中最常用的状态码一般为2XX,4XX,5XX三个段
          8. 在首部之后有一个空行( )接下来就是Content,这里有具体的业务数据,根据不同的Content-Type使用不同的序列化方式表示,例如JSON,XML,甚至HTML

      4、用一张图为大家展示一下这些知识 

                  

    1.2 RestfulAPI使用举例

       1、创建django项目testRestfulAPI

    from django.conf.urls import url
    from django.contrib import admin
    from app01 import views
    
    urlpatterns = [
        url(r'^admin/', admin.site.urls),
        url(r'^asset/', views.AssetView.as_view()),
    ]
    urls.py
    from django.shortcuts import HttpResponse
    from django.views import View
    import json
    
    class AssetView(View):
        def get(self,request):                # 返回查询信息
            print('response_select',request.META.get('HTTP_HOSTNAME'))     # c1.com
            return HttpResponse(json.dumps({'status':'ok','method':'select'}))
    
        def post(self,request):              # 创建
            print('response_create',request.body)     # {"hostname": "c1.com"}
            return HttpResponse(json.dumps({'status':'ok','method':'create'}))
    
        def put(self,request):              # 更新
            print('response_update',request.body)     # {"hostname": "c1.com"}
            return HttpResponse(json.dumps({'status':'ok','method':'update'}))
    
        def delete(self,request):          # 删除
            print('response_delete',request.body)     # {"hostname": "c1.com"}
            return HttpResponse(json.dumps({'status':'ok','method':'delete'}))
    views.py

      2、创建文件test.py使用requests模块模拟增删改查(注释服务器端csrf)

    import requests
    
    # 1、查询
    response_select = requests.get('http://127.0.0.1:8000/asset/',
                            headers={'hostname':'c1.com'},
                            )
    print('response_select',response_select.json())      # {'method': 'select', 'status': 'ok'}
    
    # 2、创建
    response_create = requests.post('http://127.0.0.1:8000/asset/',
                            headers='',
                            json={'hostname':'c1.com'}
                            )
    print('response_create',response_create.json())      # {'status': 'ok', 'method': 'create'}
    
    # 3、更新
    response_put = requests.put('http://127.0.0.1:8000/asset/',
                            headers='',
                            json={'hostname':'c1.com'}
                            )
    print('response_update',response_put.json())         # {'method': 'update', 'status': 'ok'}
    
    # 4、删除
    response_delete = requests.delete('http://127.0.0.1:8000/asset/',
                            headers='',
                            json={'hostname':'c1.com'}
                            )
    print('response_delete',response_delete.json())     # {'status': 'ok', 'method': 'delete'}
    test.py
  • 相关阅读:
    Impala 加载Hive的UDF
    在编译器中调试spark程序处理
    转:Kafka 客户端TimeoutException问题之坑
    Apache Kafka系列(五) Kafka Connect及FileConnector示例
    Apache Kafka系列(四) 多线程Consumer方案
    Apache Kafka系列(三) Java API使用
    Apache Kafka系列(二) 命令行工具(CLI)
    ajax异步刷新
    Mybaties下的分页功能的实现
    读取配置文件的方法
  • 原文地址:https://www.cnblogs.com/xiaonq/p/8309200.html
Copyright © 2011-2022 走看看