Adapter — apa itu, pola transformasi antarmuka untuk pengembangan mobile

Apa itu pola Adapter?

Adapter — pola struktural yang memecahkan masalah ketidakcocokan antarmuka. Ia membungkus satu objek (Adaptee) ke dalam kelas (Adapter) dengan antarmuka yang diharapkan klien (Target). Klien bekerja dengan Target, tanpa mengetahui keberadaan Adaptee. Ini adalah varian dari pola Wrapper.

// Kelas yang ada dengan antarmuka yang tidak kompatibel
class LegacyAuthApi {
    fun loginWithToken(token: String): Map {
        return mapOf("status" to "ok", "user_id" to 42)
    }
}

// Antarmuka target (yang diharapkan klien)
interface AuthService {
    suspend fun login(credentials: Credentials): Result
}

// Adapter — mengubah LegacyAuthApi menjadi 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 mengubah panggilan login(credentials) menjadi loginWithToken(token) untuk API lama. Klien (ViewModel) bekerja melalui antarmuka AuthService dan tidak tahu apakah di bawahnya ada Firebase Auth terbaru atau API lama berusia sepuluh tahun. Ini memungkinkan penggantian implementasi tanpa mengubah kode klien.

Adapter di Android: RecyclerView dan ListAdapter

RecyclerView.Adapter — implementasi paling umum dari pola Adapter di Android. Ia mengubah data (daftar objek) menjadi ViewHolder yang ditampilkan RecyclerView di layar. Dengan munculnya ListAdapter (Android Architecture Components), pola tersebut mendapat dukungan bawaan untuk perhitungan diff untuk animasi perubahan.

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 menggunakan ListAdapter dengan DiffUtil untuk menggambar ulang daftar secara efisien. Saat data diperbarui, DiffCallback menghitung perbedaan antara daftar lama dan baru, dan RecyclerView hanya menganimasikan elemen yang berubah — tanpa menggambar ulang seluruh daftar. Ini adalah keunggulan utama dibandingkan ListView lama yang memerlukan notifyDataSetChanged() manual.

Adapter di iOS: UITableView dan DiffableDataSource

UITableViewDataSource — adalah pola Adapter dan DataSource sekaligus. Ia mengubah data model menjadi sel tabel. Sejak iOS 13, Apple memperkenalkan DiffableDataSource — pengganti modern yang, seperti ListAdapter di Android, secara otomatis menghitung perubahan dan menganimasikan pembaruan.

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
    }
}

// Versi modern: 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 dengan DiffableDataSource secara otomatis menganimasikan perubahan saat data diperbarui: elemen muncul, menghilang, atau berpindah dengan animasi yang halus. DiffableDataSource iOS dan ListAdapter Android menyelesaikan tugas yang sama dengan API berbeda, tetapi dengan logika yang sama — perhitungan diff + animasi otomatis.

Object Adapter vs Class Adapter

Object Adapter menggunakan komposisi: adapter berisi referensi ke objek Adaptee dan mendelegasikan panggilan kepadanya. Class Adapter menggunakan pewarisan: adapter mewarisi Adaptee dan secara bersamaan mengimplementasikan antarmuka target. Di Java, Swift, dan Kotlin, Class Adapter tidak mungkin karena tidak adanya pewarisan berganda — hanya Object Adapter yang tersisa.

Dalam pengembangan mobile, hanya Object Adapter yang digunakan. RecyclerView.Adapter berisi referensi ke data dan LayoutInflater, UITableViewDataSource berisi array elemen. Komposisi membuat kode lebih fleksibel dan mudah diuji dibandingkan dengan pewarisan.

Contoh Adapter di proyek nyata

Adapter tidak hanya diterapkan untuk daftar. Mari kita lihat tiga skenario dari praktik pengembangan mobile di mana pola tersebut memecahkan masalah integrasi komponen yang tidak kompatibel.

Setiap Adapter mengenkapsulasi logika transformasi: GsonAdapter menerjemahkan string JSON menjadi objek melalui @SerializedName, PushServiceAdapter mengabstraksi pendaftaran token untuk berbagai platform. Klien (logika bisnis) bekerja dengan antarmuka seragam dan tidak bergantung pada implementasi tertentu.

Kesalahan umum saat mengimplementasikan Adapter

Kesalahan dalam implementasi Adapter menyebabkan daftar melambat, kebocoran memori, dan bug pembaruan data. Mari kita bahas tiga masalah umum.

Operasi berat di onBindViewHolder

onBindViewHolder dipanggil untuk setiap sel saat scrolling. Pembuatan objek, parsing JSON, atau query database di metode ini menyebabkan daftar tersendat (frame drops). Solusi: lakukan semua perhitungan berat sebelumnya, berikan data yang sudah siap ke adapter. Untuk gambar, gunakan pustaka dengan caching — Glide, Coil, Kingfisher.

Mengabaikan DiffUtil / DiffableDataSource

Memanggil notifyDataSetChanged() pada setiap pembaruan menggambar ulang seluruh daftar, menyebabkan kedipan dan kehilangan fokus pada input. Solusi: gunakan ListAdapter dengan DiffUtil di Android atau DiffableDataSource di iOS. Perhitungan diff memakan waktu <1 ms untuk daftar hingga 1000 elemen dan memastikan animasi yang halus.

Menyimpan objek berat di adapter

Adapter hidup selama RecyclerView/UITableView. Menyimpan Bitmap atau array besar di adapter menyebabkan kebocoran memori saat perubahan konfigurasi (rotasi layar, perubahan tema). Solusi: adapter harus menyimpan hanya model data ringan (data class / struct), dan memuat sumber daya berat melalui ViewHolder sesuai permintaan.