TypeScript: модификаторы доступа

Модификаторы доступа — одна из основных возможностей объектно-ориентированного программирования в TypeScript.

Они используются для управления видимостью членов класса (свойств, методов, конструкторов).

С помощью модификаторов доступа можно достичь инкапсуляции, защищая внутренние детали реализации класса.


SVG-диаграмма: Область действия модификаторов доступа Background Title Scope of Access Modifiers public Inside class ✓ Subclass ✓ External ✓ protected Inside class ✓ Subclass ✓ External ✗ private Inside class ✓ Subclass ✗ External ✗ Example area Use cases public scenario public Public methods/properties E.g., user name, login method protected scenario protected Methods visible to subclasses E.g., calculation formulas, template methods private scenario private Internal implementation details E.g., database connection, internal calculations

Зачем нужны модификаторы доступа?

Инкапсуляция — один из трёх принципов объектно-ориентированного программирования.

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

Модификаторы доступа — это средство достижения инкапсуляции; они управляют областью видимости членов класса.

Пояснение концепции:Модификаторы доступа определяют, где можно получить доступ к членам класса. TypeScript предоставляет три модификатора доступа: public, protected и private.


Модификатор public

public — это модификатор доступа по умолчанию; это означает, что к членам можно получить доступ где угодно.

К членам с модификатором public можно получить доступ как внутри класса, так и в подклассе или вне класса.

Пример

// Определить класс животного
class Animal {
    // Используйте public для изменения свойства name (можно не указывать, public по умолчанию)
    public name: string;

    // Конструктор
    public constructor(name: string) {
        this.name = name;
    }

    // Публичный метод speak
    public speak(): void {
        console.log(this.name + " makes a sound");
    }
}

// Создайте экземпляр
var animal = new Animal("Animal");

// Доступ к публичному свойству вне класса
console.log(animal.name);

// Вызов публичного метода вне класса
animal.speak();

Вывод:

animal
Animals make sounds.

Пояснение:Если вы не указываете модификатор доступа, TypeScript по умолчанию использует public. Поэтому public можно опустить, но для ясности кода рекомендуется указывать его явно.


Модификатор private

private обозначает приватные члены, доступ к которым возможен только внутри класса, где они определены.

Ни подклассы, ни код вне класса не могут получить доступ к приватным членам.

Это часто используется для сокрытия деталей внутренней реализации класса и защиты данных от случайного изменения.

Пример

// Определить класс банковского счёта
class BankAccount {
    // Использовать private для изменения balance, доступ к которому возможен только внутри класса
    private balance: number;

    // Конструктор
    constructor(initialBalance: number) {
        this.balance = initialBalance;
    }

    // Метод депозита
    public deposit(amount: number): void {
        if (amount > 0) {
            this.balance += amount;  // Приватные свойства доступны внутри класса
            console.log("Пополнение успешно выполнено, текущий баланс: " + this.balance);
        }
    }

    // Получить баланс
    public getBalance(): number {
        return this.balance;  // К приватным свойствам можно обращаться внутри класса
    }
}

// Создать экземпляр счета
var account = new BankAccount(1000);

// Пополнение
account.deposit(500);

// Получить баланс через публичный метод
console.log("Баланс: " + account.getBalance());

// Ошибка: к приватным свойствам нельзя обращаться напрямую вне класса
// console.log(account.balance); // Ошибка компиляции!

Вывод:

存款成功,当前余额: 1500
余额: 1500

Лучшая практика:Сделать внутреннее состояние класса приватным и обеспечить контролируемый доступ через публичные методы — это стандартный способ реализации инкапсуляции.


модификатор protected

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

Извне класса нельзя напрямую обращаться к защищённым членам.

Это очень полезно, когда нужно, чтобы подклассы наследовали определённую функциональность от родительского класса, скрывая детали реализации.

Пример

// Определяем базовый класс Person
class Person {
    // Используйте protected для изменения name, доступного в подклассах
    protected name: string;

    constructor(name: string) {
        this.name = name;
    }
}

// Определяем класс Employee, который наследует Person
class Employee extends Person {
    // Department является private
    private department: string;

    constructor(name: string, department: string) {
        super(name);  // Вызов конструктора родительского класса
        this.department = department;
    }

    // Метод самопредставления
    public introduce(): string {
        // Подклассы могут обращаться к protected-члену name
        return "I am " + this.name + ", at " + this.department + " working";
    }
}

// Создать экземпляр Employee
var emp = new Employee("Alice", "Technology Department");

console.log(emp.introduce());

// Ошибка: к protected-членам нельзя обращаться извне класса
// console.log(emp.name); // Ошибка компиляции!

Вывод:

我是 Alice,在 技术部 工作

Случаи использования:protected часто используется для определения свойств, которые нужны подклассам, но не должны быть доступны извне.


модификатор readonly

readonly используется для того, чтобы сделать свойства доступными только для чтения.

Их можно присвоить только при объявлении или в конструкторе, и после этого их нельзя изменить.

Это очень полезно при определении констант или идентификаторов.

Пример

// Определить класс User
class User {
    // Свойства, помеченные readonly, можно присвоить только во время инициализации
    // ID пользователя
    readonly id: number;
    // Имя пользователя
    readonly name: string;

    constructor(id: number, name: string) {
        this.id = id;
        this.name = name;
    }
}

// Создать экземпляр User
var user = new User(1, "Alice");

console.log("Пользователь: " + user.id + ", " + user.name);

// Ошибка: свойства readonly нельзя изменять
// user.id = 2; // Ошибка компиляции!
// user.name = "Bob"; // Ошибка компиляции!

Вывод:

User: 1, Alice

Примечание:readonly и private не конфликтуют. Вы можете использовать readonly и private вместе; свойство нельзя ни изменить, ни получить к нему доступ извне.


Свойства параметров

TypeScript предоставляет сокращённый синтаксис для свойств параметров.

Модификаторы доступа можно использовать непосредственно на параметрах конструктора, чтобы автоматически создавать и инициализировать свойства.

Пример

// Определение класса Point
class Point {
    // Используйте модификаторы непосредственно на параметрах конструктора
    // Эквивалентно объявлению свойств и одновременному присваиванию значений
    constructor(
        // Модификатор public: создаёт публичное свойство x
        public x: number,
        // модификатор public: создает открытое свойство y
        public y: number,
        // модификатор private: создает закрытое свойство z
        private z: number
    ) {
        // Тело конструктора может быть пустым; свойства создаются автоматически
    }

    // Вычислить сумму трех измерений
    public sum(): number {
        // Все свойства доступны внутри класса
        return this.x + this.y + this.z;
    }
}

// Создать экземпляр Point
var point = new Point(1, 2, 3);

// К открытым свойствам можно получить доступ извне
console.log("x: " + point.x);
console.log("y: " + point.y);

// Вызвать метод
console.log("Sum: " + point.sum());

// Ошибка: к приватным свойствам нельзя получить доступ извне
// console.log(point.z); // Ошибка компиляции!

Вывод:

x: 1
y: 2
总和: 6

Упрощённый код:Свойства параметров могут значительно упростить определения классов, избегая повторяющегося кода объявления и присваивания.


Сравнение модификаторов доступа

Ниже приведено сравнение области действия трёх модификаторов доступа.

Модификатор Внутри класса Подкласс Вне класса (экземпляр)
public ✓ Доступно ✓ Доступно ✓ Доступно
protected ✓ Доступно ✓ Доступно ✗ Недоступно
private ✓ Доступно ✗ Недоступно ✗ Недоступно

Рекомендации по выбору:По умолчанию используйте private. Используйте protected, когда необходим доступ из подкласса. Используйте public, когда требуется полный публичный доступ.


Примечания

  • Модификатор по умолчанию:Если модификатор не указан, по умолчанию используется public
  • Конструктор:Конструкторы также могут использовать модификаторы доступа для управления правами на создание экземпляров
  • Сочетание с readonly:readonly можно комбинировать с public, protected и private
  • Влияние на компиляцию:Модификаторы доступа проверяются только во время компиляции и не оказывают влияния во время выполнения

Лучшие практики:По возможности используйте наиболее строгий модификатор доступа. Открывайте только необходимые public-интерфейсы, а внутренние реализации делайте private или protected.


Итог

Модификаторы доступа — основной инструмент TypeScript для реализации инкапсуляции.

  • public:Публичный доступ, значение по умолчанию
  • private:Приватный, виден только внутри класса
  • protected:Защищённый, виден внутри класса и подклассов
  • readonly:Только для чтения, нельзя изменить после инициализации
  • Параметрические свойства:Синтаксис для упрощения объявления свойств

Рекомендации:Выработайте привычку использовать модификаторы доступа; это основа написания высококачественного кода на TypeScript.

Другие расширения