Skip to content

Encapsulation - Инкапсуляция через методы ​

Почему методы, а не открытые атрибуты ​

Прямая запись acc.balance = 9999 ломает инварианты класса: проверок нет, логов нет, правил нет. Метод — единственная точка входа в данные: любое изменение проходит через него. А реализацию можно менять, не ломая клиентов: поменяли метод — вызывающий код не тронут.

Контраст виден на простом примере: PublicAccount с открытым balance пропускает любую запись, даже acc.balance = -5, — молча, без проверок. У Account баланс приватный (__balance), и весь доступ идёт через get_balance() и deposit() с проверкой:

python
class PublicAccount:
    def __init__(self, balance=0):
        self.balance = balance


class Account:
    def __init__(self, owner, balance=0):
        self.owner = owner
        self.__balance = balance

    def get_balance(self):
        return self.__balance

    def deposit(self, amount):
        if amount < 0:
            raise ValueError('amount must be >= 0')
        self.__balance += amount
        return self.__balance


pub = PublicAccount(100)
pub.balance = -5
print(pub.balance)        # -5 — запись прошла молча, проверок нет
acc = Account('ann', 100)
print(acc.get_balance())  # 100
print(acc.deposit(50))    # 150
try:
    acc.deposit(-10)
except ValueError as e:
    print(e)  # amount must be >= 0

Проверка на входе ​

Метод withdraw(amount) на входе делает две проверки: amount > 0 и amount <= self.__balance, иначе — ValueError. Заодно обратите внимание на два элемента:

  • _history — защищённый список (соглашение): читать извне можно, трогать не стоит;
  • _record(action) — защищённый метод (внутренний помощник по соглашению): вызывается из deposit/withdraw и пишет операцию в историю.
python
class Account:
    def __init__(self, owner, balance=0):
        self.owner = owner        # public
        self._history = []        # protected (convention)
        self.__balance = balance  # private -> _Account__balance

    def _record(self, action):
        self._history.append(action)

    def get_balance(self):
        return self.__balance

    def deposit(self, amount):
        if amount < 0:
            raise ValueError('amount must be >= 0')
        self.__balance += amount
        self._record(f'deposit {amount}')
        return self.__balance

    def withdraw(self, amount):
        if amount <= 0:
            raise ValueError('amount must be > 0')
        if amount > self.__balance:
            raise ValueError('insufficient balance')
        self.__balance -= amount
        self._record(f'withdraw {amount}')
        return self.__balance


a = Account('ann', 100)
print(a.deposit(50))   # 150
print(a.withdraw(30))  # 120
print(a._history)      # ['deposit 50', 'withdraw 30']
try:
    a.withdraw(200)
except ValueError as e:
    print(e)  # insufficient balance
try:
    a.withdraw(-1)
except ValueError as e:
    print(e)  # amount must be > 0

Связь с инкапсуляцией данных ​

Ранее мы разбирали уровни именования: _x — защищённое по соглашению, __x — name mangling (компилятор переименовывает в _ИмяКласса__x). Этот механизм защищает хранение: само имя атрибута становится неудобным для внешнего доступа. Методы защищают доступ: они определяют, когда и при каких условиях данные меняются и читаются. Вместе — _x/__x плюс методы — получается полноценная инкапсуляция: хранилище скрыто, а доступ к нему проверен в единственной точке.

Проверьте себя ​

❓Почему метод называют «единственной точкой входа» в данные?
❓Что делает запись `pub.balance = -5` у класса с открытым атрибутом?
❓Какие две проверки делает `withdraw(amount)` на входе?
❓Что такое метод `_record(action)` в примере урока?
❓Что защищают методы, а что — имена `_x`/`__x`?
❓Почему метод `history()` должен возвращать копию списка, а не сам список?

Упражнения: ​

  1. Возьмите класс BankAccount из упражнения предыдущего урока. Добавьте метод withdraw(amount) с двумя проверками (отрицательная сумма; снятие больше баланса) и метод history(), возвращающий копию списка операций. Убедитесь, что прямой записью acc.__amount = ... извне сделать нельзя, а acc._BankAccount__amount = 999 — можно, и объясните, почему это плохо.

  2. Создайте класс ParcelBox с приватным __weight и методами get_weight() / set_weight(value), где set_weight отклоняет значения <= 0 и не-числа. Создайте коробку весом 2.5 кг, увеличьте вес до 3.0 и убедитесь, что set_weight(-1) бросает ValueError.

  3. Возьмите класс RomanNumber (после темы сравнения). Переименуйте атрибут roman в __roman и добавьте методы get_roman() (возвращает строку) и set_roman(value) (проверяет: только заглавные I V X L C M, непустая строка). Выведите get_roman() после set_roman('XXI') (ожидается XXI).

  4. Объясните в 3–4 предложениях: почему «данные наружу только через методы» — это инкапсуляция, и что именно ломается, если клиенту разрешить писать в атрибуты напрямую.