Design Patterns trong Python

Mẫu thiết kế Builder trong Python

Lắp ráp một đối tượng phức tạp từng bước bằng các lời gọi dễ đọc, thay vì một hàm khởi tạo mười tham số.

  • Nâng cao
  • Đọc trong 3 phút
  • 1 ví dụ chạy được
Bạn sẽ học được gì
  • Xây dựng từng bước
  • Gọi nối tiếp các phương thức của builder
  • Tạo đối tượng cuối cùng bằng build()
ReportBuilder()
  1. 1.add_title()Thêm tiêu đề
  2. 2.add_chart()Thêm biểu đồ
  3. 3.build()Report: title, chart

Thêm những phần cần thiết rồi build

Vấn đề

Một số đối tượng (object) có rất nhiều phần tùy chọn: một báo cáo có thể có tiêu đề, biểu đồ, bảng, chân trang, hoặc kết hợp tùy ý các phần đó. Một constructor (hàm khởi tạo) có mười đối số tùy chọn thì rất khó đọc và dễ gọi sai. Builder cho bạn thêm từng phần qua từng bước rõ ràng.

Hình dung đời thường

Builder giống gọi bánh mì ở quầy. Bạn gọi lần lượt: bánh mì, rồi phô mai, rồi cà chua, và chiếc bánh đầy dần theo từng yêu cầu. Khi bạn bảo đã đủ, người bán trao cho bạn chiếc bánh hoàn chỉnh.

Từ quầy bánh mì đến code
ReportBuilder()🍞 Bắt đầu một đơn trống
.add_title()🧀 Thêm một nguyên liệu
.add_chart()🍅 Thêm nguyên liệu khác; thứ tự có ý nghĩa
.build()🥪 Trao chiếc bánh hoàn chỉnh
Thêm những phần bạn cần, rồi tạo ra kết quả.
Định nghĩa ngắn gọn

Mẫu Builder dựng một object phức tạp từng bước qua các phương thức riêng, rồi trả về object hoàn chỉnh qua lời gọi build cuối cùng.

Những điểm quan trọng

  1. self.parts gom các phần đã thêm cho tới lúc đó.
  2. add_title và add_chart, mỗi phương thức thêm một phần rồi return self, nên có thể gọi nối tiếp nhau.
  3. ReportBuilder().add_title().add_chart().build() đọc như một danh sách chỉ dẫn.
  4. build() biến các phần đã gom thành nội dung báo cáo hoàn chỉnh.

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

  • Object có nhiều phần tùy chọn: báo cáo, yêu cầu HTTP, câu truy vấn SQL, tài liệu.
  • Viết các bước dựng cho dễ đọc nhờ gọi nối tiếp (method chaining).
  • Tạo nhiều biến thể với cùng các bước dựng.

Khi nào chưa cần

  • Object chỉ có hai, ba trường bắt buộc: constructor thường hoặc dataclass đơn giản hơn.
  • Code Python chỉ cần đối số có tên (keyword argument) kèm giá trị mặc định là lời gọi đã đủ rõ.

Code ví dụ

Chạy code →
main.py
class ReportBuilder:
    # Builder: assemble a complex value one optional part at a time.
    def __init__(self):
        self.parts = []

    def add_title(self):
        self.parts.append("title")
        return self

    def add_chart(self):
        self.parts.append("chart")
        return self

    def build(self):
        # Hide the final assembly behind one operation.
        return "Report: " + ", ".join(self.parts)


report = ReportBuilder().add_title().add_chart().build()
print(report)
Lấy nút Run cho ví dụ này

Kết quả khi chạy

Report: title, chart

Giải thích code

Mỗi phương thức như add_title() thêm một thành phần vào báo cáo rồi trả về chính đối tượng builder (return self). Nhờ vậy, các lời gọi có thể được nối liên tiếp trên cùng một dòng. Cuối cùng, phương thức build() ghép các thành phần lại và trả về báo cáo hoàn chỉnh là Report: title, chart.

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

Quên return self

Thiếu return self thì gọi nối tiếp bị lỗi, vì phương thức trả về None.

Sai
def add_title(self):
    self.parts.append("title")
Cách sửa
def add_title(self):
    self.parts.append("title")
    return self

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