Инкапсуляция
- Модификатор доступа
private - Рефакторинг
- Конструкторы для инициализации скрытых полей
privateконструкторы- Свойства
- Контракт функции
- Контракт класса
- Специфика абстракции функции
- Специфика абстракции класса
Задание
Заголовок раздела «Задание»-
Инкапсулируйте поле массива, сделав его
private. Создайте конструктор для его инициализации.Если есть прямое использование этого поля извне класса, сделайте новый метод, и уберите код его использования в этот метод.
Зачем?
Теперь пользователь извне класса может только догадываться о существовании массива с данными, но не сможет получить к нему прямой доступ.
В будущем вы теперь сможете переделать то, как сохранены книги, во что угодно:
- по массиву для каждого свойства;
- словарь из названия в книгу;
- отдельные списки для взятых и не взятых книг;
- список вместо массива;
- обращение в таблицу в базе данных;
- и т.д.
Поскольку прямого доступа к полю извне нет, вы можете быть уверены, что сломаются только методы в самом классе, и вам придется исправлять лишь их.
Еще одно преимущество в том, что теперь лишь методы класса способны внести изменения в массив. Извне невозможно просто так перезаписать какую-то книгу, не пройдя при этом через один из методов.
-
Измените внутреннее представление книг с одного списка на 2
List<Book>: один для взятых книг, другой для свободных.Обновите все методы, которые обновляют книги, чтобы они работали корректно.
Проверьте корректность методов для всех возможных предусловий вызова.
Это задание есть для демонстрации того, что внешний код не поменяется.
-
Сделайте абстракцию для фильтрации книг (
LibraryFilter).Должны поддерживаться как минимум следующие фильтры:
- состояние книги (
enum: взята, невзята, любое); - содержание строки в имени (
string?); - отсутствие строки в имени;
- имя автора (добавьте поле);
- начало имени.
Фильтры сделайте полями этой абстракции.
- состояние книги (
-
Создайте метод в
Library, который принимаетLibraryFilter, и печатает только книги, которые подошли по фильтру.Почему не получится метод создать в
LibraryFilterПотому что массив с книгами в
Libraryуже инкапсулирован. Его можно просматривать только в методах вLibrary.Это и есть один из недостатков этого подхода — о всех возможных взаимодействиях с книгами должно быть известно и абстракции, ответственной за их хранение.
А как это сделать? Я не знаю
Была тема по алгоритмам. Разбейте задачу на подзадачи.
-
Определите контракт класса
LibraryFilter. Для этого подумайте о том, какие значения полей имеют смысл.Например, строковые фильтры не должны быть пустой строкой, а должны быть
nullв случае, когда их не надо применять.enumзначения обязательно должны быть одним из определенных. -
Реализуйте гарантии контракта класса, используя свойства для отдельных фильтров.
Используйте
Debug.Assertдля проверки контракта в свойствах.Ничего не понял
sealed class LibraryFilter{public string? _nameInclude;public string? NameInclude{get{return _nameInclude;}set{Debug.Assert(value != "");_nameInclude = value;}}// ...} -
Сделайте еще один класс,
InputLibraryFilter, который будет в дальнейшем использоваться при вводе желаемого фильтра с консоли.Этот фильтр будет производить coercion из строки, введенной пользователем, в фильтр.
-
Сделайте функцию ввода фильтра с консоли. Сделайте ввод всех фильтров по очереди и попытку их сохранить в
InputLibraryFilter, используя его методы.Ничего не понял
LibraryFilter ReadLibraryFilter(){var ret = new LibraryFilter();var inputFilter = new InputLibraryFilter(ret);while (true){Console.Write("Status (Free, Taken, Any): ");var str = Console.ReadLine();if (!inputFilter.Status(str)){Console.WriteLine("Invalid input");continue;}break;}// ...return ret;} -
InputLibraryFilterбудет хранить в себеLibraryFilterкак поле, и будет сохранять в него фильтры с меньшим количеством проверок.Например, если попытаться сохранить пустую строку как фильтр для имени,
InputLibraryFilterпреобразует ее вnullперед тем, как записать вLibraryFilter.Не понял
sealed class InputLibraryFilter{private readonly InputFilter _impl;public void NameInclude(string? str){if (str == ""){str = null;}_impl.NameInclude = str;}// ...} -
В случае
enum-a сделайте функцию, которая будет возвращатьfalseв случае неудачи.Чего???
sealed class InputLibraryFilter{private readonly InputFilter _impl;public bool Status(string? str){if (str == null){return false;}bool ok = Enum.TryParse(value: str,ignoreCase: true,result: out TakenStatusFilter status);if (!ok){return false;}_impl.TakenStatus = status;}} -
Примените фильтр в функции
main. -
Примените абстракцию
InputLibraryFilterотдельно, для теста ввода фиксированных данных, а не от пользователя.
-
Что дает функция как абстракция?
Заголовок раздела «Что дает функция как абстракция?»Функция содержит несколько шагов, но вызывающий код видит только ее вызов по имени. Использование функций дает следующее:
-
Увеличивает уровень абстракции у кода, т.е. для части действий теперь есть свое имя.
Это позволяет уменьшить смысловую нагрузку, когда цель понять больший кусок кода на высоком уровне, не вдаваясь в каждую деталь реализации.
Недостаток этого в том, что теперь все действия большего куска кода, использующего эту абстракцию, будет понять сложнее, чем если бы ее не было.
-
Функция — это те же самые действия, но как алгоритм на более высоком уровне абстракции. Другой алгоритм теперь способен использовать эту абстракцию как подалгоритм.
Это полезно в том случае, когда данные операции используются больше, чем в одном месте в коде, и позволяет избежать повторение того же кода.
-
Выделяются зависимости функции в строгие параметры. Таким образом понятнее, от какого контекста зависит этот кусок кода.
-
Скрыты данные, необходимые для реализации функции. Того же можно достичь, используя блок.
Можно сказать, что функция инкапсулирует конкретные шаги, которые выполнятся при ее вызове, а так же временные данные, необходимые для ее выполнения, давая явный интерфейс (параметры и возвращаемое значение).
Объяснения этих идей ниже сгенерировал ИИ.
1. Увеличение уровня абстракции
Заголовок раздела «1. Увеличение уровня абстракции»Функция содержит несколько шагов, но вызывающий код видит только имя функции.
У нас есть код, который должен проверять корректность пользовательского ввода. Без абстракции — всё в одном месте:
bool ok = !string.IsNullOrWhiteSpace(input) && input.Length >= 3 && input.All(char.IsLetterOrDigit) && char.IsUpper(input[0]);Трудно понять, что именно проверяется.
Создаём функцию:
bool IsValidUserName(string name){ bool notEmpty = !string.IsNullOrWhiteSpace(name); bool longEnough = name.Length >= 3; bool allAlphanumeric = name.All(char.IsLetterOrDigit); bool startsWithUpper = char.IsUpper(name[0]);
return notEmpty && longEnough && allAlphanumeric && startsWithUpper;}Теперь вызывающий код:
bool ok = IsValidUserName(input);Что произошло:
- Мы подняли абстракцию — теперь в коде видно именно “проверить имя”, а не мешанину из условий.
- Читая основной алгоритм, не нужно читать детали проверки.
- Но чтобы понять как работает проверка, нужно идти внутрь функции — это обратная сторона абстракции.
2. Использование функции как подалгоритма (избежание дублирования)
Заголовок раздела «2. Использование функции как подалгоритма (избежание дублирования)»Мы выделяем функцию, чтобы другие алгоритмы могли использовать её повторно.
Представим, что мы считаем итоговую стоимость с учётом скидки.
decimal ApplyDiscount(decimal price, decimal discount){ return price - (price * discount);}Теперь два разных алгоритма могут пользоваться этим подалгоритмом:
decimal CalculateCartTotal(decimal[] prices){ decimal sum = prices.Sum(); return ApplyDiscount(price: sum, discount: 0.1m);}
decimal CalculateServiceFee(decimal baseFee){ return ApplyDiscount(price: baseFee, discount: 0.05m);}Что произошло:
- Код вычисления скидки не повторяется.
- Разные части программы используют одну и ту же абстракцию.
3. Строгие параметры выявляют зависимости функции
Заголовок раздела «3. Строгие параметры выявляют зависимости функции»Функция вынуждает явно передать всё, от чего она зависит. Это делает её поведение прозрачным.
Без функции:
int width = rect.Width;int height = rect.Height;int area = width * height;С функцией:
int ComputeArea(int width, int height){ return width * height;}Вызов:
int area = ComputeArea(rect.Width, rect.Height);Что произошло:
- Мы явно видим зависимость: функция зависит от width и height.
- Внутри алгоритма теперь не нужно держать в голове всю логику вычисления.
- Чтобы понять, что требуется функции — достаточно посмотреть на параметры.
4. Сокрытие данных, необходимых для реализации
Заголовок раздела «4. Сокрытие данных, необходимых для реализации»Функция может использовать внутренние данные (локальные переменные), которые вызывающий код не обязан и не должен знать.
Функция нормализует строку по нескольким правилам.
string Normalize(string text){ string trimmed = text.Trim(); // скрытые данные string noDoubleSpaces = RemoveDoubleSpaces(trimmed); // скрытые данные string lower = noDoubleSpaces.ToLower(); // скрытые данные return lower;}
string RemoveDoubleSpaces(string text){ while (text.Contains(" ")) text = text.Replace(" ", " "); return text;}Вызов:
string clean = Normalize(text: rawInput);Что произошло:
- Вызывающий код не знает о
trimmed,noDoubleSpaces,lower. - Он знает только: “Нормализуй строку”.
- Все промежуточные шаги и временные данные инкапсулированы внутри.
Что дает класс как абстракция
Заголовок раздела «Что дает класс как абстракция»Объяснение от ChatGPT
Класс — это более сильная форма абстракции, чем функция. Если функция инкапсулирует одну операцию и её временные данные, то класс инкапсулирует целый набор операций и долгоживущее состояние.
Класс предоставляет:
- Связность данных и поведения
- Инкапсуляцию состояния
- Инкапсуляцию операций
- Чёткую границу публичного интерфейса
- Стабильный контракт при изменении реализации
Ниже — разбор этих аспектов.
5. Класс связывает состояние и операции над ним
Заголовок раздела «5. Класс связывает состояние и операции над ним»Класс позволяет хранить данные и предоставить к ним подходящие операции. Это делает код естественным — объект «знает», как с собой работать.
Пример:
public class Counter{ private int _value; // состояние
public void Increment(int amount) { _value += amount; // операция меняет состояние }
public int Value => _value;}Объект:
var c = new Counter();c.Increment(5);int v = c.Value;Состояние и операции — одной логической единицы.
6. Инкапсуляция состояния
Заголовок раздела «6. Инкапсуляция состояния»Класс может скрыть своё внутреннее состояние и предоставить к нему контролируемый доступ.
Это позволяет:
- гарантировать корректность данных
- предотвращать использование внутренних деталей
- менять внутреннее представление без изменения внешнего интерфейса
Пример:
public class Temperature{ private double _celsius; // скрытые данные
public double Celsius => _celsius; public double Fahrenheit => _celsius * 9 / 5 + 32;
public void SetCelsius(double value) { if (value < -273.15) throw new ArgumentException(); _celsius = value; }}Внутренняя логика и проверки скрыты — это полноценная инкапсуляция данных.
7. Инкапсуляция операций
Заголовок раздела «7. Инкапсуляция операций»Класс может скрывать вспомогательные шаги, так же как функция, но при этом они могут использовать и изменять долгоживущее состояние объекта.
Пример:
public class Connection{ private bool _isOpen;
public void Open() { if (!_isOpen) EstablishPhysicalConnection(); // скрытый шаг }
private void EstablishPhysicalConnection() { // детали реализации скрыты _isOpen = true; }}Вызов:
var conn = new Connection();conn.Open(); // видна только высокоуровневая операция8. Явная граница между интерфейсом и реализацией
Заголовок раздела «8. Явная граница между интерфейсом и реализацией»Функции дают интерфейс только в форме параметров и возвращаемого значения. Класс даёт гораздо более структурированную границу:
- публичные методы/свойства — интерфейс
- private-поля, private-методы — реализация
Такая граница позволяет безопасно развивать код.
Пример изменения, которое не ломает пользователей класса:
// раньшеprivate int _amount;
// потомprivate decimal _amount;Если интерфейс не меняется — код, который использует класс, не ломается.
9. Класс — это стабильный контракт, который можно развивать
Заголовок раздела «9. Класс — это стабильный контракт, который можно развивать»Класс позволяет:
- добавлять новые поля
- оптимизировать алгоритмы
- менять внутреннее хранение
- добавлять кэширование
- добавлять проверки
- менять вспомогательные методы
…и всё это без изменения кода, который пользуется классом.
Класс — это «точка расширения» программы.
Коротко: различие абстрации функции и класса
Заголовок раздела «Коротко: различие абстрации функции и класса»| Характеристика | Функция | Класс |
|---|---|---|
| Состояние | нет (только временные переменные) | есть, живёт между вызовами |
| Инкапсуляция данных | только временные данные | полноценная инкапсуляция состояния |
| Инкапсуляция операций | одна операция | множество операций, связанных с данными |
| Интерфейс | параметры + return | набор методов/свойств |
| Поведение | одноразовый алгоритм | объект как долгоживущая сущность |
| Объединяет логику | частично (одна операция) | полностью (данные + методы) |