Design Pattern ใน Python

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

ในบทเรียนนี้ คุณจะใช้แพตเทิร์น Adapter เชื่อมคลาสเก่าที่มีอินเทอร์เฟซต่างไปเข้ากับโค้ดที่ต้องการอินเทอร์เฟซใหม่

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

บทนำ

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

คุณมักต้องใช้โค้ดที่แก้ไม่ได้ เช่น ระบบชำระเงินเก่าหรือไลบรารีของบุคคลที่สาม ซึ่งเมธอดไม่ตรงกับที่ส่วนอื่นของโปรแกรมคาดหวัง การเขียนผู้เรียกทุกตัวใหม่เสี่ยง adapter แปลระหว่างสองฝั่ง

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

adapter เหมือนหัวแปลงปลั๊กสำหรับเดินทาง ปลั๊กแล็ปท็อปของคุณเข้ากับเต้ารับที่บ้าน แต่เต้ารับในโรงแรมรูปทรงต่างไป หัวแปลงอยู่ตรงกลาง ทั้งแล็ปท็อปและผนังจึงไม่ต้องเปลี่ยน

จากหัวแปลงปลั๊กสู่โค้ด
gateway.pay(25)🔌 ปลั๊กของคุณ: จ่ายเป็นดอลลาร์
PaymentAdapter🔁 หัวแปลงที่อยู่ตรงกลาง
round(dollars * 100)💱 แปลงดอลลาร์เป็นเซนต์
make_payment(cents)🧱 เต้ารับเก่า: ต้องการเซนต์
adapter แปลการเรียก โดยไม่มีฝั่งไหนต้องเปลี่ยน
สรุปในประโยคเดียว

แพตเทิร์น Adapter ห่ออ็อบเจกต์ที่ interface ไม่เข้ากันไว้ในคลาสที่มี interface ตามที่ฝั่งผู้ใช้คาดหวัง และแปลแต่ละการเรียก

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

  1. LegacyGateway มีแค่ make_payment(cents)
  2. PaymentAdapter มี pay(dollars) ซึ่งเป็นเมธอดที่ส่วนอื่นของโปรแกรมต้องการเรียก
  3. round(dollars * 100) แปลงดอลลาร์เป็นเซนต์ก่อนเรียก make_payment
  4. gateway.pay(25) ทำงานได้โดยไม่ต้องเปลี่ยน LegacyGateway เลย

ใช้เมื่อไร?

  • ใช้โค้ดเก่าหรือของบุคคลที่สามผ่าน interface ที่โปรแกรมของคุณคาดหวัง
  • สลับผู้ให้บริการ เช่น บริการชำระเงินหรืออีเมล โดยไม่ต้องเปลี่ยนผู้เรียก
  • แปลงหน่วยหรือรูปแบบข้อมูลที่ขอบเขตระบบ

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

  • คุณเป็นเจ้าของทั้งสองฝั่งและแค่เปลี่ยนชื่อหรือแก้ฝั่งใดฝั่งหนึ่งได้
  • interface ต่างกันมากจน adapter จะมีตรรกะส่วนใหญ่: ออกแบบขอบเขตใหม่แทน

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

รันโค้ด →
main.py
class LegacyGateway:
    # Adapter: wrap an incompatible API with the expected interface.
    def make_payment(self, cents):
        return f"PAY {cents / 100:.2f}"


class PaymentAdapter:
    def __init__(self, gateway):
        self.gateway = gateway

    def pay(self, dollars):
        # Translate both the method name and amount format.
        return self.gateway.make_payment(round(dollars * 100))


gateway = PaymentAdapter(LegacyGateway())
print(gateway.pay(25))
สร้างปุ่ม Run สำหรับตัวอย่างนี้

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

PAY 25.00

อธิบายโค้ด

คลาส LegacyGateway มีแค่เมธอด make_payment() ที่รับจำนวนเงินเป็นเซนต์ แต่โค้ดใหม่ต้องการเรียก pay() คลาส PaymentAdapter ห่อ LegacyGateway และแปลงการเรียก pay() เป็น make_payment() ด้วยหน่วยที่ถูกต้อง จึงได้ผล PAY 25.00

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

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

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

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

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

ลืมแปลงค่า

การเปลี่ยนชื่อเมธอดอย่างเดียวจะส่งดอลลาร์ไปในที่ที่ต้องการเซนต์

ปัญหา
def pay(self, dollars):
    return self.gateway.make_payment(dollars)
วิธีแก้
def pay(self, dollars):
    return self.gateway.make_payment(round(dollars * 100))

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

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

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

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

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

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