分类目录:《系统学习Python》总目录
我们在前面的文章中编写了第一个基于类的tracer
函数装饰器的时候,我们简单地假设它也应该适用于任何方法一一一被装饰的方法应该同样地工作,并且自带的self
实例参数应该直接包含在*args
的前面。但这一假设唯一的实际缺点就是它彻头彻尾地错了!当应用于类方法的时候,tracer
的第一个版本失效了,因为self
是装饰器类的实例,并且被装饰的主体类的实例没有包含在*args
中。在python3.X和Python2.X中都是如此。
现在,我们可以在实际工作代码的上下文中看到这点。假设基于类的跟踪装饰器如下:
class tracer:def __init__(self, func):self.calls = 0self.func = funcdef __call(self, *args, **kwargs):self.calls += 1print('call %s to %s' % (self.calls, self.func.__name__))return self.func(*args, **kwargs)@tracer
def spam(a, b, c):print(a + b + c)
我们可以得到如下输出:
然而,类级别方法的装饰失效了:
class Person:def __init__(self, name, pay):self.name = nameself.pay = pay@tracerdef giveRaise(self, percent):self.pay *= (1.0 + percent)@tracerdef lastName(self):return self.name.split()[-1]
我们可以得到如下输出:
这里问题的根源在于tracer
类的__call__
方法的self
参数是一个tracer
实例,还是一个Person
实例?其实我们两者都需要:tracer
用于记录装饰器状态,Person
用于指向最初的方法。实际上,self
必须是tracer
对象,以提供对tracer
的状态信息(它的calls
和func
)的访问;不管装饰一个简单函数还是装饰一个方法,都是如此。
遗憾的是,当我们用__call__
把被装饰方法名称重绑定到一个类实例对象的时候,Python只向self
传递了tracer
实例;它根本没有在参数列表中传递Person
主体。此外,由于tracer不知道我们要利用方法调用处理的
Person`实例的任何信息,因此没有办法创建一个带有实例的绑定方法,也没有办法正确地分发调用。这不是一个漏洞,但却是一个非常值得注意的细节。
最后,前面的列表最终传递了太少的参数给被装饰的方法,并且导致了一个错误。在装饰器的__call__
方法添加一行,以打印所有的参数来验证这一点一一正如我们所看到的,self
是一个tracer
实例,而Person
实例则完全缺失:
正如前面提到的,出现这种情况是因为仅当一个方法名绑定到一个简单函数时,Python才向self
传递隐含的主体实例;当它是可调用类的实例时,就向self
传递这个类的实例。从技术上讲,仅当方法是一个简单函数,而不是另一个类的可调用实例的时候,Python才会创建一个绑定的方法对象,其中包含了主体实例。
参考文献:
[1] Mark Lutz. Python学习手册[M]. 机械工业出版社, 2018.