python @property

python 中的 @property 是一个内置装饰器，用来将方法的调用直接转换为类似属性访问的形式

e.g:

1
2
3
4
5
6
7
8
9
10
11
12
13
class Student(object):

    @property
    def score(self):
        return self._score

    @score.setter
    def score(self, value):
        if not isinstance(value, int):
            raise ValueError('score must be an integer!')
        if value < 0 or value > 100:
            raise ValueError('score must between 0 ~ 100!')
        self._score = value

需要注意的是使用方法： get函数（第一个 score ）上使用 @property 关键字，此时@property 本身又创建了另一个装饰器 @score.setter,负责把setter方法变成属性赋值，因此只要在 set 函数上使用 @score.setter 关键字就可以了。一般可以在 set 函数中对属性参数做一些必要的检查。如果只有 set 函数（@property 的部分），那么函数对应的就是只读属性。

调用时：

1
2
3
4
5
6
7
8
>>> s = Student()
>>> s.score = 60 # OK，实际转化为s.set_score(60)
>>> s.score # OK，实际转化为s.get_score()
60
>>> s.score = 9999
Traceback (most recent call last):
  ...
ValueError: score must between 0 ~ 100!

又一个例子：

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
class Screen(object):
    @property
    def width(self):
        return self._width
    @width.setter
    def width(self,width):
        self._width = width
    @property
    def height(self):
        return self._height
    @height.setter
    def height(self,height):
        self._height = height
    @property
    def resolution(self):
        return self._width*self.height

这段代码中 width,height 为读写属性，resolution 为只读属性，可以通过前两个属性计算出来。