Swift Academy · Lezione

@dynamicMemberLookup

Costruisci un accesso dinamico e sicuro rispetto ai tipi ai membri.

Lezione 4 di 413 passaggi

@dynamicMemberLookup è una lezione Swift Academy gratuita su CoddyKit. Questa è la lezione 4 di 4. Puoi leggere la lezione completa qui gratuitamente — poi esercitati direttamente nel browser con un editor di codice integrato e un tutor IA disponibile 24/7. Fa parte del percorso di apprendimento Swift Academy, e i tuoi progressi si sincronizzano tra il web e l'app CoddyKit. Il corso Swift Academy include 4 lezioni in totale.

Che cos'è la ricerca dei membri dinamici

L'attributo @dynamicMemberLookup consente a un tipo di rispondere all'accesso a membri con la sintassi a punto anche quando questi non sono dichiarati come vere proprietà. Quando scrive value.something, Swift lo inoltra a un pedice speciale definito da Lei.

Questo conferisce ai tipi wrapper un aspetto naturale, mantenendo in un unico punto la logica di accesso.

@dynamicMemberLookup
struct Settings {
    private var storage: [String: String] = ["theme": "dark"]
    subscript(dynamicMember key: String) -> String? {
        storage[key]
    }
}

let s = Settings()
print(s.theme ?? "none")

Il pedice obbligatorio

Un tipo contrassegnato con @dynamicMemberLookup deve implementare subscript(dynamicMember:). Quando il parametro è una String, il nome del membro digitato diventa quella stringa durante l'esecuzione.

Quindi config.timeout chiama il pedice con la chiave "timeout".

@dynamicMemberLookup
struct Config {
    let values: [String: Int]
    subscript(dynamicMember member: String) -> Int {
        values[member] ?? 0
    }
}

let config = Config(values: ["timeout": 30, "retries": 3])
print(config.timeout)
print(config.retries)

La ricerca tramite stringhe non è sicura rispetto ai tipi

La ricerca dinamica dei membri basata su stringhe è flessibile, ma perde i controlli in fase di compilazione. Se si scrive in modo errato il nome di un membro, il codice viene comunque compilato e si ottiene qualunque valore il pedice restituisca per una chiave mancante.

Qui sotto, un membro sconosciuto restituisce silenziosamente il valore predefinito invece di impedire la compilazione.

@dynamicMemberLookup
struct Config {
    let values: [String: Int]
    subscript(dynamicMember member: String) -> Int {
        values[member] ?? -1
    }
}

let config = Config(values: ["timeout": 30])
print(config.tmout)

Ricerca sicura rispetto ai tipi con i key path

Per maggiore sicurezza, si può fare in modo che il pedice riceva un KeyPath invece di una stringa. Ora il compilatore verifica che il membro esista nel tipo sottostante, ripristinando il controllo completo e continuando a inoltrare l'accesso.

Questo schema è ideale per i tipi wrapper che contengono un valore fortemente tipizzato.

struct User { let name: String; let age: Int }

@dynamicMemberLookup
struct Boxed {
    let user: User
    subscript<T>(dynamicMember path: KeyPath<User, T>) -> T {
        user[keyPath: path]
    }
}

let boxed = Boxed(user: User(name: "Ada", age: 36))
print(boxed.name)
print(boxed.age)

Perché la versione con key path è più sicura

Poiché il pedice riceve un KeyPath<User, T>, sono consentiti solo i membri che esistono realmente in User. Un refuso come boxed.naem ora impedirebbe la compilazione, a differenza della versione basata su stringhe.

Si ottiene la comodità della sintassi a punto senza alcun rischio.

struct User { let name: String; let age: Int }

@dynamicMemberLookup
struct ReadOnly {
    let value: User
    subscript<T>(dynamicMember path: KeyPath<User, T>) -> T {
        value[keyPath: path]
    }
}

let r = ReadOnly(value: User(name: "Lin", age: 22))
print(r.name, r.age)

Membri dinamici scrivibili

Se il pedice fornisce un setter e riceve un WritableKeyPath, è possibile anche assegnare valori ai membri inoltrati. Il wrapper trasferisce la scrittura direttamente al valore contenuto.

In questo modo si ottiene un wrapper mutabile trasparente.

struct Profile { var name: String; var score: Int }

@dynamicMemberLookup
struct Wrapper {
    var value: Profile
    subscript<T>(dynamicMember path: WritableKeyPath<Profile, T>) -> T {
        get { value[keyPath: path] }
        set { value[keyPath: path] = newValue }
    }
}

var w = Wrapper(value: Profile(name: "Mo", score: 0))
w.score = 99
print(w.value.score)

Inoltrare a un oggetto contenuto

La ricerca dinamica dei membri è ottima per i proxy leggeri che inoltrano principalmente a un valore interno, aggiungendo però un po' di comportamento. Il pedice mantiene in un unico punto la logica di inoltro.

Qui un wrapper di logging inoltra le letture e stampa quale membro è stato utilizzato.

struct Account { let id: Int; let balance: Double }

@dynamicMemberLookup
struct Logged {
    let account: Account
    subscript<T>(dynamicMember path: KeyPath<Account, T>) -> T {
        let result = account[keyPath: path]
        print("accessed a member")
        return result
    }
}

let logged = Logged(account: Account(id: 7, balance: 100))
print(logged.balance)

Combinare con le idee delle funzioni richiamabili dinamiche

La ricerca dinamica dei membri si integra bene con i generics. Un unico pedice generico può inoltrare proprietà di qualsiasi tipo, quindi un solo wrapper può gestire valori di molte forme.

Qui lo stesso Proxy funziona sia quando il membro è una String sia quando è un Int.

struct Item { let title: String; let count: Int }

@dynamicMemberLookup
struct Proxy<Wrapped> {
    let wrapped: Wrapped
    subscript<T>(dynamicMember path: KeyPath<Wrapped, T>) -> T {
        wrapped[keyPath: path]
    }
}

let proxy = Proxy(wrapped: Item(title: "Book", count: 4))
print(proxy.title, proxy.count)

Ricerca tramite stringhe per dati simili a JSON

La forma basata su stringhe trova comunque il suo spazio nella rappresentazione di dati poco strutturati, come il JSON analizzato, i cui membri non sono noti in fase di compilazione. Ogni accesso diventa una ricerca in un dizionario.

Qui un piccolo valore simile a JSON espone i propri campi tramite la sintassi a punto.

@dynamicMemberLookup
struct JSON {
    let fields: [String: String]
    subscript(dynamicMember key: String) -> String {
        fields[key] ?? ""
    }
}

let json = JSON(fields: ["city": "Oslo", "country": "Norway"])
print(json.city)
print(json.country)

Limitazioni da tenere a mente

La ricerca dinamica dei membri influisce solo sulla sintassi di accesso ai membri; non aggiunge vere proprietà memorizzate. Strumenti come il completamento automatico funzionano per la forma con key path, ma non per chiavi stringa arbitrarie.

Preferisca la versione con key path ogni volta che la struttura sottostante è nota e riservi la versione basata su stringhe ai dati realmente dinamici.

struct Point { let x: Int; let y: Int }

@dynamicMemberLookup
struct Safe {
    let point: Point
    subscript<T>(dynamicMember path: KeyPath<Point, T>) -> T {
        point[keyPath: path]
    }
}

let safe = Safe(point: Point(x: 3, y: 4))
print(safe.x + safe.y)

Un decoratore pratico

Mettendo insieme tutti gli elementi, ecco un wrapper misurato che inoltra ogni lettura di proprietà al proprio valore interno contando gli accessi. I framework reali usano questa idea per l'osservazione e il tracing.

La sintassi a punto del wrapper dà la stessa sensazione dell'utilizzo diretto del valore.

struct Sensor { let temperature: Double; let humidity: Double }

@dynamicMemberLookup
class Tracked {
    let sensor: Sensor
    var reads = 0
    init(_ s: Sensor) { sensor = s }
    subscript<T>(dynamicMember path: KeyPath<Sensor, T>) -> T {
        reads += 1
        return sensor[keyPath: path]
    }
}

let t = Tracked(Sensor(temperature: 21.5, humidity: 0.4))
print(t.temperature)
print(t.humidity)
print(t.reads)

Verifica rapida: ricerca dinamica sicura rispetto ai tipi

Ricordi quale parametro del pedice rende la ricerca dinamica dei membri sicura rispetto ai tipi.

Rispondi nella lezione interattiva

Riepilogo: ricerca dinamica dei membri

Ha imparato come funziona @dynamicMemberLookup:

L'attributo indirizza l'accesso con la sintassi a punti a membri non dichiarati verso subscript(dynamicMember:).
Un parametro String offre un accesso flessibile ma non verificato, ideale per dati simili al JSON.
Un parametro KeyPath ripristina la completa sicurezza dei tipi e il completamento automatico.
Un WritableKeyPath con un setter consente di inoltrare le scritture attraverso un wrapper.
È una comodità sintattica che si abbina naturalmente ai pattern proxy e decorator.

Ora dispone dell'intero kit di strumenti per i key path: lettura, scrittura, utilizzo con le collection e inoltro dinamico.

struct User { let name: String }

@dynamicMemberLookup
struct Wrap {
    let user: User
    subscript<T>(dynamicMember path: KeyPath<User, T>) -> T {
        user[keyPath: path]
    }
}

print(Wrap(user: User(name: "Final")).name)

Gratis per iniziare

Impara Swift con un tutor IA — gratis

Scrivi ed esegui vero codice nel tuo browser, ricevi aiuto istantaneo da un tutor IA disponibile 24/7, e riprendi da dove hai lasciato sul web o nell'app.

Corsi: 122
Lezioni: 409

Inizia a imparare gratis Visualizza il corso completo

Domande Frequenti

La lezione «@dynamicMemberLookup» è gratuita?

Sì — il testo completo di «@dynamicMemberLookup» è gratuito qui sul web. Per esercitarvi in modo interattivo (un editor di codice integrato e un tutor IA 24/7) e sbloccare il resto del corso Swift Academy, passa a CoddyKit PRO. Il corso Swift Academy include 4 lezioni in totale.

Cosa imparerò in «@dynamicMemberLookup»?

Costruisci un accesso dinamico e sicuro rispetto ai tipi ai membri. Eserciti Swift Academy con codice pratico che esegui direttamente nel browser, e un tutor IA 24/7 risponde alle tue domande mentre lavori sulla lezione.

Ho bisogno di esperienza per iniziare Swift Academy?

Non è richiesta alcuna esperienza precedente. Swift Academy su CoddyKit è strutturato per principianti e studenti avanzati, quindi puoi iniziare da qui o dall'inizio e procedere al tuo ritmo. Questa è la lezione 4 di 4.

Quanto tempo richiede la lezione «@dynamicMemberLookup»?

La maggior parte delle lezioni CoddyKit richiede circa 5–10 minuti. Ogni lezione è breve e interattiva, quindi fai progressi costanti e riprendi esattamente da dove hai lasciato su web e app.

Posso scrivere ed eseguire codice in questa lezione Swift Academy?

Sì. Ogni lezione Swift Academy include un editor di codice integrato, quindi scrivi ed esegui codice reale direttamente nel tuo browser e ricevi feedback istantaneo dall'IA — nessuna configurazione locale necessaria.

Tutte le lezioni di questo corso

← Torna a Swift Academy