Python descriptor 描述器

Descriptor HowTo Guide

概述介绍

python descriptor 包含了自定义的descriptor, 和built-in python descriptors 包含了函数,属性(properties),静态方法,类方法.

通常,一个descriptor是一个实例对象的绑定方法”binding behavior”, 他们的这些特性(attribute)可以通过descriptor协议来重写.这些方法为 __get__(), __set__(),__delete__().如果上述任何一个方法都被实例对象显式的定义,就可以称之为descriptor

对于默认的上述方法,则是对于实例对象(object)的字典进行get,set,delete操作.

例如: 执行a.x时,会进行一系列的操作:

• 首先 a.__dict__['x']
• 然后继续通过type(a),除了元类
• 当发现type(a)的基类定义了其中一种descriptor方法之后
• Python将会重写默认的方法,调用(invoke) descriptor方法

注意: 只有新式的对象或者类才能调用descriptor方法
(继承自object或者type的类是新式的类)

Descriptor Protocol(描述器协议)

descr.__get__(self, obj, type=None) -->value
descr.__set__(self, obj, value) -->Node
descr.__delete__(self,obj)

定义了任意一个方法的对象,都可以被称为一个descriptor并且重写默认的行为.

当一个对象同时定义了__get__(),__set__(),可以认为它是一个数据描述器(data descriptor),如果仅仅定义了__get__(),则它为非数据描述前(non-data descriptor)

数据描述器和非数据描述器不同在于如何重写进入实例字典的方法.

如果实例字典的入口函数名和数据描述器一样,则数据描述器优先;如果实例字典的入口函数名和非数据描述器一样,则字典入口函数优先

为了定义只读数据描述器则可以,定义__get__() ,__set()__ , 同时当__set()__函数调用时,抛出一个AttributeError的错误

Invoking Descriptors(调用描述器)

描述器可以直接的调用名字,`d.get(obj).更普遍的一种方法是,通过特性方法进行自动的调用

object.__getattribute__() 可以使 b.x 变为
type(b).__dict__['x'].__get__(b,type(b)).
这种实现方法的优先级顺序为:

1. data descriptors
2. instance variables
3. non-data descriptors
4. 最低的优先级 __getattr__() (如果提供了)

重要的点:

• descriptors 可以被 __getattribute__()方法调用
• 重写__getattribute__()阻止了desciptors的自动调用
• __getattribute__()只有新式类可用
• object.__getattribute__() 和 type.__getattribute__()对于调用__get__不同

Reference

python2.7 doc