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 đó.
- 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
- 1
client.pay(25)Giao diện nơi dùng biết - 2
PaymentAdapterChuyển đổi lời gọi - 3
legacy.make_payment(...)Giao diện cũ - 4
PAY 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.
gateway.pay(25)🔌 Phích cắm của bạn: trả tiền theo đô laPaymentAdapter🔁 Cục chuyển đổi ở giữaround(dollars * 100)💱 Đổi đô la sang xu (cent)make_payment(cents)🧱 Ổ điện cũ: cần đơn vị xuMẫ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
LegacyGatewaychỉ cómake_payment(cents).PaymentAdaptercópay(dollars), phương thức mà phần còn lại của chương trình muốn gọi.round(dollars * 100)đổi đô la sang xu trước khi gọimake_payment.gateway.pay(25)chạy được mà không hề sửaLegacyGateway.
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ụ
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))
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.
- 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 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.
def pay(self, dollars):
return self.gateway.make_payment(dollars)
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