Python装饰器

  • Python 中的函数和 Java、C++不太一样,Python 中的函数可以像普通变量一样当做参数传递给另外一个函数
  • 本质上,Python语言的decorator就是一个返回函数的高阶函数
  • Python与Java装饰器都是让其他函数或类在不需要做任何代码修改的前提下增加额外功能 。但python装饰器直接实现了AOP,作用是Java中的注解;Java中AOP要用Spring实现

背景

问题提出

  1. 夏天的短袖到冬天没法为我们防风御寒
  2. 我们想到的一个办法就是把短袖改造一下,让它变得更厚更长,这样一来,它到冬天还能为我们防风御寒(功能增强)
  3. 但问题是,这个内裤被我们改造成了加厚长袖后,虽然能为我们在冬天防风御寒,但本质上它不再是一件真正的短袖(改变了函数)
  4. 我们想不改变短袖的本质,却还在冬天为我们防风御寒
  5. 于是聪明的人们发明外套,在不改变短袖的前提下,直接把外套套在了短袖外面。这样短袖还是短袖,套上外套后也能为我们在冬天防风御寒(不改变函数,功能增强)

python的函数

函数可以像普通变量一样当做参数传递给另外一个函数

def test():
    print("this is what I want")

def receive(func):
    print("I receive a function")
    func()

receive(test)
输出

python函数的强大

装饰器在 Python 使用如此方便都要归因于 Python 的函数能像普通的对象一样能

  1. 作为参数传递给其他函数,可以被赋值给其他变量
  2. 可以作为返回值
  3. 可以被定义在另外一个函数内

装饰器

意义

用于有切面需求的场景,比如:插入日志、性能测试、事务处理、缓存、权限校验等场景
用装饰器抽离出大量与函数功能本身无关的雷同代码到装饰器中并继续重用

定义

  • 装饰器本质上是一个 Python 函数或类,它可以让其他函数或类在不需要做任何代码修改的前提下增加额外功能
  • 装饰器的返回值也是一个函数/类对象

例子

业务函数

def test():
    print("this is what I want")

新需求

现在有一个新的需求,希望可以记录下函数的执行日志,于是在代码中添加日志代码(新的需求):

def test():
    print("call test()")  #新需求
    print("this is what I want")

如果函数 test()、test2()……等一大组函数也有类似的需求,需要在这些函数里重复写新需求,造成问题:

  1. 修改工作量大
  2. 造成大量雷同的代码
  3. 不利于之后的业务扩展

新定义业务无关的函数

  • 重新定义一个辅助函数如log(func)专门处理日志(业务无关的代码,新需求)
  • 日志处理完之后再执行真正的业务代码test()
def log(func):
    print("call test()") 
    func()

def test():
    print("this is what I want")

log(test)

[图片上传失败...(image-fd6eee-1529993035512)]

存在问题

  • 上面的修改实现了功能(不改变业务函数,加入新功能)
  • 但是调用的时候不再是调用真正的业务函数test(),而是调用辅助函数log()

这破坏了原有的代码结构, 每次调用都要把原来的业务函数test()作为参数传递给辅助函数log()

简单装饰器

想要调用业务函数而不是 把业务函数作为参数传给辅助函数,就要用到装饰器

def log(func):
    def wrapper():
        print("call test()")
        return func()     # 执行传入的函数参数,如test()
    return wrapper     #返回函数对象 wrapper

def test():
    print("this is what I want")

test= log(test) 
# 因为装饰器 use_logging(test) 返回的是函数对象 wrapper
# 这条语句相当于  test = wrapper

test()         # 执行test() 相当于执行 wrapper()

辅助函数log()就是一个装饰器,它把执行真正业务函数 func 包裹在其中,看起来像 test()log()装饰了一样。

这么做可以实现面向切面编程AOP。

装饰器进阶

一. @ 语法糖

  • @ 符号是装饰器的语法糖,它放在函数开始定义的地方
  • 这样就可以省略最后一步再次赋值的操作
    本例子中@use_logging相当于test= use_logging(test)
def log(func):
    def wrapper():
        print("call test()")
        return func()
    return wrapper

@log
def test():
    print("this is what I want")

test()
输出
  • 如此一来,业务函数test()不需要做任何修改,只需在定义的地方加上装饰器,调用的时候不用加任何修饰
  • 如果我们有其他的类似函数,我们可以继续调用装饰器如@log来修饰函数,而不用重复修改函数或者增加新的封装

这样,我们就提高了程序的可重复利用性,并增加了程序的可读性。

二. 带参数的业务函数

*args、**kwargs用法

*args**kwargs是python中的可变参数。

def foo(*args, **kwargs):
    print 'args = ', args
    print 'kwargs = ', kwargs
    print '---------------------------------------'

if __name__ == '__main__':
    foo(1,2,3,4)
    foo(a=1,b=2,c=3)
    foo(1,2,3,4, a=1,b=2,c=3)
    foo('a', 1, None, a=1, b='2', c=3)

输出结果:

输出
  • *args表示任何多个无名参数,它是一个tuple
  • **kwargs表示关键字参数,它是一个dict
  • 同时使用*args**kwargs时,必须*args参数列要在**kwargs

有限个参数

当业务函数test()需要参数,比如 test(a,b)

def test(a,b):
    print("a+b = %d" % (a+b))

我们可以在定义 wrapper()函数的时候指定参数:

def log(func):
    def wrapper(a,b):
        print("call test(%d,%d)" %(a,b))
        return func(a,b)
    return wrapper

这样业务函数test(name)定义的参数就可以定义在wrapper ()函数中。

总的代码:

# -*- coding: UTF-8 -*- 
def log(func):
    def wrapper(a,b):
        print("call test(%d,%d)" %(a,b))
        return func(a,b)
    return wrapper

@log
def test(a,b):
    print("sum = %d" % (a+b))

test(2,4)
输出

可变参数

当装饰器不知道业务函数到底有多少个参数时,用*args 来代替,

如此一来,不管业务函数 test(…)定义了多少个参数,都可以完整地传递到 func中去

def log(func):
    def wrapper(*args):
        print("call test()" )
        return func(*args)
    return wrapper

@log
def test(a,b,c):
    print("sum = %d" % (a+b+c))

test(2,4,5)

[图片上传失败...(image-82a649-1529993035512)]

含关键字的可变参数

如果业务函数 test(…)还定义了一些关键字参数,用**kwargs来代替:

def test(a,b,c,way=None):
    print("sum = %d,way = %s" % ((a+b+c),way))

可以把 wrapper() 函数指定关键字函数:

def log(func):
    def wrapper(*args, **kwargs):
        print("call test()" )
        return func(*args, **kwargs)
    return wrapper

总的:

def log(func):
    def wrapper(*args, **kwargs):
        print("call test()" )
        return func(*args, **kwargs)
    return wrapper

@log
def test(a,b,c,way=None):
    print("sum = %d,way = %s" % ((a+b+c),way))

test(2,4,5,"add")
输出

三. 带参数的装饰器

装饰器还有更大的灵活性,例如带参数的装饰器,在上面的装饰器调用中,该装饰器接收唯一的参数就是业务函数 test()
装饰器的语法允许我们在调用时,提供其它参数,比如@decorator(a)。这样,就为装饰器的编写和使用提供了更大的灵活性。比如,我们可以在装饰器中指定日志的等级,因为不同业务函数可能需要的日志级别是不一样的。

def log(level):
    def decorator(func):
        def wrapper(*args, **kwargs):
            if level == "warn":
                print("%s waring" % func.__name__)
            elif level == "info":
                print("%s infomation get" % func.__name__)
            return func(*args, **kwargs)
        return wrapper
    return decorator


@log(level="warn")
def test():
    print("this is what I want")

@log(level="info")
def test2():
    print("this is also what I want")

test()
test2()
输出

上面的 log() 是允许带参数的装饰器。它实际上是对原有装饰器的一个函数封装,并返回一个装饰器。我们可以将它理解为一个含有参数的闭包。当我们用@log(level="warn")调用的时候,Python 能够发现这一层的封装,并把参数传递到装饰器的环境中。

四. 类装饰器

定义

  • 装饰器不仅可以是函数,还可以是类
  • 相比函数装饰器,类装饰器具有灵活度大、高内聚、封装性等优点
  • __call__这样前后都带下划线的方法在Python中被称为内置(魔法)方法。重载这些魔法方法一般会改变对象的内部行为

用法

  1. 让类的构造函数__init__()接受一个函数
  2. 重载__call__()并 返回一个函数
  3. 使用@类形式将装饰器附加到业务函数上
class DecorateDemo(object):
    def  __init__(self, func):
        self.__func = func
    def  __call__(self):
        print("before class decorator")
        self.__func()
        print("after class decorator")
        return self.__func

@DecorateDemo
def test():
    print("this is what I want")

test()
输出

五. functools模块

functools模块提供了两个装饰器,主要用 functools.wraps

使用装饰器极大地复用了代码,但是他有一个缺点就是原函数的元信息不见了:

def log(func):
    def wrapper():
        print("call test()")
        return func()
    return wrapper

@log
def test():
    print("this is what I want")

test()
print test.__name__
改变了函数元信息
import functools

def log(func):
    @functools.wraps(func)
    def wrapper():
        print("call test()")
        return func()
    return wrapper

@log
def test():
    print("this is what I want")

test()
print test.__name__
@functools.wraps(func)

六. 多个装饰器

装饰器顺序

一个函数还可以同时定义多个装饰器,比如:

@a
@b
@c
def f ():
    pass

它的执行顺序是从里到外,最先调用最里层的装饰器,最后调用最外层的装饰器,它等效于

f = a(b(c(f)))

例子:

def log(func):
    def wrapper():
        print("call test()")
        result = func()
        print("end test()")
        return result 
    return wrapper

def hello(func):
    def wrapper():
        print("hello test()")
        result = func()
        print("goodbye test()")
        return result 
    return wrapper

@log
@hello
def test():
    print("this is what I want")

test()
多个装饰器

参考文章:
Python装饰器由浅入深
廖雪峰python装饰器
理解 Python 装饰器看这一篇就够了

最后编辑于
©著作权归作者所有,转载或内容合作请联系作者
  • 序言:七十年代末,一起剥皮案震惊了整个滨河市,随后出现的几起案子,更是在滨河造成了极大的恐慌,老刑警刘岩,带你破解...
    沈念sama阅读 194,524评论 5 460
  • 序言:滨河连续发生了三起死亡事件,死亡现场离奇诡异,居然都是意外死亡,警方通过查阅死者的电脑和手机,发现死者居然都...
    沈念sama阅读 81,869评论 2 371
  • 文/潘晓璐 我一进店门,熙熙楼的掌柜王于贵愁眉苦脸地迎上来,“玉大人,你说我怎么就摊上这事。” “怎么了?”我有些...
    开封第一讲书人阅读 141,813评论 0 320
  • 文/不坏的土叔 我叫张陵,是天一观的道长。 经常有香客问我,道长,这世上最难降的妖魔是什么? 我笑而不...
    开封第一讲书人阅读 52,210评论 1 263
  • 正文 为了忘掉前任,我火速办了婚礼,结果婚礼上,老公的妹妹穿的比我还像新娘。我一直安慰自己,他们只是感情好,可当我...
    茶点故事阅读 61,085评论 4 355
  • 文/花漫 我一把揭开白布。 她就那样静静地躺着,像睡着了一般。 火红的嫁衣衬着肌肤如雪。 梳的纹丝不乱的头发上,一...
    开封第一讲书人阅读 46,117评论 1 272
  • 那天,我揣着相机与录音,去河边找鬼。 笑死,一个胖子当着我的面吹牛,可吹牛的内容都是我干的。 我是一名探鬼主播,决...
    沈念sama阅读 36,533评论 3 381
  • 文/苍兰香墨 我猛地睁开眼,长吁一口气:“原来是场噩梦啊……” “哼!你这毒妇竟也来了?” 一声冷哼从身侧响起,我...
    开封第一讲书人阅读 35,219评论 0 253
  • 序言:老挝万荣一对情侣失踪,失踪者是张志新(化名)和其女友刘颖,没想到半个月后,有当地人在树林里发现了一具尸体,经...
    沈念sama阅读 39,487评论 1 290
  • 正文 独居荒郊野岭守林人离奇死亡,尸身上长有42处带血的脓包…… 初始之章·张勋 以下内容为张勋视角 年9月15日...
    茶点故事阅读 34,582评论 2 309
  • 正文 我和宋清朗相恋三年,在试婚纱的时候发现自己被绿了。 大学时的朋友给我发了我未婚夫和他白月光在一起吃饭的照片。...
    茶点故事阅读 36,362评论 1 326
  • 序言:一个原本活蹦乱跳的男人离奇死亡,死状恐怖,灵堂内的尸体忽然破棺而出,到底是诈尸还是另有隐情,我是刑警宁泽,带...
    沈念sama阅读 32,218评论 3 312
  • 正文 年R本政府宣布,位于F岛的核电站,受9级特大地震影响,放射性物质发生泄漏。R本人自食恶果不足惜,却给世界环境...
    茶点故事阅读 37,589评论 3 299
  • 文/蒙蒙 一、第九天 我趴在偏房一处隐蔽的房顶上张望。 院中可真热闹,春花似锦、人声如沸。这庄子的主人今日做“春日...
    开封第一讲书人阅读 28,899评论 0 17
  • 文/苍兰香墨 我抬头看了看天上的太阳。三九已至,却和暖如春,着一层夹袄步出监牢的瞬间,已是汗流浃背。 一阵脚步声响...
    开封第一讲书人阅读 30,176评论 1 250
  • 我被黑心中介骗来泰国打工, 没想到刚下飞机就差点儿被人妖公主榨干…… 1. 我叫王不留,地道东北人。 一个月前我还...
    沈念sama阅读 41,503评论 2 341
  • 正文 我出身青楼,却偏偏与公主长得像,于是被迫代替她去往敌国和亲。 传闻我的和亲对象是个残疾皇子,可洞房花烛夜当晚...
    茶点故事阅读 40,707评论 2 335

推荐阅读更多精彩内容

  • 呵呵!作为一名教python的老师,我发现学生们基本上一开始很难搞定python的装饰器,也许因为装饰器确实很难懂...
    TypingQuietly阅读 19,436评论 26 186
  • 原文出处: dzone 译文出处:Wu Cheng(@nullRef) 1. 函数 在python中,函数通过...
    DraculaWong阅读 496评论 0 3
  • 转载来自:http://blog.csdn.net/u013471155 在学习Python的过程中,我相信有很多...
    JM68阅读 570评论 3 9
  • 每个人都有的内裤主要功能是用来遮羞,但是到了冬天它没法为我们防风御寒,咋办?我们想到的一个办法就是把内裤改造一下,...
    chen_000阅读 1,359评论 0 3
  • 我的写作水平不好,所以只能简单介绍: 94年湖南小哥一枚 性格简单 爱好摄影摄像 工作婚礼摄像师 我喜欢带着相机四...
    疯子狗阅读 1,040评论 32 11