Design pattern in Python

Il design pattern Singleton in Python

In questa lezione implementerai il pattern Singleton per garantire che una classe abbia un solo oggetto condiviso.

  • Avanzato
  • 2 min di lettura
  • 1 esempio eseguibile

Introduzione

Il problema

Alcune cose dovrebbero esistere una sola volta in un programma: le impostazioni dell'app, un pool di connessioni, un logger che scrive su un solo file. Se ogni parte del codice crea la sua copia, le impostazioni si disallineano e le risorse vengono sprecate.

Immaginalo così

Un singleton è come l'unica campanella di una scuola. Ogni classe fa suonare la stessa campanella; nessuno ne installa una privata. Chiedere "la campanella" ovunque ti dà sempre quell'unica campanella.

Dalla campanella della scuola al codice
_instance = None🔔 Nessuna campanella ancora installata
if cls._instance is None:🔧 Installala la prima volta che qualcuno la chiede
return cls._instance🔁 Tutti dopo ricevono la stessa campanella
first is second✅ Due richieste, un oggetto: True
Ogni chiamata restituisce lo stesso oggetto.
In una frase

Il pattern Singleton fa restituire a una classe la stessa unica istanza ogni volta che viene creata, dando al programma un unico oggetto condiviso.

Punti chiave

  1. _instance è un attributo di classe che salva l'unico oggetto condiviso.
  2. __new__ è il metodo che Python chiama per creare un oggetto; crea l'oggetto solo quando _instance è ancora None.
  3. cls._instance.theme = "dark" prepara una volta l'oggetto condiviso.
  4. first is second è True: entrambi i nomi puntano esattamente allo stesso oggetto.

Quando si usa?

  • Configurazione di tutta l'applicazione che ogni modulo legge.
  • Una risorsa condivisa come una cache, un logger o un pool di connessioni.
  • Imparare come __new__ controlla la creazione degli oggetti.

Quando non serve

  • La maggior parte del codice Python: un oggetto a livello di modulo (i moduli vengono creati una volta) è più semplice e fa lo stesso lavoro.
  • Codice che vuoi testare facilmente: uno stato globale nascosto fa dipendere i test l'uno dall'altro; passa invece l'oggetto.

Codice di esempio

Esegui codice →
main.py
class AppConfig:
    # Singleton: every caller receives one shared configuration object.
    _instance = None

    def __new__(cls):
        # Create the shared instance only on the first call.
        if cls._instance is None:
            cls._instance = super().__new__(cls)
            cls._instance.theme = "dark"
        return cls._instance


first = AppConfig()
second = AppConfig()
print(first is second)
Crea un pulsante Run per questo esempio

Risultato dell'esecuzione

True

Spiegazione del codice

Il metodo __new__ viene chiamato prima di __init__ ogni volta che si crea un oggetto. Alla prima chiamata, _instance è ancora None, quindi l'oggetto viene creato e salvato. Alle chiamate successive, __new__ restituisce semplicemente l'oggetto già salvato, per questo il confronto dei due oggetti con is dà True.

Modifica i valori ed esegui il programma nel compilatore Python online CodeUtility senza installare Python.

Esercizi di approfondimento

Prova a modificare il codice seguendo i suggerimenti qui sotto. Cambiare il codice e osservare il risultato ti aiuta a capire molto più che leggerlo soltanto.

  1. Sostituisci il dominio di esempio mantenendo la struttura del pattern.
  2. Confronta il pattern con un’implementazione più semplice e spiegane i compromessi.
  3. Scrivi test per ogni partecipante prima di aggiungere un’altra implementazione.
Esegui nel compilatore Python →

Errori comuni

Preparare lo stato in __init__

__init__ viene eseguito a ogni chiamata, quindi azzera ogni volta l'oggetto condiviso.

Problema
def __init__(self):
    self.theme = "dark"  # runs again for every AppConfig()
Correzione
if cls._instance is None:
    cls._instance = super().__new__(cls)
    cls._instance.theme = "dark"

Hai finito questa lezione?

Segnala come imparata per tenere traccia dei tuoi progressi.

Esercitati con una sfida

Usa ciò che questa lezione spiega per risolvere un problema reale. Ogni sfida gira nel browser, con test immediati e una revisione dell'IA.

Tutte le sfide