装饰器详解

一.装饰器
1.定义:从字面上理解,就是装饰对象的器件。可以在不修改原有代码的情况下,为被装饰的对象增加新的功能或者附加限制条件或者帮助输出。装饰器有很多种,有函数的装饰器,也有类的装饰器。装饰器在很多语言中的名字也不尽相同,它体现的是设计模式中的装饰模式,强调的是开放封闭原则。装饰器的语法是将@装饰器名,放在被装饰对象上面。
@dec
def func(): # 被装饰对象
pass

2.几个重要原则和概念
a.python程序是从上到下开始执行的,当碰到函数定义代码块时不会立即执行,只是将其放入内存中。当此函数被调用时,才会开始执行函数内部的代码块。
b.由于程序是顺序执行的,所以当我们对一个函数定义了两次。那么,后面的定义会覆盖前面的定义。所以,在python中代码的放置位置是有区别的,不能随意放置,通常函数体要放在调用语句的前面。
def foo():
print(“第一次定义的foo()函数”)

def foo():
	print("第二次定义的foo()函数")
foo()
# 结果
第二次定义的foo()函数

c.搞清楚下面几个概念:函数名、函数体、返回值、函数的内存地址、函数名加括号、函数名当作参数、函数名加括号当作参数、返回函数名、返回函数名加括号
def outer(func):
def inner():
print(“内层函数inner()”)
return inner

def foo():
	print("原始函数foo()")

outer(foo)
outer(foo())

函数名:foo、outer、inner
函数体:函数的整个代码结构
返回值:return后面的表达式
函数的内存地址:id(foo)、id(outer)等
函数名加括号:对函数进行调用,如foo()、outer(foo)
函数名作为参数:outer(foo)中foo本身是一个函数,但作为参数传递给了outer函数
函数名加括号作为参数:先调用函数,再将它的返回值当做别的函数的参数,例如outer(foo())
返回函数名:return inner
返回函数名加括号:return inner(),其实就是先执行inner()函数,再将其返回值作为别的函数的返回值。
3.函数的装饰器
虚拟场景:有一个大公司,下属的基础平台部负责内部应用程序及API的开发。另外,还有上百个业务部门负责不同的业务,这些业务部门各自调用基础平台部提供的不同API,情况如下:
# 基础平台部负责内部应用程序和API的开发
def f1():
print(“业务部门1的数据接口”)
def f2():
print(“业务部门2的数据接口”)
def f3():
print(“业务部门3的数据接口”)
def f100():
print(“业务部门100的数据接口”)

#业务部门调用各自的API
f1()
f2()
f3()
f100()

现在基础平台部分决定为函数的调用进行安全认证,第一种方法是对基础平台部门的代码进行重构,N个业务部门无需做任何修改。此方法不好,工作量太大!

基础平台部负责内部应用程序和API的开发

def f1():
	# 加入认证程序代码
	print("业务部门1的数据接口")
def f2():
	# 加入认证程序代码
	print("业务部门2的数据接口")
def f3():
	# 加入认证程序代码
	print("业务部门3的数据接口")
def f100():
	# 加入认证程序代码
	print("业务部门100的数据接口")

业务部门调用各自的API
f1()
f2()
f3()
f100()

第二种方法:定义一个认证函数,在原来其他的函数中调用它,代码如下:
def login():
print(“认证成功”)

基础平台部负责内部应用程序和API的开发
def f1():
login()
print(“业务部门1的数据接口”)
def f2():
login()
print(“业务部门2的数据接口”)
def f3():
login()
print(“业务部门3的数据接口”)
def f100():
login()
print(“业务部门100的数据接口”)

业务部门调用各自的API

f1()
f2()
f3()
f100()

第三种方法:第二种方法中,写出的代码没有遵循开放封闭的原则。即已经实现的功能代码内部不允许被修改,但外部可以被扩展。如果将开放封闭的原则应用在上面的需求中,那么就是不允许在函数f1、f2、…、f100的内部进行代码修改,但可以在外部对它们进行扩展。代码如下:
def outer(func):
def inner():
print(“认证成功”)
result = func()
print(“日志添加成功”)
return result
return inner
基础平台部负责内部应用程序和API的开发
@outer
def f1():
print(“业务部门1的数据接口”)
@outer
def f2():
print(“业务部门2的数据接口”)
@outer
def f3():
print(“业务部门3的数据接口”)
@outer
def f100():
print(“业务部门100的数据接口”)

业务部门调用各自的API
f1()
f2()
f3()
f100()

使用装饰器@outer,也是仅需对基础平台的代码进行拓展,就可以实现在其他部门调用函数API之前都进行认证操作,在操作结束后保存日志,并且其他业务部门无需对他们自己的代码做任何修改,调用方式也不用变。
4.装饰器机制分析
下面以f1函数为例,对装饰器的运行机制进行分析:
def outer(func): # 装饰函数
def inner():
print(“认证成功!”)
result = func()
print(“日志添加成功”)
return result
return inner

@outer
def f1():  # 被装饰函数
	print("业务部门1数据接口......")

a.程序开始运行,从上到下开始解释。读到def outer(func)时,发现这是一个函数的定义,将其函数体放入内存中,然后跳过。
b.跳到@outer时,程序被@这个python语法糖吸引住,知道这是个装饰器,按规矩要立即执行,于是程序开始运行@后面那个名字outer所定义的函数。
c.程序返回到outer函数,开始执行装饰器的语法规则。规则是:被装饰函数的名字会被当作函数形参传递给装饰函数。装饰函数执行它自己内部的代码后,会将它的返回值赋值给被装饰函数。原来f1函数被当作参数传递给了func,而f1这个函数名之后会指向inner函数。 注意:@outer和outer()是有区别的。没有括号时,outer函数会被立即执行。这个传统的用括号才能调用函数不同。
d.程序开始执行outer函数内部的内容,一开始它又碰到了一个函数inner,inner函数定义块被程序观察到后不会立刻执行,而是读入内存中(这是默认规则)。
e.再往下,碰到return inner,返回值是个函数名,并且这个函数名会被赋值给f1这个被装饰函数,也就是f1 = inner。此时,f1函数被新的函数inner覆盖了(实际上是f1这个函数名更改成指向inner这个函数名指向的函数体内存地址,f1不再指向它原来的函数体的内存地址),再往后调用f1的时候将执行inner函数内的代码,而不是先前的函数体。那么先前的函数体去哪了?还记得我们将f1当做参数传递给func这个形参么?func这个变量保存了老的函数在内存中的地址,通过它就可以执行老的函数体,你能在inner函数里看到result = func()这句代码,它就是这么干的!
f.接下来,还没有结束。当业务部门,依然通过f1()的方式调用f1函数时,执行的就不再是旧的f1函数的代码,而是inner函数的代码。在本例中,它首先会打印个“认证成功”的提示,很显然你可以换成任意的代码,这只是个示例;然后,它会执行func函数并将返回值赋值给变量result,这个func函数就是旧的f1函数;接着,它又打印了“日志添加成功”的提示,这也只是个示例,可以换成任何你想要的;最后返回result这个变量。我们在业务部门的代码上可以用r = f1()的方式接收result的值。
g.以上流程走完后,你应该看出来了,在没有对业务部门的代码和接口调用方式做任何修改的同时,也没有对基础平台部原有的代码做内部修改,仅仅是添加了一个装饰函数,就实现了我们的需求,在函数调用前进行认证,调用后写入日志。这就是装饰器的最大作用。
4.上面的例子中,f1函数没有参数,在实际情况中肯定会需要参数的,函数的参数怎么传递的呢?
def outer(func):
def inner(username):
print(“认证成功”)
result = func(username)
print(“日志添加成功”)
return result
return inner
@outer
def f1(name):
print("{}正在调用业务部门1的数据接口".format(name))
#调用方法
f1(“Jack”)

在inner函数的定义部分也加上一个参数,调用func函数的时候传递这个参数,很好理解吧?可问题又来了,那么另外一个部门调用的f2有2个参数呢?f3有3个参数呢?你怎么传递?很简单,我们有*args和**kwargs嘛!号称“万能参数”!简单修改一下上面的代码:
def outer(func):
def inner(*args, *kwargs):
print(“认证成功”)
result = func(*args, **kwargs)
print(“日志添加成功”)
return result
return inner
@outer
def f1(name, age):
print("{}正在调用业务部门1的数据接口".format(name))

调用方法

f1(“jack”, 19)

一个函数可以被多个函数装饰吗?可以的!看下面的例子:
def outer1(func):
def inner(*args,**kwargs):
print(“认证成功!”)
result = func(*args,**kwargs)
print(“日志添加成功”)
return result
return inner

def outer2(func):
def inner(*args,**kwargs):
print(“一条欢迎信息。。。”)
result = func(*args,**kwargs)
print(“一条欢送信息。。。”)
return result
return inner

@outer1
@outer2
def f1(name,age):
print("%s 正在连接业务部门1数据接口…"%name)

调用方法

f1(“jack”,18)

更进一步,装饰器自己可以有参数吗?可以的!看下面的例子:
# 认证函数
def auth(request,kargs):
print(“认证成功!”)

# 日志函数
def log(request,kargs):
    print("日志添加成功")
    
# 装饰器函数。接收两个参数,这两个参数应该是某个函数的名字。
def Filter(auth_func,log_func):
    # 第一层封装,f1函数实际上被传递给了main_fuc这个参数
    def outer(main_func):
        # 第二层封装,auth和log函数的参数值被传递到了这里
        def wrapper(request,kargs):
            # 下面代码的判断逻辑不重要,重要的是参数的引用和返回值
            before_result = auth(request,kargs)
            if(before_result != None):
                return before_result;

            main_result = main_func(request,kargs)
            if(main_result != None):
                return main_result;

            after_result = log(request,kargs)
            if(after_result != None):
                return after_result;
        return wrapper
    return outer
# 注意了,这里的装饰器函数有参数哦,它的意思是先执行filter函数。然后将filter函数的返回值作为装饰器函数的名字返回到这里。所以,Filter(auth,log) = outer , @Filter(auth,log) =  @outer
@Filter(auth,log)
def f1(name,age):
    print("%s 正在连接业务部门1数据接口......"%name)

# 调用方法
f1("jack",18)

欢迎使用Markdown编辑器

你好! 这是你第一次使用 Markdown编辑器 所展示的欢迎页。如果你想学习如何使用Markdown编辑器, 可以仔细阅读这篇文章,了解一下Markdown的基本语法知识。

新的改变

我们对Markdown编辑器进行了一些功能拓展与语法支持,除了标准的Markdown编辑器功能,我们增加了如下几点新功能,帮助你用它写博客:

  1. 全新的界面设计 ,将会带来全新的写作体验;
  2. 在创作中心设置你喜爱的代码高亮样式,Markdown 将代码片显示选择的高亮样式 进行展示;
  3. 增加了 图片拖拽 功能,你可以将本地的图片直接拖拽到编辑区域直接展示;
  4. 全新的 KaTeX数学公式 语法;
  5. 增加了支持甘特图的mermaid语法1 功能;
  6. 增加了 多屏幕编辑 Markdown文章功能;
  7. 增加了 焦点写作模式、预览模式、简洁写作模式、左右区域同步滚轮设置 等功能,功能按钮位于编辑区域与预览区域中间;
  8. 增加了 检查列表 功能。

功能快捷键

撤销:Ctrl/Command + Z
重做:Ctrl/Command + Y
加粗:Ctrl/Command + B
斜体:Ctrl/Command + I
标题:Ctrl/Command + Shift + H
无序列表:Ctrl/Command + Shift + U
有序列表:Ctrl/Command + Shift + O
检查列表:Ctrl/Command + Shift + C
插入代码:Ctrl/Command + Shift + K
插入链接:Ctrl/Command + Shift + L
插入图片:Ctrl/Command + Shift + G
查找:Ctrl/Command + F
替换:Ctrl/Command + G

合理的创建标题,有助于目录的生成

直接输入1次#,并按下space后,将生成1级标题。
输入2次#,并按下space后,将生成2级标题。
以此类推,我们支持6级标题。有助于使用TOC语法后生成一个完美的目录。

如何改变文本的样式

强调文本 强调文本

加粗文本 加粗文本

标记文本

删除文本

引用文本

H2O is是液体。

210 运算结果是 1024.

插入链接与图片

链接: link.

图片: Alt

带尺寸的图片: Alt

居中的图片: Alt

居中并且带尺寸的图片: Alt

当然,我们为了让用户更加便捷,我们增加了图片拖拽功能。

如何插入一段漂亮的代码片

博客设置页面,选择一款你喜欢的代码片高亮样式,下面展示同样高亮的 代码片.

// An highlighted block
var foo = 'bar';

生成一个适合你的列表

  • 项目
    • 项目
      • 项目
  1. 项目1
  2. 项目2
  3. 项目3
  • 计划任务
  • 完成任务

创建一个表格

一个简单的表格是这么创建的:

项目Value
电脑$1600
手机$12
导管$1

设定内容居中、居左、居右

使用:---------:居中
使用:----------居左
使用----------:居右

第一列第二列第三列
第一列文本居中第二列文本居右第三列文本居左

SmartyPants

SmartyPants将ASCII标点字符转换为“智能”印刷标点HTML实体。例如:

TYPEASCIIHTML
Single backticks'Isn't this fun?'‘Isn’t this fun?’
Quotes"Isn't this fun?"“Isn’t this fun?”
Dashes-- is en-dash, --- is em-dash– is en-dash, — is em-dash

创建一个自定义列表

Markdown
Text-to- HTML conversion tool
Authors
John
Luke

如何创建一个注脚

一个具有注脚的文本。2

注释也是必不可少的

Markdown将文本转换为 HTML

KaTeX数学公式

您可以使用渲染LaTeX数学表达式 KaTeX:

Gamma公式展示 Γ ( n ) = ( n − 1 ) ! ∀ n ∈ N \Gamma(n) = (n-1)!\quad\forall n\in\mathbb N Γ(n)=(n1)!nN 是通过欧拉积分

Γ ( z ) = ∫ 0 ∞ t z − 1 e − t d t   . \Gamma(z) = \int_0^\infty t^{z-1}e^{-t}dt\,. Γ(z)=0tz1etdt.

你可以找到更多关于的信息 LaTeX 数学表达式here.

新的甘特图功能,丰富你的文章

Mon 06 Mon 13 Mon 20 已完成 进行中 计划一 计划二 现有任务 Adding GANTT diagram functionality to mermaid
  • 关于 甘特图 语法,参考 这儿,

UML 图表

可以使用UML图表进行渲染。 Mermaid. 例如下面产生的一个序列图::

张三 李四 王五 你好!李四, 最近怎么样? 你最近怎么样,王五? 我很好,谢谢! 我很好,谢谢! 李四想了很长时间, 文字太长了 不适合放在一行. 打量着王五... 很好... 王五, 你怎么样? 张三 李四 王五

这将产生一个流程图。:

链接
长方形
圆角长方形
菱形
  • 关于 Mermaid 语法,参考 这儿,

FLowchart流程图

我们依旧会支持flowchart的流程图:

Created with Raphaël 2.2.0 开始 我的操作 确认? 结束 yes no
  • 关于 Flowchart流程图 语法,参考 这儿.

导出与导入

导出

如果你想尝试使用此编辑器, 你可以在此篇文章任意编辑。当你完成了一篇文章的写作, 在上方工具栏找到 文章导出 ,生成一个.md文件或者.html文件进行本地保存。

导入

如果你想加载一篇你写过的.md文件,在上方工具栏可以选择导入功能进行对应扩展名的文件导入,
继续你的创作。


  1. mermaid语法说明 ↩︎

  2. 注脚的解释 ↩︎

  • 3
    点赞
  • 8
    收藏
    觉得还不错? 一键收藏
  • 0
    评论
评论
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

当前余额3.43前往充值 >
需支付:10.00
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值