Design Pattern ใน Python

ดีไซน์แพตเทิร์น Builder ใน Python

ในบทเรียนนี้ คุณจะใช้แพตเทิร์น Builder สร้างออบเจกต์ที่ซับซ้อนผ่านหลายขั้นตอนที่ชัดเจน

  • ระดับสูง
  • อ่าน 2 นาที
  • ตัวอย่างที่รันได้ 1 ตัวอย่าง

บทนำ

ปัญหาที่ต้องแก้

บางอ็อบเจกต์มีส่วนประกอบที่จะใส่หรือไม่ใส่ก็ได้หลายอย่าง เช่น รายงานอาจมีหัวเรื่อง กราฟ ตาราง ส่วนท้าย หรือผสมกันแบบไหนก็ได้ constructor ที่มีอาร์กิวเมนต์ไม่บังคับถึงสิบตัวทั้งอ่านยากและเรียกผิดง่าย builder ช่วยให้เพิ่มส่วนประกอบได้ทีละขั้นอย่างชัดเจน

ลองนึกภาพแบบนี้

builder เหมือนการสั่งแซนด์วิชที่เคาน์เตอร์ เราบอกทีละอย่างว่าขนมปัง แล้วชีส แล้วมะเขือเทศ แซนด์วิชก็ค่อย ๆ ประกอบขึ้นตามแต่ละคำสั่ง พอบอกว่าเสร็จแล้ว ก็ได้แซนด์วิชที่พร้อมกิน

จากเคาน์เตอร์แซนด์วิชสู่โค้ด
ReportBuilder()🍞 เริ่มออเดอร์ว่าง
.add_title()🧀 เพิ่มวัตถุดิบหนึ่งอย่าง
.add_chart()🍅 เพิ่มอีกอย่าง ลำดับสำคัญ
.build()🥪 ส่งแซนด์วิชที่เสร็จแล้ว
เพิ่มส่วนประกอบที่ต้องการ แล้วสร้างผลลัพธ์
สรุปในประโยคเดียว

แพตเทิร์น Builder สร้างอ็อบเจกต์ที่ซับซ้อนทีละขั้นผ่านเมธอดแยกกัน แล้วส่งกลับอ็อบเจกต์ที่เสร็จแล้วจากการเรียก build ตอนท้าย

ประเด็นสำคัญ

  1. self.parts รวบรวมส่วนประกอบที่เพิ่มแล้ว
  2. add_title และ add_chart ต่างก็เพิ่มหนึ่งส่วนแล้ว return self จึงเรียกต่อกันเป็นสายได้
  3. ReportBuilder().add_title().add_chart().build() อ่านเหมือนรายการคำสั่ง
  4. build() เปลี่ยนส่วนประกอบที่รวบรวมไว้เป็นข้อความรายงานที่เสร็จแล้ว

ใช้เมื่อไร?

  • อ็อบเจกต์ที่มีส่วนประกอบไม่บังคับหลายอย่าง: รายงาน คำขอ HTTP คิวรี SQL เอกสาร
  • ทำให้การสร้างทีละขั้นอ่านง่ายด้วย method chaining (การเรียกเมธอดต่อกันเป็นสาย)
  • สร้างหลายรูปแบบด้วยขั้นตอนการสร้างเดียวกัน

เมื่อไรยังไม่จำเป็น

  • อ็อบเจกต์ที่มีฟิลด์บังคับสองสามตัว: constructor ปกติหรือ dataclass ง่ายกว่า
  • โค้ด Python ที่ใช้ keyword argument พร้อมค่าเริ่มต้นแล้วก็เรียกได้ชัดเจนอยู่แล้ว

โค้ดตัวอย่าง

รันโค้ด →
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)
สร้างปุ่ม Run สำหรับตัวอย่างนี้

ผลลัพธ์จากการรัน

Report: title, chart

อธิบายโค้ด

แต่ละเมธอด เช่น add_title() เพิ่มส่วนหนึ่งให้รายงานแล้วคืนตัว builder เอง (return self) จึงเรียกต่อกันในบรรทัดเดียวได้ สุดท้ายเมธอด build() รวมส่วนต่าง ๆ และคืนรายงานที่สมบูรณ์ Report: title, chart

เปลี่ยนค่าและรันโปรแกรมด้วย คอมไพเลอร์ Python ออนไลน์ของ CodeUtility โดยไม่ต้องติดตั้ง Python

แบบฝึกหัดเพิ่มเติม

ลองแก้โค้ดตามคำแนะนำด้านล่าง การเปลี่ยนโค้ดแล้วดูผลลัพธ์จะช่วยให้เข้าใจบทเรียนได้ดีกว่าการอ่านอย่างเดียวมาก

  1. เปลี่ยนโดเมนของตัวอย่างโดยยังคงโครงสร้างของแพตเทิร์นไว้
  2. เปรียบเทียบแพตเทิร์นกับการเขียนแบบที่ง่ายกว่าและอธิบายข้อแลกเปลี่ยน
  3. เขียนการทดสอบให้ผู้มีส่วนร่วมแต่ละส่วนก่อนเพิ่มการเขียนแบบอื่น
รันในคอมไพเลอร์ Python →

ข้อผิดพลาดที่พบบ่อย

ลืม return self

ถ้าไม่มี return self การต่อเมธอดจะเกิดข้อผิดพลาดเพราะเมธอดส่งกลับ None

ปัญหา
def add_title(self):
    self.parts.append("title")
วิธีแก้
def add_title(self):
    self.parts.append("title")
    return self

เรียนบทนี้จบแล้วใช่ไหม

ทำเครื่องหมายว่าเรียนแล้วเพื่อติดตามความคืบหน้า

ถัดไป: ดีไซน์แพตเทิร์น Adapter ใน Python →

ฝึกด้วยโจทย์

ใช้สิ่งที่เรียนในบทนี้แก้ปัญหาจริง ทุกโจทย์รันในเบราว์เซอร์ พร้อมการทดสอบทันทีและรีวิวจาก AI

โจทย์ทั้งหมด