O que é o padrão Singleton?

Question

Accepted Answer

O padrão **Singleton** garante que uma classe tenha apenas **uma instância** e fornece um ponto de acesso global a ela. É usado quando exatamente um objeto deve coordenar algo (uma configuração, um pool de conexões, um logger), embora também seja um pouco controverso.

## O que Singleton faz

```text
SINGLETON → guarantee a class has only ONE instance, with global access to it:
  → the class controls its own instantiation (private constructor)
  → returns the SAME instance every time it's requested
→ for: things there should only be ONE of, accessed from many places
```

## Exemplo

```js
class Config {
  static #instance;
  static getInstance() {
    if (!Config.#instance) {
      Config.#instance = new Config();   // create once
    }
    return Config.#instance;             // always return the same instance
  }
}
// Config.getInstance() always returns the same object
```

## Usos comuns e a controvérsia

```text
USES → configuration objects, loggers, connection pools, caches (one shared instance)
⚠️ CONTROVERSIAL → Singletons are often criticized:
  → GLOBAL STATE in disguise → hidden dependencies, hard to TEST (can't easily mock/replace),
    tight coupling, issues with concurrency
  → often better: DEPENDENCY INJECTION (pass the single instance in) → same "one instance"
    benefit but testable and explicit
→ use sparingly; consider DI as an alternative; valid for genuinely-single resources
```

## Por que isso importa

Entender o padrão Singleton é valioso porque é um dos **padrões de design mais bem conhecidos** (frequentemente encontrado e discutido), e compreendê-lo — incluindo suas controvérsias — reflete bom julgamento de design.

Singleton garante que uma classe tenha apenas uma instância com acesso global, usado quando genuinamente deve haver apenas um de algo (configuração, logger, pool de conexões, cache) acessado de muitos lugares.

Entender o que faz (uma classe controlando sua própria instanciação para retornar a mesma instância toda vez) é o conhecimento básico.

No entanto, entender a **controvérsia** é igualmente importante e reflete julgamento maduro: Singletons são amplamente criticados porque são essencialmente **estado global disfarçado**, criando **dependências ocultas** (código usando um Singleton tem uma dependência não declarada), tornando o código **difícil de testar** (você não pode facilmente fazer mock ou substituir a instância única), causando acoplamento forte e colocando problemas de concorrência.

Entender que **injeção de dependência é frequentemente uma alternativa melhor** (passando a instância única, fornecendo o mesmo benefício de "uma instância" mas de forma testável e explícita) reflete o julgamento de design para preferir DI sobre Singletons em muitos casos.

Este entendimento equilibrado — conhecer o padrão mas também seus problemas e melhores alternativas — é o que distingue o uso reflexivo da cargo-cult.

Como Singleton é um dos padrões mais bem conhecidos e frequentemente discutidos, e já que entender junto com suas controvérsias significativas (estado global, problemas de testabilidade) e a alternativa de injeção de dependência reflete bom julgamento de design, entender o padrão Singleton é conhecimento valioso e comumente relevante — um padrão famoso que vale a pena entender, onde apreciar seus inconvenientes (estado global, difícil de testar) e a preferência por injeção de dependência em muitos casos reflete o julgamento de design maduro que distingue desenvolvedores reflexivos, e um tópico frequentemente encontrado e discutido em design de software.