@property装饰器的概念和用法

@property 是 Python 提供的一个装饰器，它的作用是将类的方法转换成一个只读的属性。这意味着你可以通过调用方法的方式来获取计算值，但从外部看，它像是在访问普通属性一样，而不是调用方法。这使得代码的接口更加简洁和自然。

`@property` 的基本概念：

装饰器：@property 是一个装饰器，用于类的方法上。装饰器是 Python 的一种特殊语法，用来修改函数或方法的行为。
将方法转换为属性：通常，类中的方法需要使用括号来调用，而使用 @property 可以让方法看起来像一个普通的属性，通过直接访问即可获取值，而不需要加括号。
只读属性：@property 定义的方法是只读的属性，通常不能修改。如果需要可读写的属性，可以同时使用 @property 和 @<属性名>.setter 来定义可修改的属性。

为什么使用 `@property`？

有时候你希望对类的某个属性做一些逻辑计算，但又希望外部调用时表现得像是在读取一个普通属性，而不是调用一个方法。这样既能保持类内部的逻辑封装，又能对外部提供简洁的接口。

`@property` 的用法：

定义只读属性：
使用 @property 可以将一个方法伪装成属性。外部可以直接访问这个属性，而内部可以执行逻辑运算。
定义可读写属性：
通过配合 @<属性名>.setter 装饰器，可以定义一个既可以读取也可以修改的属性。

示例代码：

假设我们有一个 Circle 类，表示圆，并希望通过 radius 计算圆的面积，但不希望外部用方法的形式调用。

import math

class Circle:
    def __init__(self, radius):
        self._radius = radius
    
    # 定义半径的属性
    @property
    def radius(self):
        return self._radius
    
    # 定义面积为一个属性
    @property
    def area(self):
        return math.pi * (self._radius ** 2)

# 测试
c = Circle(5)

# 通过访问属性的方式获取半径和面积
print(c.radius)  # 输出: 5
print(c.area)    # 输出: 78.53981633974483

在这个例子中，area 是通过 @property 装饰器定义的，只读属性，可以动态计算面积。用户访问 area 属性时并不知道这背后实际上是在调用一个方法。

可读写属性示例：

如果你想定义一个既能读取也能修改的属性，可以配合 @<property>.setter 使用。比如继续改进上面的例子，允许修改 radius 属性：

class Circle:
    def __init__(self, radius):
        self._radius = radius
    
    # 定义半径的属性
    @property
    def radius(self):
        return self._radius
    
    # 设置半径的 setter 方法，允许修改半径
    @radius.setter
    def radius(self, value):
        if value <= 0:
            raise ValueError("Radius must be positive")
        self._radius = value
    
    # 定义面积为只读属性
    @property
    def area(self):
        return math.pi * (self._radius ** 2)

# 测试
c = Circle(5)
print(c.radius)  # 输出: 5
c.radius = 10    # 修改半径
print(c.area)    # 输出: 314.1592653589793

在这个改进版中，@radius.setter 装饰器允许我们通过 c.radius = 10 修改 radius 的值，而不必直接访问内部的私有属性 _radius。同时，area 属性依然保持只读。

总结：

@property 用于将一个方法转换为属性访问的形式，提供简洁的接口。
它常用于需要对类的属性进行计算但又希望对外表现为普通属性的场景。
可以配合 @<属性名>.setter 和 @<属性名>.deleter，使属性可读写，甚至支持删除。