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 ...' 的需求.


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