Python 教程 / 用方法与 property 管理对象状态

方法表达对象要执行的动作,property 则在保留属性读写语法的同时应用访问规则。通过同一个 setter 处理初始化和后续赋值,可以持续验证金额,而不只是创建对象时检查一次。

分开公开属性与内部存储

公开接口仍名为 amount,实际值保存在 _amount。@property定义读取规则,@amount.setter定义写入规则。使用者仍写 item.amount 或 item.amount = 100,不需要改成显式调用读取函数。

单下划线表示内部实现的命名约定,不是安全访问控制。外部代码仍可能直接修改 _amount,绕过公开接口;property 不会自动保护秘密,也不会令整个对象不可变。先结合类与实例状态理解属性属于哪个对象。

__init__ 中写 self.amount = amount,会使用同一个 setter;若直接写 self._amount,就绕过它的验证。官方行为见Python 官方 property 说明。

运行初始化与拒绝修改的完整示例

在独立练习目录,将以下完整代码以 UTF-8 保存为 properties.py,使用项目环境执行 python properties.py。若已核对的解释器命令为 python3,则使用 python3 properties.py。本例无需第三方包:

class Expense:
    def __init__(self, amount):
        self.amount = amount

    @property
    def amount(self):
        return self._amount

    @amount.setter
    def amount(self, value):
        if type(value) is not int or value < 0:
            raise ValueError("amount must be a nonnegative integer")
        self._amount = value

    def add_fee(self, fee):
        self.amount = self.amount + fee

item = Expense(8000)
item.add_fee(500)
print(item.amount)
try:
    item.amount = -1
except ValueError:
    print("rejected")
print(item.amount)

预期输出:

8500
rejected
8500

初始化把 8000 交给 setter,add_fee(500) 读取金额并通过同一属性写回 8500。随后赋值 -1 触发 ValueError,except 打印 rejected,表示修改被拒绝。由于 setter 先检查后写入,原来的 8500 得以保留。

type(value) is int 明确要求确切的整数类型,因此 True 虽是 int 的子类实例,也被拒绝。这是本例选择的金额契约,不是所有 property 都必须使用的类型判断。

避免递归与失败后的部分修改

调用形式 本例行为
item.amount 调用 getter,返回 _amount
item.amount = 100 调用 setter,验证后保存 _amount
item.add_fee(500) 显式方法执行加费,再经过 amount setter

setter 内若再次写 self.amount = value,会重新调用相同 setter,最终可能产生 RecursionError。验证通过后应写独立的内部属性 _amount。反过来,若先修改内部状态再验证,异常发生时就可能已经破坏旧值。

读取属性不用括号。item.amount() 会先得到整数再尝试调用它,因此不是“调用 getter”的正确写法。getter 也不宜悄悄执行昂贵网络请求或大型文件操作;这些动作使用名称清晰的方法,通常更容易让调用者预期成本和失败。

验证边界值并决定额外方法政策

  1. 在原始程序之后分别尝试给 item.amount 赋 True 和 3.5。为了继续检查,每次可单独用 try/except ValueError 包住赋值,并在 except 后打印 item.amount;两次都应被拒绝,旧值仍为 8500。
  2. 在新的 Expense(8000) 实例上调用 add_fee(-500),结果为 7500。最终金额仍符合 setter 规则,所以本例允许这个负数输入;如果业务禁止负数手续费,要在方法内另外验证 fee。
  3. 在新的 8000 实例上调用 add_fee(-9000),最终值为负,应被拒绝;捕获异常后检查金额仍为 8000,而不是变成 -1000。
  4. 移除临时实验并恢复完整示例,重新核对 8500、rejected、8500 三行。

本例的 add_fee 没有独立验证 fee 类型,布尔值 True 在加法中也可能被当作 1,得到一个合法整数。这再次说明最终 amount 有效,不等于每个输入的独立业务含义都正确。需要哪条规则,就明确实现并分别测试它。

没有 setter 的 property 可以拒绝通过该公开属性进行普通赋值,但对象的其他可变状态并不会因此冻结。选择 property 还是方法时,先判断这是自然的数值访问,还是一个应显式表达的操作,再决定接口形式。