python中的装饰器decorator

墨蓝 2022-09-09 06:47 274阅读 0赞

python中的装饰器

装饰器是为了解决以下描述的问题而产生的方法

我们在已有的函数代码的基础上，想要动态的为这个函数增加功能而又不改变原函数的代码

例如有三个函数：

def f1(x):
        return x
    def f2(x):
        return x*x
    def f3(x):
        return x*x*x

而我们想为这三个函数增加一个函数调用打印功能 类似`print("call f1()")`

如果我们直接修改的话，需要对每个函数的内部进行改写。

所以为了简化代码，我们可以使用python内置的@装饰器的方法，可以做到修饰函数的功能

Python的 decorator 本质上就是一个高阶函数，它接收一个函数作为参数，然后，返回一个新函数。

装饰器可以极大地简化代码，避免每个函数写重复性代码

**不带参数的decorator**

例如我们可以编写一个@log可以打印函数调用的装饰器

def log(f):
        def fn(x):
            print ('call ' + f.__name__ + '()...')
            return f(x)
        return fn

然后我们可以测试一下

@log
    def f1(x):
        return x
    
    a=f1(1)
    print(a)

结果

call f1()...
    1

但是，对于参数不是一个的函数，调用将报错：

''' 学习中遇到问题没人解答？小编创建了一个Python学习交流QQ群：531509025 寻找有志同道合的小伙伴，互帮互助,群里还有不错的视频学习教程和PDF电子书！ '''
    @log
    def add(x, y):
        return x + y
    print (add(1, 2))
    
    Traceback (most recent call last):
      File "D:/pythonwork/cvworktest/final/practice.py", line 12, in <module>
        print (add(1, 2))
    TypeError: fn() takes 1 positional argument but 2 were given

这是因为add() 函数需要传入两个参数，但是 @log 写死了只含一个参数的返回函数。

要让 @log 自适应任何参数定义的函数，可以利用Python的`*args` 和`**kw`，保证任意个数的参数总是能正常调用：

def log(f):
        def fn(*args, **kw):
            print ('call ' + f.__name__ + '()...')
            return f(*args, **kw)
        return fn

现在，对于任意函数，@log 都能正常工作。

**带参数decorator**

上面的@log不带任何参数，同样我们可以编写一个带参数的decorator

例如如果有的函数非常重要，希望打印出’\[INFO\] call xxx()…’，有的函数不太重要，希望打印出’\[DEBUG\] call xxx()…’，这时

log函数本身就需要传入’INFO’或’DEBUG’这样的参数，类似这样：

@log('DEBUG')
    def my_func():
        pass

我们把它翻译成高阶函数就是这样：

my_func = log('DEBUG')(my_func)

展开：

log_decorator = log('DEBUG')
    my_func = log_decorator(my_func)

又相当于：

''' 学习中遇到问题没人解答？小编创建了一个Python学习交流QQ群：531509025 寻找有志同道合的小伙伴，互帮互助,群里还有不错的视频学习教程和PDF电子书！ '''
    log_decorator = log('DEBUG')
    @log_decorator
    def my_func():
        pass

所以，带参数的log函数首先返回一个decorator函数，再让这个decorator函数接收my\_func并返回新函数：

def log(content):
        def log_decorator(f):
            def fn(*args, **kw):
                print ('[%s] %s()...' % (content, f.__name__))
                return f(*args, **kw)
            return fn
        return log_decorator
    
    @log('DEBUG')
    def test():
        pass
    print (test())

结果：

[DEBUG] test()...
    None

**decorator的注意事项：**

经过@decorator“改造”后的函数，和原函数相比，除了功能多一点外，还有很重要的一点就是函数自身的改变

在没有decorator的情况下，打印函数名：

def f1(x):
        pass
    print (f1.__name__)

结果：

有decorator的情况下，再打印函数名：

''' 学习中遇到问题没人解答？小编创建了一个Python学习交流QQ群：531509025 寻找有志同道合的小伙伴，互帮互助,群里还有不错的视频学习教程和PDF电子书！ '''
    def log(f):
        def wrapper(*args, **kw):
            print ('call...')
            return f(*args, **kw)
        return wrapper
    @log
    def f2(x):
        pass
    print (f2.__name__)

结果：

wrapper

由于decorator返回的新函数函数名已经不是’f2’，而是@log内部定义的’wrapper’。这对于那些依赖函数名的代码就会失效。decorator还改变了函数的`__doc__`等其它属性。如果要让调用者看不出一个函数经过了@decorator的“改造”，就需要把原函数的一些属性复制到新函数中：

''' 学习中遇到问题没人解答？小编创建了一个Python学习交流QQ群：531509025 寻找有志同道合的小伙伴，互帮互助,群里还有不错的视频学习教程和PDF电子书！ '''
    def log(f):
        def wrapper(*args, **kw):
            print ('call...')
            return f(*args, **kw)
        wrapper.__name__ = f.__name__
        wrapper.__doc__ = f.__doc__
        return wrapper

这样写decorator很不方便，因为我们也很难把原函数的所有必要属性都一个一个复制到新函数上，所以Python内置的functools可以用来自动化完成这个“复制”的任务：

import functools
    def log(f):
        @functools.wraps(f)
        def wrapper(*args, **kw):
            print ('call...')
            return f(*args, **kw)
        return wrapper

注意：对于函数的参数信息哦我们无法确定，因为装饰器与原函数的参数名不一定一样