Appearance
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()` должен возвращать копию списка, а не сам список?
Упражнения:
Возьмите класс
BankAccountиз упражнения предыдущего урока. Добавьте методwithdraw(amount)с двумя проверками (отрицательная сумма; снятие больше баланса) и методhistory(), возвращающий копию списка операций. Убедитесь, что прямой записьюacc.__amount = ...извне сделать нельзя, аacc._BankAccount__amount = 999— можно, и объясните, почему это плохо.Создайте класс
ParcelBoxс приватным__weightи методамиget_weight()/set_weight(value), гдеset_weightотклоняет значения<= 0и не-числа. Создайте коробку весом 2.5 кг, увеличьте вес до 3.0 и убедитесь, чтоset_weight(-1)бросаетValueError.Возьмите класс
RomanNumber(после темы сравнения). Переименуйте атрибутromanв__romanи добавьте методыget_roman()(возвращает строку) иset_roman(value)(проверяет: только заглавныеI V X L C M, непустая строка). Выведитеget_roman()послеset_roman('XXI')(ожидаетсяXXI).Объясните в 3–4 предложениях: почему «данные наружу только через методы» — это инкапсуляция, и что именно ломается, если клиенту разрешить писать в атрибуты напрямую.