Python装饰器基础详解


Posted in Python onMarch 09, 2016

装饰器(decorator)是一种高级Python语法。装饰器可以对一个函数、方法或者类进行加工。在Python中,我们有多种方法对函数和类进行加工,比如在Python闭包中,我们见到函数对象作为某一个函数的返回结果。相对于其它方式,装饰器语法简单,代码可读性高。因此,装饰器在Python项目中有广泛的应用。

前面快速介绍了装饰器的语法,在这里,我们将深入装饰器内部工作机制,更详细更系统地介绍装饰器的内容,并学习自己编写新的装饰器的更多高级语法。

什么是装饰器

装饰是为函数和类指定管理代码的一种方式。Python装饰器以两种形式呈现:

【1】函数装饰器在函数定义的时候进行名称重绑定,提供一个逻辑层来管理函数和方法或随后对它们的调用。

【2】类装饰器在类定义的时候进行名称重绑定,提供一个逻辑层来管理类,或管理随后调用它们所创建的实例。

简而言之,装饰器提供了一种方法,在函数和类定义语句的末尾插入自动运行的代码——对于函数装饰器,在def的末尾;对于类装饰器,在class的末尾。这样的代码可以扮演不同的角色。
装饰器提供了一些和代码维护性和审美相关的有点。此外,作为结构化工具,装饰器自然地促进了代码封装,这减少了冗余性并使得未来变得更容易。

函数装饰器

通过在一个函数的def语句的末尾运行另一个函数,把最初的函数名重新绑定到结果。

用法

装饰器在紧挨着定义一个函数或方法的def语句之前的一行编写,并且它由@符号以及紧随其后的对于元函数的一个引用组成——这是管理另一个函数的一个函数(或其他可调用对象)。
在编码上,函数装饰器自动将如下语法:

@decorator 
def F(arg): 
... 
F(99)

映射为这个对等形式:

def F(arg): 
... 
F = decorator(F) 
F(99)

这里的装饰器是一个单参数的可调用对象,它返回与F具有相同数目的参数的一个可调用对象。
当随后调用F函数的时候,它自动调用装饰器所返回的对象。

换句话说,装饰实际把如下的第一行映射为第二行(尽管装饰器只在装饰的时候运行一次)

fun(6,7) 
decorator(func)(6,7)

这一自动名称重绑定也解释了之前介绍的静态方法和property装饰器语法的原因:

class C: 
@staticmethod 
def meth(...):... 
@property 
def name(self):...

实现

装饰器自身是返回可调用对象的可调用对象。实际上,它可以是任意类型的可调用对象,并且返回任意类型的可调用对象:函数和类的任何组合都可以使用,尽管一些组合更适合于特定的背景。

有一种常用的编码模式——装饰器返回了一个包装器,包装器把最初的函数保持到一个封闭的作用域中:

def decorator(F): 
def wrapper(*args): 
# 使用 F 和 *args 
# 调用原来的F(*args) 
return wrapper 
@decorator 
def func(x,y): 
... 
func(6,7)

当随后调用名称func的时候,它确实调用装饰器所返回的包装器函数;随后包装器函数可能运行最初的func,因为它在一个封闭的作用域中仍然可以使用。

为了对类做同样的事情,我们可以重载调用操作:

class decorator: 
def __init__(self,func): 
self.func = func 
def __call__(self,*args): 
# 使用self.func和args 
# self.func(*args)调用最初的func 
@decorator 
def func(x,y): 
... 
func(6,7)

但是,要注意的是,基于类的代码中,它对于拦截简单函数有效,但当它应用于类方法函数时,并不很有效:
如下反例:

class decorator: 
def __init__(self,func): 
self.func = func 
def __call__(self,*args): 
# 调用self.func(*args)失败,因为C实例参数无法传递 
class C: 
@decorator 
def method(self,x,y): 
...

这时候装饰的方法重绑定到一个类的方法上,而不是一个简单的函数,这一点带来的问题是,当装饰器的方法__call__随后运行的时候,其中的self接受装饰器类实例,并且类C的实例不会包含到一个*args中。

这时候,嵌套函数的替代方法工作得更好:

def decorator: 
def warpper(*args): 
# ... 
return wrapper 
@decorator 
def func(x,y): 
... 
func(6,7) 
class C: 
@decorator 
def method(self,x,y): 
... 
x = C() 
x.method(6,7)

类装饰器

类装饰器与函数装饰器使用相同的语法和非常相似的编码方式。类装饰器是管理类的一种方式,或者用管理或扩展类所创建的实例的额外逻辑,来包装实例构建调用。

用法

假设类装饰器返回一个可调用对象的一个单参数的函数,类装饰器的语法为:

@decorator 
class C: 
... 
x = C(99)

等同于下面的语法:

class C: 
... 
C = decorator(C) 
x = C(99)

直接效果是随后调用类名会创建一个实例,该实例会触发装饰器所返回的可调用对象,而不是调用最初的类自身。

实现

类装饰器返回的可调用对象,通常创建并返回最初的类的一个新的实例,以某种方式来扩展对其接口的管理。例如,下面的实例插入一个对象来拦截一个类实例的未定义的属性:

def decorator(cls): 
class Wrapper: 
def __init__(self,*args): 
self.wrapped = cls(*args) 
def __getattr__(self,name): 
return getattr(self.wrapped,name) 
return Wrapper 
@decorator 
class C: # C = decorator(C) 
def __init__(self,x,y): # Run by Wrapper.__init__ 
self.attr = 'spam' 
x = C(6,7) # 等价于Wrapper(6,7) 
print(x.attr)

在这个例子中,装饰器把类的名称重新绑定到另一个类,这个类在一个封闭的作用域中保持了最初的类。

就像函数装饰器一样,类装饰器通常可以编写为一个创建并返回可调用对象的“工厂”函数。

装饰器嵌套

有时候,一个装饰器不够,装饰器语法允许我们向一个装饰器的函数或方法添加包装器逻辑的多个层。这种形式的装饰器的语法为:

@A 
@B 
@C 
def f(...): 
...

如下这样转换:

def f(...): 
... 
f = A(B(C(f)))

这里,最初的函数通过3个不同的装饰器传递,每个装饰器处理前一个结果。

装饰器参数

函数装饰器和类装饰器都能接受参数,如下:

@decorator(A,B) 
def F(arg): 
... 
F(99)

自动映射到其对等形式:

def F(arg): 
... 
F = decorator(A,B)(F) 
F(99)

装饰器参数在装饰之前就解析了,并且它们通常用来保持状态信息供随后的调用使用。例如,这个例子中的装饰器函数,可能采用如下形式:

def decorator(A,B): 
# 保存或使用A和B 
def actualDecorator(F): 
# 保存或使用函数 F 
# 返回一个可调用对象 
return callable 
return actualDecorator

以上,这是装饰器的基础知识,接下来将学习编写自己的装饰器。

Python 相关文章推荐
python 字典(dict)遍历的四种方法性能测试报告
Jun 25 Python
python进阶教程之模块(module)介绍
Aug 30 Python
给Python入门者的一些编程建议
Jun 15 Python
浅谈Python的Django框架中的缓存控制
Jul 24 Python
Python中最大最小赋值小技巧(分享)
Dec 23 Python
python合并同类型excel表格的方法
Apr 01 Python
Linux-ubuntu16.04 Python3.5配置OpenCV3.2的方法
Apr 02 Python
python树莓派红外反射传感器
Jan 21 Python
python浪漫表白源码
Apr 05 Python
pandas读取CSV文件时查看修改各列的数据类型格式
Jul 07 Python
使用python+whoosh实现全文检索
Dec 09 Python
python 自动化偷懒的四个实用操作
Apr 11 Python
Python求算数平方根和约数的方法汇总
Mar 09 #Python
Python实现Linux命令xxd -i功能
Mar 06 #Python
基于Python实现一个简单的银行转账操作
Mar 06 #Python
Python切片知识解析
Mar 06 #Python
Django Admin实现上传图片校验功能
Mar 06 #Python
python如何通过protobuf实现rpc
Mar 06 #Python
使用Python保存网页上的图片或者保存页面为截图
Mar 05 #Python
You might like
深入PHP变量存储的详解
2013/06/13 PHP
PHP文件缓存类示例分享
2015/01/30 PHP
Yii1.1中通过Sql查询进行的分页操作方法
2017/03/16 PHP
PHP实现双链表删除与插入节点的方法示例
2017/11/11 PHP
PHP 数组操作详解【遍历、指针、函数等】
2020/05/13 PHP
JavaScript 字符编码规则
2009/05/04 Javascript
精心挑选的12款优秀的基于jQuery的手风琴效果插件和教程
2012/08/22 Javascript
javascript解决innerText浏览器兼容问题思路代码
2013/05/17 Javascript
使用jquery hover事件实现表格的隔行换色功能示例
2013/09/03 Javascript
javascript递归回溯法解八皇后问题
2015/04/22 Javascript
异步加载JS、CSS代码(推荐)
2016/06/15 Javascript
jQuery 调用WebService 实例讲解
2016/06/28 Javascript
BootStrap中Datepicker控件带中文的js文件
2016/08/10 Javascript
jquery注册文本框获取焦点清空,失去焦点赋值的简单实例
2016/09/08 Javascript
微信小程序  简单实例(阅读器)的实例开发
2016/09/29 Javascript
underscore之Collections_动力节点Java学院整理
2017/07/10 Javascript
react 父组件与子组件之间的值传递的方法
2017/09/14 Javascript
JS实现匀速与减速缓慢运动的动画效果封装示例
2018/08/27 Javascript
如何解决React官方脚手架不支持Less的问题(小结)
2018/09/12 Javascript
JS实现的小火箭发射动画效果示例
2018/12/08 Javascript
Vue核心概念Getter的使用方法
2019/01/18 Javascript
jQuery实现消息弹出框效果
2019/12/10 jQuery
[00:36]DOTA2上海特级锦标赛 LGD战队宣传片
2016/03/04 DOTA
轻松实现python搭建微信公众平台
2016/02/16 Python
Python简单计算数组元素平均值的方法示例
2017/12/26 Python
python中 * 的用法详解
2019/07/10 Python
django表单的Widgets使用详解
2019/07/22 Python
Python collections模块使用方法详解
2019/08/28 Python
浅谈图像处理中掩膜(mask)的意义
2020/02/19 Python
利用Storage Event实现页面间通信的示例代码
2018/07/26 HTML / CSS
俄语地区最大的中国商品在线购物网站之一:Umka Mall
2019/11/03 全球购物
英文导游欢迎词
2014/01/11 职场文书
中学生运动会入场词
2014/02/12 职场文书
教师考核材料
2014/05/21 职场文书
经理岗位职责范本
2015/04/15 职场文书
2015年城乡环境综合治理工作总结
2015/07/24 职场文书