Python装饰器学习笔记

Python装饰器是Python语法的精髓，学会使用后能让代码更加简洁，代码更能复用，我们在写代码时有些功能会经常使用，比如读写文件，做短信验证校验等等，这些代码的功能实现大同小异，我们就可以使用装饰器来做到复用这类功能。

装饰器是什么？
要理解Python的装饰器，首先我们先理解一下Python的函数对象。我们知道，在Python里一切都是对象，函数也不例外，函数是第一类对象（first-class objects），它可以赋值给变量，也可以作为list的元素，还可以作为参数传递给其它函数。

函数可以被变量引用

定义一个简单的函数：

def say_hi():
    print('Hi!')
    say_hi()
# Output: Hi!

我们可以通过另外一个变量say_hi2来引用say_hi函数：

say_hi2 = say_hi
print(say_hi2)
# Output: <function say_hi at 0x7fed671c4378>

say_hi2()
# Output: Hi!

上面的语句中say_hi2 和 say_hi 指向了同样的函数定义，二者的执行结果也相同。

函数可以作为参数传递给其它函数

def say_more(say_hi_func):
    print('More')
    say_hi_func()

say_more(say_hi)
# Output:
# More
# Hi

在上面的例子中，我们把say_hi函数当做参数传递给say_more函数，say_hi 被变量 say_hi_func 引用。

函数可以定义在其它函数内部

def say_hi():
    print('Hi!')
    def say_name():
        print('Tom')
    say_name()

say_hi()
# Output:
#     Hi!
#     Tom

say_name() # 报错

say_name() # 报错
上述代码中，我们在say_hi()函数内部定义了另外一个函数say_name()。say_name()只在say_hi函数内部可见（即，它的作用域在say_hi函数内部)，在say_hi外包调用时就会出错。

函数可以返回其它函数的引用

def say_hi():
    print('Hi!')
def say_name():
    print('Tom')
return say_name

say_name_func = say_hi()
# 打印Hi!，并返回say_name函数对象
# 并赋值给say_name_func

say_name_func()
# 打印 Tom
上面的例子，say_hi函数返回了其内部定义的函数say_name的引用。这样在say_hi函数外部也可以使用say_name函数了。

前面我们理解了函数，这有助于我们接下来弄明白装饰器。

装饰器(Decorator)
装饰器是可调用对象(callable objects)，它用来修改函数或类。
可调用对象就是可以接受某些参数并返回某些对象的对象。Python里的函数和类都是可调用对象。

函数装饰器，就是接受函数作为参数，并对函数参数做一些包装，然后返回增加了包装的函数，即生成了一个新函数。

让我们看看下面这个例子：

def decorator_func(some_func):
    def wrapper_func(*args, **kwargs):
        print("Wrapper function started")
        some_func(*args, **kwargs)
        print("Wrapper function ended")
    
    return wrapper_func

@decorator_func    
def say_hi(name):
    print ("Hi!" + name)

上面例子中，decorator_func 就是定义的装饰器函数，它接受some_func作为参数。它定义了一个wrapper_func函数，该函数调用了some_func但也增加了一些自己的代码。

上面代码中使用装饰器的方法看起来有点复杂，其实真正的装饰器的Python语法是这样的：

装饰器的Python语法

@decorator_func
def say_hi():
    print 'Hi!'

@ 符合是装饰器的语法糖，在定义函数say_hi时使用，避免了再一次的赋值语句。

上面的语句等同于：

def say_hi():
    print 'Hi!'
say_hi = decorator_func(say_hi)

装饰器的顺序

@a
@b
@c
def foo():
    print('foo')

# 等同于：
foo = a(b(c(foo)))

带参数函数的装饰器

def decorator_func(some_func):
    def wrapper_func(*args, **kwargs):
        print("Wrapper function started")
        some_func(*args, **kwargs)
        print("Wrapper function ended")
    
    return wrapper_func

@decorator_func    
def say_hi(name):
    print ("Hi!" + name)

上面代码中，say_hi函数带有一个参数。通常情况下，不同功能的函数可以有不同类别、不同数量的参数，在写wrapper_func的时候，我们不确定参数的名称和数量，可以通过*args 和 **kwargs 来引用函数参数。

带参数的装饰器

不仅被装饰的函数可以带参数，装饰器本身也可以带参数。参考下面的例子：

def use_logging(level):
    def decorator(func):
        def wrapper(*args, **kwargs):
            if level == "warn":
                logging.warn("%s is running" % func.__name__)
            return func(*args)
        return wrapper

    return decorator

@use_logging(level="warn")
def foo(name='foo'):
    print("i am %s" % name)

简单来说，带参数的装饰器就是在没有参数的装饰器外面再嵌套一个参数的函数，该函数返回那个无参数装饰器即可。

类作为装饰器

前面我们提到装饰器是可调用对象。在Python里面，除了函数，类也是可调用对象。使用类装饰器，优点是灵活性大，高内聚，封装性。通过实现类内部的__call__方法，当使用 @ 语法糖把装饰器附加到函数上时，就会调用此方法。

class Foo(object):
    def __init__(self, func):
    self._func = func

def __call__(self):
    print ('class decorator runing')
    self._func()
    print ('class decorator ending')

@Foo
def say_hi():
    print('Hi!')

say_hi()
# Output:
# class decorator running
# Hi!
# class decorator ending

使用装饰器极大地复用了代码，但是他有一个缺点就是原函数的元信息不见了，比如函数的docstring、__name__、参数列表，先看看下面例子：

def decorator_func(some_func):
    def wrapper_func(*args, **kwargs):
        print("Wrapper function started")
        some_func(*args, **kwargs)
        print("Wrapper function ended")
    
    return wrapper_func

@decorator_func    
def say_hi(name):
    '''Say hi to somebody'''
    print ("Hi!" + name)

print(say_hi.__name__)  # Output: wrapper_func
print(say_hi.__doc__)   # Output: None

可以看到，say_hi函数被wrapper_func函数取代，它的__name__ 和 docstring 也自然是wrapper_func函数的了。
不过不用担心，Python有functools.wraps，wraps本身也是一个装饰器，它的作用就是把原函数的元信息拷贝到装饰器函数中，使得装饰器函数也有和原函数一样的元信息。

from functools import wraps
def decorator_func(some_func):
    @wraps(func)
    def wrapper_func(*args, **kwargs):
        print("Wrapper function started")
        some_func(*args, **kwargs)
        print("Wrapper function ended")
    
    return wrapper_func

@decorator_func    
def say_hi(name):
    '''Say hi to somebody'''
    print ("Hi!" + name)

print(say_hi.__name__)  # Output: say_hi
print(say_hi.__doc__)   # Output: Say hi to somebody

类的内置装饰器

类属性@property
静态方法@staticmethod
类方法@classmethod

通常，我们需要先实例化一个类的对象，再调用其方法。
若类的方法使用了@staticmethod或@classmethod，就可以不需要实例化，直接类名.方法名()来调用。
从使用上来看，@staticmethod不需要指代自身对象的self或指代自身类的cls参数，就跟使用普通函数一样。@classmethod不需要self参数，但第一个参数必须是指代自身类的cls参数。如果在@staticmethod中要调用到这个类的一些属性方法，只能直接类名.属性名，或类名.方法名的方式。
而@classmethod因为持有cls参数，可以来调用类的属性，类的方法，实例化对象等。

记录的学习猿人学Python教程笔记