python中@property注解的具体使用

class Circle:
    def __init__(self, radius: float):
        self.radius = radius  # 基础属性

    @property
    def area(self) -> float:
        """计算面积（只读属性），无需调用方法，直接访问"""
        return 3.1415926 * self.radius **2

# 使用：像访问普通属性一样调用，无需加 ()
c = Circle(5)
print(c.area)  # 输出：78.539815
# 尝试赋值会报错（只读属性）
# c.area = 100  # AttributeError: can't set attribute

class Person:
    def __init__(self, name: str, age: int):
        self.name = name
        self._age = age  # 下划线前缀：约定俗成的「私有变量」（Python 无真正私有）

    @property
    def age(self) -> int:
        """getter：读取年龄"""
        return self._age

    @age.setter
    def age(self, value: int):
        """setter：赋值时验证数据合法性"""
        # 类型校验
        if not isinstance(value, int):
            raise TypeError("年龄必须是整数")
        # 范围校验
        if value < 0 or value > 150:
            raise ValueError("年龄必须在 0-150 之间")
        self._age = value

# 使用：赋值时自动触发 setter 校验
p = Person("Alice", 20)
print(p.age)  # 20（触发 getter）
p.age = 25    # 合法赋值（触发 setter）
# p.age = "30"  # 触发 TypeError
# p.age = 200   # 触发 ValueError

class Person:
    # （继承上面的 __init__、age getter/setter）
    @age.deleter
    def age(self):
        """deleter：删除属性时执行的逻辑"""
        print("删除年龄属性...")
        del self._age

# 使用：删除属性触发 deleter
p = Person("Bob", 30)
del p.age  # 输出：删除年龄属性...
# 此时访问 p.age 会报错（_age 已被删除）
# print(p.age)  # AttributeError: 'Person' object has no attribute '_age'

class Student(Person):
    @property
    def age(self):
        """重写 getter：添加学生年龄的额外提示"""
        print(f"学生 {self.name} 的年龄：")
        return super().age  # 调用父类的 getter

    @age.setter
    def age(self, value):
        """重写 setter：添加学生年龄的特殊校验"""
        if value < 6 or value > 30:
            raise ValueError("学生年龄应在 6-30 之间")
        super(Student, Student).age.fset(self, value)  # 调用父类的 setter

# 测试
s = Student("Charlie", 18)
print(s.age)  # 输出：学生 Charlie 的年龄：18
s.age = 35    # 触发 ValueError

import functools

class DataProcessor:
    def __init__(self, raw_data: list[int]):
        self.raw_data = raw_data

    @property
    @functools.lru_cache(maxsize=None)  # 缓存方法结果
    def processed_data(self) -> list[int]:
        """模拟昂贵的计算：仅首次调用时计算，后续直接返回缓存"""
        print("执行昂贵计算...")
        return [x * 2 + 1 for x in self.raw_data]

# 测试
dp = DataProcessor([1, 2, 3, 4])
print(dp.processed_data)  # 输出：执行昂贵计算... [3, 5, 7, 9]
print(dp.processed_data)  # 直接返回缓存，无打印

class Person:
    def __init__(self, age: int):
        self._age = age

    # 定义 getter/setter/deleter 方法
    def get_age(self):
        return self._age

    def set_age(self, value):
        if value < 0:
            raise ValueError("年龄不能为负")
        self._age = value

    def del_age(self):
        del self._age

    # 手动创建 property 对象：property(fget, fset, fdel, doc)
    age = property(get_age, set_age, del_age, "年龄属性，支持校验")

# 使用方式与装饰器一致
p = Person(20)
print(p.age)  # 20
p.age = 25    # 合法