1. 代码
完成了一般的委托功能,一个委托上挂多个函数,可以设置函数列表为空时,是否抛出异常。返回值是函数列表中最后一个函数调用的返回,使用方法可参见test部分。
-
修改:call忘了加字典参数。--LiJie(2005.06.28)
-
修改:增加-、-=操作符,增加clear()、bind()、unbind()函数。--LiJie(2005.06.29 14:30)
1 class delegate:
2 def __init__(self, *calls, **opts):
3 for call in calls:
4 if not callable(call):
5 raise RuntimeError, str(call) + ' not a callable object'
6 self.calls = () + calls
7 self.emptyExcept = opts.get('emptyExcept', False)
8 self.proto = opts.get('proto')
9 def __call__(self, *args, **kwargs):
10 if self.emptyExcept and not self.calls:
11 raise RuntimeError, 'No callable objects'
12
13 try:
14 result = None
15 for call in self.calls:
16 result = call (*args, **kwargs)
17 return result
18 except TypeError:
19 raise RuntimeError, 'Invalid callable type: ' + str(call)
20
21 def __add__(self, call):
22 if not callable(call):
23 raise RuntimeError, str(call) + ' not a callable object'
24 return delegate(*(self.calls + (call,)))
25
26 def __iadd__(self, *calls):
27 self.calls += calls
28 return self
29
30 def __sub__(self, call):
31 return delegate (*[x for x in self.calls if x != call])
32
33 def __isub__(self, call):
34 self.calls = tuple([x for x in self.calls if x != call])
35 return self
36
37 def __str__(self):
38 if self.proto:
39 return '<delegate object, proto type: %s>' % repr(self.proto)
40 return repr(self)
41
42 def clear (self):
43 self.calls = []
44
45 def bind (self, call):
46 self.__iadd__(call)
47
48 def unbind (self, call):
49 if call not in self.calls:
50 raise RuntimeError, str(call) + ' not bind'
51 self.calls = tuple ([x for x in self.calls if x != call])
52
53 if __name__ == '__main__':
54 def a(v1, v2, **kwargs):
55 print '\ta:', v1, v2
56 def b(*args, **kwargs):
57 print '\tb:', args, kwargs
58 def c(v1, v2, **kwargs):
59 print '\tc:', v1, v2, 'hello=', kwargs.get('hello')
60
61 class Test:
62 def hello(self, v1, v2, **kwargs):
63 print '\tTest.hello:', v1, v2
64
65 class Test1:
66 def __call__(self, v1, v2, **kwargs):
67 print '\tTest1.__call__:', v1, v2
68
69 print '======== test delegate.__init__ and delegate.__call__'
70 print '\t==== a, b, c, Test.hello, Test1'
71 f = delegate(a, b, c, Test().hello, Test1())
72 f (3, 4, hello='world')
73 print '======== test delegate.__add__'
74 print '\t==== a, b, c, Test.hello, Test1, a'
75 f1 = f + a
76 f1 (5, 6)
77 print '======== test delegate.__iadd__'
78 print '\t==== a, b'
79 f2 = delegate(a, b)
80 f2 (3, 7)
81 print '\t==== a, b, c'
82 f2 += c
83 f2 (9, 10)
84 print '======== test delegate.__sub__'
85 print '\t==== a, b, c'
86 f3 = delegate (a, b, c)
87 f3 (11,11)
88 print '\t==== b, c'
89 f3 = f3 - a
90 f3 (13, 13)
91 print '\t==== b'
92 f3 = f3 - c
93 f3 (15, 15)
94 print '======== test delegate.__isub__'
95 print '\t==== a, b, c'
96 f4 = delegate(a, b, c)
97 f4 (17, 17)
98 print '\t==== b, c'
99 f4 -= a
100 f4 (19, 19)
101 print '\t==== c'
102 f4 -= b
103 f4 (21, 21)
104 print '======== test delegate.__call__ return value'
105 f3 = delegate(lambda x, y: x*y)
106 assert f3(10, 11) == 10*11
107 f3 = delegate(lambda x, y: x*y, lambda x, y: x**y)
108 assert f3(10, 11) == 10**11
109 print '======== test delegate.__call__ with empty exception (empty)'
110 f4 = delegate (emptyExcept=True)
111 try:
112 f4 (3, 5)
113 except RuntimeError, ex:
114 print 'Exception:', ex
115 print '======== test delegate.__call__ with empty exception (not empty)'
116 f4 += a
117 f4 (3, 5)
118 print '======== test delegate.bind'
119 print '\t==== a'
120 f = delegate (a)
121 f (911, 119)
122 print '\t==== a, b'
123 f.bind (b)
124 f (199, 991)
125 print '======== test delegate.unbind'
126 print '\t==== b'
127 f.unbind (a)
128 f (177, 771)
129 print '\t==== (empty)'
130 f.unbind (b)
131 f (133, 331)
132 print '======== test delegate.clear'
133 print '\t==== a, b'
134 f = delegate (a, b)
135 f (137, 138)
136 print '\t==== (empty)'
137 f.clear ()
138 f (139, 139)
139 print '======== (finished)'
1.1. 讨论
-
不太清楚这个功能的具体实用性。在NewEdit中有类似的处理,它用来处理代码的插入点。不过有两种处理方式:一种是链式执行,不需要考虑返回值的,可以执行多个函数。一种是中断式执行,即要判断返回值,如果返回值为真,则不再继续执行,并且这个返回值要返回给调用者。因此前面的方式有些象过程,后面则是一个函数式的调用。 -- limodou
1.1.1. 功用1--扩展接口设计
-
这个是模拟其它语言中的委托功能,委托实际上是个非常重要的功能,为模块接口设计提供了更广阔的选择,举个例子:
1 class NetConnection:
2 def onConnected (self):
3 pass
4 def onDisconnected (self):
5 pass
6 def onReceived (self, data):
7 pass
8 def connect (self, address):
9 pass
10 def disconnect (self):
11 pass
12 def send (self, data):
13 pass
14
15 class AutoReconnectConnection(NetConnection):
16 def onConnected (self):
17 pass
18 def onDisconnected (self):
19 pass
20
21 class AutoReconnectCommander(AutoReconnectConnection):
22 def onReceived (self, data):
23 pass
?NetConnection类完成基本的网络连接,?AutoReconnectConnection类有断线后自动重连的功能,?AutoReconnectCommander则是把接收到的数据包转为指令或消息格式,这是一个普通的继承结构,没什么问题,使用时只要生成?AutoReconnectCommander对象调用相关方法即可,接收到的数据在?AutoReconnectCommander类中处理。
不过还有其它选择,这里用刚刚完成的delegate来做,示例如下:
1 class NetConnection:
2 def __init__ (self):
3 self.onConnected = delegate (proto='onConnected()')
4 self.onDisconnected = delegate (proto='onDisconnected()')
5 self.onReceived = delegate(proto='onReceived(data)')
6 def connect (self, address):
7 pass
8 def disconnect (self):
9 pass
10
11 class Commander:
12 def __init__(self):
13 self.send = delegate (proto='send(data)')
14 def onReceived (self, data):
15 pass
16
17 class AutoReconnectProcessor:
18 def __init__ (self):
19 self.connect = delegate (proto='connect(address)')
20 def onConnected (self):
21 pass
22 def onDisconnected (self):
23 pass
注:delegate (proto='onConnected()')括号中的proto='...'其实现在没有使用,只是为了方便随时查阅要挂载的函数的原型。 这个调用过程会麻烦一些:
1 # create objects
2 connection = NetConnection ()
3 commander = Commander ()
4 auto_reconnect_processor = AutoReconnectProcessor()
5
6 # process delegate
7 connection.onConnected += auto_reconnect_processor.onConnected
8 connection.onDisconnected += auto_reconnect_processor.onDisconnected
9 connection.onReceived += commander.onReceived
10 command.send += connection.send
11 auto_reconnect_processor.connect = connection.connect
这个要很多步骤才完成一个初始化。但它带来了很多好处:
-
对象之间的行为绑定修改起来非常容易,比如这里要让某个连接断线后不重连,只要把它们之间的关系去掉即可;
-
插入行为非常容易,比如需要在接收到数据以后,把收到的数据复制一份到某文件,只要实现一个对象,并且具有与onReceived接口相容的调用形式同,并添加委托关系即可;要把发送的数据打印在屏幕,只需要实现一个与send相容的函数,在里面执行输出到屏幕,再添加委托关系即可;
-
每个部分的测试应该会比继承关系更容易,现在只需要为委托接口添加测试、输出或其它方式的测试代码即可。
2. 总述
-
总之,就像是电路板一样,实现一个个的小元件,用这种方式插到一块。每个元件之间尽量解除了藕合,对测试来说是大有益处的。就算是对整个系统做测试,也会容易很多,测试过程中要做的修改一般只需要修改委托关系即可。就像在已经完成电路板上夹上个万用表进行测试一样方便,如果某个元件工作不正常,通过简单替换成另一个功能类似的元件,重新加上委托关系即可。使用委托,唯一需要确定的是接口,对象之间根本不知道内部情况,这也与主流的软件开发思想一致。你所说的NewEdit中的处理,我想应该是类似任务列表和消息处理吧,任务列就是一起执行一组方法列表,依次执行;一般消息处理只要一组方法中,有一个处理并返回真值,则不再执行后续。如果是我所描述的这样,那么这里的delegate应该和任务列表功能相似。有些语言的delegate只支持绑定一个方法,C#的delegate支持绑定多个方法,我这里是按C#的方式来实现的,因为在前一个C++项目中使用了一个自己做的delegate,效果是好到非常(测试比较好做),所以这次有个python项目,我就直接先实现这个了。-- LiJie
-
的确 NewEdit 中有你所说的任务表和消息处理。不过感觉使用 + 法重载如果对你的类不是很清楚的话理解起来有些困难。可以提供类似于bind()或attach()之类的函数调用方式,我想更清楚一些。-- limodou
-
+运算符在C#委托中看到的,一起还有-、-=、+、+=、=,使用非常方便,不过在python里,应该是无法直接重载=运算符吧?虽说可以使用property函数,不过会让调用者额外增加几行代码,所以不考虑。我打算把-、-=加进去,再加个clear方法,clear和+=结合使用就相当于=运算符的作用了,当然一起提供bind或attach可能会符合更多人习惯。-- LiJie
-
感谢Zoom Quiet整理版面,也算是给我做个示范,下次就知道怎么排了。-- LiJie
还可以优化,python的方法都可以动态生成、绑定,所以不用每次调用时去判断,只需要在初始化、增加绑定、清除绑定时为它指定不同的调用方法即可。