Facade: أساسيات نمط الواجهة في العمارة المتنقلة

ما هو نمط Facade؟

Facade نمط هيكلي يوفر واجهة موحّدة لمجموعة من واجهات النظام الفرعي. يحدد واجهة عالية المستوى تبسّط استخدام النظام الفرعي. Facade لا يضيف وظائف جديدة — بل ينظّم المكونات الموجودة، مخفياً تعقيد تفاعلها عن العميل.

// نظام فرعي معقد
class AuthApi {
    suspend fun login(email: String, pass: String): TokenResponse
}

class UserDao {
    suspend fun saveUser(user: UserEntity)
    suspend fun getUser(id: Long): UserEntity?
}

class AnalyticsTracker {
    fun track(event: String, params: Map)
}

// Facade — واجهة بسيطة للواجهة UI
class AuthService(
    private val api: AuthApi,
    private val dao: UserDao,
    private val analytics: AnalyticsTracker
) {
    suspend fun loginUser(email: String, password: String): Result {
        return runCatching {
            val token = api.login(email, password)
            val user = User(token.userId, email, token.accessToken)
            dao.saveUser(user.toEntity())
            analytics.track("login_success", mapOf("method" to "email"))
            user
        }
    }
}

AuthService هو Facade يخفي AuthApi وUserDao وAnalyticsTracker عن ViewModel. يستدعي UI دالة loginUser(email, password) بدلاً من ثلاثة طلبات منفصلة إلى API وقاعدة البيانات والتحليلات. هذا يقلل الاقتران: إذا أصبح AuthApi غداً FirebaseAuth أو انتقل UserDao إلى Room، فلن يتغير سوى Facade وليس UI.

Facade في العمارة المتنقلة: Service Layer

Service Layer تطبيق شائع لـ Facade في التطبيقات المتنقلة. يغلّف منطق الأعمال والتنسيق بين الطبقات. في Android، يُنفَّذ Service Layer غالباً عبر UseCase (Clean Architecture)، وفي iOS عبر بروتوكولات Manager أو Service.

AuthService يجمع المكونات الأربعة جميعها. يستدعي ViewModel طريقة واحدة دون معرفة أنه خلف الكواليس يحدث طلب شبكة وكتابة في قاعدة البيانات وتتبع وفحص للشبكة. عند الاختبار، يمكن استبدال AuthService بـ mock للتحقق من منطق المصادقة بالكامل دون التكامل مع المكونات الحقيقية.

Facade مقابل Adapter مقابل Mediator

Facade وAdapter وMediator أنماط هيكلية، لكنها تحل مشكلات مختلفة. غالباً ما يُخلط بينها لأن الثلاثة تُدخل كائناً وسيطاً. لنحلل الاختلافات بمثال تطبيق متنقل.

Facade لا يخفي النظام الفرعي — يمكن للعميل الوصول إلى AuthApi مباشرة عند الحاجة. Adapter يغيّر واجهة Adaptee إلزامياً. Mediator ينسّق التفاعلات المعقدة بين كائنات عديدة قد لا تعرف بعضها البعض.

تطبيق Facade بلغة Kotlin لنظام Android

تطبيق Facade بلغة Kotlin لنظام Android مع Clean Architecture يستخدم UseCase كنقطة دخول لكل سيناريو أعمال. UseCase هو Facade يخفي المستودع والمنظّم (mapper) والتبعيات الأخرى عن طبقة UI.

// Repository هو أيضاً Facade، لكن بمستوى أدنى
class UserRepositoryImpl(
    private val local: UserLocalDataSource,
    private val remote: UserRemoteDataSource,
    private val mapper: UserMapper
) : UserRepository {
    override suspend fun getUserProfile(id: String): UserProfile {
        val cached = local.getUser(id)
        if (cached != null && !cached.isStale) {
            return mapper.toProfile(cached)
        }
        val dto = remote.fetchUser(id)
        val entity = mapper.toEntity(dto)
        local.saveUser(entity)
        return mapper.toProfile(entity)
    }
}

// UseCase — Facade لسيناريو الأعمال
class LoadUserProfileUseCase(
    private val repo: UserRepository,
    private val analytics: AnalyticsTracker
) {
    suspend operator fun invoke(userId: String): Result {
        return runCatching {
            val profile = repo.getUserProfile(userId)
            analytics.track("profile_loaded", mapOf("user_id" to userId))
            profile
        }
    }
}

LoadUserProfileUseCase هو Facade لسيناريو تحميل الملف الشخصي. يخفي منطق التخزين المؤقت (local ← remote) وتحويل DTO ← Entity ← Profile وتتبع التحليلات. يستدعي ViewModel دالة invoke(userId) ويحصل على UserProfile جاهز أو خطأ. يمكن اختبار UseCase بشكل معزول باستبدال المستودع بكائن mock.

تطبيق Facade بلغة Swift لنظام iOS

Facade في iOS يُنفَّذ غالباً كـ Manager أو Service. على عكس Android، يستخدم iOS البروتوكولات لتحديد واجهة Facade، ما يسمح بتبديل التطبيقات بسهولة في الاختبارات. لننظر إلى Facade للعمل مع الوسائط — التحميل والتخزين المؤقت والعرض.

protocol MediaServiceProtocol {
    func loadImage(from url: URL) async -> Result<UIImage, Error>
}

final class MediaService: MediaServiceProtocol {
    private let cache: ImageCache
    private let downloader: ImageDownloader
    private let decoder: ImageDecoder
    
    func loadImage(from url: URL) async -> Result<UIImage, Error> {
        // 1. فحص الكاش
        if let cached = cache.image(for: url) {
            return .success(cached)
        }
        // 2. تحميل البيانات
        let result = await downloader.download(from: url)
        guard case let .success(data) = result else {
            return .failure(MediaError.downloadFailed)
        }
        // 3. فك الترميز
        guard let image = decoder.decode(data) else {
            return .failure(MediaError.decodeFailed)
        }
        // 4. الحفظ في الكاش
        cache.setImage(image, for: url)
        return .success(image)
    }
}

MediaService يغلّف عملية من ثلاث خطوات: الكاش ← التحميل ← فك الترميز. يستدعي UI طريقة واحدة loadImage(from:) بدلاً من إدارة ImageCache وURLSession وImageDecoder. عند الاختبار، يمكن استبدال MediaServiceProtocol بـ mock يعيد صوراً محددة مسبقاً دون تحميل حقيقي.

الأخطاء الشائعة عند استخدام Facade

الأخطاء عند تصميم Facade تلغي مزاياه: بدلاً من التبسيط تحصل على God Object يعتمد عليه النظام بأكمله. لنحلل المشكلات الثلاث الرئيسية.

God Facade — مسؤولية زائدة

عندما يحتوي Facade واحد على طرق للمصادقة وتحميل الملف الشخصي وإرسال الرسائل والمزامنة — فهذا God Object. علامة: أكثر من 15 طريقة عامة في فئة واحدة. الحل: تقسيمه إلى عدة Facade متخصصة حسب مجالات المسؤولية — AuthService وProfileService وMessagingService.

Facade مع تسريب تفاصيل النظام الفرعي

إذا أعاد Facade أنواعاً خاصة بالنظام الفرعي (على سبيل المثال، FirebaseUser أو RealmObject)، فإن العميل يظل مرتبطاً بتطبيق محدد. الحل: يجب أن يعيد Facade أنواعه الخاصة فقط (data class / struct)، مما يجرّد العميل تماماً من تفاصيل النظام الفرعي.

Facade كنقطة دخول وحيدة

عندما يمنع Facade الوصول المباشر إلى النظام الفرعي، يصبح عنق زجاجة. أحياناً يحتاج العميل طريقة محددة من النظام الفرعي، وإجباره على المرور عبر Facade أمر زائد. يجب ألا يكون Facade بوابة صارمة: يوفر واجهة مريحة لكنه لا يحجب الوصول المباشر إلى المكونات.