Язык программирования C#9 и платформа .NET5

Троелсен Эндрю

Инкапсуляция с использованием традиционных методов доступа и изменения

В оставшейся части главы будет построен довольно полный класс, моделирующий обычного сотрудника. Для начала создайте новый проект консольного приложения под названием

EmployeeApp

и добавьте в него новый файл класса по имени

Employee.cs

. Обновите класс

Employee

с применением следующего пространства имен, полей, методов и конструкторов:

using System;

namespace EmployeeApp

{

class Employee

{

//

Поля данных.

private string _empName;

private int _empId;

private float _currPay;

// Конструкторы.

public Employee {}

public Employee(string name, int id, float pay)

{

_empName = name;

_empId = id;

_currPay = pay;

}

// Методы.

public void GiveBonus(float amount) => _currPay += amount;

public void DisplayStats

{

Console.WriteLine("Name: {0}", _empName); // имя сотрудника

Console.WriteLine("ID: {0}", _empId); // идентификационный

// номер сотрудника

Console.WriteLine("Pay: {0}", _currPay); // текущая выплата

}

}

}

Обратите внимание, что поля класса

Employee

в текущий момент определены с использованием ключевого слова

private

. Учитывая это, поля

empName

,

empID

и

currPay

не будут доступными напрямую через объектную переменную. Таким образом, показанная ниже логика в коде приведет к ошибкам на этапе компиляции:

Employee emp = new Employee;

// Ошибка! Невозможно напрямую обращаться к закрытым полям объекта!

emp._empName = "Marv";

Если нужно, чтобы внешний мир взаимодействовал с полным именем сотрудника, то традиционный подход предусматривает определение методов доступа (метод

get

) и изменения (метод

set

). Роль метода

get

заключается в возвращении вызывающему коду текущего значения лежащих в основе данных состояния. Метод

set

позволяет вызывающему коду изменять текущее значение лежащих в основе данных состояния при условии удовлетворения бизнес-правил.

В целях иллюстрации давайте инкапсулируем поле

empName

, для чего к существующему классу

Employee

необходимо добавить показанные ниже открытые методы. Обратите внимание,

что метод

SetName

выполняет проверку входных данных, чтобы удостовериться, что строка имеет длину 15 символов или меньше. Если это не так, тогда на консоль выводится сообщение об ошибке и происходит возврат без внесения изменений в поле

empName

.

На заметку! В случае класса производственного уровня проверку длины строки с именем сотрудника следовало бы предусмотреть также и внутри логики конструктора. Мы пока проигнорируем указанную деталь, но улучшим код позже, во время исследования синтаксиса свойств.

class Employee

{

// Поля данных.

private string _empName;

...

// Метод доступа (метод get).

public string GetName => _empName;

// Метод изменения (метод set).

public void SetName(string name)

{

// Перед присваиванием проверить входное значение.

if (name.Length > 15)

{

Console.WriteLine("Error! Name length exceeds 15 characters!");

// Ошибка! Длина имени превышает 15 символов!

}

else

{

_empName = name;

}

}

}

Такой подход требует наличия двух уникально именованных методов для управления единственным элементом данных. Чтобы протестировать новые методы, модифицируйте свой код следующим образом:

Console.WriteLine("***** Fun with Encapsulation *****\n");

Employee emp = new Employee("Marvin", 456, 30_000);

emp.GiveBonus(1000);

emp.DisplayStats;

// Использовать методы get/set для взаимодействия

// с именем сотрудника, представленного объектом.

emp.SetName("Marv");

Console.WriteLine("Employee is named: {0}", emp.GetName);

Console.ReadLine;

Благодаря коду в методе

SetName

попытка указать для имени строку, содержащую более 15 символов (как показано ниже), приводит к выводу на консоль жестко закодированного сообщения об ошибке:

Console.WriteLine("***** Fun with Encapsulation *****\n");

...

// Длиннее 15 символов! На консоль выводится сообщение об ошибке.

Employee emp2 = new Employee;