Design Patterns trong Python

Mẫu thiết kế Adapter trong Python

Giúp một class cũ hoặc của bên thứ ba khớp với giao diện mà code của bạn cần, không phải sửa class đó.

  • Nâng cao
  • Đọc trong 3 phút
  • 1 ví dụ chạy được
Bạn sẽ học được gì
  • Giao diện không tương thích
  • Bọc đối tượng cũ
  • Chuyển đổi lời gọi và dữ liệu
pay(25)
  1. 1client.pay(25)Giao diện nơi dùng biết
  2. 2PaymentAdapterChuyển đổi lời gọi
  3. 3legacy.make_payment(...)Giao diện cũ
  4. 4PAY 25.00Kết quả

Người phiên dịch giữa hai giao diện

Vấn đề

Bạn thường phải dùng code mình không sửa được, như một hệ thống thanh toán cũ hay thư viện của bên thứ ba. Các phương thức của code đó lại không khớp với cách phần còn lại của chương trình muốn gọi. Sửa lại mọi nơi gọi thì nhiều rủi ro. Adapter đứng giữa để chuyển đổi.

Hình dung đời thường

Adapter giống cục chuyển đổi phích cắm khi đi du lịch. Phích cắm laptop vừa ổ điện ở nhà, còn ổ điện khách sạn lại có hình dạng khác. Cục chuyển đổi đứng giữa, nên cả laptop lẫn ổ điện đều không phải thay đổi.

Từ cục chuyển đổi phích cắm đến code
gateway.pay(25)🔌 Phích cắm của bạn: trả tiền theo đô la
PaymentAdapter🔁 Cục chuyển đổi ở giữa
round(dollars * 100)💱 Đổi đô la sang xu (cent)
make_payment(cents)🧱 Ổ điện cũ: cần đơn vị xu
Adapter chuyển đổi lời gọi; không bên nào phải thay đổi.
Định nghĩa ngắn gọn

Mẫu Adapter bọc một đối tượng (object) có giao diện (interface) không tương thích vào trong một class mới. Class này có đúng giao diện mà nơi dùng cần và chuyển đổi từng lời gọi.

Những điểm quan trọng

  1. LegacyGateway chỉ có make_payment(cents).
  2. PaymentAdapter có pay(dollars), phương thức mà phần còn lại của chương trình muốn gọi.
  3. round(dollars * 100) đổi đô la sang xu trước khi gọi make_payment.
  4. gateway.pay(25) chạy được mà không hề sửa LegacyGateway.

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

  • Dùng code cũ hoặc code của bên thứ ba thông qua giao diện mà chương trình đang cần.
  • Chuyển giữa các nhà cung cấp, như dịch vụ thanh toán hay email, mà không sửa nơi gọi.
  • Chuyển đổi đơn vị hoặc định dạng dữ liệu ở ranh giới hệ thống.

Khi nào chưa cần

  • Cả hai phía đều là code của bạn: chỉ cần đổi tên hoặc sửa một bên là xong.
  • Hai giao diện khác nhau tới mức adapter chứa gần hết logic: hãy thiết kế lại ranh giới.

Code ví dụ

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

Kết quả khi chạy

PAY 25.00

Giải thích code

Class LegacyGateway chỉ có phương thức make_payment() nhận số tiền tính bằng xu, trong khi phần code mới muốn gọi pay(). Class PaymentAdapter bọc bên ngoài LegacyGateway và chuyển lời gọi pay() thành make_payment() với đơn vị phù hợp, nên kết quả là PAY 25.00.

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 chuyển đổi giá trị

Chỉ đổi tên phương thức thì vẫn gửi đô la vào chỗ cần xu.

Sai
def pay(self, dollars):
    return self.gateway.make_payment(dollars)
Cách sửa
def pay(self, dollars):
    return self.gateway.make_payment(round(dollars * 100))

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