首页 > 编程语言 >Python高级之装饰器

Python高级之装饰器

时间:2023-12-13 15:55:06浏览次数:46  
标签:return 函数 Python 高级 wrapper func time 装饰 def

装饰器

【一】装饰器介绍

装饰器的由来

  • 软件的设计应该遵循开放封闭原则,即对扩展是开放的,而对修改是封闭的。
    • 对扩展开放,意味着有新的需求或变化时,可以对现有代码进行扩展,以适应新的情况。
    • 对修改封闭,意味着对象一旦设计完成,就可以独立完成其工作,而不要对其进行修改。
  • 软件包含的所有功能的源代码以及调用方式,都应该避免修改,否则一旦改错,则极有可能产生连锁反应,最终导致程序崩溃
    • 而对于上线后的软件,新需求或者变化又层出不穷,我们必须为程序提供扩展的可能性,这就用到了装饰器。

装饰器的基本定义

装饰器是 Python 中一种用于修改或扩展函数行为的高级技术。装饰器本质上是一个函数,它接受一个函数作为输入,并返回一个新的函数,通常用于在不修改原始函数代码的情况下添加新的功能或行为。

装饰器的语法使用 @decorator 这样的语法糖,将装饰器应用到函数上。在应用装饰器后,原始函数会被包裹或修改,从而获得额外的功能。

下面是一个简单的装饰器示例:

def my_decorator(func):
    def wrapper():
        print("Something is happening before the function is called.")
        func()
        print("Something is happening after the function is called.")
    return wrapper

@my_decorator
def say_hello():
    print("Hello!")

# 调用被装饰后的函数
say_hello()

在这个例子中,my_decorator 是一个装饰器函数,它接受一个函数 func 作为参数,并返回一个新的函数 wrapperwrapper 函数在调用原始函数 func 前后打印一些信息。

通过使用 @my_decorator 语法糖,我们将 say_hello 函数传递给装饰器,实际上相当于 say_hello = my_decorator(say_hello)。当调用 say_hello() 时,实际上调用了被装饰后的 wrapper 函数。

装饰器的特点:

  1. 接受函数作为参数: 装饰器是一个接受函数作为输入的函数。
  2. 返回新函数: 装饰器通常返回一个新的函数,该函数通常包装了原始函数,并添加了额外的功能。
  3. 使用 @ 语法: 使用 @decorator 语法糖可以方便地应用装饰器。

常见应用场景:

  1. 日志记录: 记录函数的调用信息,参数和返回值。
  2. 性能分析: 计算函数执行时间等性能指标。
  3. 权限检查: 检查用户是否有权限执行特定函数。
  4. 缓存: 缓存函数的输出,避免重复计算。
  5. 异常处理: 包装函数,捕获异常并进行处理。

【二】装饰器的分类

【0】调用装饰器

def 装饰器(func):
    def inner():
        函数体内容
        return 返回的内容
    return inner   # 装饰器返回内部执行代码块的内存地址
def 函数体():
    函数内容
函数名 = 装饰器(函数名)   # 通过函数名重新赋值内存地址
函数名()   # 增加了装饰器内部函数的功能,且继承了原函数的功能,并可以通过同样的变量名调用

【1】无参装饰器

  • 无参装饰器和有参装饰器的实现原理一样,都是’函数嵌套+闭包+函数对象’的组合使用的产物。
# 通过参数 func 接收外部的函数地址
def wrapper(func):
    def inner():
        # 第一部分:执行外部传入的函数之前执行的代码
        '''...'''
        # 第二部分:执行外部传入的函数地址(res接受外部函数的返回值,如果有返回值的情况下)
        result = func()
        # 第三部分:执行外部传入的函数之后执行的代码
        '''...'''
        return result
    return inner

# 被装饰函数需要传参数时:
# 通过参数 func 接收外部的函数地址
def wrapper(func):
    def inner(*args, **kwargs):   ### 参数传递至此 ###
        # 第一部分:执行外部传入的函数之前执行的代码
        '''...'''
        # 第二部分:执行外部传入的函数地址(res接受外部函数的返回值,如果有返回值的情况下)
        result = func(*args, **kwargs)
        # 第三部分:执行外部传入的函数之后执行的代码
        '''...'''
        return result
    return inner

【2】有参装饰器

有参数的装饰器是指在装饰器外部可以传递一些参数,以影响装饰器的行为。这样的装饰器通常有两层嵌套,外层接收参数,内层接收函数。下面是一个简单的有参装饰器的例子:

def my_decorator(param):
    def decorator(func):
        def wrapper(*args, **kwargs):
            print(f"Decorator received parameter: {param}")
            # Decorator received parameter: Hello, I'm a parameter.
            # 语法糖的参数param可以被装饰器内部的函数调用
            result = func(*args, **kwargs)  # Hello! # 执行原来的say_hello的函数
            print(f"Function {func.__name__} was called.")  # Function say_hello was called.
            return result

        return wrapper

    return decorator


# 使用有参语法糖
# @my_decorator(param="Hello, I'm a parameter.")
def say_hello():
    print("Hello!")  # 没有返回值:None

a=my_decorator(param='最外层语法糖的内容')
say_hello = a(say_hello)
say_hello()
'''
Decorator received parameter: 最外层语法糖的内容
Hello!
Function say_hello was called
'''

在这个例子中,my_decorator 是一个有参装饰器。它实际上返回一个装饰器函数 decorator,而 decorator 函数则返回最终的包装函数 wrapper。外部传递的参数 param 影响了装饰器内部的行为。

当使用 @my_decorator("Hello, I'm a parameter.") 语法糖来装饰 say_hello 函数时,实际上相当于执行了 say_hello = my_decorator("Hello, I'm a parameter.")(say_hello)

运行 say_hello() 时,将执行 wrapper 函数,同时输出装饰器接收到的参数以及函数的调用信息。

有参装饰器非常灵活,可以根据外部传递的参数来定制装饰器的行为,使得装饰器更具通用性和可配置性。

【三】装饰器语法糖

【0】语法糖的概念

  • 语法糖(Syntactic Sugar)是一种编程语言的语法结构,它并不提供新的功能,而是提供了一种更方便、更易读、更简洁的语法形式。这种语法形式并不改变语言的表达能力,但使得代码更加易于理解和书写。
  • 在编程中,语法糖的存在旨在使得代码更加简洁,减少冗余,提高可读性。这些语法糖通常是通过编译器或解释器在底层转化为更基础的语法结构,而不是引入新的语法规则。

以下是一些常见的 Python 语法糖的例子:

  1. 列表推导式:

    # 常规写法
    squares = []
    for x in range(10):
        squares.append(x**2)
    
    # 使用列表推导式
    squares = [x**2 for x in range(10)]
    
  2. 字典推导式:

    # 常规写法
    squares_dict = {}
    for x in range(10):
        squares_dict[x] = x**2
    
    # 使用字典推导式
    squares_dict = {x: x**2 for x in range(10)}
    
  3. 装饰器:

    # 常规写法
    def my_decorator(func):
        def wrapper():
            print("Something is happening before the function is called.")
            func()
            print("Something is happening after the function is called.")
        return wrapper
    
    def say_hello():
        print("Hello!")
    
    say_hello = my_decorator(say_hello)
    
    # 使用装饰器语法糖
    @my_decorator
    def say_hello():
        print("Hello!")
    

这些例子展示了语法糖的概念:它们提供了更简洁和直观的方式来表达相同的逻辑,使得代码更加优雅和易读。

【1】无参语法糖@wrapper和有参语法糖@wrapper()

import time


def home(name):
    time.sleep(5)
    print('Welcome to the home page', name)


# 定义外层函数
def wrapper(func):
    # 定义内层函数:通过参数接收外部的值
    def inner(*args, **kwargs):
        start_time = time.time()
        res = func(*args, **kwargs)
        stop_time = time.time()
        print('run time is %s' % (stop_time - start_time))

    return inner


# 第一种调用方式
# 这里调用外层函数 wrapper 返回了内层函数的地址 inner
home = wrapper(home)
# 而内层函数其实是 inner(*args, **kwargs)
# 所以我们可以传参数进去
home("user")


# 第二种调用方式:语法糖
@wrapper
def index():
    time.sleep(5)
    print('Welcome to the index page')


index()
def my_decorator(param):
    def decorator(func):
        def wrapper(*args, **kwargs):
            print(f"Decorator received parameter: {param}")
            # Decorator received parameter: Hello, I'm a parameter.
            # 语法糖的参数param可以被装饰器内部的函数调用
            result = func(*args, **kwargs)   # Hello! # 执行原来的say_hello的函数
            print(f"Function {func.__name__} was called.")   # Function say_hello was called.
            return result

        return wrapper
    
    return decorator

# 使用有参装饰器
@my_decorator(param="Hello, I'm a parameter.")
def say_hello():
    print("Hello!")   # 没有返回值:None


# 调用被装饰后的函数
print(say_hello())
# Decorator received parameter: Hello, I'm a parameter.
# Hello!
# Function say_hello was called.
# None

【2】语法糖嵌套

  • 继承顺序是从下向上集成

  • 执行顺序是从上向下执行

@check_login  # check_login 的inner = check_balance的inner
@check_balance  # check_balance的inner = get_balance()
def get_balance(*args, **kwargs):
# 多层语法糖使用
def desc_a(func):
    print(f'111')
    def inner(*args, **kwargs):
        print(f'222')
        res = func(*args, **kwargs) # 真正的add函数
        print(f'333')
        return res
    return inner

def desc_b(func):
    print(f'444')
    def inner(*args, **kwargs):
        print(f'555')
        res = func(*args, **kwargs)# desc_a 的inner
        print(f'666')
        return res
    return inner
@desc_b
@desc_a
def add():
    print(f'777')
add()  # 111 -- 444 -- 555 -- 222 -- 777 -- 333 -- 666

'''多层语法糖相当于'''
add = desc_a(add)
add = desc_b(add)
add()  # 111 -- 444 -- 555 -- 222 -- 777 -- 333 -- 666

【3】多层语法糖练习

# 多层语法糖练习
user_data = {'username': 'dream', 'password': '521'}
bank_data = {'dream': {'pay_pwd': '521', 'balance': 1000}}
# 先验证登录
# 再验证 输入的金额 --- 符合数字 / 余额充足
def check_login(func):
    def inner(*args, **kwargs):
        username = input("请输入用户名:").strip()
        password = input("请输入密码:").strip()
        if user_data['username'] == username:
            if user_data['password'] == password:
                return func(username=username)
            else:
                return f"密码错误!"
        else:
            return f'用户名错误!'

    return inner


def check_balance(func):
    def inner(*args, **kwargs):
        pay_pwd = input("请输入支付密码:").strip()
        if bank_data[kwargs.get('username')]['pay_pwd'] == pay_pwd:
            balance = input("请输入取款金额:").strip()
            if not balance.isdigit():
                return f"金额必须是数字"
            balance = int(balance)
            if bank_data[kwargs.get('username')]['balance'] < balance:
                return f"你哪有那么多钱!"
            else:
                return func(username=[kwargs.get('username')], balance=balance)
        else:
            return f'支付密码错误!'

    return inner

# 取款函数里面
@check_login  # check_login 的inner = check_balance的inner
@check_balance  # check_balance的inner = get_balance()
def get_balance(*args, **kwargs):
    new_balance = bank_data[kwargs.get('username')]['balance'] - kwargs.get('balance')
    bank_data[kwargs.get('username')]['balance']=new_balance
    return f"取款成功,已提款{kwargs.get('balance')}现在你的余额为{new_balance}"


print(get_balance())

【四】装饰器形成的思路

【1】引入[为函数添加计时的功能]

  • 如果想为下述函数添加统计其执行时间的功能
import time

def index():
    time.sleep(3)
    print('Welcome to the index page’)
    return 200

index() #函数执行

【2】直接计时

  • 遵循不修改被装饰对象源代码的原则,我们想到的解决方法可能是这样
import time


def index():
    time.sleep(3)
    print("Welcome to the index page")
    return 200


start_time = time.time()
index()  # 函数执行
stop_time = time.time()
print('run time is %s' % (stop_time - start_time))

【3】函数作为参数

  • 考虑到还有可能要统计其他函数的执行时间
    • 于是我们将其做成一个单独的工具,函数体需要外部传入被装饰的函数从而进行调用
    • 我们可以使用参数的形式传入
import time


def index():
    time.sleep(3)
    print("Welcome to the index page")
    return 200


def wrapper(func):  # 通过参数接收外部的值
    start_time = time.time()
    res = func()
    stop_time = time.time()
    print('run time is %s' % (stop_time - start_time))
    return res


wrapper(index)
  • 但之后函数的调用方式都需要统一改成
wrapper(index)
wrapper(其他函数)
  • 这便违反了不能修改被装饰对象调用方式的原则
    • 于是我们换一种为函数体传值的方式,即将值包给函数

【4】将值包给函数

import time


def index():
    time.sleep(3)
    print("Welcome to the index page")
    return 200


def timer(func):  # 通过参数接收外部的值
    def wrapper():
        start_time = time.time()
        res = func()
        stop_time = time.time()
        print('run time is %s' % (stop_time - start_time))

    return inner


wrapper = timer(index)
wrapper()
  • 这样我们便可以在不修改被装饰函数源代码和调用方式的前提下为其加上统计时间的功能
  • 只不过需要事先执行一次timer将被装饰的函数传入,返回一个闭包函数wrapper重新赋值给变量名 /函数名index
index=timer(index)  #得到index=wrapper,wrapper携带对外作用域的引用:func=原始的index
index() # 执行的是wrapper(),在wrapper的函数体内再执行最原始的index
  • 至此我们便实现了一个无参装饰器timer,可以在不修改被装饰对象index源代码和调用方式的前提下为其加上新功能。

【5】问题:带参数会报错

  • 但我们忽略了若被装饰的函数是一个有参函数,便会抛出异常
import time


def home(name):
    time.sleep(5)
    print('Welcome to the home page', name)


def wrapper(func):  # 通过参数接收外部的值
    def inner():
        start_time = time.time()
        res = func()
        stop_time = time.time()
        print('run time is %s' % (stop_time - start_time))

    return inner


home = wrapper(home)
home()
'''
Traceback (most recent call last):
  File "E:\PythonProjects\def_func.py", line 322, in <module>
    home()
  File "E:\PythonProjects\def_func.py", line 314, in inner
    res = func()
TypeError: home() missing 1 required positional argument: 'name'
'''

【6】有参装饰器

  • 之所以会抛出异常,是因为home(egon)调用的其实是wrapper(egon),而函数wrapper没有参数。
    • wrapper函数接收的参数其实是给最原始的func用的
    • 为了能满足被装饰函数参数的所有情况,便用上*args+**kwargs组合
    • 于是修正装饰器timer如下
import time


def home(name):
    time.sleep(5)
    print('Welcome to the home page', name)


# 定义外层函数
def wrapper(func):
    # 定义内层函数:通过参数接收外部的值
    def inner(*args, **kwargs):
        start_time = time.time()
        res = func(*args, **kwargs)
        stop_time = time.time()
        print('run time is %s' % (stop_time - start_time))

    return inner


# 这里调用外层函数 wrapper 返回了内层函数的地址 inner
home = wrapper(home)
# 而内层函数其实是 inner(*args, **kwargs)
# 所以我们可以传参数进去
home("Dream")

【7】装饰器练习

# 看电影
# 用户信息字典 --- 定义用户名 和 年龄
# 大于 18 岁 看电影
# 小于 18 岁  18禁

# 取钱 ---> 登录(装饰器验证登录)
# 看电影 ==》 验证年龄(装饰器验证年龄)
user_data_dict = {'dream': 19, 'hope': 17}


# 装饰器模板
def outer(func):
    def inner():
        '''这里写调用 func 函数之前的逻辑'''
        res = func()
        '''这里写调用 func 函数之后的逻辑'''
        return res

    return inner


def watch():
    ...


def see():
    ...
user_dict = {'user': 17, 'dream': 99}

def outer(func):
    username = input("请输入用户名:")

    def inner():
        if user_dict[username] >= 18:
            return func()
        else:
            return "尚未成年,该电影你还不可以看哟~"
    return inner

def watch():
    return "你已经是成年人了,可以来看了"

watch = outer(watch)
print(watch())

标签:return,函数,Python,高级,wrapper,func,time,装饰,def
From: https://www.cnblogs.com/Lea4ning/p/17899224.html

相关文章

  • 【Python爬虫】Scrapy框架文件写入方式CSV,MYSQL,MongoDB_爬取新浪彩票双色球
    Spider代码爬取新浪彩票双色球页面数据,只爬取期号、红球、篮球classShuangseqiu11Spider(scrapy.Spider):name="shuangseqiu11"allowed_domains=["sina.com.cn"]start_urls=["https://view.lottery.sina.com.cn/lotto/pc_zst/index?lottoType=ssq&......
  • C++堆——heap与二叉树和python
    数据结构栈-->stack队列-->queue树-->tree堆-->heap散列-->hash图-->graph图结构一般包括顶点和边邻接矩阵DAG,DirectedAcyclicGraph即「有向无环图」树树(Tree)是一种非线性的数据结构,由n个节点组成,其中每个节点都有零个或多个子节点。......
  • Python 初学之华为OD机试题:求最大数字
    题目描述给定一个由纯数字组成以宇符串表示的数值,现要求字符串中的每个数字最多只能出现2次,超过的需要进行删除;删除某个重复的数字后,其它数字相对位置保持不变。如"34533”,数字3重复超过2次,需要册除其中一个3,删除第一个3后获得最大数值"4533"。请返回经过删除操作后的最大的数值......
  • pythonDay22
    【序列化与反序列化】(定义) (使用) (案例) (猴子补丁) 【xml模块】(格式) (案例) 【importconfigparser模块】 写的不好,后续修改 【subprocess模块,执行系统命令】 ......
  • 【Python爬虫】Python爬虫入门教程&注意事项
    ​一、引言        随着互联网的快速发展,网络数据已经成为人们获取信息的重要来源。而爬虫技术作为获取网络数据的重要手段,越来越受到人们的关注。在众多编程语言中,Python因其易学易用、库丰富、社区活跃等优势,成为爬虫开发的首选。本文将带你走进Python爬虫的世界,让你......
  • Python——第五章:logging模块
    filename:文件名format:数据的格式化输出。最终在日志文件中的样子时间-名称-级别-模块:错误信息datefmt:时间的格式level:错误的级别权重,当错误的级别权重大于等于leval的时候才会写入文件importlogginglogging.basicConfig(filename='x1.txt',format='%(asc......
  • 装饰器模式
    装饰器,顾名思义,一个是待装饰者,一个是装饰者,就像我们早餐吃的煎饼,煎饼是待装饰者,其他的火腿、里脊、土豆丝、生菜等都是装饰者,但最终都没有改变这还是一个煎饼。这里代码上有两个重要的点,一个是装饰者会也会继承或者实现被装饰者,第二是装饰者的构造函数会有一个类型为待装饰者的参......
  • 【Python小随笔】 Grpc协议的使用
    定义接口//test.protosyntax="proto3";optioncc_generic_services=true;serviceGreeter{//第一个接口rpcOne(OneRequest)returns(OneResponse){}//第二个接口rpcTwo(TwoRequest)returns(TwoResponse){}}//第1个接口请求值messageOn......
  • Python——第五章:shutil模块
    复制文件把dir1的文件a.txt移动到dir2内importshutilshutil.move("dir1/a.txt","dir2")复制两个文件句柄f1=open("dir2/a.txt",mode="rb")#准备读f1f2=open("dir1/b.txt",mode="wb")#准备写f2shutil.copyfileobj(f1,......
  • python N 字形变换 多种解法
    解法一:使用二维数组defconvert(s,numRows):ifnumRows==1ornumRows>=len(s):returnsrows=['']*numRowsindex,step=0,1forcharins:rows[index]+=charifindex==0:......