Можем ли создать собственный Property Wrapper?

Да, создание собственных Property Wrappers — это мощная и поддерживаемая возможность Swift

Property Wrapper — это механизм языка Swift, позволяющий инкапсулировать общую логику доступа к свойствам (геттеры/сеттеры) в переиспользуемый компонент. Apple представила их в Swift 5.1, и с тех пор они стали неотъемлемой частью экосистемы, особенно в SwiftUI (например, @State, @Binding, @Published).

Зачем создавать свой Property Wrapper?

Вы создаете кастомные Property Wrappers, когда вам нужно:

• Единообразно применять одну и ту же логику валидации, трансформации или хранения к множеству свойств.
• Уменьшить дублирование кода, вынося общие паттерны (например, сохранение в UserDefaults, кэширование, логирование).
• Улучшить читаемость кода, давая обернутому свойству понятное имя, описывающее его поведение (например, @UserDefault, @Trimmed).

Структура Property Wrapper

Минимальное требование — объявить структуру или класс, снабженный атрибутом @propertyWrapper и реализующий свойство с именем wrappedValue.

@propertyWrapper
struct Trimmed {
    private var value: String = ""

    var wrappedValue: String {
        get { value }
        set { value = newValue.trimmingCharacters(in: .whitespacesAndNewlines) }
    }

    // Необязательный, но часто используемый инициализатор
    init(wrappedValue: String) {
        self.wrappedValue = wrappedValue
    }
}

// Использование
struct UserProfile {
    @Trimmed var username: String // Присваивание "  john_doe  " сохранит "john_doe"
    @Trimmed var email: String
}

Расширенные возможности

1. Дополнительные параметры инициализации: Вы можете добавить параметры для настройки поведения обертки.

   @propertyWrapper
   struct Clamped<V: Comparable> {
       private var value: V
       private let range: ClosedRange<V>
   
       var wrappedValue: V {
           get { value }
           set { value = min(max(range.lowerBound, newValue), range.upperBound) }
       }
   
       init(wrappedValue: V, _ range: ClosedRange<V>) {
           self.range = range
           self.value = min(max(range.lowerBound, wrappedValue), range.upperBound)
       }
   }
   
   struct Exam {
       @Clamped(0...100) var score: Int = 0
   }
   
   var exam = Exam()
   exam.score = 150 // Фактически будет храниться 100
   

2. projectedValue: Позволяет предоставить дополнительное API для обернутого свойства. Доступ к нему осуществляется через префикс $.

   @propertyWrapper
   struct UserDefault<T> {
       let key: String
       let defaultValue: T
       let userDefaults: UserDefaults
   
       var wrappedValue: T {
           get { userDefaults.object(forKey: key) as? T ?? defaultValue }
           set { userDefaults.set(newValue, forKey: key) }
       }
   
       // projectedValue предоставляет объект UserDefaults, используемый для данного свойства
       var projectedValue: UserDefaults {
           get { userDefaults }
       }
   
       init(key: String, defaultValue: T, userDefaults: UserDefaults = .standard) {
           self.key = key
           self.defaultValue = defaultValue
           self.userDefaults = userDefaults
       }
   }
   
   class Settings {
       @UserDefault(key: "isDarkMode", defaultValue: false) var darkModeEnabled
   }
   
   let settings = Settings()
   // Доступ к projectedValue через $
   settings.$darkModeEnabled.set(true, forKey: "anotherKey") // Работает с тем же экземпляром UserDefaults
   

Где используются?

• Локализованное хранение: @UserDefault, @Keychain
• Валидация и нормализация данных: @Email, @NonEmpty, @Uppercased
• Управление доступом и потоками данных: @ThreadSafe, @MainActor
• Работа с базами данных: Обертки для полей Core Data или GRDB.
• Логирование: Автоматическое логирование изменений значения (@Logged).
• Бизнес-логика: @Currency, @Percentage.

Важные ограничения и нюансы

• Property Wrapper не может быть объявлен на уровне протокола (только в структурах, классах, перечислениях и глобально).
• Одна обертка — одно свойство. Нельзя применить одну обертку к нескольким свойствам сразу.
• При использовании внутри структур или классов логика инициализации может быть сложной, особенно при наличии пользовательских инициализаторов.
• Важно понимать, как обертка влияет на семантику копирования для типов-значений (struct). Часто сама обертка должна быть структурой.

Итог: Создание собственных Property Wrappers — это продвинутая, но весьма доступная практика в Swift. Она позволяет писать более декларативный, чистый и поддерживаемый код, инкапсулируя повторяющуюся логику работы со свойствами в именованные, тестируемые компоненты. Это отличный способ показать глубокое понимание возможностей языка и его идиом.