sealed class و interface في Kotlin — ما هي، بناء الجملة والتطبيق

ما هي sealed class و sealed interface؟

sealed class هي فئة مجردة مع تقييد: يجب الإعلان عن جميع فئاتها الفرعية المباشرة في نفس الملف الذي توجد فيه sealed class. هذا التقييد يجعل التسلسل الهرمي مغلقًا (sealed) — لا يمكن لأي كود خارج الملف إضافة فئة فرعية جديدة.

sealed interface، التي أُضيفت في Kotlin 1.5، توفر نفس الضمان ولكن مع مرونة الواجهة: يمكن تنفيذ sealed interface بواسطة فئات متعددة أو كائنات أو واجهات أخرى في ملف واحد. على عكس sealed class، لا تحتوي sealed interface على تقييد الوراثة الفردية — يمكن للفئة تنفيذ واجهات sealed متعددة في وقت واحد.

وفقًا لـ Kotlin Evolution and Roadmap (2026)، أُضيفت sealed interface بناءً على طلب المجتمع لنمذجة أكثر مرونة. الدافع الرئيسي هو القدرة على الجمع بين التسلسلات الهرمية للأنواع المستقلة دون وراثة متعددة للفئات.

بناء جملة sealed class

يبدأ إعلان sealed class بالمُعدِّل sealed قبل class. يتم الإعلان عن الفئات الفرعية في نفس الملف.

sealed class NetworkResult {
    data class Success(val data: String) : NetworkResult()
    data class Error(val message: String) : NetworkResult()
    object Loading : NetworkResult()
}

يمكن أن تحتوي كل فئة فرعية من sealed class على خصائصها وطرقها الخاصة. Loading هو كائن فردي (object)، Success و Error هما data classes مع معلمات. يعرف المترجم جميع المتغيرات الثلاثة ويتحقق من اكتمالها عند استخدامها في when.

الفئات sealed المتداخلة

يمكن أن تكون الفئات sealed متداخلة، مما ينشئ تسلسلات هرمية متعددة المستويات لنماذج بيانات معقدة دون فقدان أمان الأنواع.

sealed class UiState {
    object Idle : UiState()
    object Loading : UiState()
    data class Content(val items: List<Item>) : UiState()
    data class Error(val exception: Throwable) : UiState()
}

بناء جملة sealed interface (Kotlin 1.5+)

يتم الإعلان عن sealed interface بشكل مشابه لـ sealed class، ولكنه يسمح بتنفيذ واجهات sealed متعددة في فئة واحدة.

sealed interface Action
sealed interface Loggable

data class Navigate(val route: String) : Action, Loggable
data class ShowToast(val text: String) : Action
object GoBack : Action, Loggable

تقوم فئة Navigate بتنفيذ واجهتين sealed في وقت واحد — Action و Loggable. هذا مستحيل مع sealed class بسبب تقييد الوراثة الفردية. توفر sealed interface مرونة الجمع بين التسلسلات الهرمية المستقلة.

متى تختار sealed interface بدلاً من sealed class

sealed interface مفضلة عندما لا يتطلب التسلسل الهرمي حالة مشتركة أو مُنشئ. وفقًا لإرشادات JetBrains Kotlin Guidelines (2026)، يجب استخدام sealed interface افتراضيًا لجميع التسلسلات الهرمية الجديدة حيث لا تكون هناك حاجة إلى مُنشئ مشترك، مما يجعل الكود أكثر مرونة للتوسعات المستقبلية.

المعالجة الشاملة في when

الميزة الرئيسية للأنواع sealed هي المعالجة الشاملة في تعبير when. يتحقق المترجم من تغطية جميع الفئات الفرعية المحتملة.

fun handleResult(result: NetworkResult): String = when (result) {
    is NetworkResult.Success -> "Data: ${result.data}"
    is NetworkResult.Error -> "Error: ${result.message}"
    is NetworkResult.Loading -> "Loading..."
    // else غير مطلوب — المترجم يعلم أن جميع المتغيرات مغطاة
}

إذا أضاف المطور فئة فرعية جديدة إلى التسلسل الهرمي sealed لكنه نسي معالجتها في when — سيرمي المترجم خطأ. هذه سلامة على مستوى الأنواع، غير متاحة مع التسلسلات الهرمية المفتوحة التي تستخدم فرع else.

وفقًا لـ Google Android Developers (2026)، الفئات sealed هي الطريقة الموصى بها لنمذجة حالة واجهة المستخدم في Jetpack Compose. يمنع الفحص الشامل لـ when الحالات التي لم يعالج فيها المطور جميع المتغيرات المحتملة لعرض الشاشة.

مقارنة sealed class مع enum class

غالبًا ما يتم الخلط بين enum class و sealed class، لكن لهما أغراض وقدرات مختلفة.

يعتمد الاختيار بين sealed class و enum class على المهمة. إذا كانت المتغيرات لا تحمل بيانات إضافية — استخدم enum. إذا كان كل متغير يحتوي على حقول فريدة — استخدم sealed class أو sealed interface.

سيناريوهات الاستخدام العملية

تُستخدم الأنواع sealed في مشاريع Kotlin لمجموعة من السيناريوهات القياسية حيث تكون النمذجة الآمنة للأنواع مطلوبة.

حالة واجهة المستخدم في Jetpack Compose

يمكن أن تحتوي كل شاشة Compose على sealed class UiState تصف جميع الحالات المحتملة: Idle، Loading، Content(data)، Error(exception). يضمن تعبير when معالجة جميع الحالات.

نتائج طلبات الشبكة

NetworkResult مع المتغيرات Success، Error، Loading هو نمط قياسي في مشاريع Kotlin مع Retrofit و Ktor. توفر sealed class معالجة آمنة لكل نتيجة من نتائج الطلب.

التنقل في المشاريع متعددة الوحدات

sealed interface لمسارات التنقل تسمح للوحدات بالإعلان عن مساراتها الخاصة مع البقاء ضمن تسلسل هرمي موحد. هذا يلغي الأخطاء المتعلقة بالمسارات غير المعروفة في وقت الترجمة.

وفقًا لـ KotlinConf (2025)، فإن sealed class و sealed interface هما أساس التصميم الآمن للأنواع في تطبيقات Kotlin الحديثة. يتم دمجهما مع data class لنمذجة هياكل المجال المعقدة دون فقدان الأمان في وقت الترجمة.