本篇介绍装饰器的原理和用法,力求通俗易懂。
我们从一个简单的例子开始,逐步展开。假设有一个函数,函数随便做点啥:
def foo(): print("do something.")
foo 和 bar 在英语中相当于汉语的张三、李四,意思就是随便给个名字。现在要给这个函数增加点功能,比如在函数调用前和调用后都打印一个输出提示。我们日常开发中经常有这类横向插入的需求,比如日志、权限检查等等。
在 Java 中,实现这个功能要用大代理模式,但在 Python 中却异常简单,我们只需要另外一个嵌套的函数,如下:
def outer(func): def inner(): print("before execution.") func() print("after execution.") return inner # 无括号
然后这样使用:
if __name__ == "__main__": proxy = outer(foo) proxy()
程序输出:
before execution.do something.after execution.
在 Python 中,一切都是对象,函数也是对象。所以
proxy = outer(foo)
就是把 foo 函数作为参数传给 outer 函数,而 outer 函数呢,返回值为 inner 函数,所以 proxy 变量也参照到 inner 函数,再执行 proxy() 语句,就是调用 inner 函数,我们看内函数 inner 的代码,一共有三个语句:
print("before execution.") # 打印输出func() # 执行 foo() 函数print("after execution.") # 打印输出
Python 提供了装饰器语法糖·(@decorater_name),让我们使用这种嵌套的函数更加简单。
下面是变更后的代码:
def outer(func): def inner(): # 代码同上,省略 return inner@outerdef foo(): print("do something.")if __name__ == "__main__": foo()
@outer 是一个语法糖,也就是我们所说的装饰器,这个 @outer 装饰器就是告诉 Python,在调用 foo 函数的时候,把它传给 outer 函数作为参数。outer 函数通过上述机制,既保证调用 foo 函数,也通过它自己的代码增强了 foo 的功能。
上述代码为了说明机制,代码极其简化,一般化的装饰器代码是这样的:inner 函数有两个参数,以增加其灵活性。假设我们的需求实现一个 logger 装饰器,记录函数被调用的时间:
from datetime import datetimedef logger(func): def wrapper(*args, **kwargs): print ('[INFO] {}, function "{}" was called '.format(datetime.now(), func.__name__)) return func(*args, **kwargs) return wrapper@loggerdef foo(): print("do something.")if __name__ == "__main__": foo()
因为装饰器器外部函数需要以 function 作为参数,所以如果调用函数需要有信息需要传给装饰器,就需要再增加一层嵌套。
from datetime import datetimedef logger(msg): def decorator(func): def wrapper(*args, **kwargs): print('[INFO] {}, "{}" was called with message "{}"'.format( datetime.now(), func.__name__, msg)) return func(*args, **kwargs) return wrapper return decorator@logger("Maybe bored.")def foo(name): print("do something, " + name)foo('Johnny')
装饰器也可以基于类来实现,要求装饰器类实现 __init__() 方法和 __call__() 方法。类装饰器实现 logger 的代码如下:
from datetime import datetimeclass logger(object): def __init__(self, func): self.func = func def __call__(self, *args, **kwargs): print ('[INFO] {}, function "{}" was called '.format( datetime.now(), self.func.__name__)) return self.func(*args, **kwargs)@loggerdef foo(): print("do something.")if __name__ == "__main__": foo()
如果觉得我的文章对您有用,请随意打赏。你的支持将鼓励我继续创作!