الملفات في جافا | Java Files IO

التعامل مع الملفات في جافا

مقدمة التعامل مع الملفات في جافا

غالباً ما تحتاج البرامج إلى تبادل البيانات مع مصادر خارجية, سواء كان ذلك لإستقبال البيانات من مصدر ما أو لإرسال البيانات إلى مستقبل ما.

المرسل و المستقبل في عملية تبادل البيانات قد تكون لهم أشكال مختلفة أمثلة:
يمكن تبادل البيانات بين البرنامج و الملف, أو بين البرنامج و الشبكة, أو بين البرنامج و قاعدة بيانات, أو بين البرنامج و برنامج إلخ...

و بالنسبة لأنواع البيانات التي يمكن نقلها. يمكنك تبادل أي نوع من أنواع البيانات أمثلة:
نصوص, صور, ملفات صوتية, برامج, إلخ..

لغة جافا توفر لك الحزمة java.io و التي تحتوي على جميع الكلاسات التي تحتاجها للتعامل مع الملفات, سواء لإدخال بيانات جديدة في الملف Input Operation أو لإستخراج بيانات موجودة في الملف Output Operation, و حتى لإنشاء أو حذف الملفات. و من هنا جاء الإسم I/O.

عملية إدخال البيانات أو إستخراجها من الملفات تسمى Streaming data, و هذه الكلمة تعني تدفق البيانات في اللغة العربية.

سميت هذه العملية ( تدفق البيانات ) لأنك عندما تتعامل مع الملفات سواء للقراءة أو الكتابة فأنت تقوم بذلك على دفعات صغيرة, بمعنى أنك تبرمج على سبيل المثال برنامج يفتح ملف معين و يقرأ منه حرف واحد أو مجموعة أحرف في كل دفعة حتى نقل كامل بيانات الملف. سترى ذلك لاحقاً بتفصيل.

الكلمة Streams في جافا

الكلمة Streams تعني سلسلة من البيانات, يتم إستخراجها أو إدخالها في ملف معين.

هناك نوعين من الـ Streams و هما: input stream و output stream.

لذلك تم بناء الكلاسات التالية للتعامل مع الـ Streams:

• الكلاس InputStream يستخدم لقراءة البيانات من ملف معين يسمى Source.

• الكلاس OutputStream يستخدم لكتابة البيانات في ملف معين يسمى Destination.

في هذا الدرس سنشرح لك كيف تستخدم الحزمة I/O لقراءة أي نوع من الملفات و سنشرح فقط الكلاسات الأكثر استخداماً فيها.

طريقة التعامل مع الملفات في جافا

عندما تتعامل مع الملفات عليك إتباع نمط معين حتى تتجنب حدوث أي خطأ في البرنامج, و لقد قمنا بوضع خطوات ستساعدك كثيراً في فهم عملية نقل البيانات, و وضعنا أيضاً بعض الملاحظات التي يجب عليك الإنتباه لها أثناء تحديد مكان وجود الملفات التي سيتعامل البرنامج معها.

الخطوات التي يجب إتباعها لقراءة البيانات من ملف و كتابتها في ملف آخر

1. إنشاء كائن يمثل الملف الذي تريد قراءة البيانات منه.

2. إنشاء كائن يمثل الملف الذي تريد كتابة البيانات فيه.

3. عليك وضع جميع الأوامر التي تتعامل مع الملفات بداخل الجملة try لأن البرنامج قد يتعرض لعدة مشاكل عندما يتعامل مع الملفات و التي سنذكرها لك لاحقاً.

4. تحديد مسار و إسم و نوع الملف للكائن الذي يمثل الملف الذي سيتم قراءة البيانات منه.

5. تحديد مسار و إسم و نوع الملف للكائن الذي يمثل الملف الذي سيتم كتابة البيانات فيه.

6. تعريف متغير من النوع int.

7. إستخدام حلقة بشكل متوازي بين الملفين, أي في كل دورة من دورات هذه الحلقة نقرأ حرف من الملف الأول و نضعه في الملف الثاني.

8. إستخدام الدالة read() لقراءة حرف من الملف الأول, بعدها يجب تخزين هذا الحرف في المتغير.

9. إستخدام الدالة write() لكتابة الحرف الموجود في المتغير في الملف الثاني.

10. في الأخير عليك التأكد من إغلاق الملفات التي حاولت الإتصال معها سواء نجحت عملية النسخ أم لم تنجح, لذلك عليك إستدعاء الدالة close() في الجملة finally لإغلاق أي كائن متصل بالملفات حتى لا تعرض الملفات لأي خطر.

هذه الصورة توضح لك كيف تتم عملية نقل المحتوى من ملف لآخر, و هذا السيناريو هو نفسه تقريباً في جميع عمليات نقل البيانات و هو يستمر في نقل الأحرف الواحد تلو الآخر حتى آخر حرف موجود في الملف عندما نكتبه بالشكل الصحيح بداخل حلقة.

الدالة read() كما هو موضح في الصورة تقرأ حرف واحد من الملف و ترجعه كلما تم إستدعائها.
في حال تم قراءة جميع الأحرف الموجودة في الملف, ثم حاولت الدالة read() قرائة حرف من جديد, ستقوم بإرجاع 1-.
إذاً عندما ترجع الدالة read() القيمة 1- فهذا يعني أنه تم تخطي آخر حرف موجود في الملف.
من هنا جائت فكرة أنه يمكنك إستخدام الدالة read() و القيمة 1- كشرط أساسي لإيقاف عملية قرائة البيانات بعد آخر حرف يتم قرائته.

تحديد مسار الملفات التي تحاول التعامل معها في جافا

من الأشياء المهمة التي عليك الإنتباه لها عندما تتعامل مع الملفات هي معرفة كيف يتعامل نظام التشغيل الذي تبني برنامجك لأجله مع المسارات.

لنفترض أنه عندنا ملف موجود بداخل 3 مجلدات و نريد الوصول إليه كما في الصورة التالية:

الآن سترى كيف يتم تحديد المسار الموجود فيه الملف على أشهر أنظمة التشغيل.

• على نظامي Mac و Windows نضع \\ بعد إسم كل مجلد عند تحديد المسار الموجود فيه الملف test.

• على نظامي Unix و Linux نضع / بعد إسم كل مجلد عند تحديد المسار الموجود فيه الملف test.

لاحظ كيف أننا نضع نفس أسماء المجلدات و نفس إسم الملف لكي نصل للملف text. الإختلاف الوحيد هو الرمز الذي نضعه بعد كل مجلد.

A\\B\\C\\test.txt       // هكذا نصل للملف Mac و Windows على

A/B/C/test.txt          // هكذا نصل للملف Linux و Unix على
	

في جافا يمكنك إستخدام الأسلوب الذي تريده مهما كان نظام التشغيل, ثم تقوم بتحويل المسار عنك ليتناسب مع نظام التشغيل.

Character Streams

الكلاسات التي تصنف كـ Character Streams مصممة للتعامل مع الملفات النصية العادية التي تعتمد على الترميز unicode, أي كل حرف في الملف يتم تمثيله بـ 2 Bytes.

هناك العديد من الكلاسات التي تنتمي للـ Character Streams لكن الكلاسات الأكثر إستخداماً هما : FileReader و FileWriter.

تقنياً

الكلاسات FileReader و FileWriter يعتمدون على الكلاسات FileInputStream و FileOutputStream.
الفرق الوحيد بينهم هو أن الكلاس FileReader يقرأ 2 Bytes في كل مرة و الكلاس FileWriter يكتب 2 Bytes في كل مرة.

الترميز unicode يمثل كل حرف موجود في الملف بـ 2 Bytes.
إذاً الكلاس FileReader يقرأ حرف من الملف في كل مرة و الكلاس FileWriter يكتب حرف في الملف في كل مرة.

مثال

في حال كان عندنا ملف إسمه input.txt موجود في المسار C:\\MyFiles\\ كما في الصورة التالية:

و نريد إنشاء نسخة ثانية منه في نفس المسار إسمها output.txt كما في الصورة التالية:

نكتب الكود التالي.

مثال

Main.java

import java.io.FileReader;
import java.io.FileWriter;
import java.io.IOException;
 
public class Main {
 
    public static void main(String[] args) throws IOException {
 
        FileReader in = null;
        FileWriter out = null;
 
        try {
            in = new FileReader("C:\\MyFiles\\input.txt");
            out = new FileWriter("C:\\MyFiles\\ouput.txt");
            int c;
 
            while ((c = in.read()) != -1) {
                out.write(c);
            }
        }
        catch(IOException e) {
            System.out.println("There is IOException!");
        }
        finally {
            if (in != null) {
                in.close();
            }
            if (out != null) {
                out.close();
            }
        }
 
    }

}
		

شرح الكود

import java.io.FileReader;
import java.io.FileWriter;
import java.io.IOException;
			

• هنا قمنا باستدعاء الكلاسات التي سنحتاجها في البرنامج.

	public static void main(String[] args) throws IOException {
			

• هنا قمنا بوضع الجملة throws IOException لأن الدالة close() التي قمنا باستدعائها لاحقاً في الكود قد ترمي إستثناء في الدالة main().

        FileReader in = null;
        FileWriter out = null;
			

• هنا قمنا بإنشاء الكائن in لتمثيل الملف الذي سيتم فتحه لاحقاً.

• و قمنا بإنشاء الكائن out لتمثيل الملف الذي سيتم خلقه لاحقاً.

            in = new FileReader("C:\\MyFiles\\input.txt");
            out = new FileWriter("C:\\MyFiles\\ouput.txt");
            int c;
			

• هنا قمنا بتحديد الملف الذي سيمثله الكائن in.
  الملف input.txt الموجود في المسار C:\\MyFiles\\ أصبح متمثلاً بالكائن in.

• و قمنا بخلق ملف جديد على إسمه output.txt و يمثله الكائن out.
  الملف output.txt حتى الآن عبارة عن ملف فارغ موجود في المسار C:\\MyFiles\\.

• المتغير c سنستخدمه كوسيط بين الملفين عند نقل البيانات.

            while ((c = in.read()) != -1) {
                out.write(c);
            }
			

• في الحلقة while سيحدث التالي في كل دورة:

1. ستقوم الدالة read() بقراءة 2 Bytes من الملف الذي يمثله الكائن in ثم تخزنهم في المتغير c.

2. إذا كانت قيمة المتغير c لا تساوي -1 , سيتم إدخال الـ 2 Bytes الموجودة في المتغير c في الكائن out بواسطة الدالة write().

الكلاسات المصممة للتعامل مع الـ Character Streams

في جافا تم بناء الكلاسات التي تتعامل مع الـ Character Streams بشكل متناسق كما في الصورة التالية.

الكلاس Reader هو الكلاس الأساسي لقراءة الأحرف من الملفات. و الكلاس Writer هو الكلاس الأساسي لكتابة الأحرف في الملفات.

أهم كلاسَين للتعامل مع الـ Character Streams هما الكلاس BufferedReader و الكلاس BufferedWriter بحيث يوفران لك كثير من الدوال التي تمكنك من التعامل مع الملفات بسهولة و مرونة و استخدام الـ buffer للحصول على أفضل أداء ممكن.

طريقة التعامل مع هذه الكلاسات

عندما تستخدم هذه الكلاسات ستستخدم مبدأ يسمى Upcasting.
و المقصود من هذا أنك مثلاً تنشئ كائن من الكلاس InputStream ثم تضع فيه أي كائن من الكلاسات التي ترث منه, مثل InputStreamReader.
بمعنى آخر تنشئ كائن من الكلاس InputStream ثم تحدد أنك تريد إستخدام الكلاس FileInputStream.

فكرة الـ Buffer و أهميتها عند التعامل مع الملفات في جافا

إفترض أن برنامجك سيقرأ على سبيل المثال ملف حجمه 10 MB, و التي تساوي 10,485,760 Bytes.

هل ستستدعي الدالة read() أكثر من 10 ملايين مرة حتى تقرأ هذا الملف؟!
حتماً لا لأنك إن فعلت ذلك ستهلك المعالج و الذاكرة و القرص الصلب لقراءة هذا الملف البسيط, و من هنا جائت فكرة الـ Buffer.

مفهوم الـ Buffer في جافا

الـ Buffer عبارة عن مساحة مؤقتة للتخزين يتم إنشاءها في الذاكرة من أجل قراءة كمية كبيرة من المعلومات, ثم يتم التخلص منها عند الإنتهاء.
عندما تستخدم كائن يتعامل مع الـ Buffer فهذا الكائن سينشئ هذه المساحة المؤقت في الذاكرة.

الآن إذا رجعنا للمثال السابق, كان يمكنك قراءة 1000 Bytes أو أكثر على سبيلا المثال في كل مرة تستدعي فيها الدالة read() بدل إستدعاءها لقراءة 1 Byte في كل مرة. و لو كان هذا مثال حي للاحظت الفارق في السرعة بين الأسلوبين.

في الجدول التالي وضعنا بعض كلاسات الـ Character Streams التي تستخدم للقراءة من الملفات.

الكلاس مع تعريفه
class InputStreamReader الكلاس InputStreamReader يقرأ بيانات الملف كـ bytes و يحولهم لأحرف حسب الترميز الذي نقوم بتحديده في الكونستركتور. تابع القراءة »
class FileReader الكلاس FileReader يرث من الكلاسات InputStreamReader و Reader و هو يستخدم لقراءة Streams من الأحرف. تابع القراءة »
class BufferedReader الكلاس BufferedReader يقرأ أحرف كائن الـ InputStreamReader و يضعهم في الـ buffer. و هذا يوفر لك طرق عديدة لقراءة المحتوى من الـ buffer. مثل قراءته حرفاً حرفاً, أو تخزينه في مصفوفة, أو قراءته سطراً سطراً. يمكنك تحديد حجم الـ buffer, أو استخدام الحجم الإفتراضي لها و الذي يعتبر جيداً في معظم الحالات. تابع القراءة »

في الجدول التالي وضعنا بعض كلاسات الـ Character Streams التي تستخدم للكتابة في الملفات.

الكلاس مع تعريفه
class OutputStreamWriter الكلاس OutputStreamWriter يكتب الأحرف في الملف كـ bytes حسب الترميز الذي نقوم بتحديده في الكونستركتور. تابع القراءة »
class FileWriter الكلاس FileWriter يرث من الكلاسات OutputStreamWriter و Writer و هو يستخدم لكتابة نص في الملف. تابع القراءة »
class BufferedWriter الكلاس BufferedWriter يضع أحرف كائن الـ OutputStreamWirter في الـ buffer. و هذا يوفر لك طرق عديدة لكتابة محتوى الـ buffer في الملف. مثل كتابته حرفاً حرفاً, أو تخزينه في مصفوفة, أو كتابته سطراً سطراً. يمكنك تحديد حجم الـ buffer, أو استخدام الحجم الإفتراضي لها و الذي يعتبر جيداً في معظم الحالات. تابع القراءة »

Byte Streams

الكلاسات التي تصنف كـ Byte Streams مصممة للتعامل الملفات الغير نصية التي تخزن المحتوى بشكل سلسلة بيانات من 1 Byte مثل ( PNG, MP4, MP3.. ) و يمكنها نقل الأحرف العادية شرط أن تكون الأحرف المستخدمة تتألف من 1 Byte حتى تنقل بشكل صحيح.

هناك العديد من الكلاسات التي تنتمي للـ Byte Streams لكن الكلاسات الأكثر إستخداماً هما : FileInputStream و FileOutputStream.

مثال

في حال كان عندنا ملف إسمه input.MP4 موجود في المسار C:\\MyFiles\\ كما في الصورة التالية:

و نريد إنشاء نسخة ثانية منه في نفس المسار إسمها output.MP4 كما في الصورة التالية:

نكتب الكود التالي.

مثال

Main.java

import java.io.FileInputStream;
import java.io.FileOutputStream;
import java.io.IOException;
 
public class Main {
 
    public static void main(String[] args) throws IOException {
 
        FileInputStream in = null;
        FileOutputStream out = null;
 
        try {
            in = new FileInputStream("C:\\MyFiles\\input.MP4");
            out = new FileOutputStream("C:\\MyFiles\\ouput.MP4");
            int c;
 
            while ((c = in.read()) != -1) {
                out.write(c);
            }
        }
        catch(IOException e) {
            System.out.println("There is IOException!");
        }
        finally {
            if (in != null) {
                in.close();
            }
            if (out != null) {
                out.close();
            }
        }
 
    }
 
}
		

شرح الكود

import java.io.FileInputStream;
import java.io.FileOutputStream;
import java.io.IOException;
			

• هنا قمنا باستدعاء الكلاسات التي سنحتاجها في البرنامج.

    public static void main(String[] args) throws IOException {
			

• هنا قمنا بوضع الجملة throws IOException لأن الدالة close() التي قمنا باستدعائها لاحقاً في الكود قد ترمي إستثناء في الدالة main().

        FileInputStream in = null;
        FileOutputStream out = null;
			

• هنا قمنا بإنشاء الكائن in لتمثيل الملف الذي سيتم فتحه لاحقاً.

• و قمنا بإنشاء الكائن out لتمثيل الملف الذي سيتم خلقه لاحقاً.

            in = new FileInputStream("C:\\MyFiles\\input.MP4");
            out = new FileOutputStream("C:\\MyFiles\\ouput.MP4");
            int c;
			

• هنا قمنا بتحديد الملف الذي سيمثله الكائن in.
  الملف input.mp4 الموجود في المسار C:\\MyFiles\\ أصبح متمثلاً بالكائن in.

• و قمنا بخلق ملف جديد على إسمه output.MP4 و يمثله الكائن out.
  الملف output.MP4 حتى الآن عبارة عن ملف فارغ موجود في المسار C:\\MyFiles\\.

• المتغير c سنستخدمه كوسيط بين الملفين عند نقل البيانات.

            while ((c = in.read()) != -1) {
                out.write(c);
            }
			

• في الحلقة while سيحدث التالي في كل دورة:
  

  1. ستقوم الدالة read() بقراءة 1 Byte من الملف الذي يمثله الكائن in ثم تخزنهم في المتغير c.

  2. إذا كانت قيمة المتغير c لا تساوي -1 , سيتم إدخال الـ 1 Byte الموجودة في المتغير c في الكائن out بواسطة الدالة write().

ملاحظة

عندما تقوم بتشغيل هذا البرنامج. سيحتاج إلى بعض الوقت حتى ينتهي من عملية النسخ بشكل كامل (أي لا تظنه معلق), و في حال قمت بإيقاف البرنامج أثناء عمله, إفتح الملف Output.MP4 و ستجد أن الجزء الأخير في الفيديو مفقود.

الكلاسات المصممة للتعامل مع الـ Byte Streams

في جافا تم بناء الكلاسات التي تتعامل مع الـ Byte Streams بشكل متناسق كما في الصورة التالية.

الكلاس InputStream هو الكلاس الأساسي لقراءة البيانات من ملف. و الكلاس OutputStream هو الكلاس الأساسي لكتابة البيانات في ملف.

أهم كلاسَين للتعامل مع الـ Streams هما الكلاس FileInputStream و الكلاس FileOutputStream بحيث يوفران لك كثير من الدوال التي تمكنك من التعامل مع الملفات بسهولة و مرونة.

في الجدول التالي وضعنا بعض كلاسات الـ Byte Streams التي تستخدم للكتابة في الملفات.

الكلاس مع تعريفه
class FileInputStream الكلاس FileInputStream يستخدم لقراءة البيانات من الملفات. تابع القراءة »
class ByteArrayInputStream الكلاس ByteArrayInputStream يسمح باستخدام الـ buffer في الذاكرة كـ InputStream. و هو يقرأ البيانات من المصدر كمصفوفة نوعها byte. تابع القراءة »
class DataInputStream الكلاس DataInputStream يستخدم لقراءة البيانات البدائية primitive data types من ملف معين. تابع القراءة »

في الجدول التالي وضعنا بعض كلاسات الـ Byte Streams التي تستخدم للقراءة من الملفات.

الكلاس مع تعريفه
class FileOutputStream الكلاس FileOutputStream يستخدم لإنشاء ملف جديد و كتابة البيانات فيه. في حال وجود ملف يحمل نفس الإسم و النوع في نفس المسار الموضوع للـ OutputStream, سيتم تبديل الملف القديم بملف الـ OutputStreamالجديد. تابع القراءة »
class ByteArrayOutputStream الكلاس ByteArrayOutputStream ينشئ buffer في الذاكرة لتخزين بيانات الـ Stream فيها قبل إرسالها للـ OutputStream. تابع القراءة »
class DataOutputStream الكلاس DataOutputStream يستخدم لكتابة البيانات البدائية primitive data types في ملف معين. تابع القراءة »

الكلاس File

تم إعداد الكلاس File لمعالجة الملفات و المجلدات.
لا يوجد كلاس خاص لمعالجة المجلدات لأن المجلدات عبارة عن ملفات فارغة يمكنها إحتواء ملفات و مجلدات أخرى.

يستخدم الكلاس File للأغراض التالية:

• لخلق ملف أو مجلد جديد.

• لحذف ملف أو مجلد موجود.

• للبحث عن ملف أو مجلد.

• لعرض جميع الملفات و المجلدات الموجودة في المجلد.

• لقراءة صلاحيات الملف أو المجلد.

• لتغيير صلاحيات الملف أو المجلد.

وضعنا لك هنا أهم المعلومات التي قد تحتاجها حول الكلاس File.

تابع القراءة »

التعامل مع المجلدات في جافا

المجلد يسمى directory في البرمجة, و هو عبارة عن ملف يمكنه تخزين ملفات و مجلدات أخرى.

باستخدام كائن من الكلاس File يمكنك إنشاء العدد الذي تريده من المجلدات, و معرفة عدد الملفات الموجودة في مجلد ما.
لتعرف تفاصيل أكثر عن علاقة الكلاس File بالمجلدات, أدرس الكلاس File و ستتعرف على بعض الدوال الموجودة فيه المخصصة للتعامل مع المجلدات.

إنشاء المجلدات في جافا

يوجد دالتين في الكلاس File يمكن إستخدامها لإنشاء مجلدات.

• الدالة mkdir() تستخدم لإنشاء مجلد واحد, و ترجع true إذا تم إنشاءه بنجاح و false إذا لم فشلة عملية إنشاءه.
  إذا فشلت علية إنشاءه فذلك يعني أن المسار الموضوع في كائن الـ File موجود في الأصل, أو أنه لا يمكن إنشاء المجلد لإن المسار الموضوع قبل إسم الملف الذي سيتم إنشائه غير موجود.

• الدالة mkdirs() تستخدم لإنشاء مجلد أو أكثر.
  هنا في حال كان المسار الموضوع غير موجود ستقوم هي بإنشاءه. أي ستنشئ جميع المجلدات الموضوعة في المسار.

عرض محتوى المجلدات في جافا

يمكنك استخدام الدالة list() الموجودة في الكلاس File لعرض جميع الملفات الموجودة في المجلد.

مثال

•في هذا المثال سنقوم بإنشاء مجلد إسمه harmash بداخله سننشئ مجلدين images و videos, و سننشئ فيه أيضاً ملف إسمه index.php.

•بعدها سنقوم بعرض جميع الأشياء الموجودة في المجلد harmash.

Main.java

import java.io.File;
import java.io.IOException;
 
public class Main {
 
    public static void main(String[] args) throws IOException {
 
        try {
            // harmash قمنا بإنشاء هذا المتغير للإشارة إلى المسار الأساسي الذي سيوضع فيه المجلد
            String websitePath = "C:\\projects\\harmash\\";
 
            File harmashFolder = new File(websitePath);                 // الذي سننشئه لاحقاً harmash هنا قمنا بإنشاء كائن يشير لمسار المشروع
            File imagesFolder  = new File(websitePath + "images");      // harmash الذي سننشئه لاحقاً بداخل المجلد images هنا قمنا بإنشاء كائن يشير للمجلد
            File videosFolder  = new File(websitePath + "videos");      // harmash الذي سننشئه لاحقاً بداخل المجلد videos هنا قمنا بإنشاء كائن يشير للمجلد
            File pageFile      = new File(websitePath + "index.php");   // harmash الذي سننشئه لاحقاً بداخل المجلد index.php هنا قمنا بإنشاء كائن يشير للملف
 
            harmashFolder.mkdirs();      // harmash و بداخله المجلد project هنا قمنا بإنشاء المجلد
            imagesFolder.mkdir();        // videos هنا قمنا بإنشاء المجلد
            videosFolder.mkdir();        // images هنا قمنا بإنشاء المجلد
            pageFile.createNewFile();    // index.php هنا قمنا بإنشاء الملف
 
            System.out.println("c:\\projects\\harmash contain: ");
 
            // هنا قمنا بعرض جميع المجلدات و الملفات الموجودة في المشروع
            String[] paths = harmashFolder.list();
 
            for (String path:paths) {
                System.out.println("- " + path);
            }
        }
        catch(Exception e) {
            System.out.println("There is Exception!");
        }
 
    }

}
		

•سنحصل على النتيجة التالية عند التشغيل.

c:\projects\harmash contain:
- images
- index.php
- videos 
		

__________&&&______;&&&___________;

الكلاس InputStreamReader في جافا

الكلاس InputStreamReader يقرأ بيانات الملف كـ bytes و يحولهم لأحرف حسب الترميز الذي نقوم بتحديده في الكونستركتور.

الكلاس InputStreamReader يحتوي على الـ constructors المذكورين في الجدول التالي.

الكونستركتور مع تعريفه
public InputStreamReader(InputStream in) ينشئ كائن نوعه InputStreamReader يستخدم الترميز الإفتراضي.
public InputStreamReader(InputStream in, Charset cs) ينشئ كائن نوعه InputStreamReader يستخدم ترميز كائن الـ Charset
public InputStreamReader(InputStream in, CharsetDecoder dec) ينشئ كائن نوعه InputStreamReader يستخدم ترميز كائن الـ CharsetDecoder
public InputStreamReader(InputStream in, String charsetName) ينشئ كائن نوعه InputStreamReader يستخدم ترميز كائن الـ String

بعد أن يصبح كائن الـ InputStreamReader جاهزاً, يمكنك إستخدام الكثير من الدوال الجاهزة للقراءة من الملف أو لفعل أي شيء آخر.

الدالة مع تعريفها
public void close() throws IOException تغلق الـ InputStreamReader و تقطع الإتصال بين الـ Stream و أي مصدر كان متصلاً فيه.
public String getEncoding() ترجع إسم الترميز المستخدم من قبل كائن الـ InputStreamReader.
public int read() throws IOException في كل مرة تقرأ حرف جديد من أحرف الـ InputStreamReader و ترجعه. ترجع 1- إذا وصلت لنهاية الملف.
public int read(char[] cbuf, int offset, int length) throws IOException في كل مرة تستدعى فيها تقرأ مجموعة أحرف جديدة من الـ InputStreamReader و تخزنهم في المصفوفة cbuf. المتغير offset يقصد به من أي عنصر في المصفوفة cbuf سيكتب في الـ InputStreamReader. المتغير length يقصد به كم عنصر من عناصر المصفوفة cbuf سيكتب في الـ InputStreamReader.

مثال

•في هذا المثال سنقوم بإنشاء ملف جديد و كتابة نص صغير فيه, ثم سنقوم بقراءة النص من الملف.

Main.java

                    import java.io.FileInputStream;
                    import java.io.FileOutputStream;
                    import java.io.InputStreamReader;
                    import java.io.OutputStreamWriter;
                    import java.io.IOException;

                    public class Main {

                    public static void main(String[] args) {

                    try {
                    // يشير إلى الملف الذي سنكتب البيانات فيه و في حال لم يكن موجوداً, سيتم إنشاءه FileOutputStream هنا قمنا بإنشاء كائن نوعه
                    FileOutputStream fos = new FileOutputStream("c:\\MyFiles\\test.txt");

                    // للكتابة في الملف OutputStreamWriter هنا قمنا بإنشاء كائن نوعه
                    OutputStreamWriter osw = new OutputStreamWriter( fos, "UTF-16" );

                    // هنا قمنا بكتابة نص في الملف ثم قمنا بتفريغ الذاكرة و إغلاق الكائن المتصل بالملف
                    osw.write("الترميز" + " UTF-16 " + "يجعلك تخزن البيانات في جميع لغات العالم");
                    osw.flush();
                    osw.close();

                    // يشير إلى الملف الذي ستقرأ البيانات منه FileInputStream هنا قمنا بإنشاء كائن نوعه
                    FileInputStream fis = new FileInputStream("c:\\MyFiles\\test.txt");

                    // للقراءة من الملف InputStreamReader هنا قمنا بإنشاء كائن نوعه
                    InputStreamReader isr = new InputStreamReader( fis, "UTF-16" );

                    // هنا قمنا بإنشاء حلقة تمر على جميع أحرف الملف, في كل دورة تقرأ حرف من الملف ثم تعرضه و بعدها قمنا بإغلاق الكائن المتصل بالملف
                    int c;
                    while ((c = isr.read()) != -1) {
                    System.out.print((char)c);
                    }
                    isr.close();
                    }
                    catch(IOException e) {
                    System.out.println("There is IOException!");
                    }

                    }

                    }
                  

•سنحصل على النتيجة التالية عند التشغيل.

الترميز UTF-16 يجعلك تخزن البيانات في جميع لغات العالم

__________&&&______;&&&___________;

الكلاس FileReader في جافا

الكلاس FileReader يرث من الكلاسات InputStreamReader و Reader و هو يستخدم لقراءة Streams من الأحرف.

الكلاس FileReader يحتوي على الـ constructors المذكورين في الجدول التالي.

الكونستركتور مع تعريفه
public FileReader(File file) ينشئ كائن نوعه FileReader يستخدم للقراءة من كائن الـ File.
public FileReader(String fileName) ينشئ كائن نوعه FileReader يستخدم للقراءة من الملف الذي يشير إليه كائن الـ String.
public FileReader(FileDescriptor fd) ينشئ كائن نوعه FileReader يستخدم للقراءة من كائن الـ FileDescriptor.

بما أن الكلاس FileReader يرث من الكلاسات InputStreamReader و Reader, يمكنك إستدعاء الدوال التي سيرثها هذا الكائن من هذه الكلاسات.

مثال

•في هذا المثال سنقوم بإنشاء ملف جديد و كتابة نص صغير فيه, ثم سنقوم بقراءة النص من الملف.

Main.java

                    import java.io.FileReader;
                    import java.io.FileWriter;
                    import java.io.IOException;

                    public class Main {

                    public static void main(String[] args) {

                    try {
                    // لإنشاء ملف و الكتابة فيه لاحقاً FileWriter هنا قمنا بإنشاء كائن نوعه
                    FileWriter fw = new FileWriter("c:\\MyFiles\\test.txt");

                    // هنا قمنا بكتابة نص في الملف ثم قمنا بتفريغ الذاكرة و إغلاق الكائن المتصل بالملف
                    fw.write("first line.\nsecond line.\nthird line.");
                    fw.flush();
                    fw.close();

                    // يسمح بالقراءة من الملف fr يشير إلى الملف, إذا الكائن FileReader هنا قمنا بإنشاء كائن نوعه
                    FileReader fr = new FileReader("c:\\MyFiles\\test.txt");

                    // هنا قمنا بإنشاء حلقة تمر على جميع أحرف الملف, في كل دورة تقرأ حرف من الملف ثم تعرضه و بعدها قمنا بإغلاق الكائن المتصل بالملف
                    int c;
                    while ((c = fr.read()) != -1) {
                    System.out.print((char)c);
                    }
                    fr.close();
                    }
                    catch(IOException e) {
                    System.out.println("There is IOException!");
                    }

                    }

                    }
                  

•سنحصل على النتيجة التالية عند التشغيل.

                    first line.
                    second line.
                    third line. 
                  

__________&&&______;&&&___________;

الكلاس BufferedReader في جافا

الكلاس BufferedReader يقرأ أحرف كائن الـ InputStreamReader و يضعهم في الـ buffer. و هذا يوفر لك طرق عديدة لقراءة المحتوى من الـ buffer. مثل قراءته حرفاً حرفاً, أو تخزينه في مصفوفة, أو قراءته سطراً سطراً.

يمكنك تحديد حجم الـ buffer, أو استخدام الحجم الإفتراضي لها و الذي يعتبر جيداً في معظم الحالات.

الكلاس BufferedReader يحتوي على الـ constructors المذكورين في الجدول التالي.

الكونستركتور مع تعريفه
BufferedReader(Reader in) ينشئ كائن نوعه BufferedReader يستخدم حجم الـ buffer الإفتراضي.
BufferedReader(Reader in, int size) ينشئ كائن نوعه BufferedReader يستخدم حجم الـ buffer الذي نقوم بتحديده.

بعد أن يصبح كائن الـ BufferedReader جاهزاً, يمكنك إستخدام الكثير من الدوال الجاهزة للقراءة من الملف أو لفعل أي شيء آخر.

الدالة مع تعريفها
public void close() throws IOException تغلق الـ BufferedReader و تقطع الإتصال بين الـ Stream و أي مصدر كان متصلاً فيه.
public int read() throws IOException في كل مرة تقرأ حرف جديد من أحرف الـ BufferedReader و ترجعه. ترجع 1- إذا وصلت لنهاية الملف.
public int read(char[] cbuf, int offset, int length) throws IOException في كل مرة تستدعى فيها تقرأ مجموعة أحرف جديدة من الـ BufferedReader و تخزنهم في المصفوفة cbuf. المتغير offset يقصد به من أي عنصر في المصفوفة cbuf سيكتب في الـ BufferedReader. المتغير length يقصد به كم عنصر من عناصر المصفوفة cbuf سيكتب في الـ BufferedReader.
public String readLine() throws IOException في كل مرة تقرأ سطر جديد من أسطر الـ BufferedReader و ترجعه. ترجع null إذا وصلت لنهاية الملف. السطر يتعبر منتهياً إذا كان ينتهي بـ \n, أو بـ \r, أو بالإثنين مع بعض \n\r.
public long skip(long n) throws IOException تتخطى عدد من الأحرف الموجودة في الـ buffer. ثم ترجع عدد الأحرف التي تجاوزتها. المتغير N يقصد به عدد الأحرف التي سيتم تجاوزها عند القراءة من الـ buffer.

مثال

•في هذا المثال سنقوم بإنشاء ملف جديد و كتابة نص صغير فيه, ثم سنقوم بقراءة النص من الملف.

Main.java

                    import java.io.BufferedReader;
                    import java.io.BufferedWriter;
                    import java.io.FileInputStream;
                    import java.io.FileOutputStream;
                    import java.io.InputStreamReader;
                    import java.io.OutputStreamWriter;
                    import java.io.IOException;

                    public class Main {

                    public static void main(String[] args) {

                    try {
                    // يشير إلى الملف الذي سنكتب البيانات فيه و في حال لم يكن موجوداً, سيتم إنشاءه FileOutputStream هنا قمنا بإنشاء كائن نوعه
                    FileOutputStream fos = new FileOutputStream("c:\\MyFiles\\test.txt");

                    // BufferedWriter من أجل كائن الـ buffer لوضعه في الـ OutputStreamWriter هنا قمنا بإنشاء كائن نوعه
                    OutputStreamWriter osw = new OutputStreamWriter( fos, "UTF-16" );

                    // للكتابة في الملف BufferedWriter هنا قمنا بإنشاء كائن نوعه
                    BufferedWriter bw = new BufferedWriter(osw);

                    // هنا قمنا بكتابة نص في الملف ثم قمنا بتفريغ الذاكرة و إغلاق الكائن المتصل بالملف
                    bw.write("السطر الأول");
                    bw.newLine();
                    bw.write("السطر الثاني");
                    bw.flush();
                    bw.close();

                    // يشير إلى الملف الذي ستقرأ البيانات منه FileInputStream هنا قمنا بإنشاء كائن نوعه
                    FileInputStream fis = new FileInputStream("c:\\MyFiles\\test.txt");

                    // BufferedReader من أجل كائن الـ buffer لوضعه في الـ InputStreamReader هنا قمنا بإنشاء كائن نوعه
                    InputStreamReader isr = new InputStreamReader( fis, "UTF-16" );

                    // للقراءة من الملف BufferedReader هنا قمنا بإنشاء كائن نوعه
                    BufferedReader br = new BufferedReader(isr);

                    // هنا قمنا بإنشاء حلقة تمر على جميع أحرف الملف, في كل دورة تقرأ حرف من الملف ثم تعرضه و بعدها قمنا بإغلاق الكائن المتصل بالملف
                    int c;
                    while ((c = br.read()) != -1) {
                    System.out.print((char)c);
                    }
                    br.close();
                    }
                    catch(IOException e) {
                    System.out.println("There is IOException!");
                    }

                    }

                    }
                  

•سنحصل على النتيجة التالية عند التشغيل.

                    السطر الأول
                    السطر الثاني
                  

__________&&&______;&&&___________;

الكلاس OutputStreamWriter في جافا

الكلاس OutputStreamWriter يكتب الأحرف في الملف كـ bytes حسب الترميز الذي نقوم بتحديده في الكونستركتور.

الكلاس OutputStreamWriter يحتوي على الـ constructors المذكورين في الجدول التالي.

الكونستركتور مع تعريفه
public OutputStreamWriter(OutputStream out) ينشئ كائن نوعه OutputStreamWriter يستخدم الترميز الإفتراضي.
public OutputStreamWriter(OutputStream out, Charset cs) ينشئ كائن نوعه OutputStreamWriter يستخدم ترميز كائن الـ Charset.
public OutputStreamWriter(OutputStream out, CharsetEncoder enc) ينشئ كائن نوعه OutputStreamWriter يستخدم ترميز كائن الـ CharsetEncoder.
public OutputStreamWriter(OutputStream out, String charsetName) ينشئ كائن نوعه OutputStreamWriter يستخدم ترميز كائن الـ String.

بعد أن يصبح كائن الـ OutputStreamWriter جاهزاً, يمكنك إستخدام الكثير من الدوال الجاهزة للكتابة في الملف أو لفعل أي شيء آخر.

الدالة مع تعريفها
public void close() throws IOException تغلق الـ OutputStreamWriter و تقطع الإتصال بين الـ Stream و أي مصدر كان متصلاً فيه.
public void flush() throws IOException تضمن عدم بقاء أي بيانات في الذاكرة, و ترسل أي بيانات موجودة في الـ buffer إلى كائن الـ OutputStreamWriter. تستدعى دائماً قبل استدعاء الدالة close().
public String getEncoding() ترجع إسم الترميز المستخدم من قبل كائن الـ OutputStreamWriter.
public void write(int c) throws IOException تكتب الحرف الذي يعطى لها كـ argument في كائن الـ OutputStream.
public void write(char[] cbuf, int off, int len) throws IOException في كل مرة تستدعى فيها تكتب مجموعة أحرف من المصفوفة cbuf في كائن الـ OutputStream. المتغير off يقصد به من أي عنصر في المصفوفة cbuf سيكتب في كائن الـ OutputStream. المتغير len يقصد به كم عنصر من عناصر المصفوفة cbuf سيكتب في كائن الـ OutputStream.
public void write(String[] str, int off, int len) throws IOException في كل مرة تستدعى فيها تكتب مجموعة أحرف من النص str في كائن الـ OutputStream. المتغير off يقصد به من أي حرف في النص str سيكتب في كائن الـ OutputStream. المتغير len يقصد به كم حرف من أحرف النص str سيكتب في كائن الـ OutputStream.

مثال

•في هذا المثال سنقوم بإنشاء ملف جديد و كتابة نص صغير فيه, ثم سنقوم بقراءة النص من الملف.

Main.java

                    import java.io.FileInputStream;
                    import java.io.FileOutputStream;
                    import java.io.InputStreamReader;
                    import java.io.OutputStreamWriter;
                    import java.io.IOException;

                    public class Main {

                    public static void main(String[] args) {

                    try {
                    // يشير إلى الملف الذي سنكتب البيانات فيه و في حال لم يكن موجوداً, سيتم إنشاءه FileOutputStream هنا قمنا بإنشاء كائن نوعه
                    FileOutputStream fos = new FileOutputStream("c:\\MyFiles\\test.txt");

                    // للكتابة في الملف OutputStreamWriter هنا قمنا بإنشاء كائن نوعه
                    OutputStreamWriter osw = new OutputStreamWriter( fos, "UTF-16" );

                    // هنا قمنا بكتابة نص في الملف ثم قمنا بتفريغ الذاكرة و إغلاق الكائن المتصل بالملف
                    osw.write("الترميز" + " UTF-16 " + "يجعلك تخزن البيانات في جميع لغات العالم");
                    osw.flush();
                    osw.close();

                    // يشير إلى الملف الذي ستقرأ البيانات منه FileInputStream هنا قمنا بإنشاء كائن نوعه
                    FileInputStream fis = new FileInputStream("c:\\MyFiles\\test.txt");

                    // للقراءة من الملف InputStreamReader هنا قمنا بإنشاء كائن نوعه
                    InputStreamReader isr = new InputStreamReader( fis, "UTF-16" );

                    // هنا قمنا بإنشاء حلقة تمر على جميع أحرف الملف, في كل دورة تقرأ حرف من الملف ثم تعرضه و بعدها قمنا بإغلاق الكائن المتصل بالملف
                    int c;
                    while ((c = isr.read()) != -1) {
                    System.out.print((char)c);
                    }
                    isr.close();
                    }
                    catch(IOException e) {
                    System.out.println("There is IOException!");
                    }

                    }

                    }
                  

•سنحصل على النتيجة التالية عند التشغيل.

الترميز UTF-16 يجعلك تخزن البيانات في جميع لغات العالم

__________&&&______;&&&___________;

الكلاس FileWriter في جافا

الكلاس FileWriter يرث من الكلاسات OutputStreamWriter و Writer و هو يستخدم لكتابة نص في الملف.

الكلاس FileWriter يحتوي على الـ constructors المذكورين في الجدول التالي.

الكونستركتور مع تعريفه
public FileWriter(File file) ينشئ كائن نوعه FileWriter يستخدم للكتابة في كائن الـ File.
public FileWriter(File file, boolean append) ينشئ كائن نوعه FileWriter يستخدم للكتابة في كائن الـ File. في حال تم إعطاء true كقيمة للباراميتر append, سيضيف المحتوى الجديد في آخر المحتوى القديم. في حال تم إعطاء false كقيمة للباراميتر append, سيمسح المحتوى القديم و يضيف المحتوى الجديد.
public FileWriter(String fileName) ينشئ كائن نوعه FileWriter يستخدم للكتابة في الملف الذي يشير إليه كائن الـ String.
public FileWriter(String fileName, boolean append) ينشئ كائن نوعه FileWriter يستخدم للكتابة في الملف الذي يشير إليه كائن الـ String. في حال تم إعطاء true كقيمة للباراميتر append, سيضيف المحتوى الجديد في آخر المحتوى القديم. في حال تم إعطاء false كقيمة للباراميتر append, سيمسح المحتوى القديم و يضيف المحتوى الجديد.
public FileWriter(FileDescriptor fd) ينشئ كائن نوعه FileWriter يستخدم للكتابة في كائن الـ FileDescriptor.

بما أن الكلاس FileWriter يرث من الكلاسات InputStreamWriter و Writer, يمكنك إستدعاء الدوال التي سيرثها هذا الكائن من هذه الكلاسات.

مثال

•في هذا المثال سنقوم بإنشاء ملف جديد و كتابة نص صغير فيه, ثم سنقوم بقراءة النص من الملف.

Main.java

                    import java.io.FileReader;
                    import java.io.FileWriter;
                    import java.io.IOException;

                    public class Main {

                    public static void main(String[] args) {

                    try {
                    // لإنشاء ملف و الكتابة فيه لاحقاً FileWriter هنا قمنا بإنشاء كائن نوعه
                    FileWriter fw = new FileWriter("c:\\MyFiles\\test.txt");

                    // هنا قمنا بكتابة نص في الملف ثم قمنا بتفريغ الذاكرة و إغلاق الكائن المتصل بالملف
                    fw.write("first line.\nsecond line.\nthird line.");
                    fw.flush();
                    fw.close();

                    // يسمح بالقراءة من الملف fr يشير إلى الملف, إذا الكائن FileReader هنا قمنا بإنشاء كائن نوعه
                    FileReader fr = new FileReader("c:\\MyFiles\\test.txt");

                    // هنا قمنا بإنشاء حلقة تمر على جميع أحرف الملف, في كل دورة تقرأ حرف من الملف ثم تعرضه و بعدها قمنا بإغلاق الكائن المتصل بالملف
                    int c;
                    while ((c = fr.read()) != -1) {
                    System.out.print((char)c);
                    }
                    fr.close();
                    }
                    catch(IOException e) {
                    System.out.println("There is IOException!");
                    }

                    }

                    }
                  

•سنحصل على النتيجة التالية عند التشغيل.

                    first line.
                    second line.
                    third line.
                  

__________&&&______;&&&___________;

الكلاس BufferedWriter في جافا

الكلاس BufferedWriter يضع أحرف كائن الـ OutputStreamWirter في الـ buffer. و هذا يوفر لك طرق عديدة لكتابة محتوى الـ buffer في الملف. مثل كتابته حرفاً حرفاً, أو تخزينه في مصفوفة, أو كتابته سطراً سطراً.

يمكنك تحديد حجم الـ buffer, أو استخدام الحجم الإفتراضي لها و الذي يعتبر جيداً في معظم الحالات.

الكلاس BufferedWriter يحتوي على الـ constructors المذكورين في الجدول التالي.

الكونستركتور مع تعريفه
BufferedWriter(Writer out) ينشئ كائن نوعه BufferedWriter يستخدم حجم الـ buffer الإفتراضي.
BufferedWriter(Writer out, int size) ينشئ كائن نوعه BufferedWriter يستخدم حجم الـ buffer الذي نقوم بتحديده.

بعد أن يصبح كائن الـ BufferedWriter جاهزاً, يمكنك إستخدام الكثير من الدوال الجاهزة للكتابة في الملف أو لفعل أي شيء آخر.

الدالة مع تعريفها
public void close() throws IOException تغلق الـ BufferedWriter و تقطع الإتصال بين الـ Stream و أي مصدر كان متصلاً فيه.
public void flush() throws IOException تضمن عدم بقاء أي بيانات في الذاكرة, و ترسل أي بيانات موجودة في الـ buffer إلى كائن الـ BufferedWriter. تستدعى دائماً قبل استدعاء الدالة close().
public void newLine() throws IOException تكتب أحرف تمثل نهاية للسطر.
public void write(int c) throws IOException تكتب الحرف الذي يعطى لها كـ argument في كائن الـ BufferedWriter.
public void write(char[] cbuf, int off, int len) throws IOException في كل مرة تستدعى فيها تكتب مجموعة أحرف من المصفوفة cbuf في كائن الـ BufferedWriter. المتغير off يقصد به من أي عنصر في المصفوفة cbuf سيكتب في كائن الـ BufferedWriter. المتغير len يقصد به كم عنصر من عناصر المصفوفة cbuf سيكتب في كائن الـ BufferedWriter.
public void write(String[] str, int off, int len) throws IOException في كل مرة تستدعى فيها تكتب مجموعة أحرف من النص str في كائن الـ BufferedWriter. المتغير off يقصد به من أي حرف في النص str سيكتب في كائن الـ BufferedWriter. المتغير len يقصد به كم حرف من أحرف النص str سيكتب في كائن الـ BufferedWriter.

مثال

•في هذا المثال سنقوم بإنشاء ملف جديد و كتابة نص صغير فيه, ثم سنقوم بقراءة النص من الملف.

Main.java

                    import java.io.BufferedReader;
                    import java.io.BufferedWriter;
                    import java.io.FileInputStream;
                    import java.io.FileOutputStream;
                    import java.io.InputStreamReader;
                    import java.io.OutputStreamWriter;
                    import java.io.IOException;

                    public class Main {

                    public static void main(String[] args) {

                    try {
                    // يشير إلى الملف الذي سنكتب البيانات فيه و في حال لم يكن موجوداً, سيتم إنشاءه FileOutputStream هنا قمنا بإنشاء كائن نوعه
                    FileOutputStream fos = new FileOutputStream("c:\\MyFiles\\test.txt");

                    // BufferedWriter من أجل كائن الـ buffer لوضعه في الـ OutputStreamWriter هنا قمنا بإنشاء كائن نوعه
                    OutputStreamWriter osw = new OutputStreamWriter( fos, "UTF-16" );

                    // للكتابة في الملف BufferedWriter هنا قمنا بإنشاء كائن نوعه
                    BufferedWriter bw = new BufferedWriter(osw);

                    // هنا قمنا بكتابة نص في الملف ثم قمنا بتفريغ الذاكرة و إغلاق الكائن المتصل بالملف
                    bw.write("السطر الأول");
                    bw.newLine();
                    bw.write("السطر الثاني");
                    bw.flush();
                    bw.close();

                    // يشير إلى الملف الذي ستقرأ البيانات منه FileInputStream هنا قمنا بإنشاء كائن نوعه
                    FileInputStream fis = new FileInputStream("c:\\MyFiles\\test.txt");

                    // BufferedReader من أجل كائن الـ buffer لوضعه في الـ InputStreamReader هنا قمنا بإنشاء كائن نوعه
                    InputStreamReader isr = new InputStreamReader( fis, "UTF-16" );

                    // للقراءة من الملف BufferedReader هنا قمنا بإنشاء كائن نوعه
                    BufferedReader br = new BufferedReader(isr);

                    // هنا قمنا بإنشاء حلقة تمر على جميع أحرف الملف, في كل دورة تقرأ حرف من الملف ثم تعرضه و بعدها قمنا بإغلاق الكائن المتصل بالملف
                    int c;
                    while ((c = br.read()) != -1) {
                    System.out.print((char)c);
                    }
                    br.close();
                    }
                    catch(IOException e) {
                    System.out.println("There is IOException!");
                    }

                    }

                    }
                  

•سنحصل على النتيجة التالية عند التشغيل.

                    السطر الأول
                    السطر الثاني
                  

__________&&&______;&&&___________;

الكلاس FileInputStream في جافا

يستخدم هذا الكلاس لقراءة البيانات من الملفات. و هو يحتوي على أكثر من كونستركتور.

الكونستركتور التالي نمرر له إسم الملف كـ String لإنشاء كائن الـ InputStream و الذي من خلاله يمكن قراءة الملف. مثال:

                  InputStream is = new FileInputStream("C://MyFiles//test.txt")
                

الكونستركتور التالي نمرر له كائن نوعه File لإنشاء كائن الـ InputStream و الذي من خلاله يمكن قراءة الملف. يجب إنشاء كائن الـ File قبله. مثال:

                  File f = new File("C://MyFiles//test.txt")
                  InputStream is = new FileInputStream(f);
                

بعد أن يصبح كائن الـ InputStream جاهزاً, يمكنك إستخدام الكثير من الدوال الجاهزة لقراءة الملف أو لفعل أي شيء آخر.

الدالة مع تعريفها
public void close() throws IOException تغلق الـ InputStream و تقطع الإتصال بين الـ Stream و أي مصدر كان متصلاً فيه.
public int read() throws IOException في كل مرة تقرأ byte جديدة من بيانات الـ InputStream و ترجعها كقيمة نوعها int بين 255-0. ترجع 1- إذا وصلت لنهاية الملف.
public int read(byte[] b) throws IOException تقرأ مجموعة جديدة من الـ bytes من بيانات الـ InputStream في كل مرة تستدعى فيها و تخزنهم في المصفوفة b و ترجعها كـ int. ترجع 1- إذا وصلت لنهاية الملف.
public int available() throws IOException ترجع عدد الـ bytes الذي يمكن قراءتهم من الـ InputStream و ترجع 0 عند الوصول لنهاية الملف.

مثال

•في هذا المثال سنقوم بإنشاء ملف جديد و كتابة بعض البيانات فيه, ثم سنقوم بقراءة هذه البيانات من الملف.

Main.java

                    import java.io.InputStream;
                    import java.io.OutputStream;
                    import java.io.FileInputStream;
                    import java.io.FileOutputStream;
                    import java.io.IOException;

                    public class Main {

                    public static void main(String[] args) {

                    try {
                    // لخلق ملف جديد و الذي سنكتب قيم المصفوفة فيه OutputStream هنا قمنا بإنشاء مصفوفة, و قمنا بإنشاء كائن نوعه
                    byte[] bytes = {1, 2, 3, 4, 5, 6, 7, 8, 9, 10};
                    OutputStream os = new FileOutputStream("test.txt");

                    // هنا قمنا بكتابة قيم المصفوفة في الملف
                    for (int i=0; i<bytes.length; i++) {
                    os.write( bytes[i] );
                    }
                    os.close();

                    // و الذي سنقرأ بواسطته محتوى الملف InputStream هنا قمنا بإنشاء كائن نوعه
                    InputStream is = new FileInputStream("test.txt");

                    // size الموجودين في الملف في المتغير bytes هنا قمنا بتخزين عدد الـ
                    int size = is.available();

                    // موجودة في الملف byte هنا قمنا بقراءة و عرض كل
                    for (int i=0; i<size; i++) {
                    System.out.print( is.read() + " " );
                    }
                    is.close();
                    }
                    catch(IOException e) {
                    System.out.println("There is IOException!");
                    }

                    }

                    }
                  

•سنحصل على النتيجة التالية عند التشغيل.

                    1 2 3 4 5 6 7 8 9 10
                  

__________&&&______;&&&___________;

الكلاس ByteArrayInputStream في جافا

الكلاس ByteArrayInputStream يسمح باستخدام الـ buffer في الذاكرة كـ InputStream. و هو يقرأ البيانات من المصدر كمصفوفة نوعها byte.

الكلاس ByteArrayInputStream يحتوي على الـ constructors المذكورين في الجدول التالي.

الكونستركتور مع تعريفه
public ByteArrayInputStream(byte[] buf) يقبل مصفوفة نوعها byte كـ argument. المصفوفة buf هي التي ستوضع كما هي في الـ buffer.
public ByteArrayInputStream(byte[] buf, int off, int len) يأخذ مصفوفة من الـ bytes, و متغيرين آخرين نوعهما int. المتغير off يقصد به من أي عنصر في المصفوفة buf سيكتب في الـ buffer. المتغير len يقصد به كم عنصر من عناصر المصفوفة buf سيكتب في الـ buffer.

بعد أن يصبح كائن الـ ByteArrayInputStream جاهزاً, يمكنك إستخدام الكثير من الدوال الجاهزة لقراءة الملف أو لفعل أي شيء آخر.

الدالة مع تعريفها
public int read() في كل مرة تستدعى فيها تقرأ byte جديدة من بيانات الـ InputStream و ترجعها كقيمة نوعها int بين 255-0. و ترجع 1- إذا وصلت لنهاية الملف.
public int read(byte[] b, int off, int len) في كل مرة تستدعى فيها تقرأ مجموعة bytes جديدة من بيانات الـ InputStream و تخزنهم في المصفوفة b. المتغير off يقصد به من أي عنصر في المصفوفة b سيكتب في الـ InputStream. المتغير len يقصد به كم عنصر من عناصر المصفوفة b سيكتب في الـ InputStream.
public int available() ترجع عدد الـ bytes الذي يمكن قراءتهم من الـ InputStream و ترجع 0 عند الوصول لنهاية الملف.

__________&&&______;&&&___________;

الكلاس DataInputStream في جافا

الكلاس DataInputStream يستخدم لقراءة البيانات البدائية primitive data types من ملف معين.

الكونستركتور التالي ينشئ كائن DataInputStream و الذي من خلاله يمكن قراءة الملف. مثال:

                  InputStream in = new DataInputStream(InputStream in)
                

بعد أن يصبح كائن الـ InputStream جاهزاً, يمكنك إستخدام الكثير من الدوال الجاهزة لقراءة الملف أو لفعل أي شيء آخر.

الدالة مع تعريفها
public final int read() throws IOException في كل مرة تستدعى فيها تقرأ بعض الـ bytes من بيانات الـ InputStream و تخزنهم في المصفوفة b ثم ترجع عدد البيانات الذي قرأته. ترجع 1- إذا وصلت لنهاية الملف.
public final int read(byte[] b, int off, int len) throws IOException في كل مرة تستدعى فيها تقرأ مجموعة bytes جديدة من بيانات الـ InputStream و تخزنهم في المصفوفة b. المتغير off يقصد به من أي عنصر في المصفوفة b سيكتب في الـ InputStream. المتغير len يقصد به كم عنصر من عناصر المصفوفة b سيكتب في الـ InputStream.
public String readLine() throws IOException في كل مرة تستدعى فيها تقرأ بيانات سطر جديد من الـ InputStream. تقرأ الـ bytes بالترتيب الموجودين فيه مع تحويل كل byte بشكل منفصل إلى حرف. في الأخير ترجع الأحرف التي قرأتها كـ String.
public final boolean readBoolean() throws IOException في كل مرة تستدعى فيها تقرأ 1 byte من الـ InputStream. و ترجعها كـ boolean.
public final byte readByte() throws IOException في كل مرة تستدعى فيها تقرأ 1 byte من الـ InputStream. و ترجعها كـ byte.
public final char readChar() throws IOException في كل مرة تستدعى فيها تقرأ 2 bytes من الـ InputStream. و ترجعهم كـ short.
public final int readInt() throws IOException في كل مرة تستدعى فيها تقرأ 4 bytes من الـ InputStream. و ترجعهم كـ int.

مثال

•في هذا المثال سنقوم بإنشاء ملف جديد و كتابة نص صغير فيه, ثم سنقوم بقراءة النص من الملف.

Main.java

                    import java.io.DataInputStream;
                    import java.io.DataOutputStream;
                    import java.io.FileInputStream;
                    import java.io.FileOutputStream;
                    import java.io.IOException;

                    public class Main {

                    public static void main(String[] args) throws IOException {

                    // UTF-8 ملاحظة هنا يعتمد الترميز .fis من خلال الكائن DataOutputStream هنا قمنا بإنشاء كائن نوعه
                    DataOutputStream dos = new DataOutputStream(new FileOutputStream("C:\\myFiles\\example.txt"));

                    // هنا قمنا بكتابة نص في الملف
                    dos.writeUTF("harmash.com" + "\n" + "أفضل موقع عربي لتعلم البرمجة");

                    // UTF-8 ملاحظة هنا يعتمد الترميز .dos من خلال الكائن DataInputStream هنا قمنا بإنشاء كائن نوعه
                    DataInputStream dis = new DataInputStream(new FileInputStream("C:\\myFiles\\example.txt"));

                    // هنا قمنا بقراءة محتوى الملف ثم عرضه
                    while (dis.available()>0) {
                    String k = dis.readUTF();
                    System.out.print(k);
                    }

                    }

                    }
                  

•سنحصل على النتيجة التالية عند التشغيل.

                    harmash.com
                    أفضل موقع عربي لتعلم البرمجة 
                  

__________&&&______;&&&___________;

الكلاس FileOutputStream في جافا

يستخدم هذا الكلاس لإنشاء ملف جديد و كتابة البيانات فيه.
في حال وجود ملف يحمل نفس الإسم و النوع في نفس المسار الموضوع للـ OutputStream, سيتم تبديل الملف القديم بملف الـ OutputStreamالجديد.

يحتوي هذا الكلاس على أكثر من كونستركتور.

الكونستركتور التالي نمرر له إسم الملف كـ String لإنشاء كائن الـ OutputStream و الذي من خلاله يمكن قراءة الملف. مثال:

                  OutputStream is = new FileOutputStream("C://MyFiles//test.txt")
                

الكونستركتور التالي نمرر له كائن نوعه File لإنشاء كائن الـ OutputStream و الذي من خلاله يمكن قراءة الملف. يجب إنشاء كائن الـ File قبله. مثال:

                  File f = new File("C://MyFiles//test.txt")
                  OutputStream is = new FileOutputStream(f); 
                

بعد أن يصبح كائن الـ OutputStream جاهزاً, يمكنك إستخدام الكثير من الدوال الجاهزة لقراءة الملف أو لفعل أي شيء آخر.

الدالة مع تعريفها
public void close() throws IOException تغلق الـ OutputStream و تقطع الإتصال بين الـ Stream و أي مصدر كان متصلاً فيه.
public abstract write(int b) throws IOException تكتب الـ byte التي تمرر لها كـ argumentفي الـ OutputStream.
public int write(byte[] b) throws IOException تكتب مجموعة الـ bytes الموجودين في المصفوفة b في الـ OutputStream.
public int wirte(byte[] b, int off, int len) throws IOException تكتب مجموعة من الـ bytes الموجودين في المصفوفة b في الـ OutputStream. المتغير off يقصد به من أي عنصر في المصفوفة b سيكتب في الـ OutputStream. المتغير len يقصد به كم عنصر من عناصر المصفوفة b سيكتب في الـ OutputStream.

مثال

•في هذا المثال سنقوم بإنشاء ملف جديد و كتابة بعض البيانات فيه, ثم سنقوم بقراءة هذه البيانات من الملف.

Main.java

                    import java.io.InputStream;
                    import java.io.OutputStream;
                    import java.io.FileInputStream;
                    import java.io.FileOutputStream;
                    import java.io.IOException;

                    public class Main {

                    public static void main(String[] args) {

                    try {
                    // لخلق ملف جديد و الذي سنكتب قيم المصفوفة فيه OutputStream هنا قمنا بإنشاء مصفوفة, و قمنا بإنشاء كائن نوعه
                    byte[] bytes = {1, 2, 3, 4, 5, 6, 7, 8, 9, 10};
                    OutputStream os = new FileOutputStream("test.txt");

                    // هنا قمنا بكتابة قيم المصفوفة في الملف
                    for (int i=0; i<bytes.length; i++) {
                    os.write( bytes[i] );
                    }
                    os.close();

                    // و الذي سنقرأ بواسطته محتوى الملف InputStream هنا قمنا بإنشاء كائن نوعه
                    InputStream is = new FileInputStream("test.txt");

                    // size الموجودين في الملف في المتغير bytes هنا قمنا بتخزين عدد الـ
                    int size = is.available();

                    // موجودة في الملف byte هنا قمنا بقراءة و عرض كل
                    for (int i=0; i<size; i++) {
                    System.out.print( is.read() + " " );
                    }
                    is.close();
                    }
                    catch(IOException e) {
                    System.out.println("There is IOException!");
                    }

                    }

                    }
                  

•سنحصل على النتيجة التالية عند التشغيل.

                    1 2 3 4 5 6 7 8 9 10
                  

__________&&&______;&&&___________;

الكلاس ByteArrayOutputStream في جافا

الكلاس ByteArrayOutputStream ينشئ buffer في الذاكرة لتخزين بيانات الـ Stream فيها قبل إرسالها للـ OutputStream.

الكلاس ByteArrayOutputStream يحتوي على الـ constructors المذكورين في الجدول التالي.

الكونستركتور مع تعريفه
public ByteArrayOutputStream() ينشئ كائن ByteArrayOutputStream يملك buffer تتألف من 32 bytes.
public ByteArrayOutputStream(int bufSize) ينشئ كائن ByteArrayOutputStream يملك buffer تتألف من الحجم الذي تدخله له.

بعد أن يصبح كائن الـ ByteArrayOutputStream جاهزاً, يمكنك إستخدام الكثير من الدوال الجاهزة لقراءة الملف أو لفعل أي شيء آخر.

الدالة مع تعريفها
public int reset() تستخدم لتصفير الـ buffer ( أي لمسح جميع البيانات الموجودة فيها ), أي سيتم مسح جميع البيانات الموجودة في كائن ByteArrayOutputStream.
public byte toByteArray() تنشئ مصفوفة جديدة نوعها byte, حجمها يساوي حجم الـ ByteArrayOutputStream و المحتوى الموجود في الـ Buffer يتم نسخه فيها. ترجع محتوى الـ ByteArrayOutputStream كمصفوفة نوعها byte.
public String toString() تحول محتوى الـ buffer لقيمة String. يتم تحويل القيمة هنا حسب الترميز المستخدم.
public void write(int b) تكتب الـ byte التي تعطى لها كـ argument في الـ ByteArrayOutputStream.
public void write(byte[] b, int off, int len) في كل مرة تستدعى فيها تكتب مجموعة bytes من المصفوفة b في الـ OutputStream. المتغير off يقصد به من أي عنصر في المصفوفة b سيكتب في الـ OutputStream. المتغير len يقصد به كم عنصر من عناصر المصفوفة b سيكتب في الـ OutputStream.
public void write(OutputStream out) throws IOException تكتب محتوى كائن الـ OutputStream الذي قام باستدعائها في كائن الـ OutputStream الذي يعطى لها كـ argument.

__________&&&______;&&&___________;

الكلاس DataOutputStream في جافا

الكلاس DataOutputStream يستخدم لكتابة البيانات البدائية primitive data types في ملف معين.

الكونستركتور التالي ينشئ كائن DataOutputStream و الذي من خلاله يمكن قراءة الملف. مثال:

                  OutputStream in = new DataOutputStream(OutputStream ou)
                

بعد أن يصبح كائن الـ OutputStream جاهزاً, يمكنك إستخدام الكثير من الدوال الجاهزة لقراءة الملف أو لفعل أي شيء آخر.

الدالة مع تعريفها
public final int write(int b) تكتب الـ byte التي تعطى لها كـ argument في كائن الـ OutputStream. ترجع عدد الـ bytes الذي تم كتابته في الـ buffer.
public final void write(byte[] b, int off, int len) في كل مرة تستدعى فيها تكتب مجموعة bytes من المصفوفة b في كائن الـ OutputStream. المتغير off يقصد به من أي عنصر في المصفوفة b سيكتب في كائن الـ OutputStream. المتغير len يقصد به كم عنصر من عناصر المصفوفة b سيكتب في كائن الـ OutputStream.
public final void writeBoolean() throws IOException في كل مرة تستدعى فيها تكتب قيمة boolean تتألف من 1 byte في كائن الـ OutputStream.
public final void writeByte() throws IOException في كل مرة تستدعى فيها تكتب قيمة byte تتألف من 1 byte في كائن الـ OutputStream.
public final void writeChar() throws IOException في كل مرة تستدعى فيها تكتب قيمة char تتألف من 2 bytes في كائن الـ OutputStream.
public final void writeInt() throws IOException في كل مرة تستدعى فيها تكتب قيمة int يتم كتابتها كـ 4 bytes في كائن الـ OutputStream.
public void flush() throws IOException تضمن كتابة جميع البيانات الموجودة في الـ buffer في كائن الـ OutputStream ثم تقوم بمسح جميع البيانات من الـ buffer.

مثال

•في هذا المثال سنقوم بإنشاء ملف جديد و كتابة نص صغير فيه, ثم سنقوم بقراءة النص من الملف.

Main.java

                    import java.io.DataInputStream;
                    import java.io.DataOutputStream;
                    import java.io.FileInputStream;
                    import java.io.FileOutputStream;
                    import java.io.IOException;

                    public class Main {

                    public static void main(String[] args) throws IOException {

                    // UTF-8 ملاحظة هنا يعتمد الترميز .fis من خلال الكائن DataOutputStream هنا قمنا بإنشاء كائن نوعه
                    DataOutputStream dos = new DataOutputStream(new FileOutputStream("C:\\myFiles\\example.txt"));

                    // هنا قمنا بكتابة نص في الملف
                    dos.writeUTF("harmash.com" + "\n" + "أفضل موقع عربي لتعلم البرمجة");

                    // UTF-8 ملاحظة هنا يعتمد الترميز .dos من خلال الكائن DataInputStream هنا قمنا بإنشاء كائن نوعه
                    DataInputStream dis = new DataInputStream(new FileInputStream("C:\\myFiles\\example.txt"));

                    // هنا قمنا بقراءة محتوى الملف ثم عرضه
                    while (dis.available()>0) {
                    String k = dis.readUTF();
                    System.out.print(k);
                    }

                    }

                    }
                  

•سنحصل على النتيجة التالية عند التشغيل.

                    harmash.com
                    أفضل موقع عربي لتعلم البرمجة 
                  

__________&&&______;&&&___________;

الكلاس File في جافا

الكلاس File يمثل جميع أنواع الملفات و المجلدات و المسارات.
يستخدم هذا الكلاس لفحص الملفات, المجلدات, البحث عن ملفات, مسح ملفات إلخ..

كائن الـ File الذي تقوم بإنشاءه, يمثل ملف أو مجلد معين موجود في الجهاز.

الكلاس File يحتوي على الـ constructors المذكورين في الجدول التالي.

الكونستركتور مع تعريفه
public File(File parent, String child) ينشئ كائن جديد من الـ File الموجود في المسار parent, و الذي إسمه child.
public File(String pathname) ينشئ كائن جديد من الـ File الذي يشير إليه الـ pathname.
public File(String parent, String child) ينشئ كائن جديد من الـ File الموجود في المسار parent, و الذي إسمه child.
public File(URI uri) ينشئ كائن جديد من الـ File الذي يشير إليه الـ uri.

بعد أن يصبح كائن الـ File جاهزاً, يمكنك إستخدام الكثير من الدوال الجاهزة لقراءة الملف أو لفعل أي شيء آخر.

الدالة مع تعريفها
public String getName() ترجع إسم الملف أو المجلد الذي يشير إليه مسار كائن الـ File الذي قام باستدعائها.
public String getParent() ترجع المسار الأب للملف أو المجلد الذي يشير إليه كائن الـ File الذي قام باستدعائها كـ String. أو ترجع null إذا كان المسار الموضوع غير موجود.
public File getParent() ترجع المسار الأب للملف أو المجلد الذي يشير إليه كائن الـ File الذي قام باستدعائها كـ File. أو ترجع null إذا كان المسار الموضوع غير موجود.
public String getPath() تحول المسار الذي يشير إليه كائن الـ File الذي قام باستدعائها إلى String.
public boolean isAbsolute() تختبر المسار الذي يشير إليه كائن الـ File الذي قام باستدعائها لمعرفة إذا كان absolute أم لا. ترجع true إذا كان absolute و ترجع false إذا لم يكن كذلك.
public String getAbsolutePath() ترجع المسار الـ absolute للمسار الذي يشير إليه كائن الـ File الذي قام باستدعائها.
public boolean canRead() تختبر إذا كان البرنامج يقدر أن يقرأ من الملف الذي يشير إليه كائن الـ File الذي قام باستدعائها. ترجع true إذا كان الملف موجود و يمكن قراءته. غير ذلك ترجع false.
public boolean canWrite() تختبر إذا كان البرنامج يقدر أن يكتب في الملف الذي يشير إليه كائن الـ File الذي قام باستدعائها. ترجع true إذا كان الملف موجود و يمكن الكتابة فيه. غير ذلك ترجع false.
public boolean exist() تختبر إذا كان الملف أو المجلد الذي يشير إليه كائن الـ File الذي قام باستدعائها موجوداً أم لا. ترجع true إذا كان الملف موجود. غير ذلك ترجع false.
public boolean isFile() تختبر إذا كان الملف الذي يشير إليه كائن الـ File الذي قام باستدعائها هو ملف عادي (normal file) أم لا. ملف عادي تعني ليس مجلد, أي ليس directory. أي ملف عادي تم إنشائه من خارج تطبيقات جافا يعتبر مباشرةً ملف عادي. ترجع true إذا كان الملف موجود و إذا لم يكن directory. غير ذلك ترجع false.
public boolean isDirectory() تختبر إذا كان الملف الذي يشير إليه كائن الـ File الذي قام باستدعائها هو مجلد (directory) أم لا. ترجع true إذا كان الملف موجود و إذا كان directory. غير ذلك ترجع false.
public long lastModified() ترجع وقت آخر مرة تم فيها تعديل الملف الذي يشير إليه كائن الـ File الذي قام باستدعائها. الوقت الذي ترجعه هو وقت بالـ milliseconds منذ ( 1/1/1970 00:00:00 GMT ), أو ترجع 0L إذا كان الملف غير موجود أو في حال حدوث أي خطأ.
public long length() ترجع طول الملف الذي يشير إليه مسار كائن الـ File الذي قام باستدعائها بالـ bytes. و ترجع 0L إذا لم يكن الملف موجود أو إذا كان المسار يشير إلى مجلد.
public boolean createNewFile() throws IOException تنشئ ملف جديد فارغ في المسار الذي يشير إليه كائن الـ File في حال كان لا يشير إلى ملف موجود أصلاً. ترجع true إذا كان الملف غير موجود و إذا تم إنشاءه بنجاح. غير ذلك ترجع false.
public boolean delete() تمسح الملف أو المجلد الذي يشير إليه كائن الـ File الذي قام باستدعائها. إذا كان المجلد فارغاً يجب أن يكون فارغاً حتى يتم مسحه. ترجع true إذا تم مسح الملف أو المجلد. غير ذلك ترجع false.
public void deleteOnExit() ترسل طلب إلى الـ JVM يقضي بمسح الملف أو المجلد الذي يشير إليه كائن الـ File الذي قام باستدعائها عند الإنتهاء من تنفيذ أوامر البرنامج.
public String[] list() ترجع مصفوفة نوعها String تحتوي على أسماء الملفات و المجلدات الموجودة في المسار الذي يشير إليه كائن الـ File الذي قام باستدعائها.
public File[] listFiles() ترجع مصفوفة نوعها File تحتوي على مسارات جميع الملفات و المجلدات الموجودة في المسار الذي يشير إليه المجلد الذي يشير إليه كائن الـ File الذي قام باستدعائها.
public boolean mkdir() تنشئ مجلد في المسار الذي يشير إليه كائن الـ File. ترجع true إذا تم إنشاء الملف. غير ذلك ترجع false.
public boolean mkdirs() تنشئ مجلد في المسار الذي يشير إليه كائن الـ File الذي قام باستدعائها. هنا في حال كان المسار الموضوع غير موجود ستقوم هي بإنشاءه. أي ستنشئ جميع المجلدات الموضوعة في المسار. ترجع true إذا تم إنشاء الملف. غير ذلك ترجع false.
public boolean renameTo(File dest) تستخدم لإعطاء إسم جديد للملف الذي يشير إليه كائن الـ File الذي قام باستدعائها. الإسم الذي يعطى للكائن dest هو الإسم الجديد الذي سيعطى للملف. ترجع true إذا تمت العملية بنجاح. غير ذلك ترجع false.
public boolean setLastModified(long time) تستخدم لتغيير آخر وقت تم فيه تعديل الملف يشير إليه كائن الـ File الذي قام باستدعائها. ترجع true إذا تمت العملية بنجاح. غير ذلك ترجع false.
public boolean setReadOnly(long time) تستخدم لجعل الملف الذي يشير إليه كائن الـ File الذي قام باستدعائها يملك صلاحية الـ read only. هذه الصلاحية تمنع أي عملية تعديل أو كتابة في الملف و تسمح فقط بقراءة محتواه. ترجع true إذا تمت العملية بنجاح. غير ذلك ترجع false.
public static File createTempFile(String prefix, String suffix, File directory) throws IOException تستخدم لإنشاء ملف مؤقت, أي ملف يتم مسحه تلقائياً عند إنتهاء الـ JVM من تنفيذ أوامر البرنامج. prefix هو إسم الملف الذي سيتم إنشاءه, suffix هو نوع الملف الذي سيتم إنشاءه. directory هو الذي سيتم إنشاء الملف فيه. ترجع مسار الملف الذي تم إنشاءه.
public static File createTempFile(String prefix, String suffix) throws IOException تستخدم لإنشاء ملف مؤقت, أي ملف يتم مسحه تلقائياً عند إنتهاء الـ JVM من تنفيذ أوامر البرنامج. الملف هنا يتم إنشاءه في المكان الذي تحفظ فيه الملفات الإفتراضية على الجهاذ. prefix هو إسم الملف الذي سيتم إنشاءه, suffix هو نوع الملف الذي سيتم إنشاءه. ترجع مسار الملف الذي تم إنشاءه.
public int compareTo(File pathname) تقارن أحرف مسارين مع بعض. أي مسار الكائن الذي قام باستدعاءها مع مسار الكائن pathname. ترجع 0 إذا كان مسار الكائن الذي قام باستدعاءها يساوي مسار الكائن pathname. ترجع عدد أصغر من 0 إذا كان مسار الكائن الذي قام باستدعاءها أكبر من مسار الكائن pathname. ترجع عدد أكبر من 0 إذا كان مسار الكائن الذي قام باستدعاءها أصغر من مسار الكائن pathname.
public int compareTo(Object obj) تقارن أحرف مسارين مع بعض. أي مسار الكائن الذي قام باستدعاءها مع مسار أي كائن نضعه كـ argument. ترجع 0 إذا كان مسار الكائن الذي قام باستدعاءها يساوي مسار الكائن obj. ترجع عدد أصغر من 0 إذا كان مسار الكائن الذي قام باستدعاءها أكبر من مسار الكائن obj. ترجع عدد أكبر من 0 إذا كان مسار الكائن الذي قام باستدعاءها أصغر من مسار الكائن obj.
public boolean equals(Object obj) تختبر الكائن الذي قام باستدعاءها مع أي كائن نضعه كـ argument. ترجع true إذا كانت قيمة الكائنين لا تساوي null و إذا كان الكائنين عندهم نفس المسار سواء كان يشير إلى ملف أو إلى مجلد. غير ذلك ترجع false.
public String toString() ترجع إسم الملف أو المجلد الذي يشير إليه مسار كائن الـ File الذي قام باستدعائها كـ String. و هي مثل الدالة getPath().

مثال

•في هذا المثال سنقوم بإنشاء كائن نوعه File يشير إلى ملف معين, ثم سنعرض فقط بعض خصائص هذا الملف.

Main.java

                    import java.io.File;

                    public class Main {

                    public static void main(String[] args) {

                    // File هنا قمنا بإنشاء كائن نوعه
                    File f = null;

                    try {

                    // f هنا قمنا بتحديد الملف الذي يشير إليه الكائن
                    f = new File("C:\\MyFiles\\input.txt");

                    // يشير إلى ملف أو مجلد موجود سيتم عرض جميع خصائصه f هنا قلنا إذا كان الكائن
                    if(f.exists()) {
                    System.out.println("File name:              " +f.getName());
                    System.out.println("File length:            " +f.length());
                    System.out.println("File parent path:       " +f.getParent());
                    System.out.println("File absolute path:     " +f.getAbsolutePath());
                    System.out.println("File read permission:   " +f.canRead());
                    System.out.println("File write permission:  " +f.canWrite());

                    // يشير إلى مجلد, سيتم عرض جميع الأشياء الموجودة بداخله f هنا قلنا إذا كان الكائن
                    if (f.isDirectory()) {
                    System.out.println("\n" +f.getName()+ " contains:");
                    File files[] = f.listFiles();
                    for(int i=0; i<files.length; i++) {
                    System.out.println((i+1)+") "+files[i].getName());
                    }
                    }
                    }
                    // لا يشير لأي ملف أو مجلد موجود سيعرض أن الملف غير موجود f هنا قلنا إذا كان الكائن
                    else {
                    System.out.println("File not exists!");
                    }

                    }
                    catch(Exception e) {
                    System.out.println("There is Exception!");
                    }

                    }

                    }
                  

•سنحصل على نتيجة تشبه النتيجة التالية عند التشغيل.

                    File name:              input.txt
                    File length:            70
                    File parent path:       C:\MyFiles
                    File absolute path:     C:\MyFiles\input.txt
                    File read permission:   true
                    File write permission:  true 
                  

•في حال قمنا بتغيير مسار الكائن f لجعله يشير إلى المجلد MyFiles, سنحصل على النتيجة التالية عند التشغيل.

                    File name:              MyFiles
                    File length:            4096
                    File parent path:       C:\
                    File absolute path:     C:\MyFiles
                    File read permission:   true
                    File write permission:  true

                    MyFiles contains:
                    1) input.txt
                    2) intro.MP4
                    3) hacker song.MP3
                    4) output.txt
                    5) folder 1
                    6) folder 2 
                  

دورة تعلم الجافا

1- أساسيات اللغة

Java - نظرة عامة
Java - تهيئة بيئة التطوير
Java - أساسيات لغة جافا
Java - أسلوب الكتابة
Java - أول برنامج لك
Java - أنواع البيانات
Java - المتغيرات
Java - الدوال
Java - العوامل
العوامل التي تستخدم لإعطاء قيم للمتغيرات (Assignment Operators) في جافا
العوامل التي تستخدم للتعامل مع الـ bits (Bitwise Operators) في جافا
العوامل التي تستخدم في وضع شروط منطقية (Logical Operators) في جافا
العوامل التي تستخدم في المقارنات (Comparison Operators) في جافا
Java - الحلقات
Java - الشروط
Java - الأعداد
Java - الأحرف
Java - النصوص
Java - دوال المقارنة الموجودة في الكلاس String
Java - دوال التبديل الموجودة في الكلاس String
Java - دوال التجزيء الموجودة في الكلاس String
Java - المصفوفات
Java - التاريخ و الوقت
Java - التعابير النمطية
Java - الإستثناءات

2-برمجة الكائنات

Class and Object - Java
Modifiers - Java
Encapsulation - Java
Inheritance - Java
Overriding - Java
Overloading - Java
Type Casting - Java
Abstraction - Java
Interfaces - Java
Polymorphism - Java
Nested Classes - Java
Enum - Java

3-برمجة متقدمة

Java - إدخال البيانات
Java - التعامل مع الملفات
Java - المزامنة
Data Structure - Java
Collection - Java
Generics - Java
Java - الشبكات
Java - تعدد المهام
Java - قواعد البيانات
Lambda Expressions - Java

تعديل المقال