API总结

1. 什么是Webservice

WebService就是一个应用程序向外界暴露出一个能通过Web进行调用的API,也就是说能用编程的方法通过 Web 来调用这个应用程序。我们把调用这个WebService的应用程序叫做客户端,而把提供这个WebService的应用程序叫做服务端

2. 什么是RPC

RPC 全称 Remote Procedure Call—— 远程过程调用。在学校学编程,我们写一个函数都是在本地调用就行了。但是在互联网公司,服务都是部署在不同服务器上的分布式系统,如何调用呢? RPC 技术简单说就是为了解决远程调用服务的一种技术,使得调用者像调用本地服务一样方便透明。 下图是客户端调用远端服务的过程:

API总结

  1. 客户端client发起服务调用请求。
  2. client stub可以理解成一个代理,会将调用方法、参数按照一定格式进行封装,通过服务提供的地址,发起网络请求。
  3. 消息通过网络传输到服务端。
  4. server stub接受来自socket的消息 。
  5. server stub将消息进行解包、告诉服务端调用的哪个服务,参数是什么 。
  6. 结果返回给server stub
  7. sever stub把结果进行打包交给socket
  8. socket通过网络传输消息 。
  9. client slubsocket拿到消息。
  10. client stub解 包消息将结果返回给client。一个RPC框架就是把步骤2到9都封装起来。

3. 谈谈你对RESTfull规范的认识?

一种软件架构风格、设计风格,而不是标准,只是提供了一组设计原则和约束条件,规定如何编写以及如何设置返回值、状态码等信息

# -–-–API与用户的通信协议: https -–-–-– 

# -–-–-–-–-– 域名 -–-–-–-–-–-–-–-–-–-– 
    # 应该尽量将API部署在专用域名之下。 
    https://api.example.com

    #如果确定API很简单,不会有进一步扩展,可以考虑放在主域名下 
    https://example.org/api
        
#----------- 版 本 ------------------
    # 应该将API的版本号放入URL。
    https://api.example.com/v1/ 
        #另一种做法是,将版本号放在HTTP头信息中,但不如放入URL方便和直观 
        
# ------------ 路径 ------------------
    #视网络上任何东西都是资源,均使用名词表示(可复数) 
    https://api.example.com/v1/zoos 
    https://api.example.com/v1/animals 
    https://api.example.com/v1/employees

# --------- method -------------------
    GET :从服务器取出资源(一项或多项) 
    POST:在服务器新建一个资源 
    PUT:在服务器更新资源(客户端提供改变后的完整资源) 
    PATCH:在服务器更新资源(客户端提供改变的属性) 
    DELETE :从服务器删除资源

# ---------- 过滤 ----------------------
    # 通过在url上传参的形式传递搜索条件 
        https://api.example.com/v1/zoos?limit=10:指定返回记录的数量
        https://api.example.com/v1/zoos?offset=10:指定返回记录的开始位置
        https://api.example.com/v1/zoos?page=2&per_page=100:指定第几页,以及每页的记录
        https://api.example.com/v1/zoos?sortby=name&order=asc:指定返回结果按照哪个属性排序,以及排序顺序
        https://api.example.com/v1/zoos?animal_type_id=1:指定筛选条

#---------- 状态码 ------------
    200 OK:客户端请求成功,一般用于GET和POST请求
    400 Bad Request:客户端请求有语法错误,不能被服务器所理解。
    301 Moved Permanently:永久移动,请求的资源已被永久移动到新url,返回信息会包含新的url,浏览器会自动 定向到新url 
    401 Unauthorized:请求未经授权,这个状态代码必须和WWW-Authenticate报头域一起使用。
    403 Forbidden:服务器收到请求,但是拒绝提供服务。
    404 Not Found:请求资源不存在,举个例子:输入了错误的URL。
    500 Internal Server Error:服务器发生不可预期的错误。
    502 Bad Gateway: 充当网关或代理的服务器,从远端接收到一个无效的请求
    503 Server Unavailable:服务器当前不能处理客户端的请求,一段时间后可能恢复正常

# ------错误处理 --------------- 
状态码是4xx时,应返回错误信息,error当做key。 { error: "Invalid API key" } 


#------ 返回结果 -------------- 
    GET /collection:返回资源对象的列表(数组) 
    GET /collection/resource:返回单个资源对象 
    POST /collection:返回新生成的资源对象 
    PUT /collection/resource:返回完整的资源对象 
    PATCH /collection/resource:返回完整的资源对象 
    DELETE /collection/resource:返回一个空文档

4. 接口的幂等性是什么意思?

一个接口通过1次相同的访问,再对该接口进行N次相同的访问时,对资源不造影响就认为接口具有幂等性 

GET,  # 第一次获取结果、第二次也是获取结果对资源都不会造成影响,幂等。 

POST, # 第一次新增数据,第二次也会再次新增,非幂等。 

PUT,  # 第一次更新数据,第二次不会再次更新,幂等。 

PATCH,# 第一次更新数据,第二次不会再次更新,非幂等。 

DELTE,# 第一次删除数据,第二次不在再删除,幂等。 

5. 为什么要使用django rest framework框架?

# 在编写接口时可以不使用django rest framework框架, 

# 不使用:也可以做,可以用django的CBV来实现,开发者编写的代码会更多一些。 

# 使用:内部帮助我们提供了很多方便的组件,我们通过配置就可以完成相应操作
    如:'序列化'可以做用户请求数据校验 + queryset对象的序列化称为json
        '解析器'获取用户请求数据request.data,会自动根据content-type请求头的不能对数据进行解析 
        '分页'将从数据库获取到的数据在页面进行分页显示。 
        
# 还有其他组件:
    '认证'、'权限'、'访问频率控制

6. django rest framework框架中都有那些组件?

序列化、视图、认证、权限、限制

分页、版本控制、过滤器、解析器、渲染器

7. django rest framework框架中的视图都可以继承哪些类?

API总结

# ---- 继承APIView --------
# APIView继承于View ,但是重写了父类View中的dispatch(),将get、post、put的数据放入request。data中, 将请求的参数放入request.query_params
# ----继承GenericAPIView----
# 每一个接口都是生成一个序列化对象,实例化,调用data方法,对其进行封装
class GenericAPIView(views.APIView):
    queryset = None
    serializer_class = None
    
# python mixin(混合类):不能单独使用,和其它类搭配起来使用(利用了Python支持多继承)
class PublisherList(GenericView,ListMixin,CreateMixin): 
    queryset = models.Publisher.objects.all() 
    serializer_class = PublisherSerializer
       
# -----继承GenericViewSet ---------- 

# GenericViewSet(ViewSetMixin, generics.GenericAPIView):

# ViewSetMixin重写了as.view()方法,实现了根据请求的方法执行具体的类方法

# 路由注册的时候,利用actions参数,实现路由的定向分发 而不是简单的 反射

url(r'authors/$', views.AuthorViewSet.as_view(actions={
                                                        'get': 'list',
                                                        'post': 'create'
                                                    })),

# 作者列表
url(r'authors/(?P<pk>\d+)/$', views.AuthorViewSet.as_view( actions={
                                                        'get': 'retrieve',
                                                        'put': 'update',
                                                        'delete': 'destroy'
                                                    })),


# -----继承ModelViewSet ------
class ModelViewSet(mixins.CreateModelMixin,
                   mixins.RetrieveModelMixin,
                   mixins.UpdateModelMixin,
                   mixins.DestroyModelMixin,
                   mixins.ListModelMixin,
                   GenericViewSet)

#将不同的请求连接到不同的方法

8. django rest framwork 框架如何对QuerySet进行序列化?

序列化过程:ORM对象-->JSON格式数据 
反序列化:  JSON格式数据-->ORM对象

API总结

serializers.serializer

序列化过程:
    # (get请求)定义一个serializer类,继承serializers.Serializer,定义字段告诉REST框架,哪些字段(field),需要被序列化/反序列化
    
    # 使用serializer类,将查询结果集QuerySet传入,并标明 many=True,表示序列化多个 得到序列化的结果对象ser_obj,ser_obj.data即为得到的json格式的数据 反序列化过程:
    
1.若是post请求提交数据 request.data即为提交的json格式的数据, 使用serializer类对   数据进行反序列化 -->ser_obj对象 
   对ser_obj对象进行is_vaild()校验,此处可以自定义校验规则,具体参照上述表格        ser_obj.save()需要重写serializer.create方法 


2.若是put请求: 
    根据pk去查询具体的那本书籍对象obj 
    获取用户发送过来的数据并且更新对象, 赋值给instance的obj对象, partial=True的意识允许做局部更新 
    ser_obj = Serializer(instance=obj, data=request.data, partial=True) 
    对ser_obj对象进行is_vaild()校验,此处可以自定义校验规则,具体参照上述表格       ser_obj.save() 需要重写serializer.update方法
    

serializers.ModelSerializer

#序列化过程 - 不用定义字段
    class Meta:
        model = models.Book fields = "__all__"
        # depth = 1 # 所有有关系的字段都变成 read_only
        # exclude = [] # 排除某个字段
        extra_kwargs = { # 每个字段的一些额外参数 
            'publisher': {'write_only': True},
            'authors': {'write_only': True},
            'category': {'write_only': True},
        } 
#反序列化的过程: 
#.save() 直接一键更新或创建,已经封装了这两个方法 
#另外:SerializerMethodField 会自动去找 get_字段名 的方法执行 
class BookModelSerializer(serializers.ModelSerializer):
    # SerializerMethodField 会自动去找 get_字段名 的方法执行 
    category_info = serializers.SerializerMethodField(read_only=True)
    publisher_info = serializers.SerializerMethodField(read_only=True)
    authors_info = serializers.SerializerMethodField(read_only=True)
    def get_category_info(self, book_obj):
        return book_obj.get_category_display()
    
    def get_publisher_info(self, book_obj):
        return PublisherSerializer(book_obj.publisher).data
    
    def get_authors_info(self, book_obj):
        return AuthorSerializer(book_obj.authors.all(), many=True).data
    
    class Meta: model = models.Book
        fields = "__all__"
        # depth = 1 # 所有有关系的字段都变成 read_only
        # exclude = [] # 排除某个字段
        extra_kwargs = { # 每个字段的一些额外参数
            'publisher': {'write_only': True},
            'authors': {'write_only': True},
            'category': {'write_only': True},
        }

9. 简述django rest framwork 框架的认证流程?

# 1.认证、权限和限制是在执行请求之前做的,路由-->as.view()-->APIView中的dispatch()方法中的 initial 方法 
    self.initial(request, *args, **kwargs)

# 2.在initial函数中
    # Ensure that the incoming request is permitted
    self.perform_authentication(request) # 认证
    self.check_permissions(request) # 权限
    self.check_throttles(request) # 限制

# 3.执行perform_authentication方法,其中request.user是一个@property的函数

# 4.在user方法中通过 self._authenticate()函数,去执行_authenticate()方法,将当前请求的用户交给定义的在 authentication_classes=[]中的类的 authenticate进行身份验证

# 5.实现 BaseAuthentication中的authenticate方法,返回元组,元组的第一个元素赋值给 request.user 第二个元素复制给了request.auth(token) 

# 6.若是authenticate方法 抛错后,捕获到报错(raise),此时执行的 _not_authenticated 方法的,return 结果:user &auth 都赋值为None

10. Token:jwt替代session存储的方案

11. 简述django rest framwork框架的权限实现

# 1.认证、权限和限制是在执行请求之前做的,路由-->as.view()-->APIView中的dispatch()方法中的initial方法
    self.initial(request, *args, **kwargs)
# 2.在initial函数中
    # Ensure that the incoming request is permitted 
    self.perform_authentication(request)  # 认证 
    self.check_permissions(request)  # 权限 
    self.check_throttles(request)  # 限制
    
# 3.执行 check_permissions方法,从当前 permission_classes 列表中,执行 has_permission()方法,判断有没有权限

# 4.实现BasePermission中的has_permission()方法
class MyPermission(BasePermission):
    message = '只有VIP才能访问' 
    def has_permission(self, request, view): #通过上面的认证源码得知:当不输入token参数或者未登录,则 user ,auth 均为None,当auth存在则此时 的user不为None
        if not request.auth:
            return False
        #当有Vip才有权限访问
        #if request.user当前经过认证的用户对象
        if request.user.vip:
            return True else:
            #如果不是Vip就拒绝的范围
            return False

# 5.如果存在验证不通过,那么就执行self.permission_denied,然后这个异常在dispatch函数中被捕捉,当做结果传递给response

12. DRF如何实现用户访问频率控制 ( 匿名用户,注册用户 )

# 1.若是未注册用户,所以不可能经过认证,则此时user,auth 均为None

# 2.自定义allow_request方法 
    #拿到当前的请求的ip作为访问记录的key 
    #把当前的请求的访问记录拿出来保存到一个变量中 
    #循环访问历史,把超过10 秒钟的请求事件去掉 
    #在视图或者全局中进行配置
    

throttle.py

# 使用内置限制类
from rest_framework.throttling import SimpleRateThrottle
class VisitThrottle(SimpleRateThrottle):
    scope = "xxx"
    def get_cache_key(self, request, view):
        return self.get_ident(request)

settings.py

# 在settings文件中进行配置
"DEFAULT_THROTTLE_CLASSES": {["BAR.XXX.VisitThrottle", ],
                             "DEFAULT_THROTTLE_RATES": {
                                 "xxx": "1/s",
                             }
                             

API总结

上一篇:SetWindowPos函数详解


下一篇:windows中Crontab的使用