Python 从attribute到property详解

字面意思上的区别

Attribute与property, 都可翻译成属性. 虽然无论是在中文中还是英文中 它们的意思都几乎一样, 但仍有些许差别. Google了好几下, 找到了一个看起来比较靠谱的解释:

According to Webster, a property is a characteristic that belongs to a thing’s essential nature and may be used to describe a type or species.

An attribute is a modifier word that serves to limit, identify, particularize, describe, or supplement the meaning of the word it modifies.

简单来说, property是类的本质属性, 可用于定义和描述一个类别或物种； attribute则是用于详细说明它所描述的物体, 是物体的具体属性.

例如: 人都有嘴巴. 有的人嘴巴很大, 嘴巴是人的property之一, 而大嘴巴只能说是部分人的attribute.

从这个意义上讲, property是attribute的子集.

Python里的attribute与property

回到Python.

Attribute与property在Java中不作区分, 但在Python中有所不同. 下面是Fluent Python(Chapter 19)给出的(非正式)定义:

接下来分别解释.

attribute

所有的数据属性(data attribute)与方法(method)都是attribute. 根据attribute的所有者, 可分为class attribute与instance attribute. class或instance的所有attribute都存储在各自的__dict__属性中.

例如:

# Python3class Foo(): name = ’Foo class attribute’ def fn(self): passprint(’class attribute:’, Foo.__dict__)print()foo = Foo()foo.name = ’foo instance attribute’print(’instance attribute:’, foo.__dict__)

输出:

class attribute: {’fn’: <function Foo.fn at 0x7fd135ec8ea0>, ... , ’name’: ’Foo class attribute’}

instance attribute: {’name’: ’foo instance attribute’}

property

property是出于安全考虑用setter/getter方法替代data attribute, 例如, 只读属性与属性值合法性验证.

只读属性

例如:

class Foo(): def __init__(self, name): self.name = namefoo = Foo(’I do not want to be changed’)print(’foo.name = ’, foo.name)foo.name = ’Unluckily, I can be changed’print(’foo.name = ’, foo.name)

输出:

foo.name = I do not want to be changedfoo.name = Unluckily, I can be changed

在上面的代码中, 假如我们只想将foo的name属性暴露给外部读取, 但并不想它被修改, 我们该怎么办? 之前在Python 定义只读属性中列出了两种解决方案. 第一种方案:”通过私有属性”, 其实就是用property替代attribute.

将上面的foo.name改写成property:

class Foo(): def __init__(self, name): self.__name = name @property def name(self): return self.__namefoo = Foo(’I do not want to be changed’)print(’foo.name = ’, foo.name)foo.name = ’Luckily, I really can not be changed’

输出:

foo.name = I do not want to be changed---------------------------------------------------------------------------AttributeError Traceback (most recent call last)<ipython-input-69-101c96ba497e> in <module>() 9 foo = Foo(’I do not want to be changed’) 10 print(’foo.name = ’, foo.name)---> 11 foo.name = ’Luckily, I really can not be changed’AttributeError: can’t set attribute

有两点需要注意:

foo.name确实已经不能通过foo.name = ...来修改了, 即, foo.name已经是只读属性.

将foo.name从attribute变成property之后, 它的访问方式并没有改变. 也就是说, 对外接口没有改变. 这个优点可以让我们从容的写代码, 不用在一开始就纠结于是使用property还是attribute, 因为可以都使用attribute, 如果有需要, 以后可以在不影响外部代码的前提下随时修改. 而在Java里要做到这一点很难(如果可以做到的话).

属性值合法性验证

在上面的例子中, foo.name只有getter方法, 是只读的, 但其实property也是可修改的, 只需要为它添加一个setter方法就行了. 那么问题就来了, 如果property也是可读可改, 那为何要费事将attribute改写成property呢?

想象一个简单的购物相关的业务场景. 一个Item代表用户购买的一样东西, 主要有类别, 价格和数量属性:

class Item(): def __init__(self, category, count, price): self.cat = category self.count = count self.price = price

正常的调用是类似于这样的, 价格与数量都是正数:

item = Item(’Bread’, 1, 10)

可是, 若价格或数量设置为负数也不会报错:

item.price = -10item.count = -1invalid_item1 = Item(’Bread’, -1, 10)invalid_item2 = Item(’Bread’, 1, -10)

从语法上看, 这些语句都是合法的, 但从业务上看, 它们都是不合法的. 那么, 怎样才能防止这种非法赋值呢? 一种解决方案是按照Java风格, 实现一个Java式的setter方法, 通过item.set_price(price)设置price属性, 然后在set_price方法里写验证代码. 这样是可行的, 但不够Pythonic. Python的风格是读与写都通过属性名进行:

print(item.price)item.price = -10

这样做的好处之前提到过: 将attribute改写成property时不会改变对外接口. 那么, 如何在执行item.price = -10时检验-10的合法性呢? 最直白的方法是在__setattr__方法里设置拦截, 但很麻烦, 特别是当需要验证的属性很多时.(不信的话可以参照Python 定义只读属性的方案二试试).

Python提供的最佳方案是通过property的setter方法:

class Item(): def __init__(self, category, count, price): self.__cat = category # attribute self.count = count # property self.price = price # property @property def cat(self): return self.__cat @property def count(self): return self.__dict__[’count’] @count.setter def count(self, value): if value < 0: raise ValueError(’count can not be minus: %r’%(value)) self.__dict__[’count’] = value @property def price(self): return self.__dict__[’price’] @price.setter def price(self, value): if value < 0: raise ValueError(’price can not be minus: %r’%(value)) self.__dict__[’price’] = value

之前合法的语句现在仍然可以正常运行:

item = Item(’Bread’, 1, 10)item.price = 20item.count = 2print(item.price)

但下面的语句执行时便会报错了:

item = Item(’Bread’, 1, -10)# oritem.price = -10

会报出同一个错误:

---------------------------------------------------------------------------ValueErrorTraceback (most recent call last)<ipython-input-93-4fcbd1284b2d> in <module>()----> 1 item.price = -10<ipython-input-91-7546240b5469> in price(self, value) 27 def price(self, value): 28 if value < 0:---> 29 raise ValueError(’price can not be minus: %r’%(value)) 30 self.__dict__[’price’] = valueValueError: price can not be minus: -10

定义property的其他方式

@property中的property虽可被当作修饰器来使用, 但它其实是一个class(具体API请参考文档), 所以上面的代码还可以改写为:

class Item(): def __init__(self, category, count, price): self.__cat = category # attribute self.count = count # property self.price = price # property def get_cat(self): return self.__cat def get_count(self): return self.__dict__[’count’] def set_count(self, value): if value < 0: raise ValueError(’count can not be minus: %r’%(value)) self.__dict__[’count’] = value def get_price(self): return self.__dict__[’price’] def set_price(self, value): if value < 0: raise ValueError(’price can not be minus: %r’%(value)) self.__dict__[’price’] = value bill = property(get_bill) cat = property(get_cat) count = property(get_count, set_count) price = property(get_price, set_price)

功能上达到要求了, 可代码本身看起来很冗长, 比Java中的getter/setter风格还要长. 这时可以通过property factory来简化代码:

先定义可共用的property factory函数:

def readonly_prop(storage_name): def getter(instance): return instance.__dict__[storage_name] return property(getter)def positive_mutable_prop(storage_name): def getter(instance): return instance.__dict__[storage_name] def setter(instance, value): if value < 0: raise ValueError(’%s can not be minus: %r’%(storage_name, value)) instance.__dict__[storage_name] = value return property(getter, setter)

然后, 之前的示例代码可以简化为:

class Item(): def __init__(self, category, count, price): self.__cat = category # attribute self.count = count # property self.price = price # property cat = readonly_prop(’__cat’) count = positive_mutable_prop(’count’) price = positive_mutable_prop(’price’)

这样一来, 在保证代码简洁的前提下实现了访问控制和合法性验证.

property不会被instance attribute覆盖

之前在Python对象的属性访问过程一文中展示了attribute的解析过程, 从中知道class attribute可以被instance attribute覆盖:

class Foo(): name = ’Foo’foo = Foo()foo.name = ’foo’codes = [’Foo.name’, ’foo.name’]for code in codes: print(code, ’=’, eval(code))

输出为:

Foo.name = Foofoo.name = foo

但在property身上不会发生这种事情:

class Foo(): @property def name(self): return ’Foo’foo = Foo()foo.__dict__[’name’] = ’foo’# 已经不能通过foo.name赋值了codes = [’Foo.name’, ’foo.name’]for code in codes: print(code, ’=’, eval(code))

输出:

Foo.name = <property object at 0x7fd135e7ecc8>foo.name = Foo

至少可以看出两点:

1. 通过class Foo访问Foo.name得到的是property对象, 而非property值.

2. 访问 foo.name时返回的是Foo.name的property值. 究其原因, 是因为在属性解析过程中, property的优先级是最高的.

总结

1.Python的attribute与property不同:

attribute: data attribute + method

property: replace attribute with access control methods like getter/setter, for security reasons.

2.可以通过多种方式定义property:

@property

property(getter, setter)

property factory

3.property在属性解析时的优先级最高, 不会被instance attribute覆盖.

以上这篇Python 从attribute到property详解就是小编分享给大家的全部内容了，希望能给大家一个参考，也希望大家多多支持好吧啦网。