Adapter — ما هو، نمط تحويل الواجهات لتطوير التطبيقات المحمولة

ما هو نمط Adapter؟

Adapter هو نمط هيكلي يحل مشكلة عدم توافق الواجهات. يغلف كائنًا (Adaptee) في فئة (Adapter) بواجهة يتوقعها العميل (Target). يعمل العميل مع Target دون معرفة بوجود Adaptee. هذا نوع من نمط Wrapper.

// الفئة الموجودة بواجهة غير متوافقة
class LegacyAuthApi {
    fun loginWithToken(token: String): Map {
        return mapOf("status" to "ok", "user_id" to 42)
    }
}

// الواجهة الهدف (ما يتوقعه العميل)
interface AuthService {
    suspend fun login(credentials: Credentials): Result
}

// Adapter — يحول LegacyAuthApi إلى 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 يحول استدعاء login(credentials) إلى loginWithToken(token) لواجهة API القديمة. يعمل العميل (ViewModel) من خلال واجهة AuthService ولا يعرف ما إذا كان تحتها أحدث Firebase Auth أو واجهة قديمة من عشر سنوات. هذا يسمح باستبدال التطبيقات دون تغيير كود العميل.

Adapter في Android: RecyclerView وListAdapter

RecyclerView.Adapter هو التطبيق الأكثر شيوعًا لنمط Adapter في Android. يحول البيانات (قائمة كائنات) إلى ViewHolders التي يعرضها RecyclerView على الشاشة. مع ظهور ListAdapter (Android Architecture Components)، حصل النمط على دعم مدمج لحساب الفروقات (diff) لتحريك التغييرات.

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 يستخدم ListAdapter مع DiffUtil لإعادة رسم القائمة بكفاءة. عندما يتم تحديث البيانات، يحسب DiffCallback الفرق بين القائمة القديمة والجديدة، ويقوم RecyclerView بتحريك العناصر المتغيرة فقط — دون إعادة رسم القائمة بأكملها. هذه ميزة رئيسية مقارنة بـ ListView القديم الذي كان يتطلب notifyDataSetChanged() يدويًا.

Adapter في iOS: UITableView وDiffableDataSource

UITableViewDataSource هو في نفس الوقت نمط Adapter ونمط DataSource. يحول بيانات النموذج إلى خلايا جدول. منذ iOS 13، قدمت Apple DiffableDataSource — بديل حديث، مثل ListAdapter في Android، يحسب التغييرات تلقائيًا ويحرك التحديثات.

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

// النسخة الحديثة: 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 مع DiffableDataSource يقوم تلقائيًا بتحريك التغييرات عند تحديث البيانات: تظهر العناصر أو تختفي أو تتحرك مع رسوم متحركة سلسة. DiffableDataSource في iOS وListAdapter في Android يحلان نفس المشكلة بواجهات برمجة مختلفة ولكن بنفس المنطق — حساب الفروقات + الرسوم المتحركة التلقائية.

Object Adapter مقابل Class Adapter

Object Adapter يستخدم التركيب: المحول يحتوي على مرجع لكائن Adaptee ويفوض الاستدعاءات إليه. Class Adapter يستخدم الوراثة: يرث المحول من Adaptee وينفذ الواجهة الهدف في نفس الوقت. في Java وSwift وKotlin، Class Adapter غير ممكن بسبب عدم وجود وراثة متعددة — يبقى فقط Object Adapter.

في تطوير التطبيقات المحمولة، يُستخدم Object Adapter فقط. RecyclerView.Adapter يحتوي على مراجع للبيانات وLayoutInflater، UITableViewDataSource يحتوي على مصفوفة عناصر. التركيب يجعل الكود أكثر مرونة وقابلية للاختبار مقارنة بالوراثة.

أمثلة على Adapter في المشاريع الحقيقية

Adapter لا يُستخدم فقط للقوائم. دعنا ننظر في ثلاثة سيناريوهات من ممارسة تطوير التطبيقات المحمولة حيث يحل النمط مشكلة دمج المكونات غير المتوافقة.

كل Adapter يغلف منطق التحويل: GsonAdapter يترجم سلسلة JSON إلى كائن عبر @SerializedName، PushServiceAdapter يجرد تسجيل الرمز المميز لمنصات مختلفة. يعمل العميل (منطق الأعمال) مع واجهة موحدة ولا يعتمد على التطبيق المحدد.

الأخطاء الشائعة عند تنفيذ Adapter

الأخطاء في تنفيذ Adapter تؤدي إلى بطء القوائم وتسرب الذاكرة وأخطاء في تحديث البيانات. دعنا نستعرض ثلاث مشاكل شائعة.

العمليات الثقيلة في onBindViewHolder

يتم استدعاء onBindViewHolder لكل خلية أثناء التمرير. إنشاء كائنات أو تحليل JSON أو استدعاء قاعدة البيانات في هذه الطريقة يؤدي إلى انخفاض الإطارات (frame drops). الحل: إجراء جميع الحسابات الثقيلة مسبقًا، وتمرير البيانات الجاهزة إلى المحول. استخدام مكتبات التخزين المؤقت للصور — Glide، Coil، Kingfisher.

تجاهل DiffUtil / DiffableDataSource

استدعاء notifyDataSetChanged() في كل تحديث يعيد رسم القائمة بأكملها، مما يسبب وميضًا وفقدان التركيز على الإدخالات. الحل: استخدام ListAdapter مع DiffUtil في Android أو DiffableDataSource في iOS. حساب الفروقات يستغرق <1 مللي ثانية للقوائم حتى 1000 عنصر ويضمن رسومًا متحركة سلسة.

تخزين كائنات ثقيلة في المحول

المحول يعيش بنفس مدة RecyclerView/UITableView. تخزين Bitmap أو مصفوفات كبيرة في المحول يؤدي إلى تسرب الذاكرة عند تغيير التكوين (تدوير الشاشة، تغيير السمة). الحل: يجب أن يخزن المحول فقط نماذج بيانات خفيفة (data class / struct)، وتحميل الموارد الثقيلة عبر ViewHolder عند الطلب.