property是内置的装饰器,用于创建特定属性的getter、setter和deleter方法。
property装饰器可以帮助我们实现封装性和数据的访问控制。(建议使用)
通常与getter、setter和deleter方法一起使用,用于获取、设置和删除特定属性的值。 这样做的好处是,可以隐藏底层实现细节,使得属性的访问更加灵活和可控。
示例
class Circle: def __init__(self, age): self._age = age @property def radius(self): print("Getting radius") return self._age # 创建Circle对象 circle = Circle(18) # 使用property的getter方法 print(circle.radius) # 输出: Getting radius 18
需要注意的是,虽然使用property装饰器可以让方法看起来像属性一样访问,但在背后仍然是方法的调用。这使得我们可以在访问属性时执行自定义的逻辑,而不仅仅是简单地返回属性的值。
property.setter
@property.setter是property装饰器的一个变体,用于定义属性的setter方法。它与@property配合使用,用于创建一个可写的属性,允许对属性进行赋值操作。
class Circle: def __init__(self, age): self._age = age @property def radius(self): print("Getting radius") return self._age @radius.setter def radius(self, value): print("Setting radius") if value >= 0: self._age = value else: raise ValueError("Radius cannot be negative.") # 创建Circle对象 circle = Circle(18) # 使用property的setter方法 circle.radius = 27 print(circle.radius) # Setting radius # Getting radius # 27
运用
class FileWriter: def __init__(self): self.datas = None @property def file_content(self): return self.datas @file_content.setter def file_content(self, path): with open(path, 'r') as file: self.datas = file.read() # 创建FileWriter对象 writer = FileWriter('1弧形.csv') # 使用属性读取文件内容 print(writer.file_content) # 输出文件的内容 # 使用属性设置文件内容 writer.file_content = r"C:\Users\admin\Desktop\Log\20230706_13_54_20.log" # 再次读取文件内容 print(writer.file_content) # 输出'New content'
乍一看是不是觉得,明明可以写在一个函数里面,现在却要分开写了,完全没必要。
直白点说,这样写看着很是牛逼的感觉。在使用Ctrl+鼠标点击file_content看到是return self.datas的file_content方法。一定程度上隐藏实现细节。
如果我想在类里面的其他函数获取读取的值,怎么操作:
class FileWriter: def __init__(self): self.datas = None @property def file_content(self): return self.datas @file_content.setter def file_content(self, path): with open(path, 'r') as file: self.datas = file.read() def get_data(self): print(self.file_content) # 创建FileWriter对象 writer = FileWriter() # 使用属性读取文件内容 print(writer.file_content) # 输出文件的内容 # 使用属性设置文件内容 writer.file_content = r"C:\Users\admin\Desktop\Log\20230706_13_54_20.log" writer.get_data()
就这样就可以了,大大提高了灵活性,对于自己而言,维护性也是非常不错的,封装性也是达到了。如果再给我一次重写以前代码的机会,我会把之前的读取文件代码改成这样(装杯(B))。
当然,你也可以单纯的使用property。
property.deleter
这个一般很少用到,因为在下写的项目都不大。
清理资源、阻止属性的进一步访问、阻止属性的进一步访问
class Person: def __init__(self, name): self._name = name @property def name(self): return self._name @name.setter def name(self, value): self._name = value @name.deleter def name(self): del self._name # 创建Person对象 person = Person("Alice") # 获取属性值 print(person.name) # 输出: Alice # 删除属性 del person.name # 再次获取属性值(会引发AttributeError异常) print(person.name) # 抛出异常: AttributeError: 'Person' object has no attribute '_name'
什么时候适合使用?
1、封装属性访问:当你想要控制属性的访问方式时,可以使用property来定义属性的getter和setter方法。这样可以隐藏属性的具体实现细节,通过方法调用的方式来读取和设置属性值,从而提供更好的封装性和访问控制。
2、数据验证和处理:使用property可以在属性的getter和setter方法中添加验证逻辑,确保属性值的合法性和一致性。你可以在setter方法中进行输入验证、范围检查、类型转换等操作,以确保属性值满足特定的要求。
3、计算属性:有时候,某些属性的值是根据其他属性计算得出的,而不是直接存储的。使用property可以定义这样的计算属性,通过getter方法根据其他属性的值计算出结果,并返回给调用者。
4、兼容性和向后兼容:当你需要对已有代码进行扩展或修改时,使用property可以保持代码的向后兼容性。你可以在保持属性访问方式不变的前提下,添加新的验证逻辑、计算逻辑或其他功能,而不会影响到已有代码的调用方式。
5、简化接口:当你希望将方法调用转换为属性访问时,可以使用property。这样可以简化调用者的代码,使其更具可读性和易用性。