一、定义
装饰器 decorator 或者称为包装器,是对函数的一种包装。
二、作用
- 它能使函数的功能得到扩充,而同时不用修改函数本身的代码。
- 它能够增加函数执行前、执行后的行为,而不需对调用函数的代码做任何改变。
三、举例
初始化函数
# 函数hello,输出 hello + name 的字符串
def hello(name):return 'hello ' + name
希望实现功能:在每一个调用 hello 函数的时候,将输出的字符串用 <tag>包住
例如:hello john 变成 <tag>hello john<tag>
方法一:自定义wrapper函数
这种方法成功修改了函数 hello 的行为,不过需要修改对 hello的调用。
每一个调用hello 的地方,都要给成调用wrapper,并修改参数列表
def hello(name):return 'hello ' + namedef wrapper(tag, func, *arg, **kvargs):tag = "<" + tag + ">"return tag + func(*arg, **kvargs) + tagif __name__ == "__main__":print(wrapper('p', hello, 'john'))
输出
方法二:自定义decorator函数
为了不改变对 hello的调用。我们需要得到一个新的函数对象,它修改 hello的行为,并用这个对象对 hello赋值。
从而调用 hello的时候,调用的是扩充行为后的 hello
def hello(name):return 'hello ' + namedef myDecorator(func, tag):def myWrapper(*arg, **kvargs): # 重新包装func,其参数列表与func一致sign = "<" + tag + ">"return sign + func(*arg, **kvargs) + signreturn myWrapperhello = myDecorator(hello, "div") # 用新的函数对象修改helloif __name__ == "__main__":print(hello("john"))
这样,只要hello被myDecorator 赋值一次,以后再调用hello 时,就调用的是包装后的函数
输出
方法三: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) + signreturn myWrapperreturn myDecorator@setTag("div") # 用@标签在定义函数时套上装饰器
def hello(name):return 'hello' + nameif __name__ == '__main__':print(hello('john'))
本质上,方式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 结构更清晰。
伪代码:
def myDecorator(...): #定义装饰器,可能带参数def decorator(func): #装饰器核心,以被装饰的函数对象为参数,返回装饰后的函数对象def wrapper(*args, **kvargs): #装饰的过程,参数列表适应不同参数的函数... #修改函数调用前的行为func(*args, **kvargs) #调用函数... #修改函数调用后的行为return wrapperreturn decorator@myDecorator(...): #给函数加上装饰器
def myFunc(...): #自己定义的功能函数...
知识点:
- 在python中,当*和**符号出现在函数定义的参数中时,表示任意数目参数收集。*arg表示任意多个无名参数,类型为tuple;**kwargs表示关键字参数,为dict,使用时需将*arg放在**kwargs之前,否则会有“SyntaxError: non-keyword arg after keyword arg”的语法错误
- 在函数调用时,*会以单个元素的形式解包一个元祖,使其成为独立的参数。
- 在函数调用时,**会以键/值对的形式解包一个字典,使其成为独立的关键字参数。