Python-02进阶-02装饰器

最新推荐文章于 2020-02-02 10:38:52 发布

SuperScfan

最新推荐文章于 2020-02-02 10:38:52 发布

阅读量157

点赞数

分类专栏： # docs_Python docs 文章标签： Python

本文链接：https://blog.csdn.net/qq_21165007/article/details/104139496

版权

docs 同时被 2 个专栏收录

47 篇文章 0 订阅

订阅专栏

docs_Python

18 篇文章 0 订阅

订阅专栏

Python-00装饰器

装饰器

文章目录

Python-00装饰器

TODO

总结

装饰器的作用就是为已经存在的函数或对象添加额外的功能

装饰器使用种类：

函数装饰器
类装饰器
函数装饰器装饰类
类装饰器装饰函数

装饰器样例

@staticmethod
@logging
def a():
    return 1
    pass
等价于
a = staticmethod(logging(a))

默认装饰器函数

@property
通过property装饰器控制类的属性的绑定与获取，一般就是给某个属性增加一个验证类型等功能。
@staticmethod
将被装饰的函数从类中分离出来，该函数不能访问类的属性，简单说可以将该函数理解为一个独立的函数，不允许使用self。
staticmethod 就是将该被装饰的函数与该类没有关系，该函数不能用self传参，需要和普通函数一样传参。
@classmethod
classmethod 可以用来为一个类创建一些预处理的实例.类方法只能找类变量，不能访问实例变量

装饰器库 functools
因为使用装饰器 functools 会导致函数或类信息缺失。
例如 func.__name__
所以需要使用 functools 装饰器库处理

使用方法:
每个装饰器前面加上下句话即可
@functools.wraps(func)
样例如下所示：

def log(text):
    def decorator(func):
        @functools.wraps(func)
        def wrapper(*args, **kw):
            print '%s %s():' % (text, func.__name__)
            return func(*args, **kw)
        return wrapper
    return decorator

装饰器&函数

函数简单说明

参考链接: 12步轻松搞定python装饰器

了解装饰器之前也需要了解内部函数与函数闭包。

参考链接: 内部函数&函数闭包

内部函数

def wai_hanshu(canshu_1):

  def nei_hanshu(canshu_2): # 我在函数内部有定义了一个函数
    return canshu_1*canshu_2

  return nei_hanshu  # 我将内部函数返回出去

a = wai_hanshu(123)   # 此时 canshu_1 = 123
print a
print a(321)  # canshu_2 = 321

闭包说明
参考链接：函数闭包
python中的闭包从表现形式上定义（解释）为：
如果在一个内部函数里，对在外部作用域（但不是在全局作用域）的变量进行引用，那么内部函数就被认为是闭包(closure)。

闭包=函数+引用环境
闭包中是不能修改外部作用域的局部变量的
当闭包执行完后，仍然能够保持住当前的运行环境
闭包可以根据外部作用域的局部变量来得到不同的结果

装饰器说明

装饰器本质上是一个Python函数，它可以让其他函数在不需要做任何代码变动的前提下增加额外功能。
装饰器的返回值也是一个函数对象。
它经常用于有切面需求的场景，比如：插入日志、性能测试、事务处理、缓存、权限校验等场景。
装饰器是解决这类问题的绝佳设计，有了装饰器，我们就可以抽离出大量与函数功能本身无关的雷同代码并继续重用。

装饰器的作用就是为已经存在的函数或对象添加额外的功能

装饰器/修饰符 - decorator

装饰器知识

函数装饰器

参考链接:
https://www.cnblogs.com/cicaday/p/python-decorator.html

概括的讲，装饰器的作用就是为已经存在的函数或对象添加额外的功能

简单装饰器样例

def debug(func):
    def wrapper(*args, **kwargs):  # 指定宇宙无敌参数
        print "[DEBUG]: enter {}()".format(func.__name__)
        print 'Prepare and say...',
        return func(*args, **kwargs)
    return wrapper  # 返回

@debug
def say(something):
    print "hello {}!".format(something)
   
等同于 
say = debug(say)

原理分析

@decorator_a
def f():
    pass
等价于
f = decorator_a(f)

装饰器满足的条件

装饰器函数运行在函数定义的时候
装饰器需要返回一个可执行的对象
装饰器返回的可执行对象要兼容函数f的参数

类装饰器

类装饰器中必须使用 __call__ 方法。将类实例转为可调用对象。

class Decorator(object):
    def __init__(self, f):
        self.f = f
    def __call__(self):
        print("decorator start")
        self.f()
        print("decorator end")

@Decorator
def func():
    print("func")

func()

这里有注意的是：call()是一个特殊方法，它可将一个类实例变成一个可调用对象:

p = Decorator(func) # p是类Decorator的一个实例
p() # 实现了__call__()方法后，p可以被调用

要使用类装饰器必须实现类中的__call__()方法，就相当于将实例变成了一个方法。

装饰器链

所谓装饰器链，即多个装饰器的解析方式。

@decorator_b
@decorator_a
def test():
    pass
等同于
test = decorator_b(decorator_a(test))

装饰器执行顺序 是从近到远依次执行。

内置装饰器

内置装饰器

特性（property）
静态方法（staticmethod）
类方法（classmethod）

内置装饰器参考链接

附录A-装饰器库参数表

官方functools文档
 functools参考博客

functools，用于高阶函数：
指那些作用于函数或者返回其它函数的函数，通常只要是可以被当做函数调用的对象就是这个模块的目标。

functools方法

cmp_to_key，将一个比较函数转换关键字函数；
partial，针对函数起作用，并且是部分的；
reduce，与python内置的reduce函数功能一样；
total_ordering，在类装饰器中按照缺失顺序，填充方法；
update_wrapper，更新一个包裹（wrapper）函数，使其看起来更像被包裹（wrapped）的函数；
wraps，可用作一个装饰器，简化调用update_wrapper的过程；

cmp_to_key
将老式的比较函数（comparison function）转换为关键字函数（key function），与接受key function的工具一同使用（例如sorted，min，max，heapq.nlargest，itertools.groupby），该函数主要用于将程序转换成Python 3格式的，因为Python 3中不支持比较函数。比较函数是可调用的，接受两个参数，比较这两个参数并根据他们的大小关系返回负值、零或者正值中的一个。关键字函数也是可调用的，接受一个参数，同时返回一个可以用作排序关键字的值。
partial
functools.partial(func, *args, **keywords)，函数装饰器，返回一个新的partial对象。调用partial对象和调用被修饰的函数func相同，只不过调用partial对象时传入的参数个数通常要少于调用func时传入的参数个数。
reduce
与Python内置的reduce函数一样，为了向Python3过渡
total_ordering
这是一个类装饰器，给定一个类，这个类定义了一个或者多个比较排序方法，这个类装饰器将会补充其余的比较方法，减少了自己定义所有比较方法时的工作量.
被修饰的类必须至少定义 lt()， le()，gt()，ge()中的一个，同时，被修饰的类还应该提供 eq()方法。
update_wrapper
更新一个包裹（wrapper）函数，使其看起来更像被包裹（wrapped）的函数。
wraps
这个函数可用作一个装饰器，简化调用update_wrapper的过程，调用这个函数等价于调用partial(update_wrapper, wrapped = wrapped, assigned = assigned,updated = updated)。

附录B-测试代码样例

文件： /home/scfan/pro/server/pro/tools/base_decorator.py

import time
import datetime
import functools

def decorator_func(text="all"):
    u""" 统计函数相关信息 All
    - 函数运行时间
    - 函数名称

    """
    def decorator(func,*args,**kwargs):
        @functools.wraps(func)
        def wrapper(*args,**kwargs):
            start = datetime.datetime.now()
            data = func(*args, **kwargs)
            runtime = datetime.datetime.now() - start
            msg = "@函数运行信息: 函数类型[%s],函数名称[%s],运行时间[%s秒]"%(text,func.__name__,runtime.total_seconds())
            print(msg)
            return data
        return wrapper
    return decorator

class Decorator(object):
    u"""
        装饰器类
    """
    def __init__(self, func):
        self.func = func

    # __call__()是一个特殊方法，它可将一个类实例变成一个可调用对象
    def __call__(self, *args, **kwargs):
        print("decorator start")
        self.func()
        print("decorator end")
 
 if __name__ == '__main__':
    @Decorator
    @decorator_func("all")
    def a(b="cc"):
        for i in range(2):
            time.sleep(1)
        print "函数运行...."
        return b
    a()

运行信息

(env) [scfan@WOM tools]$ python base_decorator.py 
decorator start
函数运行....
@函数运行信息: 函数类型[all],函数名称[a],运行时间[2.004331秒]
decorator end

附录C-参考资源链接

附录D-装饰器相关

SuperScfan

关注

0
点赞
踩
0

收藏

觉得还不错? 一键收藏
打赏
0
评论
Python-02进阶-02装饰器

Python-00装饰器装饰器文章目录Python-00装饰器总结装饰器&函数函数简单说明装饰器说明装饰器知识函数装饰器原理分析类装饰器装饰器链内置装饰器附录A-装饰器库参数表附录B-测试代码样例附录C-参考资源链接附录D-装饰器相关TODO总结装饰器的作用就是为已经存在的函数或对象添加额外的功能装饰器使用种类：函数装饰器类装饰器函数装饰器装饰类类装饰器装饰函数...
复制链接

扫一扫