Pythonのシングルトンクラスの作り方を完全解説！初心者でもわかるデザインパターン入門

1. シングルトンクラスとは何か

1. シングルトンクラスとは何か

シングルトンクラスとは、プログラムの中でインスタンスが必ず1つだけ存在するように制御されたクラスのことです。インスタンスとは、クラスをもとにして作られた実体のことを指します。

初心者の方は、クラスを「設計図」、インスタンスを「その設計図から作った実物」と考えるとわかりやすいです。通常は設計図から何個でも実物を作れますが、シングルトンでは「この設計図からは1個しか作れない」という制限をかけます。

この考え方はデザインパターンと呼ばれる、よく使われる設計の型の一つです。デザインパターンは、よくある問題に対する定番の解決方法をまとめたものです。

2. なぜシングルトンが必要なのか

2. なぜシングルトンが必要なのか

シングルトンが使われる理由は、「全体で同じ状態を共有したい」場面が多いからです。たとえばアプリ全体の設定情報、ログの出力先、データベースへの接続管理などは、何個も存在すると混乱の元になります。

もし設定クラスが複数作られてしまうと、ある場所で変更した設定が別の場所に反映されないという問題が起こります。シングルトンにしておけば、どこから使っても必ず同じ1つのインスタンスを参照するため、状態がズレません。

初心者の段階では少し難しく感じますが、「みんなで共有する箱は1つにする」と覚えておくと理解しやすいです。

3. 通常のクラスでは何が問題になるのか

3. 通常のクラスでは何が問題になるのか

まずは、普通のクラスがどのように動くのかを確認してみましょう。何も工夫しない場合、クラスからはいくつでもインスタンスを作ることができます。

class Sample:
    pass

a = Sample()
b = Sample()

print(a is b)

False

この結果は、aとbが別々のインスタンスであることを意味しています。設定管理などでこれが起きると、意図しない動作につながります。そのため、インスタンス生成を制御する必要があります。

4. __new__メソッドを使った基本的なシングルトン

4. __new__メソッドを使った基本的なシングルトン

Pythonでは、__new__という特別なメソッドを使うことで、インスタンスの生成そのものを制御できます。__new__は、インスタンスが作られる直前に呼ばれるメソッドです。

ここで「すでにインスタンスがあればそれを返す」という処理を書けば、シングルトンを実現できます。

class Singleton:
    _instance = None

    def __new__(cls):
        if cls._instance is None:
            cls._instance = super().__new__(cls)
        return cls._instance

a = Singleton()
b = Singleton()

print(a is b)

True

このように、常に同じインスタンスが返されるため、aとbは同一の存在になります。これがシングルトンクラスの基本形です。

5. 初期化処理で気をつけるポイント

5. 初期化処理で気をつけるポイント

シングルトンでは、__init__の扱いに注意が必要です。__init__はインスタンス生成時だけでなく、呼び出すたびに実行されるため、毎回初期化してしまう可能性があります。

そのため、初期化は一度だけ行うようにフラグを使うのが一般的です。

class Config:
    _instance = None
    _initialized = False

    def __new__(cls):
        if cls._instance is None:
            cls._instance = super().__new__(cls)
        return cls._instance

    def __init__(self):
        if not self._initialized:
            self.setting = "default"
            self._initialized = True

config1 = Config()
config2 = Config()

print(config1.setting)
print(config1 is config2)

default
True

このようにすることで、初期化処理が一度だけ実行され、安全にシングルトンを利用できます。

6. モジュールを使ったシンプルなシングルトン

6. モジュールを使ったシンプルなシングルトン

Pythonでは、モジュール自体が一度しか読み込まれないという特徴があります。この性質を利用すると、クラスを使わなくてもシングルトンのような動きを実現できます。

初心者にとっては、こちらの方が理解しやすい場合もあります。

# settings.py
value = 10

# main.py
import settings

print(settings.value)

同じモジュールを何度importしても、中身は共有されます。そのため、設定管理用途ではよく使われる方法です。

7. シングルトンを使うときの注意点

7. シングルトンを使うときの注意点

シングルトンは便利ですが、使いすぎるとプログラムの構造が分かりにくくなります。どこからでも同じインスタンスを触れるため、変更の影響範囲が広がりやすいからです。

また、テストが難しくなるという欠点もあります。状態が共有されるため、テスト同士が影響し合う可能性があります。

そのため、「本当に1つである必要があるか」を考えたうえで使うことが大切です。

8. 初心者が理解するための身近な例え

8. 初心者が理解するための身近な例え

シングルトンは「家の中のリモコン」に例えられます。テレビは1台なのに、リモコンが何個もあると混乱しますよね。チャンネルが合わなくなったり、音量が変わったりします。

リモコンを1つにして、家族全員がそれを使えば、常に同じ状態を操作できます。シングルトンも同じで、プログラム全体で1つの存在を共有する仕組みなのです。