Design Patterns trong Python

Mẫu thiết kế Singleton trong Python

Đảm bảo một class chỉ có đúng một đối tượng dùng chung, như một đối tượng cấu hình hay một nhóm kết nối.

  • Nâng cao
  • Đọc trong 2 phút
  • 1 ví dụ chạy được
Bạn sẽ học được gì
  • Vấn đề mà Singleton giải quyết
  • Cài đặt bằng __new__
  • Cách đơn giản hơn trong Python: dùng module
Gọi AppConfig() hai lần
  1. 1a = AppConfig()Lần đầu tạo đối tượng
  2. 2b = AppConfig()Lần hai trả lại đối tượng đã lưu
  3. 3a is b → TrueCùng một đối tượng

Lần gọi nào cũng trả về cùng một đối tượng

Vấn đề

Có những thứ chỉ nên tồn tại đúng một bản trong chương trình: cài đặt của ứng dụng, một nhóm kết nối (connection pool), một logger ghi vào một file. Nếu mỗi phần code tự tạo bản riêng, các cài đặt sẽ lệch nhau và tài nguyên bị lãng phí.

Hình dung đời thường

Singleton giống cái chuông duy nhất của một ngôi trường. Lớp nào cũng rung cùng cái chuông đó; không ai lắp chuông riêng. Ở đâu hỏi "cái chuông" thì cũng nhận được đúng cái chuông ấy.

Từ cái chuông trường đến code
_instance = None🔔 Chưa lắp chuông
if cls._instance is None:🔧 Lắp chuông ở lần đầu có người hỏi
return cls._instance🔁 Từ đó ai cũng nhận cùng một cái chuông
first is second✅ Hai lần hỏi, một object: True
Lần gọi nào cũng trả về cùng một object.
Định nghĩa ngắn gọn

Mẫu Singleton làm cho một class lần nào được tạo cũng trả về cùng một instance duy nhất, cho chương trình một object dùng chung.

Những điểm quan trọng

  1. _instance là thuộc tính của class, lưu object dùng chung duy nhất.
  2. __new__ là phương thức Python gọi để tạo object; nó chỉ tạo object khi _instance vẫn là None.
  3. cls._instance.theme = "dark" thiết lập object dùng chung đúng một lần.
  4. first is second là True: cả hai tên cùng trỏ tới một object.

Khi nào nên sử dụng?

  • Cấu hình chung cho cả ứng dụng mà module nào cũng đọc.
  • Một tài nguyên dùng chung như cache, logger hay connection pool.
  • Học cách __new__ điều khiển việc tạo object.

Khi nào chưa cần

  • Phần lớn code Python: một object ở cấp module (module chỉ được tạo một lần) đơn giản hơn mà làm đúng việc đó.
  • Code bạn muốn kiểm thử dễ dàng: trạng thái toàn cục bị giấu làm các bài kiểm thử phụ thuộc lẫn nhau; hãy truyền object vào.

Code ví dụ

Chạy code →
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)
Lấy nút Run cho ví dụ này

Kết quả khi chạy

True

Giải thích code

Phương thức __new__ được gọi trước __init__ mỗi khi tạo đối tượng mới. Ở lần gọi đầu tiên, _instance còn là None nên đối tượng được tạo và lưu lại. Những lần gọi sau, __new__ chỉ trả về đúng đối tượng đã lưu, vì vậy phép so sánh hai đối tượng bằng is cho kết quả True.

Thay đổi giá trị và chạy chương trình bằng trình chạy Python online của CodeUtility mà không cần cài Python.

Bài tập mở rộng

Hãy thử chỉnh sửa code theo các gợi ý dưới đây. Tự thay đổi và quan sát kết quả sẽ giúp bạn hiểu bài sâu hơn nhiều so với chỉ đọc code.

  1. Thay đổi domain của ví dụ nhưng vẫn giữ nguyên cấu trúc của design pattern.
  2. So sánh design pattern với một implementation đơn giản hơn và giải thích các trade-off.
  3. Viết test cho từng thành phần trước khi thêm một implementation khác.
Chạy trong trình biên dịch Python →

Lỗi hay gặp

Thiết lập trạng thái trong __init__

__init__ chạy ở mỗi lần gọi, nên nó đặt lại object dùng chung mỗi lần.

Sai
def __init__(self):
    self.theme = "dark"  # runs again for every AppConfig()
Cách sửa
if cls._instance is None:
    cls._instance = super().__new__(cls)
    cls._instance.theme = "dark"

Bạn học xong bài này chưa?

Đánh dấu đã học để theo dõi tiến độ của bạn.

Luyện tập với thử thách

Áp dụng kiến thức của bài học này để giải một bài toán thực tế. Mỗi thử thách chạy ngay trên trình duyệt, có kiểm thử tức thì và AI nhận xét.

Tất cả thử thách