关于如何在 python 中使用属性功能的真实示例？

Question

我对如何在 Python 中使用 @property 感兴趣。我已经阅读了 python 文档，并且其中的示例在我看来只是一个玩具代码：

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

我不知道通过包装用属性装饰器填充的 _x 可以获得什么好处。为什么不直接实现为：

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

我认为，属性功能在某些情况下可能很有用。但什么时候呢？有人可以给我一些现实世界的例子吗？

Answer 1

其他示例包括验证/过滤设置的属性（强制它们在范围内或可接受的范围内）以及复杂或快速变化的术语的惰性评估。

隐藏在属性后面的复杂计算：

class PDB_Calculator(object):
    ...
    @property
    def protein_folding_angle(self):
        # number crunching, remote server calls, etc
        # all results in an angle set in 'some_angle'
        # It could also reference a cache, remote or otherwise,
        # that holds the latest value for this angle
        return some_angle

>>> f = PDB_Calculator()
>>> angle = f.protein_folding_angle
>>> angle
44.33276

验证：

class Pedometer(object)
    ...
    @property
    def stride_length(self):
        return self._stride_length

    @stride_length.setter
    def stride_length(self, value):
        if value > 10:
            raise ValueError("This pedometer is based on the human stride - a stride length above 10m is not supported")
        else:
            self._stride_length = value

Answer 2

一个简单的用例是设置一个只读实例属性，正如您所知，在 python 中用一个下划线 _x 开头的变量名称通常意味着它是私有（内部使用），但是有时我们希望能够读取实例属性而不是写入它，因此我们可以使用 property 来实现：

>>> class C(object):

        def __init__(self, x):
            self._x = x

        @property
        def x(self):
            return self._x

>>> c = C(1)
>>> c.x
1
>>> c.x = 2
AttributeError        Traceback (most recent call last)

AttributeError: can't set attribute

Answer 3

查看这篇文章了解非常实际的用途。简而言之，它解释了在 Python 中您通常如何放弃显式的 getter/setter 方法，因为如果您在某个阶段需要它们，您可以使用 property 进行无缝实现。

Answer 4

我使用它的一件事是缓存存储在数据库中的查找缓慢但不变的值。这适用于您的属性需要计算或其他一些您只想按需执行的长时间操作（例如数据库检查、网络通信）的情况。

class Model(object):

  def get_a(self):
    if not hasattr(self, "_a"):
      self._a = self.db.lookup("a")
    return self._a

  a = property(get_a)

这是在一个 Web 应用程序中，任何给定的页面视图可能只需要这种类型的一个特定属性，但底层对象本身可能有几个这样的属性 - 在构造时将它们全部初始化会很浪费，而属性允许我灵活地使用属性是惰性的，哪些不是。

Answer 5

阅读答案和评论，主题似乎是答案似乎缺少一个简单但有用的示例。我在这里包含了一个非常简单的示例，演示了 @property 装饰器的简单使用。该类允许用户使用各种不同的单位（即 in_feet 或 in_metres）指定和获取距离测量值。

class Distance(object):
    def __init__(self):
        # This private attribute will store the distance in metres
        # All units provided using setters will be converted before
        # being stored
        self._distance = 0.0

    @property
    def in_metres(self):
        return self._distance

    @in_metres.setter
    def in_metres(self, val):
        try:
            self._distance = float(val)
        except:
            raise ValueError("The input you have provided is not recognised "
                             "as a valid number")

    @property
    def in_feet(self):
        return self._distance * 3.2808399

    @in_feet.setter
    def in_feet(self, val):
        try:
            self._distance = float(val) / 3.2808399
        except:
            raise ValueError("The input you have provided is not recognised "
                             "as a valid number")

    @property
    def in_parsecs(self):
        return self._distance * 3.24078e-17

    @in_parsecs.setter
    def in_parsecs(self, val):
        try:
            self._distance = float(val) / 3.24078e-17
        except:
            raise ValueError("The input you have provided is not recognised "
                             "as a valid number")

用法：

>>> distance = Distance()
>>> distance.in_metres = 1000.0
>>> distance.in_metres
1000.0
>>> distance.in_feet
3280.8399
>>> distance.in_parsecs
3.24078e-14

Answer 6

属性只是围绕字段的抽象，它使您可以更好地控制特定字段的操作方式以及进行中间件计算。我想到的很少有用法是验证、事先初始化和访问限制

@property
def x(self):
    """I'm the 'x' property."""
    if self._x is None:
        self._x = Foo()

    return self._x

Answer 7

与使用 setter 和 getter 相比，属性的另一个很好的功能是它们允许您继续在您的代码上使用 OP= 运算符（例如 +=、-=、*= 等）
属性，同时仍然保留 setter 和 getter 将提供的任何验证、访问控制、缓存等。

例如，如果您使用 setter setage(newage) 和 getter getage() 编写类 Person，那么要增加您的年龄必须写：

bob = Person('Robert', 25)
bob.setage(bob.getage() + 1)

但是如果你将 age 设为一个属性，你可以写得更清晰：

bob.age += 1

Answer 8

是的，对于发布的原始示例，该属性的工作方式与仅具有实例变量“x”完全相同。

这是Python属性中最好的一点。从外部看，它们的工作方式与实例变量完全相同！这允许您使用类外部的实例变量。

这意味着您的第一个示例实际上可以使用实例变量。如果事情发生了变化，然后您决定更改实现并且属性很有用，则该属性的接口与类外部的代码仍然相同。 从实例变量到属性的更改对类外部的代码没有影响。

许多其他语言和编程课程将指示程序员永远不要公开实例变量，而应使用“getters”和“setters”对于从类外部访问的任何值，即使是问题中引用的简单情况。

许多语言（例如Java）使用类外部的代码

object.get_i()
    #and
object.set_i(value)

#in place of (with python)
object.i
    #and 
object.i = value

并且在实现类时，有许多“getters”和“setters”，它们的作用与您的第一个示例完全相同：复制一个简单的实例变量。这些 getter 和 setter 是必需的，因为如果类实现发生更改，则类外部的所有代码都需要更改。
但Python属性允许类外的代码与实例变量相同。因此，如果添加属性或具有简单的实例变量，则不需要更改类外部的代码。
因此，与大多数面向对象的语言不同，对于您的简单示例，您可以使用实例变量而不是真正不需要的“getters”和“setters”，这在知识上是安全的如果您将来更改某个属性，则使用您的类的代码无需更改。

这意味着如果存在复杂的行为，您只需要创建属性，并且对于非常常见的简单情况，如问题中所述，只需要一个简单的实例变量，您只需使用实例变量即可。

Answer 9

对你的问题的简短回答是，在你的例子中，没有任何好处。您可能应该使用不涉及属性的形式。

属性存在的原因是，如果您的代码将来发生更改，并且您突然需要对数据执行更多操作：缓存值、保护访问、查询某些外部资源......无论如何，您可以轻松修改您的类以添加 getter和数据的设置器而无需更改接口，因此您不必在代码中找到访问该数据的所有位置并对其进行更改。

Answer 10

许多人一开始没有注意到的是，您可以创建自己的财产子类。我发现这对于公开只读对象属性或可以读取和写入但不能删除的属性非常有用。这也是包装功能（例如跟踪对象字段修改）的绝佳方法。

class reader(property):
    def __init__(self, varname):
        _reader = lambda obj: getattr(obj, varname)
        super(reader, self).__init__(_reader)

class accessor(property):
    def __init__(self, varname, set_validation=None):
        _reader = lambda obj: getattr(obj, varname)
        def _writer(obj, value):
            if set_validation is not None:
               if set_validation(value):
                  setattr(obj, varname, value)
        super(accessor, self).__init__(_reader, _writer)

#example
class MyClass(object):
   def __init__(self):
     self._attr = None

   attr = reader('_attr')