Python descriptor-描述符

最近看Flask源码时发现很多不熟悉的语法,其中一个就是描述符,在config.py中出现,描述符的用处很多,是Python中很多特性的底层机制,如properties, methods, static methods, class methodssuper()

什么是描述符

描述符一般是一个有绑定动作的属性对象,这个属性的获取、赋值、删除操作和途径被描述符协议重写。对象属性的正常获取顺序是这样的,比如想要获取a.x,那么首先查找a.__dict__['x'],如果找不到则查看type(a).__dict__['x'],如果还没有则查看父类的__dict__

Python中有很多协议,比如迭代对象的迭代器协议,上下文管理协议等,都是靠重写类中以__开头和结尾的魔法方法来实现的。描述符协议也不例外,只要实现了__get__(self, instance, owner)__set__(self, instance, value)__delete__(self, instance)中任意一个或全部的方法,这个类就变成了一个描述符。如果只定义了__get__,则这是一个non-data descriptor,定义了__get____set__两个方法的是data descriptor,这里的区别,后面会提到。实现这些方法后,对属性进行操作时就不走正常途径,而是调用这几个魔法方法。需要注意的是,描述符必须是一个新式类。

为什么需要描述符

写过的Java的应该有一些印象,类里的属性一般是private的,如果想要拿到这个属性,一般是通过一个publicget_xxx方法来获得属性,重新赋值时也是一个道理。但是这样虽然隐藏了属性,但是后续写代码时都得用object.get_xxx()来获取值,而不是object.attr,显然第二种方式更简单,更美观,所以Python这种简洁的语言就提供了这样的更简洁的实现方式---描述符协议。

还有一种情况,假设有一个Person类,它有一个age属性,那么在对年龄赋值时是有一些限制的,比如必须是整数,必须大于0。所以应该在赋值时进行检查,这么一看好像赋值时又需要通过方法xiaoming.age=cls.examine_age(1000),又不美观了,而描述符协议可以在背地里帮我们做这种检查,而我们还是可以使用xiaoming.age=1000这个更简洁的语句。

这里有个我之前一直困惑的地方提一下,可能你们觉得不难,但是确实干扰了我很久。那就是这三个魔法方法定义在什么地方,还是回到上面那个例子,好像只有Person是一个类,所以我之前一直觉得应该定义在Person类中,但其实不是。魔法方法应该定义在一个Age类中,然后age属性是一个Age对象实例。

class Age(object):
    def __init__(self, age):
        self.age = age

    def __get__(self, instance, owner):
        print('instance={}, owner={}'.format(instance, owner))
        return self.age

    def __set__(self, instance, value):
        print('instance={}, value={}'.format(instance, value))
        if value < 0:
            raise AttributeError('age should > 0')
        self.age = value


class Person(object):
    age = Age(100)


xiaoming = Person()
xiaoming.age = 10
print(xiaoming)
print(xiaoming.age)

# output::::::::
# >>> instance=<__main__.Person object at 0x107a24310>, value=10
# >>> <__main__.Person object at 0x107a24310>
# >>> instance=<__main__.Person object at 0x107a24310>, owner=<class '__main__.Person'>
# >>> 10

方法中的instance属性返回的是获取属性的那个对象,在这里就是xiaomingowner是获取属性的对象的类,在这里就是Person

描述符的调用机制

上面提到了非描述符属性的获取途径,定义了描述符协议后,obj.b的操作将调用b.__get__(obj)这个方法来获取属性。描述符的调用机制根据调用对象是对象还是有一些区别。

描述符是通过type.__getattribute__()方法被调用,这也是为什么描述符必须是在新式类中的原因,继承自object的类被称为新式类,否则没有这个方法,则无法调用描述符的方法。

对于对象来说,object.__getattribute__()会将b.x 转换为 type(b).__dict__['x'].__get__(b, type(b))。这个转换通过下面这样的一个优先链:data descriptors大于实例变量,实例变量大于 non-data descriptors,如果存在__getattr__(),则__getattr__()优先级最低。完整的C实现在PyObject_GenericGetAttr() in Objects/object.c.

对于类来说,object.__getattribute__()会将 B.x 转换为B.__dict__['x'].__get__(None, B)。Python实现如下:

def __getattribute__(self, key):
    "Emulate type_getattro() in Objects/typeobject.c"
    v = object.__getattribute__(self, key)
    if hasattr(v, '__get__'):
        return v.__get__(None, self)
    return v

描述符实例

上面提到了一个最简单的描述符实例,就是对属性进行取值或者赋值时进行额外的操作,同时保持代码的简洁。描述符在Python语言中本来也有很多的应用,但是能力不够,不能很好的理解其中的奥妙,就不误导大家了。主要是Property,Function and methodstatic method and class method这几个方面,给出链接,有兴趣的可以钻研一下。

参考链接

Python Descriptors, Part 1 of 2

Descriptor HowTo Guide

©著作权归作者所有,转载或内容合作请联系作者
  • 序言:七十年代末,一起剥皮案震惊了整个滨河市,随后出现的几起案子,更是在滨河造成了极大的恐慌,老刑警刘岩,带你破解...
    沈念sama阅读 199,902评论 5 468
  • 序言:滨河连续发生了三起死亡事件,死亡现场离奇诡异,居然都是意外死亡,警方通过查阅死者的电脑和手机,发现死者居然都...
    沈念sama阅读 84,037评论 2 377
  • 文/潘晓璐 我一进店门,熙熙楼的掌柜王于贵愁眉苦脸地迎上来,“玉大人,你说我怎么就摊上这事。” “怎么了?”我有些...
    开封第一讲书人阅读 146,978评论 0 332
  • 文/不坏的土叔 我叫张陵,是天一观的道长。 经常有香客问我,道长,这世上最难降的妖魔是什么? 我笑而不...
    开封第一讲书人阅读 53,867评论 1 272
  • 正文 为了忘掉前任,我火速办了婚礼,结果婚礼上,老公的妹妹穿的比我还像新娘。我一直安慰自己,他们只是感情好,可当我...
    茶点故事阅读 62,763评论 5 360
  • 文/花漫 我一把揭开白布。 她就那样静静地躺着,像睡着了一般。 火红的嫁衣衬着肌肤如雪。 梳的纹丝不乱的头发上,一...
    开封第一讲书人阅读 48,104评论 1 277
  • 那天,我揣着相机与录音,去河边找鬼。 笑死,一个胖子当着我的面吹牛,可吹牛的内容都是我干的。 我是一名探鬼主播,决...
    沈念sama阅读 37,565评论 3 390
  • 文/苍兰香墨 我猛地睁开眼,长吁一口气:“原来是场噩梦啊……” “哼!你这毒妇竟也来了?” 一声冷哼从身侧响起,我...
    开封第一讲书人阅读 36,236评论 0 254
  • 序言:老挝万荣一对情侣失踪,失踪者是张志新(化名)和其女友刘颖,没想到半个月后,有当地人在树林里发现了一具尸体,经...
    沈念sama阅读 40,379评论 1 294
  • 正文 独居荒郊野岭守林人离奇死亡,尸身上长有42处带血的脓包…… 初始之章·张勋 以下内容为张勋视角 年9月15日...
    茶点故事阅读 35,313评论 2 317
  • 正文 我和宋清朗相恋三年,在试婚纱的时候发现自己被绿了。 大学时的朋友给我发了我未婚夫和他白月光在一起吃饭的照片。...
    茶点故事阅读 37,363评论 1 329
  • 序言:一个原本活蹦乱跳的男人离奇死亡,死状恐怖,灵堂内的尸体忽然破棺而出,到底是诈尸还是另有隐情,我是刑警宁泽,带...
    沈念sama阅读 33,034评论 3 315
  • 正文 年R本政府宣布,位于F岛的核电站,受9级特大地震影响,放射性物质发生泄漏。R本人自食恶果不足惜,却给世界环境...
    茶点故事阅读 38,637评论 3 303
  • 文/蒙蒙 一、第九天 我趴在偏房一处隐蔽的房顶上张望。 院中可真热闹,春花似锦、人声如沸。这庄子的主人今日做“春日...
    开封第一讲书人阅读 29,719评论 0 19
  • 文/苍兰香墨 我抬头看了看天上的太阳。三九已至,却和暖如春,着一层夹袄步出监牢的瞬间,已是汗流浃背。 一阵脚步声响...
    开封第一讲书人阅读 30,952评论 1 255
  • 我被黑心中介骗来泰国打工, 没想到刚下飞机就差点儿被人妖公主榨干…… 1. 我叫王不留,地道东北人。 一个月前我还...
    沈念sama阅读 42,371评论 2 346
  • 正文 我出身青楼,却偏偏与公主长得像,于是被迫代替她去往敌国和亲。 传闻我的和亲对象是个残疾皇子,可洞房花烛夜当晚...
    茶点故事阅读 41,948评论 2 341

推荐阅读更多精彩内容