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ố.
- 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()
- 1
.add_title()Thêm tiêu đề - 2
.add_chart()Thêm biểu đồ - 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.
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ỉnhMẫ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
self.partsgom các phần đã thêm cho tới lúc đó.add_titlevàadd_chart, mỗi phương thức thêm một phần rồireturn self, nên có thể gọi nối tiếp nhau.ReportBuilder().add_title().add_chart().build()đọc như một danh sách chỉ dẫn.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ụ
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)
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.
- Thay đổi domain của ví dụ nhưng vẫn giữ nguyên cấu trúc của design pattern.
- So sánh design pattern với một implementation đơn giản hơn và giải thích các trade-off.
- Viết test cho từng thành phần trước khi thêm một implementation khác.
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.
def add_title(self):
self.parts.append("title")
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