http://book.pythontips.com/en/latest/decorators.html
在《Built-in Functions(3.6)》和《Python上下文管理器》两篇笔记中,已经有了装饰器初步的示例,本篇结合一个高露洁大学牛人的博客来系统的解释下python中装饰器的作用。
一、首先提出一个统一的概念
Decorators are functions which modify the functionality of other functions. They help to make our code shorter and more Pythonic.
装饰器(也可以叫修饰器)的作用就是改变其他函数的运作方式,这可以使得代码更加简洁和Pythonic。
二、接下来一步一步的接近decorator
首先,函数是可以返回函数的,示例如下:
def hi(name="Leo"):
def greet():
return "恭喜!"
def welcome():
return "欢迎!"
if name == "Leo":
return greet
else:
return welcome
a = hi()
print(a)
#
# 这说明这里的a就是greet(),因为默认name="Leo",而return是不带括号的greet,这会返回一个函数而不是函数执行后的结果
print(a())
# 恭喜!
# 如果像上边那样print(a)那么得到的只是一个greet()函数,但如果是print(a())那么函数就会被执行,因此返回的是greet() return的内容
然后,函数当然也可以作为其他函数的参数:
def hi():
return "hi Leo!"
def doSomethingBeforeHi(func):
print("执行"+func.__name__+"()之前先打个666")
print(func())
doSomethingBeforeHi(hi)
# 执行hi()之前先打个666
# hi Leo!
到这里再次提出一个概念就可以很好被理解了,即:Python中所有的东西都可以看做一个object。无论是自定义函数还是基础的数据类型亦或是自定义的class或者实例,万物皆对象(很熟悉吧)。这些对象可以被作为输入也可以被返回。
三、好,接下来可以写一个decorator了
# coding=utf-8
def decorator(func):
def doSomethingBeforeFunc():
print("办正事之前先来点其他的。")
func()
return doSomethingBeforeFunc
def func():
print("真正要做的事在这里。")
func=decorator(func)
func()
# 办正事之前先来点其他的。
# 真正要做的事在这里。
我们可以看到func函数本来只是想打印一句话“真正要做的事在这里”,但是由于经过了decorator()的处理其行为发生了变化多打印了一句,这是因为decorator将func作为输入参数,并return了一个封装了func的函数,这个封装好的函数不仅包含了func()的功能还包含了print("办正事之前先来点其他的。")的功能,因此执行func=decorator(func)后func就不是原来的func了,实际上是doSomethingBeforeFunc()。
而常见的装饰器的调用方式并非上述func=decorator(func),而是使用@符号。
以下写法为,在定义func之前使用@decorator 调用装饰器,相当于在定义func之后执行了func=decorator(func):
# coding=utf-8
def decorator(func):
def doSomethingBeforeFunc():
print("办正事之前先来点其他的。")
func()
return doSomethingBeforeFunc
@decorator
def func():
print("真正要做的事在这里。")
func()
# 办正事之前先来点其他的。
# 真正要做的事在这里。
这段代码与上面的代码的作用是一模一样的,只不过下边的写法更为常见,更Pythonic(更对新手不友好)。
四、上述代码的一个BUG
如果我们对上述代码中使用了decorator后的func打印__name__会如何?很容易猜到得到的肯定是doSomethingBeforeFunc这个名字,这一般不是我们想要的。
# coding=utf-8
from functools import wraps
def decorator(func):
@wraps(func)
def doSomethingBeforeFunc():
print("办正事之前先来点其他的。")
func()
return doSomethingBeforeFunc
@decorator
def func():
print("真正要做的事在这里。")
func()
print(func.__name__)
# 办正事之前先来点其他的。
# 真正要做的事在这里。
# func
通过引入functools的wraps方法,可以解决__name__的显示问题。至于wraps是通过什么样的机制实现的,源码实在是太绕了就不去看了。简单来说就是wraps可以让我们获取func()被修饰器修饰之前的各种内置属性。
五、Decorator的经典使用场景
在Python中装饰器一个很经典的使用场景是Django里常见的需要密码验证的时候,举个例子:
# coding=utf-8
from functools import wraps
def require_login(func):
@wraps(func)
def new_func(*args, **kwargs):
auth = request.authorization
if not auth or check_auth(auth.username, auth.password):
authenticate()
return func(*args, **kwargs)
return new_func
@require_login
def func():
print("浏览页面中...")
上述只是一段伪代码示例,django中可以直接调用相关的模块:
from django.contrib.auth.decorators import login_required
六、不仅仅是decorator函数,还可以是decorator类
之前的示例全都是修饰器函数,实际上修饰器还可以是类。只要类可以像函数那样被调用就可以了:
# coding=utf-8
class Decorator(object):
def __init__(self , func):
self.func = func
def __call__(self, *args, **kwargs): # 只要重写类的__call__方法就可以将类当做函数调用
print("嘿!孙贼!")
return self.func(*args, **kwargs)
@Decorator
def Charge():
print("正在向法爷冲锋!!!")
Charge()