python - 数据描述符(class 内置 get/set/delete方法 )

数据描述符(class 内置 get/set/del方法 ):

# 什么是描述符
# 官方的定义：描述符是一种具有“捆绑行为”的对象属性。访问（获取、设置和删除）它的属性时，实际是调用特殊的方法（_get_(),
# _set_(),_delete_()）。也就是说，如果一个对象定义了这三种方法的任何一种，它就是一个描述符。
# 更多的理解：
# 通常情况下，访问一个对象的搜索链是怎样的？比如a.x,首先，应该是查询 a._dict_[‘x’]，然后是type(a)._dict_[‘x’]，一直
# 向上知道元类那层止（不包括元类）。如果这个属性是一个描述符呢？那python就会“拦截”这个搜索链，取而代之调用描述符方法
# （_get_）。

# 描述符有什么作用？
# The default behavior for attribute access is to get, set, or delete the attribute from an object's dictionary.
# For instance, a.x has a lookup chain starting witha.__dict__[‘x'], then type(a).__dict__[‘x'], and continuing
# through the base classes of type(a) excluding metaclasses. If the looked-up value is an object defining one of
# the descriptor methods, then Python may override the default behavior and invoke the descriptor method instead.
# Where this occurs in the precedence chain depends on which descriptor methods were defined.
#                                                                                               —–摘自官方文档
# 简单的说描述符会改变一个属性的基本的获取、设置和删除方式。

# 数据描述符（data descriptor）和非数据描述符（non-data descriptors）
# 数据描述符：定义了_set_ 和_get_方法的对象
# 非数据描述符：只定义了_get_方法的对象。通常方法都是非数据描述符。

# 区别：
# 1、位于搜索链上的顺序。搜索链（或者优先链）的顺序大概是这样的：数据描述符＞实体属性（存储在实体的_dict_中）>非数据描述符。
# 这个顺序初看起来挺晦涩。解释如下：
# 获取一个属性的时候：
# 首先，看这个属性是不是一个数据描述符，如果是，就直接执行描述符的_get_，并返回值。
# 其次，如果这个属性不是数据描述符，那就按常规去从_dict_里面取。
# 最后，如果_dict_里面还没有，但这是一个非数据描述符，则执行非数据描述符的_get_方法，并返回。

# 三个方法（协议）：
# • _get_(self, instance, owner) —获取属性时调用，返回设置的属性值，通常是_set_中的value,或者附加的其他组合值。
# • _set_(self, instance, value) — 设置属性时调用，返回None.
# • _delete_(self, instance) — 删除属性时调用，返回None
# 其中，instance是这个描述符属性所在的类的实体，而owner是描述符所在的类。

# 为什么要区分数据描述符和非数据描述符？(访问属性的优先级不一样)
# 1.非数据描述符的获取属性的优先级链是，__getattribute__->找__dict__->找描述符，这条链的规则给了"缓存属性"理论支持(通常是这种)
# 2.数据描述符,又分为:
#     2.1 有__get__方法的覆盖型的获取属性的优先级链是，__getattribute__->找描述符，同时__set__方法也会覆盖对实例属性的赋值
# 操作，就是说任何外部对属性的赋值都将被__set__捕获，同时获取属性也是通过__get__方法获取，__dict__不再起直接作用。
#     2.2 没有__get__方法的覆盖型的获取属性优先级链是在没有对属性赋值时是__getattribute__->找描述符（返回描述符对象本身）
# ，对属性赋值了之后是__getattribute__->找__dict__->找描述符

# 对象属性的访问顺序：
# ①.实例属性
# ②.类属性
# ③.父类属性
# ④.__getattr__()方法

#数据描述符 - 优先级顺序:
# ① __getattribute__()， 无条件调用
# ② 数据描述符：由 ① 触发调用 （若人为的重载了该 __getattribute__() 方法，可能会调职无法调用描述符）
# ③ 实例对象的字典（若与描述符对象同名，会被覆盖哦）
# ④ 类的字典
# ⑤ 非数据描述符
# ⑥ 父类的字典
# ⑦ __getattr__() 方法

# 描述符有什么用和好处
# 1）一般情况下不会用到，建议：先定基本的，以后真有需要再扩展。别贪玩。
# 2）可以在设置属性时，做些检测等方面的处理
# 3）缓存？
# 4）设置属性不能被删除？那定义_delete_方法，并raise 异常。
# 5）还可以设置只读属性
# 6）把一个描述符作为某个对象的属性。这个属性要更改，比如增加判断，或变得更复杂的时候，所有的处理只要在描述符中操作就行了。

# #举例:
# @property
# #这就是一个数据描述符
# class Afff():
#     pass

# 更详尽的示例:
#摘录于:
#描述符阐述:
# https://blog.csdn.net/allenalex/article/details/54097319
#应用示例:
# https://www.jb51.net/article/91028.htm
#优先级阐述:
# https://www.cnblogs.com/Jimmy1988/p/6808237.html

 示例:

#描述符类(相当于代理)
#定义为了数据描述符：定义了_set_ 和_get_方法的对象
class Foo():
    def __get__(self, instance, owner):
        print("执行Foo get方法")
    def __set__(self, instance, value):
        print("执行Foo set方法")
    def __delete__(self):
        print("执行Foo del方法")

#主要运行的类:
class Test():
    #类的x属性被Foo代理,所以属性访问优先级也被修改:
    #类属性 > 数据描述符 > 实例属性 > 非实例属性 > __getattr__()
    x = Foo()
    def __init__(self,num):
        self.x = num

#因为x类属性被Foo代理,触发Foo的set方法,而set方法只是打印了,没有做数据操作,
abc = Test(100)
abc.x
print(abc.__dict__)

# print输出:-----------
# 执行Foo set方法
# 执行Foo get方法
# {}
# 执行Foo del方法
# print输出:-----------

 练习:

#描述符应用- 练习(判断录入类型是否合规)
class Test():
    def __init__(self, key,type_data):
        self.key = key
        self.type_data = type_data
    def __set__(self, instance, value):
        if isinstance(value,self.type_data):
            instance.__dict__[self.key] = value
        else:
            print("赋值类型错误")

class People():
    name =Test('name',str)
    def __init__(self,name,old):
        self.name = name
        self.old = old

#赋值为str类型
name = 'anec'
#赋值为int类型
name2 = 123

abc = People(name,23)
abc2 = People(name2,24)

print(abc.__dict__)
print(abc2.__dict__)