Adapter — nó là gì, mẫu chuyển đổi giao diện cho phát triển di động

Mẫu Adapter là gì?

Adapter là một mẫu cấu trúc giải quyết vấn đề không tương thích giao diện. Nó bọc một đối tượng (Adaptee) vào một lớp (Adapter) với giao diện mà client mong đợi (Target). Client làm việc với Target mà không biết về sự tồn tại của Adaptee. Đây là một biến thể của mẫu Wrapper.

// Lớp hiện có với giao diện không tương thích
class LegacyAuthApi {
    fun loginWithToken(token: String): Map {
        return mapOf("status" to "ok", "user_id" to 42)
    }
}

// Giao diện mục tiêu (client mong đợi)
interface AuthService {
    suspend fun login(credentials: Credentials): Result
}

// Adapter — chuyển đổi LegacyAuthApi thành AuthService
class LegacyAuthAdapter(
    private val legacyApi: LegacyAuthApi
) : AuthService {
    override suspend fun login(credentials: Credentials): Result {
        val token = "${credentials.login}:${credentials.password}"
            .encodeToByteArray().let { Base64.encodeToString(it) }
        val response = legacyApi.loginWithToken(token)
        return if (response["status"] == "ok") {
            Result.success(User(response["user_id"] as Int))
        } else {
            Result.failure(AuthException("Login failed"))
        }
    }
}

LegacyAuthAdapter chuyển đổi lời gọi login(credentials) thành loginWithToken(token) cho API cũ. Client (ViewModel) làm việc thông qua giao diện AuthService và không biết bên dưới là Firebase Auth mới nhất hay API cũ hàng thập kỷ. Điều này cho phép thay thế các triển khai mà không cần thay đổi mã client.

Adapter trong Android: RecyclerView và ListAdapter

RecyclerView.Adapter là triển khai phổ biến nhất của mẫu Adapter trong Android. Nó chuyển đổi dữ liệu (một danh sách đối tượng) thành ViewHolder mà RecyclerView hiển thị trên màn hình. Với sự ra đời của ListAdapter (Android Architecture Components), mẫu này đã có được hỗ trợ tính toán khác biệt tích hợp để tạo hiệu ứng cho các thay đổi.

class UserAdapter(
    private val onItemClick: (User) -> Unit
) : ListAdapter(DiffCallback()) {

    override fun onCreateViewHolder(
        parent: ViewGroup,
        viewType: Int
    ): UserViewHolder {
        val view = LayoutInflater.from(parent.context)
            .inflate(R.layout.item_user, parent, false)
        return UserViewHolder(view)
    }

    override fun onBindViewHolder(
        holder: UserViewHolder,
        position: Int
    ) {
        holder.bind(getItem(position), onItemClick)
    }

    class UserViewHolder(itemView: View) :
        RecyclerView.ViewHolder(itemView) {
        
        private val tvName = itemView.findViewById(R.id.tvName)
        
        fun bind(user: User, click: (User) -> Unit) {
            tvName.text = user.name
            itemView.setOnClickListener { click(user) }
        }
    }

    private class DiffCallback : DiffUtil.ItemCallback() {
        override fun areItemsTheSame(old: User, new: User) = old.id == new.id
        override fun areContentsTheSame(old: User, new: User) = old == new
    }
}

UserAdapter sử dụng ListAdapter với DiffUtil để vẽ lại danh sách hiệu quả. Khi dữ liệu được cập nhật, DiffCallback tính toán sự khác biệt giữa danh sách cũ và mới, và RecyclerView chỉ tạo hiệu ứng cho các mục đã thay đổi — mà không vẽ lại toàn bộ danh sách. Đây là một lợi thế chính so với ListView cũ, vốn yêu cầu notifyDataSetChanged() thủ công.

Adapter trong iOS: UITableView và DiffableDataSource

UITableViewDataSource đồng thời là mẫu Adapter và mẫu DataSource. Nó chuyển đổi dữ liệu mô hình thành các ô của bảng. Từ iOS 13, Apple đã giới thiệu DiffableDataSource — một sự thay thế hiện đại, giống như ListAdapter trong Android, tự động tính toán các thay đổi và tạo hiệu ứng cho các bản cập nhật.

class UserTableViewAdapter: NSObject, UITableViewDataSource {
    var items: [User] = []
    
    func tableView(_ tableView: UITableView,
                    numberOfRowsInSection section: Int) -> Int {
        items.count
    }
    
    func tableView(_ tableView: UITableView,
                    cellForRowAt indexPath: IndexPath) -> UITableViewCell {
        let cell = tableView.dequeueReusableCell(
            withIdentifier: "UserCell", for: indexPath)
        let user = items[indexPath.row]
        cell.textLabel?.text = user.name
        return cell
    }
}

// Phiên bản hiện đại: DiffableDataSource
enum Section { case main }

class ModernUserAdapter {
    var dataSource: UITableViewDiffableDataSource<Section, User>!
    
    func configure(for tableView: UITableView) {
        dataSource = UITableViewDiffableDataSource(
            tableView: tableView
        ) { tableView, indexPath, user in
            let cell = tableView.dequeueReusableCell(
                withIdentifier: "UserCell", for: indexPath)
            cell.textLabel?.text = user.name
            return cell
        }
    }
    
    func update(with users: [User]) {
        var snapshot = NSDiffableDataSourceSnapshot<Section, User>()
        snapshot.appendSections([.main])
        snapshot.appendItems(users)
        dataSource.apply(snapshot, animatingDifferences: true)
    }
}

ModernUserAdapter với DiffableDataSource tự động tạo hiệu ứng cho các thay đổi khi dữ liệu được cập nhật: các mục xuất hiện, biến mất hoặc di chuyển với hiệu ứng mượt mà. DiffableDataSource của iOS và ListAdapter của Android giải quyết cùng một vấn đề với các API khác nhau nhưng cùng một logic — tính toán khác biệt + hiệu ứng tự động.

Object Adapter vs Class Adapter

Object Adapter sử dụng thành phần: adapter chứa tham chiếu đến đối tượng Adaptee và ủy quyền các lời gọi cho nó. Class Adapter sử dụng kế thừa: adapter kế thừa Adaptee và đồng thời triển khai giao diện mục tiêu. Trong Java, Swift và Kotlin, Class Adapter không khả thi do thiếu đa kế thừa — chỉ còn Object Adapter.

Trong phát triển di động, chỉ Object Adapter được sử dụng. RecyclerView.Adapter chứa tham chiếu đến dữ liệu và LayoutInflater, UITableViewDataSource chứa một mảng các mục. Thành phần làm cho mã linh hoạt và dễ kiểm tra hơn so với kế thừa.

Ví dụ Adapter trong các dự án thực tế

Adapter không chỉ được sử dụng cho danh sách. Hãy xem xét ba kịch bản từ thực tiễn phát triển di động nơi mẫu giải quyết vấn đề tích hợp các thành phần không tương thích.

Mỗi Adapter đóng gói logic chuyển đổi: GsonAdapter dịch chuỗi JSON thành đối tượng qua @SerializedName, PushServiceAdapter trừu tượng hóa việc đăng ký token cho các nền tảng khác nhau. Client (logic nghiệp vụ) làm việc với một giao diện thống nhất và không phụ thuộc vào triển khai cụ thể.

Lỗi thường gặp khi triển khai Adapter

Lỗi trong triển khai Adapter dẫn đến danh sách chậm, rò rỉ bộ nhớ và lỗi cập nhật dữ liệu. Hãy xem xét ba vấn đề phổ biến.

Thao tác nặng trong onBindViewHolder

onBindViewHolder được gọi cho mỗi ô trong khi cuộn. Tạo đối tượng, phân tích JSON hoặc gọi cơ sở dữ liệu trong phương thức này dẫn đến giảm khung hình (frame drops). Giải pháp: thực hiện tất cả các tính toán nặng trước, truyền dữ liệu đã sẵn sàng vào adapter. Sử dụng thư viện bộ nhớ đệm cho hình ảnh — Glide, Coil, Kingfisher.

Bỏ qua DiffUtil / DiffableDataSource

Gọi notifyDataSetChanged() mỗi khi cập nhật sẽ vẽ lại toàn bộ danh sách, gây nhấp nháy và mất tiêu điểm trên các đầu vào. Giải pháp: sử dụng ListAdapter với DiffUtil trong Android hoặc DiffableDataSource trong iOS. Tính toán khác biệt mất <1 ms cho danh sách lên đến 1000 mục và đảm bảo hiệu ứng mượt mà.

Lưu trữ đối tượng nặng trong adapter

Adapter tồn tại lâu bằng RecyclerView/UITableView. Lưu trữ Bitmap hoặc mảng lớn trong adapter dẫn đến rò rỉ bộ nhớ khi thay đổi cấu hình (xoay màn hình, thay đổi chủ đề). Giải pháp: adapter chỉ nên lưu trữ các mô hình dữ liệu nhẹ (data class / struct) và tải tài nguyên nặng qua ViewHolder khi cần.