الثوابت في Kotlin: كيف تنشئها بشكل صحيح؟ دليل كامل

الثوابت في Kotlin: توقف عن التخمين، ابدأ باستخدامها بشكل صحيح

إذا كنت تكتب بلغة Kotlin لمدة أسبوع على الأقل، فمن المحتمل أنك واجهت السؤال: "كيف أعلن عن ثابت بشكل صحيح؟" يبدو الأمر بسيطًا — هناك val، وهناك const val، وهناك companion object. لكن الشيطان، كما هو الحال دائمًا، يكمن في التفاصيل. وهذا السؤال على Stack Overflow حصد آلاف المشاهدات ليس من دون سبب.

دعنا ننهي الأمر مرة واحدة وإلى الأبد: ما هي طرق إنشاء الثوابت في Kotlin، ومتى تستخدم أيًا منها، ولماذا val ليس دائمًا ثابتًا. هيا بنا!

1. val مقابل const val: أين المكمن؟

السؤال الأكثر شيوعًا للمبتدئين: "لقد كتبت val — هل هذا ثابت؟" الإجابة: نعم ولا.

val هو مرجع غير قابل للتغيير (للقراءة فقط). لكن القيمة تُحسب في وقت التشغيل. أي أنه ليس ثابتًا في وقت الترجمة.

// هذا ليس ثابتًا في وقت الترجمة\nval currentTime = System.currentTimeMillis()

const val هو ثابت حقيقي يُدمج في الكود في مرحلة الترجمة (مثل static final في Java).

// أما هذا فهو ثابت\nconst val PI = 3.14159

قيود مهمة: يمكن استخدام const val فقط مع الأنواع البدائية و String. لا يُسمح بالكائنات أو القوائم أو الفئات المخصصة.

2. أين تعلن الثوابت؟ أفضل 3 طرق

الطريقة 1: ثوابت المستوى الأعلى (موصى بها)

أبسط وأنظف طريقة — أعلن الثابت في المستوى الأعلى للملف. لا حاجة للفئات، ولا للكائنات — مجرد ملف بالثوابت.

// Constants.kt\nconst val BASE_URL = "https://api.example.com"\nconst val TIMEOUT_SECONDS = 30\nconst val APP_NAME = "MyKotlinApp"

لماذا هذا رائع؟

\n
• أقل كود ممكن
\n
• متاح من أي مكان بدون بادئات
\n
• يقوم المترجم بدمج القيم
\n
• سهل إعادة الهيكلة
\n

الطريقة 2: companion object داخل الفئة

النهج الكلاسيكي من Java الذي انتقل إلى Kotlin. استخدمه عندما تكون الثوابت مرتبطة منطقيًا بالفئة.

class NetworkClient {\n    companion object {\n        const val DEFAULT_PORT = 8080\n        const val PROTOCOL = "https"\n    }\n}\n\n// الاستخدام\nval port = NetworkClient.DEFAULT_PORT

العيب: ضجيج نحوي. الميزة: الثوابت مرتبطة بالسياق.

الطريقة 3: object (مفرد) لمجموعات الثوابت

عندما يكون هناك العديد من الثوابت وتحتاج إلى تجميعها حسب المعنى.

object AppConstants {\n    const val MAX_LOGIN_ATTEMPTS = 5\n    const val SESSION_DURATION = 3600L\n    const val DATE_FORMAT = "yyyy-MM-dd"\n\n    object Urls {\n        const val LOGIN = "/auth/login"\n        const val LOGOUT = "/auth/logout"\n    }\n}\n\n// الاستخدام\nAppConstants.Urls.LOGIN

3. الثوابت في Android: الخصائص

إذا كنت تكتب لتطبيقات Android، فهناك بعض التفاصيل الإضافية.

الثوابت في companion object و @JvmStatic

لجعل الثابت من companion object ثابتًا حقيقيًا في Java (على سبيل المثال، للتعليقات التوضيحية)، استخدم @JvmStatic:

class MyFragment : Fragment() {\n    companion object {\n        @JvmStatic\n        const val ARG_ID = "id"\n    }\n}

الثوابت في الموارد

لا تنسَ الطريقة الكلاسيكية في Android — الموارد. للنصوص والألوان والأحجام:

// strings.xml\n<string name="app_name">MyApp</string>\n\n// في الكود\nval appName = getString(R.string.app_name)

لكن هذه ليست ثوابت وقت الترجمة.