قراءة ملف من الموارد في Kotlin: دليل كامل مع أمثلة

كيفية قراءة ملف نصي من مجلد resources في Kotlin: برنامج تعليمي خطوة بخطوة

مرحباً يا صديقي! إذا كنت قد كتبت يوماً ما بلغة Kotlin لتطبيقات Android أو ببساطة قمت بإنشاء تطبيق وحدة تحكم، فبالتأكيد واجهت مهمة بسيطة ولكنها خادعة: كيف تقرأ ملفاً نصياً موجوداً في مجلد resources؟ قد يبدو الأمر بسيطاً، ولكن إذا ألقيت نظرة على Stack Overflow، فإن السؤال "How to read a text file from resources in Kotlin?" يحقق آلاف المشاهدات. هذا يعني أن المشكلة حقيقية.

في هذه المقالة، سنستعرض 5 طرق موثوقة للقيام بذلك. ستتعرف على الفرق بين javaClass و ClassLoader، وكيفية تجنب الوقوع في NullPointerException، وماذا تفعل إذا كان مشروعك عبارة عن مكتبة وليس تطبيقاً. هيا بنا!

1. التحضير: أين نضع الملف؟

قبل القراءة، يجب وضع الملف في المكان الصحيح. في مشروع Kotlin القياسي (Gradle, Maven)، يوجد مجلد الموارد عادةً هنا:

src/main/resources/

للاختبارات — src/test/resources/. إذا كان لديك مشروع Android، توضع الموارد في src/main/res/raw/ (ولكن هناك منطق خاص بها، سنتحدث عنه لاحقاً). سنركز هنا على Kotlin/JVM الخالص.

لنقم بإنشاء ملف بسيط data.txt بمحتوى:

مرحباً بالعالم!\nهذه أسطر من الموارد.\nKotlin هو الأفضل.

ممتاز، الأداة جاهزة. الآن دعنا نرى كيفية فتحه.

2. الطريقة رقم 1: الطريقة التقليدية عبر javaClass

الطريقة الأكثر شيوعاً وبديهية هي استخدام javaClass (وهي غلاف Kotlin لـ getClass() في Java).

import java.io.File\n\nfun readFromResources(fileName: String): String {\n    val inputStream = this::class.java.classLoader?.getResourceAsStream(fileName)\n        ?: throw IllegalArgumentException("الملف $fileName غير موجود في الموارد")\n    return inputStream.bufferedReader().readText()\n}

تحليل الكود:

\n
• this::class.java — نحصل على فئة Java للكائن الحالي.
\n
• .classLoader — نأخذ ClassLoader (محمل الفئات).
\n
• getResourceAsStream(fileName) — نفتح تياراً.
\n
• عامل إلفيس ?: يلقي استثناءً إذا لم يتم العثور على الملف.
\n

نقوم بالاستدعاء:

fun main() {\n    val content = readFromResources("data.txt")\n    println(content)\n}

عند الإخراج سنرى ثلاثة أسطر من ملفنا. بسيط وأنيق.

3. الطريقة رقم 2: استخدام object للأدوات المساعدة

إذا كنت تكتب فئة أدوات مساعدة، فمن المناسب وضع المنطق في object (مفرد). في Kotlin يتم ذلك كالتالي:

object ResourceReader {\n    fun readText(fileName: String): String {\n        val stream = ResourceReader::class.java.classLoader\n            .getResourceAsStream(fileName)\n            ?: throw FileNotFoundException("الموارد $fileName غير موجودة")\n        return stream.bufferedReader().readText()\n    }\n}\n\n// الاستخدام:\nfun main() {\n    val text = ResourceReader.readText("config.json")\n    println(text)\n}

لاحظ: نحن نستخدم ResourceReader::class.java — هذا يعمل لأن object هو مفرد وله فئة.

4. الطريقة رقم 3: القراءة كـ URL (للحصول على المسار)

أحياناً نحتاج ليس إلى المحتوى، بل إلى مسار الملف (مثلاً لتمريره إلى مكتبة أخرى). في هذه الحالة نستخدم getResource():

fun getResourcePath(fileName: String): String {\n    val url = this::class.java.classLoader.getResource(fileName)\n        ?: throw RuntimeException("الموارد $fileName غير موجودة")\n    return url.path\n}

ولكن كن حذراً: إذا كان المشروع مضغوطاً في JAR، فقد يشير url.path إلى داخل الأرشيف، ولن يتمكن File من قراءته. في هذه الحالة، من الأفضل دائماً استخدام التدفق (