python中常见常用的修饰符

装饰器是Python中一个非常强大的功能，它允许程序在定义函数或方法时“装饰”它们，即在不改变其内部实现的情况下，给它们增加新的功能。装饰器本质上是一个函数，它接收一个函数作为参数并返回一个新的函数。

• 像@classmethod和@staticmethod这样的装饰器是Python内建的、预定义好的装饰器，它们专门用于类的上下文中，以提供特定的功能（如前所述，将方法转变为类方法或静态方法）。
• 除了这些内建装饰器，Python还允许创建自定义装饰器。这意味着你可以定义自己的装饰器来实现特定的逻辑或行为，并可以重用这些装饰器。自定义装饰器可以用于多种用途，如日志记录、性能测试、事务处理、权限校验等。

内置装饰器

@classmethod

• 将方法转变为类方法。这意味着该方法的调用是针对类而不是类的实例。类方法的第一个参数通常是cls，它指向类本身，而不是类的实例。
• 类方法可以被类和其所有实例调用。

class MyClass:
    count = 0

    def __init__(self, value):
        self.value = value
        MyClass.count += 1

    @classmethod
    def how_many(cls):
        return cls.count

    @classmethod
    def create_instance(cls, value):
        return cls(value)  # 创建并返回一个MyClass的实例

# 访问类属性
print(MyClass.how_many())  # 调用类方法，输出: 0

# 创建实例
instance = MyClass.create_instance(5)
print(instance.value)  # 输出: 5
print(MyClass.how_many())  # 输出: 1

在这个例子中，cls.count访问的是类变量count，而cls(value)通过调用类的构造方法来创建一个新的MyClass实例。这展示了cls.和cls()的不同用途：前者用于访问类级别的属性和方法，后者用于实例化对象。

@staticmethod

• 将方法转变为静态方法。静态方法不接收额外的第一个参数（如self或cls），因此它既不需要实例也不需要类来调用。
• 静态方法主要用于组织代码，它们可以通过类或其实例调用，但是它们与类的其他部分相对独立。

class C(object):
    @staticmethod
    def f():
        print('runoob');
 
C.f();          # 静态方法无需实例化 runoob
cobj = C()
cobj.f()        # 也可以实例化后调用 runoob

上述两个修饰器方法的区别：

1. staticmethod不接受隐式的第一个参数（即它们不传递self或cls），classmethod至少一个参数代表类本身。

2. @classmethod通常用于定义那些需要访问类属性或方法的函数，但不需要访问任何实例属性的场景。@staticmethod用于那些逻辑上属于类的方法，但实际上不需要访问类或实例的任何属性，就像是放在类定义中的普通函数。

@property

• 将一个方法转变为属性。这允许类的方法被当作属性一样访问，这样就可以在不改变类接口的前提下，将一个类的属性访问封装成方法。
• 通常用于计算属性，或者在访问属性时添加逻辑（如验证或延迟计算）。（在赋值属性的时候通过在被修饰的方法内添加代码）

class C(object):
    def __init__(self):
        self._x = None
 
    @property
    def x(self):
        """I'm the 'x' property."""
        return self._x
 
    @x.setter
    def x(self, value):
        self._x = value
 
    @x.deleter
    def x(self):
        del self._x

似乎这种方式只是普通的方法也能实现，但是使用@property使得访问和设置属性看起来就像是直接操作属性一样，这样的代码更加简洁和直观。而传统的getter和setter方法需要显式地调用方法，这使得代码看起来更加繁琐。比如上述代码，def 的名称直接是x，即类属性

上述实现等于下属实现

class C(object):
    def __init__(self):
        self._x = None
 
    def getx(self):
        return self._x
 
    def setx(self, value):
        self._x = value
 
    def delx(self):
        del self._x
 
    x = property(getx, setx, delx, "I'm the 'x' property.")

以下是 property() 方法的语法:

class property([fget[, fset[, fdel[, doc]]]])

参数：

• fget -- 获取属性值的函数
• fset -- 设置属性值的函数
• fdel -- 删除属性值函数
• doc -- 属性描述信息

返回值：返回新式类属性。

自定义装饰器使用方法

 

参考：chatgpt

runoob.com

https://zhuanlan.zhihu.com/p/265779360