【Day 10 Java转Python】@property——把方法当属性用，Python的封装艺术

Java老兵写Python时最常问的问题“私有字段呢getter和setter呢没有这些封装还叫封装吗”别急Python告诉你封装不是为了写一堆getXxx()/setXxx()而是为了在需要时优雅地插入逻辑。今天我们就来聊聊property装饰器——它让Python的属性既能像字段一样直接访问又能像方法一样动态计算和校验彻底告别Java里那些“样板式”的getter/setter。1. Java的封装防御性编程的“肌肉记忆”在Java中我们习惯这样写publicclassStudent{privateStringname;privateintage;publicStudent(Stringname,intage){this.namename;setAge(age);// 构造器中调用setter进行校验}publicStringgetName(){returnname;}publicvoidsetName(Stringname){this.namename;}publicintgetAge(){returnage;}publicvoidsetAge(intage){if(age0||age150){thrownewIllegalArgumentException(年龄非法);}this.ageage;}}好处可以在setAge里加校验未来还能改内部实现而不影响外部调用。坏处每个字段都要写一堆重复代码。IDE能自动生成但看着还是啰嗦。2. Python的简单粗暴直接暴露属性Python新手包括从Java转来的一开始可能这样写classStudent:def__init__(self,name,age):self.namename self.ageage sStudent(Alice,25)print(s.age)# 25s.age-5# 直接赋值没有任何校验程序可能崩在后面简单是简单但失去了封装的控制。外部可以随意赋一个不合法的值错误会在意想不到的地方爆发。3. property两全其美的方案Python提供了property装饰器让你可以把一个方法伪装成属性。调用时不用加括号就像访问字段一样自然。同时你可以定义属性名.setter来控制赋值逻辑。classStudent:def__init__(self,name,age):self.namename self._ageage# 约定下划线表示“保护属性”外部别直接访问propertydefage(self):获取年龄returnself._ageage.setterdefage(self,value):设置年龄带校验ifnotisinstance(value,int):raiseTypeError(年龄必须是整数)ifvalue0orvalue150:raiseValueError(年龄必须在0-150之间)self._agevalue sStudent(Alice,25)print(s.age)# 25像属性一样读取s.age30# 像属性一样赋值实际调用setterprint(s.age)# 30# s.age -5 # 抛出 ValueError: 年龄必须在0-150之间关键点property把方法变成只读属性。age.setter把另一个同名方法变成可写属性且能加校验逻辑。外部代码完全不用改以后你内部实现可以换成数据库存储、计算属性等调用方无感知。4. 对比Java的getter/setter特性JavaPythonproperty代码量每个字段至少5-6行一行self._xxx 装饰器方法可读性obj.getAge()obj.age封装性强字段private强通过下划线约定property控制访问校验逻辑写在setter中写在setter中计算属性需要额外方法如getFullName()直接用property调用时像属性惰性计算手动实现property配合缓存可实现计算属性示例Java需要显式调用方法Python看起来像字段classRectangle:def__init__(self,width,height):self.widthwidth self.heightheightpropertydefarea(self):面积根据当前宽高动态计算returnself.width*self.height rRectangle(3,4)print(r.area)# 12像字段一样但实际是计算出来的r.width5print(r.area)# 20自动更新Java中你得写r.getArea()而且通常不会把它和普通字段混为一谈。Python让计算属性和存储属性在使用时完全统一体现了“统一访问原则”。5. 高级用法删除器与只读属性只读属性只有getter没有setterclassCircle:def__init__(self,radius):self._radiusradiuspropertydefradius(self):returnself._radiuspropertydefdiameter(self):returnself._radius*2# 只读计算属性cCircle(5)print(c.diameter)# 10# c.diameter 20 # AttributeError: cant set attribute删除器属性名.deleterclassUser:def__init__(self,name):self._namenamepropertydefname(self):returnself._namename.deleterdefname(self):print(f删除用户{self._name})delself._name uUser(Alice)delu.name# 输出 删除用户 Alice6. 实战小练习银行账户的余额控制题目设计一个BankAccount类包含属性owner账户名_balance余额私有使用property定义balance只读属性外部不能直接修改余额。提供deposit(amount)和withdraw(amount)方法内部修改_balance并在修改时通过_balance的setter可选或直接在方法中校验。额外要求余额不能为负数取款不能透支。再添加一个只读属性interest_balance返回余额加上年利息假设年利率3%。参考代码可直接运行classBankAccount:def__init__(self,owner,initial_balance0):self.ownerowner self._balanceinitial_balancepropertydefbalance(self):只读属性外部不能直接赋值returnself._balancebalance.setterdefbalance(self,value):内部使用的setter也可以开放给外部但这里我们通过方法控制ifvalue0:raiseValueError(余额不能为负数)self._balancevaluedefdeposit(self,amount):ifamount0:raiseValueError(存款金额必须为正数)self._balanceamountprint(f存入{amount}元当前余额{self._balance})defwithdraw(self,amount):ifamount0:raiseValueError(取款金额必须为正数)ifamountself._balance:raiseValueError(f余额不足当前余额{self._balance}元)self._balance-amountprint(f取出{amount}元剩余余额{self._balance})propertydefinterest_balance(self):计算属性余额加上一年利息3%returnself._balance*1.03# 测试accBankAccount(张三,1000)print(f{acc.owner}当前余额{acc.balance})# 1000acc.deposit(500)# 存入 500 元当前余额1500acc.withdraw(200)# 取出 200 元剩余余额1300print(f一年后本息{acc.interest_balance:.2f})# 1339.00# 尝试直接修改balance会报错# acc.balance 5000 # AttributeError: cant set attribute? 实际上我们有setter但balance属性有setter这里是可以的等等上面的setter存在但外部调用acc.balance 5000会触发setter但我们不希望外部直接赋值应该去掉setter或者改成私有。正确做法只读属性不要提供setter。修改去掉balance的setter让deposit/withdraw直接操作_balance。修正版本只读balance不提供setterclassBankAccount:def__init__(self,owner,initial_balance0):self.ownerownerifinitial_balance0:raiseValueError(初始余额不能为负数)self._balanceinitial_balancepropertydefbalance(self):只读属性returnself._balancedefdeposit(self,amount):ifamount0:raiseValueError(存款金额必须为正数)self._balanceamountprint(f存入{amount}元当前余额{self._balance})defwithdraw(self,amount):ifamount0:raiseValueError(取款金额必须为正数)ifamountself._balance:raiseValueError(f余额不足当前余额{self._balance}元)self._balance-amountprint(f取出{amount}元剩余余额{self._balance})propertydefinterest_balance(self):returnself._balance*1.03accBankAccount(李四,2000)print(acc.balance)# 2000acc.deposit(1000)# 存入 1000 元当前余额3000# acc.balance 500 # AttributeError: cant set attributeprint(f一年后本息{acc.interest_balance:.2f})# 3090.007. 深入property的底层实现与何时使用property本质是描述符descriptor的语法糖。你可以用类属性方式手动实现但通常装饰器足够。什么时候用property需要校验或计算比如年龄范围、面积计算。需要向后兼容一开始用普通属性后来要加逻辑直接加property外部代码不用改。只读属性暴露内部状态但不允许修改。惰性计算第一次访问时计算后续缓存结果配合functools.cached_property。什么时候不用简单的数据容器比如DTO、配置对象直接用普通属性即可过度封装反而累赘。属性访问非常频繁且性能敏感property调用比直接访问字段稍慢但通常可忽略。8. 结语封装不是写模板而是留后路Java的getter/setter是“防御性”的提前为未来可能的变化做准备。Python的property则是“响应式”的先简单暴露字段等需要加逻辑时轻松改成property外部无感知。这就是Python的“鸭子类型”思想在属性层面的体现只要接口长得像属性它就是属性。今日挑战写一个Temperature类属性celsius摄氏度用property实现fahrenheit华氏度作为计算属性且fahrenheit可读写赋值时自动转换并存储到celsius。公式F C * 9/5 32C (F - 32) * 5/9。要求修改celsius时fahrenheit自动变化修改fahrenheit时celsius自动变化。欢迎评论区贴代码下篇预告Day 11 我们将学习异常处理与文件操作看看with语句如何比Java的try-with-resources更简洁。本文代码基于Python 3.14在VSCode中测试通过。如果觉得有收获请点赞、收藏、转发让更多Java转Python的朋友看到~