В чем разница между fileprivate и private?

Разница между fileprivate и private в Swift

fileprivate и private — это модификаторы доступа в Swift, которые ограничивают видимость объявлений (классов, структур, свойств, методов) в пределах определенных контекстов. Основное различие заключается в области видимости, которую они определяют.

Область видимости

private — самый строгий модификатор доступа. Объявление, помеченное как private, доступно только внутри того же лексического контекста (например, внутри одного типа или расширения, объявленного в том же файле). Это означает, что даже другие типы в том же файле не могут получить к нему доступ, если они не находятся в том же самом объявлении.

fileprivate — менее строгий, чем private. Объявление, помеченное как fileprivate, доступно в пределах всего исходного файла, в котором оно объявлено. Это позволяет нескольким типам внутри одного файла взаимодействовать с такими объявлениями.

Практический пример

Рассмотрим пример, который иллюстрирует разницу на практике. Представьте, что у нас есть файл UserManager.swift:

// UserManager.swift
class UserManager {
    private var secretToken: String = "12345" // Доступно только внутри UserManager
    fileprivate var internalLog: String = "" // Доступно в пределах файла
    
    func authenticate() {
        print(secretToken) // OK: доступ внутри того же типа
        internalLog = "User authenticated" // OK
    }
}

extension UserManager {
    func logAction() {
        // secretToken = "new" // Ошибка: secretToken недоступен здесь (разные лексические контексты)
        internalLog = "Action logged" // OK: fileprivate доступен в расширении в том же файле
    }
}

class Logger {
    func logManagerData(manager: UserManager) {
        // print(manager.secretToken) // Ошибка: private недоступен
        print(manager.internalLog) // OK: fileprivate доступен в пределах файла
    }
}

Ключевые моменты

• private идеален для сокрытия деталей реализации, которые не должны быть доступны даже внутри того же файла. Например, вспомогательные свойства или методы, используемые только внутри одного типа.

• fileprivate полезен, когда несколько типов в одном файле должны взаимодействовать с общими данными, но эти данные не должны быть видны за пределами файла. Это часто используется в модульных архитектурах для скрытия внутренних зависимостей.

Эволюция в Swift 4 и позднее

В Swift 3 и ранее private был эквивалентен современному fileprivate, что вызывало путаницу. Начиная с Swift 4, private был усилен, чтобы быть действительно приватным в пределах лексического контекста. Однако, расширения (extensions) в том же файле получили доступ к private объявлениям, если они расширяют тот же тип. Это важное исключение:

class Example {
    private var hiddenValue = 42
}

extension Example {
    func reveal() {
        print(hiddenValue) // OK в Swift 4+: расширение в том же файле имеет доступ
    }
}

Рекомендации по использованию

• Используйте private по умолчанию для скрытия внутренних деталей. Это способствует инкапсуляции и уменьшает связность кода.
• Применяйте fileprivate осознанно, когда вам необходимо разделить состояние или логику между несколькими типами в одном файле, но скрыть их от внешнего мира.
• Избегайте злоупотребления fileprivate, так как это может привести к излишней связанности кода внутри файла. Если типы часто обмениваются данными, рассмотрите рефакторинг.

Заключение

В итоге, private и fileprivate служат разным целям: первый защищает данные в пределах одного лексического контекста (с оговоркой на расширения), а второй открывает доступ в пределах файла. Понимание этой разницы критично для написания безопасного, модульного и поддерживаемого кода на Swift.