Adapteraka Wrapper, Translator

Bạn mang laptop sang Nhật: ổ cắm ở đó là chân dẹt 100V, sạc của bạn là chân tròn. Bạn không đục lại tường khách sạn, cũng không thay dây sạc — chỉ cần một cục adapter ở giữa. Laptop vẫn là laptop, ổ điện vẫn là ổ điện, adapter lo phần 'phiên dịch'.You take your laptop to Japan: the sockets there are flat-pin 100V while your charger has round pins. You don't rewire the hotel wall or swap the cable — you just put an adapter in between. The laptop stays a laptop, the socket stays a socket; the adapter does the 'translating'.

Thành phần tham giaParticipants

Target

Interface mà code của bạn muốn dùng (ShippingCarrier).The interface your code wants to use (ShippingCarrier).

Adaptee

Class/SDK có sẵn, interface không khớp và không sửa được.An existing class/SDK with a mismatched interface you can't change.

Adapter

Implement Target, giữ Adaptee bên trong và phiên dịch qua lại.Implements Target, holds the Adaptee and translates back and forth.

Client

Chỉ làm việc với Target, không biết Adaptee tồn tại.Works only with Target, unaware the Adaptee exists.

Dùng Tự chạy hoặc phím mũi tên để đi qua từng bước gọi giữa các object. Console hiển thị output tương ứng của chương trình.Use Autoplay or the arrow keys to step through each call between objects. The console shows the matching program output.

Cùng một bài toán, hai ngôn ngữ. Rê chuột hoặc focus vào chú thích (số màu cam) để làm nổi bật dòng code tương ứng.Same problem, two languages. Hover or focus an annotation (orange number) to highlight its line.

package com.shop.shipping;

// Target: the interface OUR code wants to speak, in business terms
public interface ShippingCarrier {1
    String code();

    Quote quote(Parcel parcel);

    record Parcel(int weightGrams, String fromProvince, String toProvince, long codVnd) {}2

    record Quote(String carrier, long feeVnd, int etaDays) {}
}

package shipping

import (
	"context"
	"errors"
)

type Parcel struct {
	WeightGrams  int
	FromProvince string
	ToProvince   string
	CODVND       int64
}

type Quote struct {
	Carrier string
	FeeVND  int64
	ETADays int
}

// Carrier is the target interface our checkout code depends on.
type Carrier interface {1
	Quote(ctx context.Context, p Parcel) (Quote, error)
}

// CarrierFunc adapts a plain function to Carrier — same trick as http.HandlerFunc.
type CarrierFunc func(ctx context.Context, p Parcel) (Quote, error)2

func (f CarrierFunc) Quote(ctx context.Context, p Parcel) (Quote, error) { return f(ctx, p) }3

func Cheapest(ctx context.Context, p Parcel, carriers ...Carrier) (Quote, error) {
	var best Quote
	var errs []error
	for _, c := range carriers {
		q, err := c.Quote(ctx, p)
		if err != nil {
			errs = append(errs, err)
			continue
		}
		if best.Carrier == "" || q.FeeVND < best.FeeVND {
			best = q
		}
	}
	if best.Carrier == "" {
		return Quote{}, errors.Join(errs...)4
	}
	return best, nil
}

• JDK: Arrays.asList, InputStreamReaderJDK: Arrays.asList, InputStreamReader

  Arrays.asList(array) biến mảng thành List; InputStreamReader chuyển InputStream (byte) thành Reader (ký tự).Arrays.asList(array) turns an array into a List; InputStreamReader adapts an InputStream (bytes) into a Reader (chars).

• Spring MVC HandlerAdapterSpring MVC HandlerAdapter

  DispatcherServlet gọi mọi loại handler (@Controller method, HttpRequestHandler...) qua HandlerAdapter. Spring Security cũng có nhiều adapter cho các nguồn user khác nhau.DispatcherServlet calls every kind of handler (@Controller methods, HttpRequestHandler...) through a HandlerAdapter. Spring Security has many adapters for different user sources too.

• Go: http.HandlerFunc, io.NopCloserGo: http.HandlerFunc, io.NopCloser

  http.HandlerFunc(f) biến hàm thành http.Handler; io.NopCloser(r) biến io.Reader thành io.ReadCloser.http.HandlerFunc(f) turns a function into an http.Handler; io.NopCloser(r) turns an io.Reader into an io.ReadCloser.

• Tích hợp hãng vận chuyển, SMS, ngân hàngCarrier, SMS and bank integrations

  Mỗi hãng ship (GHN, GHTK, J&T), nhà mạng SMS (eSMS, SpeedSMS) hay core banking cũ dùng SOAP/XML đều được bọc bằng adapter.Each carrier (GHN, GHTK, J&T), SMS vendor (eSMS, SpeedSMS) or legacy SOAP/XML core banking system gets wrapped in an adapter.