python之理解“@”(装饰器/decorators)

woceshiyong8

前言

 
初学python时，第一次见到“@”符号，感觉很眼熟，如果是学习过java或者接触过AOP（面向切面编程），对于这个符号应该是比较熟悉的。实际上，python中的@也是AOP思想的一种实现。
 
python的@，官方语言叫做“decorators”，即装饰器。这是python的一大特性，对于初学者来说，很难透彻的理解decorators。本文以多个python例子为引，层层深入，帮助读者来透彻的理解decorators。
 

从函数开始

 
decorators和函数是密不可分的，因此必须对python的函数有所了解，之前我写过一篇函数基础的博客，链接如下：http://yunjianfei.iteye.com/blog/2186064
 
通过该博客，主要要了解的是：
1. 函数的基本概念：函数名、实参、形参、函数体、函数返回值
2. 作用域、生存周期的概念
 

嵌套函数与闭包

 
要理解decorator，嵌套函数与闭包也是需要了解的知识，这里我单独写了一个博客，链接如下：

http://yunjianfei.iteye.com/blog/2186092

通过该博客，主要要了解的是：
1. 函数是对象，所以函数可以在另一个函数中定义（嵌套函数）
2. 函数也可以赋给另一个变量 （类似C语言的函数指针）
3. 函数可以作为参数，也可以作为返回值（不执行该函数，只是返回）
4. 闭包是内部函数可以使用外部函数变量的机制
 
 

装饰器（Decorators）

 
装饰器其实就是调用时，把一个函数作为参数，把此函数封装后，返回一个替代函数。
读起来有点抽象，换句话说：装饰器其实就是在不修改原函数的基础上，在执行原函数的前后执行别的代码
 
我们看一个简单的例子，下面是手动实现的一个装饰器。
 

#!/usr/bin/env python
def outer(some_func):
def inner():
print "before some_func"
ret = some_func() # 1
return ret + 1
return inner
def foo():
return 1
decorated = outer(foo) # 2
print decorated()
print "decorated 's __name__ : " + decorated.__name__      
 输出结果：

before some_func
2
decorated 's __name__ : inner

 
这个例子有以下要点：
1. outer函数有一个名为some_func的参数，在outer函数里定义了一个嵌套函数inner,outer将inner函数作为       返回值返回（注意：并没有去调用inner，只是将inner作为变量返回）
2. inner函数打印了一行字符串，然后调用了some_func，并且在#1处获取了some_func的返回值
3. outer每次调用时，参数some_func的值可能会不同，但是我们都会在inner中去调用这个函数。
4. inner在结束时，其返回值是some_func()+1
5. 在#2处，调用了outer函数（foo函数作为参数），并将返回的inner函数作为赋值给decorated 
6.最后调用decorated()函数，执行inner，打印一行，并在inner中调用foo函数，最后返回2
 
上面这个例子可以用一句话概括：变量decorated是将foo函数装饰后（封装后）的版本，或者说，foo函数前后附加其他的一些代码。
 

decorated = outer(foo)
上面的这一行代码其实就是装饰器的本质。下面的例子用我们一般见到的“@”，也就是装饰器的一般用法来写，如下：

#!/usr/bin/env python
def outer(some_func):
def inner():
print "before some_func"
ret = some_func() # 1
return ret + 1
return inner
@outer
def foo():
return 1
print foo()
print "foo's __name__ : " + foo.__name__  #2
执行结果为：

before some_func
2
foo's __name__ : inner

 
上面的两套代码是等价的。
 
@outer这一行，实际上执行的就是：

foo = outer(foo)
 
注意：#2处打印了foo的__name__，打印结果为：inner。这再次印证了我们开头处的一句话：
函数装饰器就是把一个函数作为参数，把此函数封装后，返回一个替代函数。
对应上面的代码，就是：
outer装饰器，把foo函数作为参数，把foo封装成inner后，返回inner。
 
 

一定要用嵌套函数吗

 
第一次看到装饰器的时候，估计有很多人都疑惑过，为啥就是嵌套函数呢？好吧，其实也可以不用嵌套函数的，看下面的例子：

#!/usr/bin/env python
some_func = None #1
def outer(func):
global some_func
some_func = func #2
return inner
def inner():
print "before some_func"
ret = some_func() # 3
return ret + 1
@outer
def foo():
return 1
print foo()
print "foo's __name__ : " + foo.__name__
 
这个例子比上面嵌套函数的装饰器版本复杂了不少，但是效果是等同的。这样一比较，从各个角度来看，嵌套函数的写法显然要简洁很多。
 

收尾

 
 上面介绍装饰器的时候，其实只是介绍了装饰器里最基本的部分，函数装饰器相关，鉴于篇幅，暂时先不在这里写了。