Decorator - 装饰器

 装饰器 Decorator,

     先来看看对 decorator 这个名词的解释,
         一个可调用的对象 A (decorator), 返回另一个可调用的对象 B, 在可调用的对象 C 的定义体之前通过语法 @A 调用.
         Python 的解释器会调用 A(C), 把 C 的定义提替换成 B 并返回(return).
         如果可调用对象 C 是函数, 那么将 A 称作 '函数装饰器(function decorator)'; 若 C 是类,则称 A 为 '类装饰器(class decorator)'.
         decorator 的作用是对目标对象 C 进行'加工处理'(可以理解为对对象 C '增','删','改','查'等), 并返回处理处理后的新对象.

     通过例子说明,
         装饰器 decorator 是可以调用的对象, 其参数是另一个被装饰对象 object (class or function).
         装饰器 可能会'加工'被装饰的对象, 然后把它返回, 又或者将其替换成另一个可以调用对象返回.

         函数装饰器例子(function decorator),
             def A(a,b):
                 print(a+b)
             函数 A 直接打印 两个入参的和, 现在有这样一个需求,再打印结果(和)之前, 提示:'Start calculating the sum of a and b ...',
             来看看这个需求如何通过 decorator 来实现.
                 def C(A):                                                        #1 传入 被调用对象
                     def innerC(a,b):                                             #2 加工函数, 对被装饰对象 A 进行加工处理, 参数与目标对象 A 保持一直
                         print('Start calculating the sum of %d and %d' % (a,b))  #3  '需求' 的实现
                         return A(a,b)                                            #4 将被装饰函数的调用返回,保证'闭环', 返回的是 对象 A 的 return 的对象(非必选的 return)
                     return innerC                                                #5 将包装对象 A 的 函数返回(必选的return, 保证对对象 A 装饰后得到新对象是可调用的)

                 @C                                                               #6 装饰器语法
                 def A(a,b):
                     print(a + b)

                 A(1,3)

                 Output,
                     Start calculating the sum of 1 and 3 ...   #3
                     4

         类装饰器例子(class decorator),
             同样地, 计算 a, b 的和, 用类来实现, 并将 decorator C 应用到这个类上, 看看输出结果如何,
                 @C
                 class A(object):
                     def __init__(self,a,b):
                         print(a + b)

                 Output,
                     Start calculating the sum of 3 and 5 ...
                     8
                     <__main__.A object at 0x038234D0>
                     # 同样, 通过 class decorator C 满足了在计算之前打印提示:'Start calculating the sum of a and b ...' 的需求.

         注, 装饰器的一个关键特性是, 它们在被装饰的函数定义之后立即运行。通常是在导入时。
             实际的情况是, 更多的时候装饰器函数通常在一个模块中被定义, 然后被应用到其他模块儿中的对象上.