Swift Academy · Lezione

Progettare API con semantica dei valori

Scegliere tra struct e class quando si progettano interfacce pubbliche e framework.

Progettare API con semantica dei valori è 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.

Introduzione

Progettare API basate sulla semantica di valore porta a un codice prevedibile, sicuro per i thread e facile da testare. Esaminiamo i principi e i pattern che aiutano a compiere questa scelta.

Il contratto della semantica di valore

Un tipo ha semantica di valore se: • Due copie indipendenti rimangono per sempre indipendenti • La modifica di una copia non influisce mai sull’altra • Il tipo si comporta come `Int`: `a = b; a += 1` lascia `b` invariato

API pubblica: preferire i tipi restituiti valore

```swift // Reference semantics — caller shares state: func getUser() -> UserClass { ... } // Value semantics — caller gets independent copy: func getUser() -> UserStruct { ... } ``` I tipi restituiti valore proteggono lo stato interno dalle modifiche esterne.

Tipi riferimento immutabili

Quando una classe è sempre immutabile, si comporta come un tipo valore: ```swift final class Token { let value: String init(_ v: String) { value = v } // No mutable state — safe to share freely } ```

Checklist per scegliere struct invece di class

Preferisca `struct` quando: ✓ Il tipo rappresenta dati, non un’identità ✓ Non è necessaria l’ereditarietà ✓ Le istanze non devono essere condivise o sottoposte ad aliasing ✓ È possibile implementare Equatable confrontando i valori dei campi ✓ Funziona bene con Swift Concurrency (Sendable)

Sendable e semantica di valore

Swift 6 Concurrency richiede che i tipi che attraversano i confini degli actor siano `Sendable`: ```swift struct Message: Sendable { var text: String; var timestamp: Date } // Safe to pass between actors ``` I tipi valore con proprietà tutte `Sendable` diventano automaticamente `Sendable`.

Rendere sicure per i valori le API delle classi

```swift struct Config { // Expose value snapshot instead of the class: func snapshot() -> Config { self } // copy by value semantics } // Or use a value-type DTO: struct UserDTO: Sendable { var id: UUID; var name: String } ```

Pattern Builder con i tipi valore

```swift struct Request { var url: URL var method: String = "GET" var headers: [String:String] = [:] func adding(header: String, value: String) -> Request { var copy = self copy.headers[header] = value return copy } } let r = Request(url: url).adding(header: "Auth", value: "Bearer x") ```

Indicazione nella documentazione dell’API

Scegliere `struct` invece di `class` comunica un’indicazione chiara a chi utilizza l’API: • «Questi sono dati: li copi liberamente» • «Le modifiche alla Sua copia non influiranno sulla mia» • «È sicuro passare questo valore tra i thread» In questo modo si riduce la necessità di effettuare copie difensive nel codice che utilizza l’API.

Quando accettare la semantica di riferimento

Accetti la semantica di classe o di riferimento quando: • L’identità è importante (`===`): due oggetti `User` possono rappresentare la stessa persona • Lo stato mutabile condiviso è la funzionalità desiderata: `Database`, `Cache`, `AudioEngine` • È necessaria l’interoperabilità con ObjC: i tipi UIKit e AppKit sono classi • Sono necessarie callback del ciclo di vita: `deinit` per la pulizia delle risorse

Verifica rapida

Quale parola chiave di Swift indica che un tipo può essere passato in sicurezza oltre i confini degli actor in Swift Concurrency?

Riepilogo

Concetti chiave: • Semantica di valore: le modifiche sono locali e non c’è aliasing • Preferisca `struct` per i modelli di dati e `class` per identità e ciclo di vita • Le classi immutabili si comportano come tipi valore • `Sendable` + tipi valore = concorrenza sicura • Il pattern Builder basato su copie di struct crea API immutabili e ordinate Corso completato! Successivo: ARC e pattern di gestione della memoria.

Domande Frequenti

La lezione «Progettare API con semantica dei valori» è gratuita?

Sì — il testo completo di «Progettare API con semantica dei valori» è 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 «Progettare API con semantica dei valori»?

Scegliere tra struct e class quando si progettano interfacce pubbliche e framework. 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 «Progettare API con semantica dei valori»?

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

Stack e heap: dove risiedono i valori
Mutazione, condivisione e aliasing imprevisto
Grafi misti di valori e riferimenti
Progettare API con semantica dei valori

← Torna a Swift Academy