Python中的类与描述器(Descriptors)

Python中的类与描述器(Descriptors)

描述器的表现

魔术方法	说明
__get__(self,instance,owner)	获取所有者类的属性，定义了该函数，那么该类就是一个"非数据描述器"
__set__(self,instance,value)	设置所有者类的属性，如果一个"非数据描述器"定义了该函数，那么就是"数据描述器"
__delete__(self,instance)	删除所有者类的属性

1. 参数介绍：
   • self指代当前类的实例，调用者
   • instance是个实例，是owner的实例
   • owner是属性的所属的类

描述器

• 在类中只要定义了__get__,__set__,__delete__三个方法之一，那么该类就是一个描述器
  1. 实现了__get__，就是非数据描述器non-data descriptor
  2. 实现了__get__,__set__就是数据描述器 data descriptor
  3. 实现了__get__,__delete__方法，也是数据描述器
  4. 实现了__get__,__set__,__delete方法，同样也是数据描述器
• 如果一个类的类属性设置为描述器示例，那么它被称为owner属主
• 当该类的类属性被查找、设置、删除时，就会调用描述器相应的方法。

注意：

1. 当一个类的类属性被描述器描述那么在该类，或该类的实例访描述器或描述器的属性时，一定会通过__get__方法。而该类的类属性的值取决于描述器中__get__方法的返回值
2. 非数据描述器不会改变属性的访问顺序
3. 数据描述器会改变属性的访问顺序。会优先访问数据描述器描述的属性。
4. 实例化对象在访问父类属性时，继承体系的优先级，高于"数据描述器"修饰的属性的优先级。
   • 数据描述器无法改变继承体系中属性访问的优先级，只能改变实例化属性访问的优先级。如果实例化对象访问的属性被父类拦截，其祖先类中被“数据描述器”修饰的属性优先级会被最近父类的属性拦截。

非数据描述器

• 如果类中的类属性被一个非数据描述器描述，那么改类的类属性值取决于非数据描述器中的__get__方法的返回值。
• 非数据描述器不会改变属性的访问顺序

1. 简单示例：

class A:
    def __init__(self):
        self.z = 10

    def __get__(self, instance, owner):
        print("--get--被调用",self, instance, owner)
        return self  #如果是None，或其他值，那么b.x或B.x的返回值就是None或其他值。

class B:
    x = A()
    y = 10
    z = A()

    def __init__(self):
        self.y = 2
        self.a = A()
        self.z = 18

b = B()
print(b.a)
print(b.y,b.z,b.a)
print("------------------------------")
print(b.a.z)  #不会调用A中的__get__
print(b.__class__.z)  #可以看到instance值为None,因为不是B的实例调用
print("***********")
print(b.x.z)  #会调用A中的__get__
print(B.x.z)  #会调用A中的__get__
print("***********")
B.x = 10
print(b.x)

• 上面示例可以看出：__get__(self,instance,owner)方法的签名，会传入3个参数
  1. B.x调用时，self表示A的实例，instance为None,owner为B类
  2. b.x调用时，self表示A的实例，instance为B的实例b,owner为B类

数据描述器

带__set__的数据描述器

• 实现了__get__,__set__就是数据描述器 data descriptor

• 数据描述器会改变属性的访问顺序。会优先访问数据描述器描述的属性。

• 3.6新增描述器方法__set_name__(self,owner,name),它在属主类构建的时候会调用。（注意：目前动态的为属主owner类使用setattr注入类属性时，不会调用(本人怀疑可以能是bug)）

• 实现了__get__,__delete__方法，也是数据描述器

• 简单示例：

class A:
    def __init__(self):
        self.z = 10

    def __get__(self, instance, owner):
        prin