Python 装饰器 property() 函数

描述：property() 函数的作用是在新式类中返回属性值。

　　　@property 装饰器简单理解就是负责把一个方法变成属性调用

下面理解property()方法语法：

class property([fget[, fset[, fdel[, doc]]]])

参数：fget-获取属性值的函数；fset-设置属性值的函数；fdel-删除属性值函数；doc-属性描述信息

实例

class C（object）:
        def __init__(self):
                self._x = None

        def getx(self):
                return self._x

        def setx(self):
                self._x = value

        def delx(self):
                del self._x

        x = property(getx, setx, delx, "I'm the 'x' property.")

实例化结果：

注：c 是类C的实例化

1、c.x  触发getter；2、c.x = value 触发setter；3、del c.x 触发 deleter 

————————————————————　　　　@property 　　——————————————————————————————

将property 函数用作@property装饰器详解：

getter、setter、deleter方法用作装饰器

class C(object):
    def __init__(self):
        self._x = None

    @property
    def x(self):
        """I'm the 'x' property."""
        return self._x
    
    @x.setter
    def x(self, value):
        self._x = value

    @x.deleter
    def x(self):
         del self._x        

理解以上，下面来考虑实际场景。

在绑定属性时，如果直接把属性暴露出去，写起来简单，但是没有办法检查参数，导致成绩可以随便改变：

s = Student()
s.score = 9999 #成绩未做校验

为了限制score范围，通过set_score()方法来设置成绩，再通过get_score()获取成绩，在set_score()里面

检查参数：

class Student(object):

    def get_score(self):

            return self._score

    def set_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

现在对任意的Student实例进行操作，score就产生了限制：

>>>s = Student() #实例化
>>>s.set_score(60)
>>>s.get_score() #执行get获取成绩
60
>>>s.set_score(9999)#执行set方法校验
Traceback (most recent call last):
  ...
ValueError: score must between 0 ~ 100!

以上为常规方法实现，下面应用Python内置的@property装饰器负责把一个方法变成属性调用：

class Student(object):
    
    @property
    def score(self):            #加上@property 把getter方法变成属性
            return self._score

    @score.setter　　　　　　　　　# 加上@score.setter 把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 
            

可控属性操作：

>>>s =Student()
>>>s.score = 60 #属性赋值操作，实际转化为s.set_score(60)
>>>s.score         #获取属性操作，实际转化为s.get_score()
60
>>> s.score = 9999
Traceback (most recent call last):
  ...
ValueError: score must between 0 ~ 100!

注意这个@property，我们在对实例属性操作时，就知道该属性很可能不是直接暴露的，而是通过getter和setter方法来实现。

可以定义只读属性，只定义getter方法，不一定setter方法就是一个只读属性：

class Student(object):
    
    @property
    def birth(self):
        return self._birth

    @birth.setter
    def birth(self, value):
        self._birth = value

    @property
    def age(self):
        return 2015 - self._birth

birth 是可读可写属性，age是只读属性

注：额外函数的名字和property下的一样。

到此，整个property装饰器理解结束，写进博客做记录。

本次资料源自：

廖雪峰：https://www.liaoxuefeng.com/wiki/0014316089557264a6b348958f449949df42a6d3a2e542c000/00143186781871161bc8d6497004764b398401a401d4cce000

菜鸟教程：

http://www.runoob.com/python/python-func-property.html