Introduzione alla serializzazione

1. Introduzione

Immagina che il tuo oggetto nel programma sia un complesso e bello costruttore LEGO. È fatto di tanti pezzi, ognuno al suo posto, e tutto insieme forma un unico insieme. Finché il costruzione sta sul tuo tavolo (nella memoria del computer), tutto bene. Ma cosa succede se devi portarlo a casa di un amico (trasmetterlo in rete), o semplicemente metterlo in una scatola fino alla prossima volta (salvarlo su disco)? Non puoi semplicemente prenderlo e metterlo in una scatola piatta! Si romperebbe!

Proprio questo — smontare con cura l'oggetto in parti per conservarlo o trasmetterlo in modo sicuro — è ciò di cui si occupa la serializzazione. È il processo che trasforma il tuo oggetto dal suo stato "vivo" in memoria in una sequenza di byte (o in una rappresentazione testuale) che può essere salvata su file, inviata in rete o messa negli appunti. In pratica è come smontare con cura il tuo LEGO, mettere i pezzi in sacchetti, etichettarli e impacchettarli in una scatola per il trasporto o lo stoccaggio.

flowchart LR
    ObjectInMemory(Oggetto in memoria)
    Serialize[SERIALIZZAZIONE]
    BytesOrText[Byte / File di testo / JSON / XML]
    Deserialize[DESERIALIZZAZIONE]
    ObjectAgain(Oggetto di nuovo in memoria)

    ObjectInMemory -->|serialize| Serialize
    Serialize --> BytesOrText
    BytesOrText -->|deserialize| Deserialize
    Deserialize --> ObjectAgain

E, ovviamente, se qualcosa è stato impacchettato dobbiamo saperlo anche aprire! Il processo inverso si chiama deserializzazione. È quando prendi quella scatola con i sacchetti di pezzi LEGO, li versi, e poi, seguendo le istruzioni (o semplicemente ricordando come era montato), ricostruisci l'oggetto in memoria nello stesso esatto stato in cui si trovava prima dell'imballaggio. Ecco la magia!

Il termine "serializzazione" letteralmente significa "rappresentazione sequenziale". Prendiamo una struttura complessa, magari dispersa in memoria (un oggetto può riferirsi ad altri oggetti, collezioni ecc., formando un intero "grafo di oggetti") e la trasformiamo in una forma lineare e sequenziale che è facile da scrivere o trasmettere.

2. Perché non basta semplicemente File.WriteAllText?

Ottima domanda! Se tutti i dati fossero semplici stringhe o numeri, potremmo farne a meno della serializzazione. Ma nel mondo reale le nostre applicazioni lavorano con modelli complessi: clienti, ordini, prodotti, studenti, eroi, livelli. Tutti rappresentati come oggetti in memoria. Ecco perché la serializzazione è il tuo miglior amico:

Salvataggio dello stato dell'applicazione

Immagina di scrivere un editor di testo. L'utente digita, cambia font, inserisce immagini. Tutti questi dati (testo, impostazioni, posizione del cursore) sono, in sostanza, oggetti nel tuo programma. Quando l'utente preme "Salva", vuoi che al prossimo avvio del programma veda tutto esattamente com'era. La serializzazione permette di "congelare" tutti gli oggetti necessari e scriverli su disco, per poi "scongelarli" al caricamento. È come la funzione "salva partita" nei videogiochi. Non vuoi rifare tutto il livello se è saltata la corrente, giusto?

Scambio di dati tra applicazioni

La tua applicazione C# parla con un web server che può essere scritto in Python. Oppure la tua app mobile (per esempio su Xamarin o MAUI) comunica con un server .NET. Questi programmi non condividono la memoria. Per scambiare dati serve un formato comune e comprensibile. La serializzazione trasforma gli oggetti in questo formato comune (per esempio JSON o XML), che può essere inviato in rete. Dall'altra parte, il ricevente deserializza questi dati di nuovo nei propri oggetti, comprensibili per il loro linguaggio. Senza serializzazione dovresti "spacchettare" manualmente ogni pezzo di dati e ricomporlo. Sarebbe noioso, lento e pieno di errori!

Immagina di inviare un pacco in un altro paese. Non puoi mandare le tue cose così come sono; devi imballarle in un contenitore (serializzazione) secondo standard internazionali. All'altra estremità il destinatario aprirà il contenitore e prenderà le sue cose (deserializzazione).

Configurazione dell'applicazione

Spesso le applicazioni hanno molte impostazioni: dimensione della finestra, percorsi dei file, documenti recenti, tema. Salvare ogni impostazione in una variabile separata e poi riscriverle manualmente in un file di config (per esempio .ini o .txt) è scomodo. È molto più semplice definire una classe ImpostazioniApplicazione in cui ogni impostazione è una proprietà, e poi serializzare quell'oggetto di impostazioni in un file. All'avvio — deserializzi. Bello e pratico!

Cache dei dati

A volte ottenere dati (per esempio dalla database o da un server remoto) richiede tempo. Per non richiederli ogni volta possiamo recuperarli una volta, serializzarli e salvarli nella cache (su disco o in uno storage dedicato). Alla richiesta successiva controlliamo prima la cache e se i dati sono lì li deserializziamo. Questo accelera l'app e riduce il carico sulle sorgenti esterne.

3. Idea principale: salvare lo "stato"

Il concetto più importante nella serializzazione è il salvataggio dello stato. Un oggetto è, in pratica, l'insieme dei suoi campi e dei loro valori in un dato momento. La serializzazione "fotografa" quello stato. Quando deserializziamo un oggetto non creiamo semplicemente un nuovo oggetto vuoto, ma lo ricreiamo con tutti quei valori dei campi che aveva al momento della serializzazione.

Non è solo copiare dati. È una copia profonda della struttura e dei valori, incluse le referenze ad altri oggetti, se il serializer sa gestirle. Alcuni serializer possono persino salvare l'informazione sul tipo dell'oggetto, permettendo di deserializzarlo nel giusto class type anche se al momento della deserializzazione non conosciamo il tipo esatto a priori.

Esempio classico: serializzazione degli animali domestici

Continuiamo con la nostra app "Enciclopedia degli animali domestici". Supponiamo di avere questa classe:

public class Pet
{
    public string Name { get; set; }
    public string Type { get; set; } // Per esempio: "Kot", "Sobaka"
    public int Age { get; set; }
}

Vogliamo:

• Riempire una collezione di questi oggetti in memoria,
• Salvarla su file,
• E poi ripristinarla più tardi (per esempio dopo il riavvio del programma).

Schematizzato è così:

Collezione List<Pet>
    ↓ serializzazione
    File (JSON, XML, byte)
    ↓ deserializzazione
Collezione List<Pet> (di nuovo in memoria!)

4. Quali sono i formati di serializzazione

Come nel mondo dei trasporti, dove esistono diversi tipi di contenitori (scatole di cartone, casse di legno, container metallici), anche in programmazione esistono vari formati di serializzazione. Ognuno ha caratteristiche, pregi e difetti.

Per ora non entriamo troppo nel dettaglio, ma ricordati alcuni nomi per capire di cosa parleremo nelle prossime lezioni:

• JSON (JavaScript Object Notation): Oggi probabilmente il formato più popolare. È testuale, relativamente leggibile dall'umano e molto usato per lo scambio dati sul web. Appare come coppie "chiave-valore" racchiuse in parentesi graffe. In sostanza è testo strutturato che i programmi possono parsare facilmente.
• XML (Extensible Markup Language): Più vecchio ma ancora molto diffuso. È basato su tag, come HTML, e ha una struttura rigida. Spesso usato per file di configurazione e scambio dati in sistemi enterprise. Anche leggibile dall'umano, ma spesso verboso.
• Formati binari: Questi salvano i dati non come testo ma direttamente come byte, così come sono in memoria. Di solito sono più compatti e più veloci da serializzare/deserializzare, ma sono illeggibili per un umano. Usati quando serve massima performance o minimo spazio, per esempio per salvataggi di gioco o per trasferire grandi volumi di dati tra componenti dello stesso sistema.

La scelta del formato dipende dal task: serve che un umano possa leggere i dati? Sono importanti velocità e dimensione? Su quali piattaforme invii i dati? Per lo scambio tra sistemi diversi JSON e XML sono spesso preferibili per la loro universalità. Per salvataggi interni a una stessa applicazione i formati binari possono essere più veloci ed efficienti.

Come vedi, la serializzazione è uno strumento potente alla base di molte applicazioni moderne. Permette ai nostri programmi di "ricordare" i dati tra gli avvii, comunicare tra loro e gestire informazioni complesse in modo efficiente. Nelle prossime lezioni non parleremo più solo della "magia", ma impareremo a usarla concretamente con le librerie .NET! Preparati, sarà interessante!