day 42 类的装饰器

day 29
有了类和装饰器，那么类还能进一步封装么？可以的，类也有装饰器
函数的装饰器是：接收一个函数，返回一个修改后的函数。我们之前是用复用的思想来看装饰器的，换一个角度理解，当你想修改一个函数的时候，可以通过装饰器方法来修改而无需重新定义这个函数。
类也有修饰器，逻辑类似：接收一个类，返回一个修改后的类。比如
1、添加新的方法或属性（如示例中的log 方法）
2、修改原有的方法（如替换init 方法，添加日志）
3、甚至可以返回一个全新的类（继承或组合原类）
通过类装饰器，可以在不修改类内部代码的情况下，为多个类统一添加功能（如日志、统计）


 **类装饰器 vs 函数装饰器：核心区别**
| **特性**         | **函数装饰器**                                | **类装饰器**                                |
|------------------|---------------------------------------------|---------------------------------------------|
| **作用对象**     | 函数（function）                              | 类（class）                                 |
| **传入参数**     | 接收函数作为参数（`def decorator(func):`）    | 接收类作为参数（`def decorator(cls):`）      |
| **返回值**       | 返回**包装后的函数**（通常是闭包）            | 返回**修改后的类**（可以是原类或新类）      |
| **常见用途**     | 修改函数行为（如日志、计时、权限验证）        | 修改类的结构（如添加属性、方法、修改初始化逻辑） |
| **核心逻辑**     | 用闭包包裹函数，在不修改函数代码的前提下扩展功能 | 直接修改类的定义（如添加/替换方法、属性）    |
# 定义类装饰器，为类添加日志功能
def class_logger(cls):
    # 保存原始的 __init__ 方法
    original_init = cls.__init__

    def new_init(self, *args, **kwargs):
        # 新增实例化日志
        print(f"[LOG] 实例化对象: {cls.__name__}")
        original_init(self, *args, **kwargs)  # 调用原始构造方法

    # 将类的 __init__ 方法替换为新方法
    cls.__init__ = new_init

    # 为类添加一个日志方法（示例）
    def log_message(self, message):
        print(f"[LOG] {message}")

    cls.log = log_message  # 将方法绑定到类，这是一种将外部函数添加为类的属性的方法
    return cls
    # 定义简单打印类，应用装饰器
    # 同样是语法糖的写法
@class_logger
class SimplePrinter:
    def __init__(self, name):
            self.name = name  # 构造方法：初始化名称

    def print_text(self, text):
            """简单打印方法"""
            print(f"{self.name}: {text}")
# 使用示例
printer = SimplePrinter("Alice")  # 实例化时触发装饰器的日志
printer.print_text("Hello, World!")  # 调用普通方法
printer.log("这是装饰器添加的日志方法")  # 调用装饰器新增的方法

注意到其中的cls.log = log_message 这行代码，他把外部的函数赋值给了类的新定义的属性，这里我们介绍这种写法
实际上，定义类的方法，有2类写法：
1、在类定义内部直接写方法，这是静态方法，一般定义类都这么完成。
2、在类外部定义方法，然后方法赋值给类的属性--这是一种动态方法，常在装饰器中使用，可以在外部赋值，是为了在不修改原类代码的情况下增强类的功能。
ps :之前无论是函数还是类的装饰器，我们都发现是先有装饰器，再有类，既然我们说了装饰器除了让原本的代码更加清晰可读可复用，还具有修改函数or类的功能，那如何修改之前写好的类或者函数呢
所以你还是需要理解装饰器本质就是一个语法糖，对类而言：@decorator语法只是MYclass=decorator 的简写，即使类已定义，仍可手动调用装饰器函数修改他。
总结：装饰器的核心是动态修改类/函数，而不改变原代码。通过外部赋值，可以在不修改类定义的前提下，为类添加新方法或修改已有方法。

@浙大疏锦行