Microservice Patterns
Anti-Corruption Layer
Đặt một lớp façade biên dịch giữa hệ thống mới và hệ thống cũ, để mô hình, giao thức và các tật của hệ thống cũ nằm yên ở phía bên kia — và tiện thể cache, gộp lời gọi và bảo vệ hệ thống cũ.
Sau bài này bạn sẽ
- Giải thích mô hình cũ rò rỉ vào code mới ra sao khi không có ranh giới.
- Thiết kế anti-corruption layer biên dịch cả mô hình lẫn giao thức.
- Giảm tải lên hệ thống cũ bằng cache và lời gọi thô.
- Dùng lớp này làm đường nối cho việc chuyển đổi dần dần.
Nên đọc trước
Tổng quan
Khi làm việc với đối tác nước ngoài, công ty thuê một phiên dịch thay vì bắt mọi nhân viên học ngôn ngữ và phong tục của đối tác. Nhân viên cứ nói bình thường; phiên dịch lo phần chuyển ngữ — và còn nhớ ra câu hỏi đó hôm qua đã được trả lời rồi.
Service mới thường phải nói chuyện với hệ thống cũ — ERP, mainframe, API bên thứ ba — có mô hình không khớp với mình (tên gọi, mã, độ chi tiết, giao thức kiểu SOAP hay file khác hẳn). Anti-corruption layer (ACL) là một lớp façade lộ ra mô hình riêng của hệ thống mới và biên dịch qua lại với mô hình cũ. Không thứ gì bên ngoài ACL phụ thuộc vào kiểu dữ liệu của hệ thống cũ.
Chạy thử
Ở A, service Orders mới gọi thẳng bốn lời gọi chi tiết vào ERP cho mỗi đơn. Ở B, một lời gọi gọn gàng đi tới ACL, ACL cache dữ liệu tham chiếu và chỉ gọi ERP một lần. So sánh ô Lượt gọi ERP phải phục vụ và độ trễ, rồi thử làm ERP chậm đi.
Lớp này làm gì
- Biên dịch mô hình:
CUST_NOvàORD_HDRthànhCustomervàOrder; các mã thành enum. - Biên dịch giao thức: REST/event ở phía mới, SOAP, file hay đọc màn hình ở phía cũ.
- Định hình lời gọi: một thao tác thô thay vì nhiều thao tác lắm lời; gộp khi có thể.
- Bảo vệ hệ thống cũ: cache dữ liệu tham chiếu, giới hạn số lời gọi đồng thời, áp timeout và circuit breaker.
- Khoanh vùng các tật: retry cho thao tác hay chập chờn đã biết, ánh xạ mã lỗi, làm sạch dữ liệu.
Phác thảo triển khai
public interface OrderPlacement { // cổng của domain mới
PlacedOrder place(NewOrder order);
}
@Component
class ErpOrderPlacement implements OrderPlacement { // anti-corruption layer
private final ErpSoapClient erp;
private final Cache<String, ErpCustomer> customers; // dữ liệu tham chiếu hiếm khi đổi
public PlacedOrder place(NewOrder order) {
ErpCustomer customer = customers.get(order.customerId(), erp::findCustomer);
OrdHdr header = OrdHdr.of(customer.custNo(), order.lines().stream().map(this::toErpLine).toList());
ErpResult result = erp.createOrder(header); // một lời gọi thô vào hệ thống cũ
if (result.rc() != 0) throw translate(result); // mã lỗi cũ → exception của domain
return new PlacedOrder(result.ordNo().trim(), OrderStatus.from(result.stat()));
}
}Đánh đổi
| Được | Mất | |
|---|---|---|
| Toàn vẹn mô hình | Code mới sạch sẽ và nói bằng ngôn ngữ của chính nó. | Phải viết, test và giữ code biên dịch đồng bộ với cả hai phía. |
| Tải | Cache và lời gọi thô bảo vệ hệ thống cũ mong manh. | Dữ liệu cache có thể cũ; cần suy nghĩ chuyện invalidate. |
| Vận hành | Một nơi duy nhất để giám sát và tinh chỉnh tích hợp với hệ thống cũ. | Thêm một chặng và có thể thêm một service để chạy và scale. |
Lưu ý khi chạy production
- Để team sở hữu mô hình mới sở hữu ACL, không phải team của hệ thống cũ.
- Contract test cả hai phía: interface mới và hành vi của hệ thống cũ mà nó phụ thuộc.
- Áp timeout, giới hạn đồng thời và circuit breaker cho chiều gọi vào hệ thống cũ.
- Ghi log request và response thô của hệ thống cũ (đã che dữ liệu nhạy cảm) — cực kỳ quý khi hệ thống cũ cư xử khó hiểu.