装饰器 decorator
或者称为包装器,是对函数的一种包装。
它能使函数的功能得到扩充,而同时不用修改函数本身的代码。
它能够增加函数执行前、执行后的行为,而不需对调用函数的代码做任何改变。
下面用一个简单的例子介绍装饰器:
# 函数hello,输出 hello + name 的字符串
def hello(name):
return 'hello ' + name
下面,我们希望在每一个调用 hello 函数的时候,将输出的字符串用 <tag>包住
比如:hello john 变成 <tag>hello john<tag>
方法1:自定义wrapper 函数
def wrapper(tag, func, *arg, **kvargs):
tag = "<" + tag + ">" #根据参数生成 <tag>
return tag + func(*arg, **kvargs) + tag #将<tag>加在func结果的首末 if __name__ == "__main__":
wrapper('p', hello, 'john') #输出: <p>hello john<p>
这种方法成功修改了函数 hello 的行为,不过需要修改对 hello的调用。
每一个调用hello 的地方,都要给成调用wrapper,并修改参数列表
方法2:自定义decorator 函数
为了不改变对 hello的调用。我们需要得到一个新的函数对象,它修改 hello的行为,并用这个对象对 hello赋值。
从而调用 hello的时候,调用的是扩充行为后的 hello
def myDecorator(func, tag)
def myWrapper(*arg, **kvargs): #重新包装func,其参数列表与func一致
sign = "<" + tag + ">"
return sign + func(*arg, **kvargs) + sign
return wrapper2 #调用 myDecorator 能返回一个函数对象,用于给func重新赋值 hello = myDecorator(hello, "div") #用新的函数对象修改hello if __name__ == "__main__":
hello("john") #输出 <div>hello john<div>
这样,只要hello被myDecorator 赋值一次,以后再调用hello 时,就调用的是包装后的函数
方式3:python的 decorator
python 的装饰器所做的事与方式2类似
它通过语法糖使装饰器看起来更清晰、简介,而不用每次都书写方式2中第7行代码 hello = myDecorator(hello, "div")
def setTag(tag): #由于此装饰器需要参数,所以要再套一层
def myDecorator(func): #装饰器的核心,接受函数对象做参数,返回包装后的函数对象
def myWrapper(*arg, **kvargs): #包装的具体过程
sign = "<" + tag + ">"
return sign + func(*arg, **kvargs) + sign
return myWrapper
return myDecorator @setTag("div") #用@标签在定义函数时套上装饰器
def hello(name):
return 'hello' + name
本质上,方式2 与 方式3 完成的是同一件事,只不过方式3 比方式2 代码更简洁,方便。
比如,现在要给 hello 函数套上三个标签<body><div><p>
如果用方式2
hello = myDecorator(myDecorator(myDecorator(hello, "body"),"div"),"p")
如果用方式3
@myDecorator("body")
@myDecorator("div")
@myDecorator("p")
def hello(name)
return 'hello' + name
在多个装饰器嵌套的情况下,python内置的decorator 结构更清晰。
装饰器语法总结
完成一个装饰器需要两步:1.定义装饰器函数 2.在被装饰的函数定义之前加上 @装饰器
下面的伪代码展示了这个过程
def myDecorator(...): #定义装饰器,可能带参数
def decorator(func): #装饰器核心,以被装饰的函数对象为参数,返回装饰后的函数对象
def wrapper(*args, **kvargs): #装饰的过程,参数列表适应不同参数的函数
... #修改函数调用前的行为
func(*args, **kvargs) #调用函数
... #修改函数调用后的行为
return wrapper
return decorator @myDecorator(...): #给函数加上装饰器
def myFunc(...): #自己定义的功能函数
...
参考:
[1] The Code Ship 中关于python装饰器的说明:http://thecodeship.com/patterns/guide-to-python-function-decorators/
[2] python 装饰器的主要用途与例子:https://wiki.python.org/moin/PythonDecoratorLibrary