翻译：《实用的Python编程》05_02_Classes_encapsulation

目录 | 上一节 (5.1 再谈字典) | 下一节 (6 生成器)

5.2 类和封装

创建类时，通常会尝试将类的内部细节进行封装。本节介绍 Python 编程中有关封装的习惯用法（包括私有变量和私有属性）。

Public vs Private

虽然类的主要作用之一是封装对象的属性和内部实现细节。但是，类还定义了外界用来操作该对象的公有接口（public interface）。实现细节与公有接口之间的区别很重要。

问题

在 Python 中，几乎所有与类和对象有关的东西都是开放（open）的。

• 可以轻松地查看对象的内部细节。
• 可以随意地修改。
• 没有访问控制的概念（例如：私有类成员）。

如何隔离内部实现的细节，这是一个问题。

Python 封装

Python 依赖编程约定来指示某些东西的用途。这就约定基于命名。有一种普遍的态度是，程序员应该遵守规则，而不是让语言来强制执行规则。

私有属性

以下划线 _ 开头的任何属性被认为是私有的（private）。

class Person(object):
    def __init__(self, name):
        self._name = 0

如前所述，这这是一种编程风格。你仍然可以对这些私有属性进行访问和修改。

>>> p = Person('Guido')
>>> p._name
'Guido'
>>> p._name = 'Dave'
>>>

一般来说，一个以下划线 _ 开头的名称被认为是内部实现，无论该名称是变量名、函数名还是模块名。如果你发现自己直接使用这些名称，那么你可能在做一些错误的事情。你应该寻找更高级的功能。

简单属性

考虑下面这个类：

class Stock:
    def __init__(self, name, shares, price):
        self.name = name
        self.shares = shares
        self.price = price

这里有一个让人惊讶的特性，你可以给属性设置任何值：

>>> s = Stock('IBM', 50, 91.1)
>>> s.shares = 100
>>> s.shares = "hundred"
>>> s.shares = [1, 0, 0]
>>>

你可能会想要对此进行检查（译注：例如 shares 表示的是股份数目，值应该是整数。所以给 shares 赋值时应该对值进行检查。如果检查发现给 shares 赋的值不是整数，那么应该触发一个 TypeError 异常）：

s.shares = '50'     # Raise a TypeError, this is a string

这时候你会怎么做？

托管属性

方法一：引进访问方法（accessor methods）。

class Stock:
    def __init__(self, name, shares, price):
        self.name = name
        self.set_shares(shares)
        self.price = price

    # Function that layers the "get" operation
    def get_shares(self):
        return self._shares

    # Function that layers the "set" operation
    def set_shares(self, value):
        if not isinstance(value, int):
            raise TypeError('Expected an int')
        self._shares = value

糟糕的是，这破坏了我们的已有代码。例如：之前是通过 s.shares = 50 给 shares 赋值的，那么现在就要改成s.set_shares(50) 给 shares 赋值，这很不好。

特征属性（Properties）

方法二：

class Stock:
    def __init__(self, name, shares, price):
        self.name = name
        self.shares = shares
        self.price = price

    @property
    def shares(self):
        return self._shares

    @shares.setter
    def shares(self, value):
        if not isinstance(value, int):
            raise TypeError('Expected int')
        self._shares = value

现在，普通属性（normal attribute）的访问触发了 @property 和 @shares.setter 下的 getter 方法和 setter 方法。

>>> s = Stock('IBM', 50, 91.1)
>>> s.shares         # Triggers @property
50
>>> s.shares = 75    # Triggers @shares.setter
>>>

使用该方法，不需要对源代码做任何修改。在类内（包括在 __init__() 方法内）有赋值的时候，直接调用新的 setter：

class Stock:
    def __init__(self, name, shares, price):
        ...
        # This assignment calls the setter below
        self.shares = shares
        ...

    ...
    @shares.setter
    def shares(self, value):
        if not isinstance(value, int):
            raise TypeError('Expected int')
        self._shares = value

特征属性和私有名称（ private names）的使用之间经常会出现混淆。尽管特征属性内部使用的是私有名称，如 _shares。类的其它地方（不是特征属性），仍可以继续使用诸如 shares 这样的名称。

特征属性对于计算数据属性也非常有用。

class Stock:
    def __init__(self, name, shares, price):
        self.name = name
        self.shares = shares
        self.price = price

    @property
    def cost(self):
        return self.shares * self.price
    ...

这允许你删除 cost 后面的括号，隐藏 cost 是一个方法的事实：

>>> s = Stock('GOOG', 100, 490.1)
>>> s.shares # Instance variable
100
>>> s.cost   # Computed Value
49010.0
>>>

统一访问

最后一个例子展示了如何在对象上放置一个更加统一的接口。如果不这样做，对象使用起来可能会令人困惑。

>>> s = Stock('GOOG', 100, 490.1)
>>> a = s.cost() # Method
49010.0
>>> b = s.shares # Data attribute
100
>>>

为什么 cost 后面需要加上括号 ()，但是 shares 却不需要？ 特征属性可以解决这个问题。

装饰器语法

@ 语法称为“装饰（decoration）”。它指定了一个修饰符（modifier），应用于紧接其后的函数定义：

...
@property
def cost(self):
    return self.shares * self.price

更多细节在 第 7 节 中给到。

插槽属性（__slots__）

你可以使用 __slots__ 限制属性名称集：

class Stock:
    __slots__ = ('name','_shares','price')
    def __init__(self, name, shares, price):
        self.name = name
        ...

使用其它属性时，将会触发错误：

>>> s.price = 385.15
>>> s.prices = 410.2
Traceback (most recent call last):
File "<stdin>", line 1, in ?
AttributeError: 'Stock' object has no attribute 'prices'

管这样可以防止错误和限制对象的使用，但实际上使用 __slots__ 是为了提高性能，提高 Python 利用内存的效率。

关于封装的最终说明

不要滥用私有属性（private attributes），特征属性（properties），插槽属性（slots）等。它们有特殊的用途，你在阅读其它 Python 代码时可能会看到。但是，对于大多数日常编码而言，它们不是必需的。

练习

练习 5.6：简单特征属性

使用特征属性是一种非常有用的给对象添加“计算属性”的方式。虽然你在 stock.py 文件中创建了 Stock 对象，但是请注意，在 Stock 对象上 ，对于不同类型的属性，获取方式稍微有点不同。

>>> from stock import Stock
>>> s = Stock('GOOG', 100, 490.1)
>>> s.shares
100
>>> s.price
490.1
>>> s.cost()
49010.0
>>>

具体来说，cost 后面之所以要添加括号，是因为 cost 是一个方法。

如果你想去掉 cost() 的括号，那么可以把该方法转为一个特征属性。请修改 Stock 类，使其像下面这样计算所持有股票的总价:

>>> ================================ RESTART ================================
>>> from stock import Stock
>>> s = Stock('GOOG', 100, 490.1)
>>> s.cost
49010.0
>>>

尝试将 cost作为方法调用（s.cost()），你会发现，现在已经被定义为特征属性的 cost 无法作为方法被调用。

>>> s.cost()
... fails ...
>>>

这些更改很可能会破坏你之前的 pcost.py 程序，所以，你可能需要返回到 pcost.py 中去掉 cost() 方法后面的括号()。

练习 5.7：特征属性和 Setters

请修改 shares 属性，以便将该值存储在私有属性中，并且使用属性函数（property functions）确保赋给 shares 的值总是整数。预期行为示例：

>>> ================================ RESTART ================================
>>> from stock import Stock
>>> s = Stock('GOOG',100,490.10)
>>> s.shares = 50
>>> s.shares = 'a lot'
Traceback (most recent call last):
  File "<stdin>", line 1, in <module>
TypeError: expected an integer
>>>

练习 5.8：添加插槽属性（slots）

请修改 Stock 类，以便 Stock 类拥有一个 __slots__ 属性。然后确认无法添加新属性:

>>> ================================ RESTART ================================
>>> from stock import Stock
>>> s = Stock('GOOG', 100, 490.10)
>>> s.name
'GOOG'
>>> s.blah = 42
... see what happens ...
>>>

使用 __slots__ 时，Python 使用更高效的对象内部表示。如果你尝试查看实例 s 的底层字典会发生什么？

>>> s.__dict__
... see what happens ...
>>>

应当指出， __slots__ 作为数据结构是类中最常用的一种优化。使用插槽属性使程序占用更少的内存，运行更快。但是，在其它大多数类中，你应该尽可能避免使用 __slots__ 。

目录 | 上一节 (5.1 再谈字典) | 下一节 (6 生成器)

注：完整翻译见 https://github.com/codists/practical-python-zh