Python装饰器(Decorators )

http://book.pythontips.com/en/latest/decorators.html

在《Built-in Functions(3.6)》和《Python上下文管理器》两篇笔记中,已经有了装饰器初步的示例,本篇结合一个高露洁大学牛人的博客来系统的解释下python中装饰器的作用。

一、首先提出一个统一的概念

Decorators are functions which modify the functionality of other functions. They help to make our code shorter and more Pythonic.

装饰器(也可以叫修饰器)的作用就是改变其他函数的运作方式,这可以使得代码更加简洁和Pythonic。

二、接下来一步一步的接近decorator

首先,函数是可以返回函数的,示例如下:

def hi(name="Leo"):
    def greet():
        return "恭喜!"

    def welcome():
        return "欢迎!"

    if name == "Leo":
        return greet
    else:
        return welcome

a = hi()
print(a)
# 
# 这说明这里的a就是greet(),因为默认name="Leo",而return是不带括号的greet,这会返回一个函数而不是函数执行后的结果

print(a())
# 恭喜!
# 如果像上边那样print(a)那么得到的只是一个greet()函数,但如果是print(a())那么函数就会被执行,因此返回的是greet() return的内容

 然后,函数当然也可以作为其他函数的参数:

def hi():
    return "hi Leo!"

def doSomethingBeforeHi(func):
    print("执行"+func.__name__+"()之前先打个666")
    print(func())

doSomethingBeforeHi(hi)
# 执行hi()之前先打个666
# hi Leo!

到这里再次提出一个概念就可以很好被理解了,即:Python中所有的东西都可以看做一个object。无论是自定义函数还是基础的数据类型亦或是自定义的class或者实例,万物皆对象(很熟悉吧)。这些对象可以被作为输入也可以被返回。

而装饰器的核心也就是上边提出的:为了使代码更加简洁。因为把所有功能写在一个函数里会显得很臃肿,因此把一部分功能先写出来,作为另一个函数的输入,这可以使得代码更加轻便。

三、好,接下来可以写一个decorator了

# coding=utf-8
def decorator(func):
    def doSomethingBeforeFunc():
        print("办正事之前先来点其他的。")
        func()
    return doSomethingBeforeFunc

def func():
    print("真正要做的事在这里。")

func=decorator(func)
func()
# 办正事之前先来点其他的。
# 真正要做的事在这里。

我们可以看到func函数本来只是想打印一句话“真正要做的事在这里”,但是由于经过了decorator()的处理其行为发生了变化多打印了一句,这是因为decorator将func作为输入参数,并return了一个封装了func的函数,这个封装好的函数不仅包含了func()的功能还包含了print("办正事之前先来点其他的。")的功能,因此执行func=decorator(func)后func就不是原来的func了,实际上是doSomethingBeforeFunc()。

而常见的装饰器的调用方式并非上述func=decorator(func),而是使用@符号。

以下写法为,在定义func之前使用@decorator 调用装饰器,相当于在定义func之后执行了func=decorator(func):

# coding=utf-8
def decorator(func):
    def doSomethingBeforeFunc():
        print("办正事之前先来点其他的。")
        func()
    return doSomethingBeforeFunc
@decorator 
def func():
    print("真正要做的事在这里。")

func()
# 办正事之前先来点其他的。
# 真正要做的事在这里。

这段代码与上面的代码的作用是一模一样的,只不过下边的写法更为常见,更Pythonic(更对新手不友好)。

四、上述代码的一个BUG

如果我们对上述代码中使用了decorator后的func打印__name__会如何?很容易猜到得到的肯定是doSomethingBeforeFunc这个名字,这一般不是我们想要的

# coding=utf-8
from functools import wraps
def decorator(func):
    @wraps(func)
    def doSomethingBeforeFunc():
        print("办正事之前先来点其他的。")
        func()
    return doSomethingBeforeFunc

@decorator
def func():
    print("真正要做的事在这里。")

func()
print(func.__name__)
# 办正事之前先来点其他的。
# 真正要做的事在这里。
# func

通过引入functools的wraps方法,可以解决__name__的显示问题。至于wraps是通过什么样的机制实现的,源码实在是太绕了就不去看了。简单来说就是wraps可以让我们获取func()被修饰器修饰之前的各种内置属性。

五、Decorator的经典使用场景

在Python中装饰器一个很经典的使用场景是Django里常见的需要密码验证的时候,举个例子:

# coding=utf-8
from functools import wraps
def require_login(func):
    @wraps(func)
    def new_func(*args, **kwargs):
        auth = request.authorization
        if not auth or check_auth(auth.username, auth.password):
            authenticate()
        return func(*args, **kwargs)
    return new_func

@require_login
def func():
    print("浏览页面中...")

上述只是一段伪代码示例,django中可以直接调用相关的模块:

from django.contrib.auth.decorators import login_required

六、不仅仅是decorator函数,还可以是decorator类

之前的示例全都是修饰器函数,实际上修饰器还可以是类。只要类可以像函数那样被调用就可以了:

# coding=utf-8
class Decorator(object):
    def __init__(self , func):
        self.func = func
    def __call__(self, *args, **kwargs):  # 只要重写类的__call__方法就可以将类当做函数调用
        print("嘿!孙贼!")
        return self.func(*args, **kwargs)

@Decorator
def Charge():
    print("正在向法爷冲锋!!!")

Charge()

你可能感兴趣的:(Python装饰器(Decorators ))