اعتبارًا من 27 آذار (مارس) 2025، ننصحك باستخدام android-latest-release بدلاً من aosp-main لإنشاء AOSP والمساهمة فيه. لمزيد من المعلومات، يُرجى الاطّلاع على التغييرات في AOSP.

تمت ترجمة هذه الصفحة بواسطة Cloud Translation API‏.

FileUtil

public class FileUtil
extends Object

java.lang.Object
↳	com.android.tradefed.util.FileUtil

فئة مساعدة للعمليات ذات الصلة بالملفات

ملخّص

الفئات المُدمجة
`class`	`FileUtil.LowDiskSpaceException` يتم طرحه إذا كانت مساحة القرص القابلة للاستخدام أقل من الحد الأدنى.

الثوابت
`int`	`FILESYSTEM_FILENAME_MAX_LENGTH`

وظائف الإنشاء العامة
`FileUtil()`

الطرق العامة
`static String`	`calculateBase64Md5(File file)` طريقة مساعدة لاحتساب md5 base64 لملف.
`static long`	`calculateCrc32(File file)` طريقة مساعدة لاحتساب CRC-32 لملف.
`static String`	`calculateMd5(File file)` طريقة مساعدة لاحتساب md5 لملف.
`static boolean`	`chmod(File file, String perms)`
`static boolean`	`chmodGroupRW(File file)` يبذل أقصى جهد لجعل مجموعة الملفات المحدّدة قابلة للقراءة والكتابة.
`static boolean`	`chmodGroupRWX(File file)` يبذل قصارى جهده لجعل مجموعة الملفات المحدّدة قابلة للتنفيذ والقراءة والكتابة.
`static boolean`	`chmodRWXRecursively(File file)`
`static void`	`closeZip(ZipFile zipFile)` تم إيقاف هذه الطريقة نهائيًا. تم نقله إلى `ZipUtil.closeZip(ZipFile)`.
`static`	`collectJars(File dir)` عرض جميع ملفات jar التي تم العثور عليها في الدليل المحدّد
`static boolean`	`compareFileContents(File file1, File file2)` طريقة مساعدة لإجراء مقارنة بين محتوى ملفَّين حسب البايت
`static long`	`convertSizeToBytes(String sizeString)` الدالة العكسية لدالة `convertToReadableSize(long)`
`static IOException`	`convertToDiskSpaceIfNeeded(IOException e)` تُغلِّف هذه الوظيفة الخطأ في خطأ مساحة القرص إذا لزم الأمر.
`static String`	`convertToReadableSize(long sizeLong)` تحويل حجم الملف المحدَّد بالبايت إلى تنسيق أكثر سهولة للقراءة بالتنسيق X.Y[KMGT]
`static void`	`copyFile(File origFile, File destFile)` طريقة مساعدة لنسخ محتوى ملف إلى ملف على الجهاز
`static File`	`createNamedTempDir(File parentDir, String name)` دالة مساعدة لإنشاء دليل مُعنوَن داخل مجلد
`static File`	`createNamedTempDir(String name)` دالة مساعدة لإنشاء دليل مُعنوَن داخل مجلّدك المؤقّت.
`static File`	`createTempDir(String prefix)` وظيفة مساعدة لإنشاء دليل مؤقت في دليل الملفات المؤقتة التلقائي للنظام
`static File`	`createTempDir(String prefix, File parentDir)` دالة مساعدة لإنشاء دليل مؤقت
`static File`	`createTempFile(String prefix, String suffix, File parentDir)` دالة مساعدة ملف تعريف حول `ERROR(/File#createTempFile(String, String, File))` التي تتحقّق من احتمالية حدوث سيناريو عدم توفّر مساحة على القرص.
`static File`	`createTempFile(String prefix, String suffix)` دالة مساعدة ملف تعريف حول `ERROR(/File#createTempFile(String, String))` التي تتحقّق من سيناريو نقص مساحة القرص المحتمل.
`static File`	`createTempFileForRemote(String remoteFilePath, File parentDir)` طريقة مساعدة لإنشاء ملف فريد على القرص المؤقت، والذي يتطابق اسمه بأكبر قدر ممكن مع اسم الملف الذي يقدّمه مسار الملف البعيد
`static File`	`createZip(File dir)` تم إيقاف هذه الطريقة نهائيًا. تم نقله إلى `ZipUtil.createZip(File)`.
`static void`	`createZip(File dir, File zipFile)` تم إيقاف هذه الطريقة نهائيًا. تم نقله إلى `ZipUtil.createZip(File, File)`.
`static void`	`deleteFile(File file)` حاوِل حذف ملف.
`static boolean`	`ensureGroupRWX(File file)` تبذل هذه الوظيفة قصارى جهدها لضمان أن تكون مجموعة الملفات المحدّدة قابلة للتنفيذ والقراءة والكتابة.
`static File`	`extractFileFromZip(ZipFile zipFile, String filePath)` تم إيقاف هذه الطريقة نهائيًا. تم نقله إلى `ZipUtil.extractFileFromZip(ZipFile, String)`.
`static void`	`extractZip(ZipFile zipFile, File destDir)` تم إيقاف هذه الطريقة نهائيًا. تم نقله إلى `ZipUtil.extractZip(ZipFile, File)`.
`static File`	`findDirectory(String dirName, File... dirs)` البحث عن الدليل الأول `ERROR(/File)` وإظهاره بين الدلائل الأخرى
`static`	`findDirsUnder(File rootDir, File relativeParent)` العثور بشكل متكرر على جميع الدلائل ضمن `rootDir` المحدَّد
`static File`	`findFile(String fileName, IAbi abi, File... dirs)` الحصول على جميع مسارات الملفات في الدليل المحدّد التي تحمل اسمًا مطابقًا للفلترة المحدّدة، وفلترة الملف الذي تم العثور عليه أيضًا حسب abi arch إذا لم يكن abi فارغًا
`static File`	`findFile(File dir, String fileName)` البحث بشكل متكرر في الدليل المحدّد عن الملف الأول الذي يحمل الاسم المحدّد
`static`	`findFiles(String fileName, IAbi abi, boolean includeDirectory, File... dirs)` الحصول على جميع الملفات في الدليل المحدّد التي تحمل اسمًا مطابقًا للفلترة المحدّدة، وكذلك فلترة الملفات التي تم العثور عليها حسب abi arch إذا لم يكن abi فارغًا
`static`	`findFiles(File dir, String filter)` الحصول على جميع مسارات الملفات في الدليل المحدّد التي تحمل اسمًا مطابقًا للفلترة المحدّدة
`static`	`findFilesObject(File dir, String filter)` الحصول على جميع مسارات الملفات في الدليل المحدّد التي تتطابق أسماؤها مع الفلتر المحدّد
`static`	`findFilesObject(File dir, String filter, boolean includeDirectory)` الحصول على جميع مسارات الملفات في الدليل المحدّد التي تتطابق أسماؤها مع الفلتر المحدّد
`static String`	`getBaseName(String fileName)` تحصل على الاسم الأساسي لاسم الملف المحدَّد بدون امتداده.
`static String`	`getContentType(String filePath)` الحصول على نوع محتوى الملف استنادًا إلى امتداده
`static String`	`getExtension(String fileName)` تحصل على امتداد اسم الملف المحدَّد.
`static File`	`getFileForPath(File parentDir, String... pathSegments)` طريقة مساعدة لإنشاء ملف يعتمد على النظام
`static String`	`getPath(String... pathSegments)` طريقة مساعدة لإنشاء مسار نسبي يعتمد على النظام
`static void`	`gzipFile(File file, File gzipFile)` تم إيقاف هذه الطريقة نهائيًا. تم نقله إلى `ZipUtil.gzipFile(File, File)`.
`static void`	`hardlinkFile(File origFile, File destFile)` طريقة مساعدة تربط ملفًا بملف آخر.
`static void`	`hardlinkFile(File origFile, File destFile, boolean ignoreExistingFile)` طريقة مساعدة تربط ملفًا بملف آخر.
`static boolean`	`isDiskSpaceError(String message)` تعرِض هذه الدالة القيمة "صحيح" إذا كانت الرسالة خطأ في مساحة القرص.
`static boolean`	`mkdirsRWX(File file)` طريقة لإنشاء سلسلة من الأدلة وضبطها جميعًا على تنفيذ/قراءة/كتابة المجموعة أثناء إنشائها، من خلال استدعاء `chmodGroupRWX(File)`
`static String`	`readStringFromFile(File sourceFile, long startOffset, long length)` طريقة مساعدة لقراءة بيانات سلسلة جزئية من ملف
`static String`	`readStringFromFile(File sourceFile)` طريقة مساعدة لقراءة بيانات السلاسل من ملف
`static void`	`recursiveCopy(File sourceDir, File destDir)` نسخ محتويات المجلد بشكل متكرر
`static void`	`recursiveDelete(File rootDir)` حذف الملف أو الدليل المحدَّد وجميع محتوياته بشكل متكرّر
`static void`	`recursiveHardlink(File sourceDir, File destDir)` إنشاء روابط صلبة لمحتوى المجلدات بشكل تسلسلي
`static void`	`recursiveHardlink(File sourceDir, File destDir, boolean ignoreExistingFile)` إنشاء روابط صلبة لمحتوى المجلدات بشكل تسلسلي
`static void`	`recursiveSymlink(File sourceDir, File destDir)` إنشاء روابط تشعبية لمحتوى المجلد بشكل تسلسلي
`static File`	`saveResourceFile(InputStream resourceStream, File destDir, String targetFileName)` احفظ ملف مورد في دليل.
`static void`	`setReadableRecursive(File file)` ضبط أذونات القراءة والتنفيذ (إذا كان المجلد) بشكل متكرر للملف المحدّد
`static Long`	`sizeOfDirectory(File directory)` لعرض الحجم الذي يُبلغ عنه الدليل.
`static void`	`symlinkFile(File origFile, File destFile)` طريقة مساعدة تربط ملفًا بملف آخر
`static`	`unixModeToPosix(int mode)` لتحويل عدد صحيح يمثّل وضع Unix إلى مجموعة من `ERROR(/PosixFilePermission)`
`static void`	`writeToFile(String inputString, File destFile, boolean append)` طريقة مساعدة لكتابة بيانات السلسلة أو إلحاقها بالملف
`static void`	`writeToFile(String inputString, File destFile)` طريقة مساعدة لكتابة بيانات السلسلة في ملف
`static void`	`writeToFile(InputStream input, File destFile, boolean append, long startOffset, long size)` طريقة مساعدة لكتابة بيانات مصدر البيانات إلى ملف
`static void`	`writeToFile(InputStream input, File destFile)` طريقة مساعدة لكتابة بيانات مصدر البيانات إلى ملف
`static void`	`writeToFile(InputStream input, File destFile, boolean append)` طريقة مساعدة لكتابة بيانات مصدر البيانات إلى ملف

الطرق المحمية
`static boolean`	`chmodExists()` مساعد داخلي لتحديد ما إذا كان chmod متاحًا على نظام التشغيل للنظام
`static void`	`setChmodBinary(String chmodName)` تمّ عرضها للاختبار.

الثوابت

FILESYSTEM_FILENAME_MAX_LENGTH

public static final int FILESYSTEM_FILENAME_MAX_LENGTH

القيمة الثابتة: 255 (0x000000ff)

وظائف الإنشاء العامة

FileUtil

public FileUtil ()

الطرق العامة

calculateBase64Md5

public static String calculateBase64Md5 (File file)

طريقة مساعدة لاحتساب md5 base64 لملف.

المرتجعات
`String`	md5 للملف

calculateCrc32

public static long calculateCrc32 (File file)

طريقة مساعدة لاحتساب CRC-32 لملف.

المرتجعات
`long`	تجزئة CRC-32 للملف

عمليات الرمي
	IOException

calculateMd5

public static String calculateMd5 (File file)

طريقة مساعدة لاحتساب md5 لملف.

المرتجعات
`String`	md5 للملف

chmod

public static boolean chmod (File file, 
                String perms)

المعلمات
`file`	`File`
`perms`	`String`

المرتجعات
`boolean`

chmodGroupRW

public static boolean chmodGroupRW (File file)

تبذل هذه الوظيفة قصارى جهدها لجعل مجموعة الملفات المحدّدة قابلة للقراءة والكتابة.

يُرجى العلم أنّ إذن التنفيذ مطلوب لإتاحة الوصول إلى الدلائل. يُرجى الاطّلاع على chmodGroupRWX(File).

إذا لم يكن الأمر chmod متوافقًا مع نظام التشغيل الأساسي، سيتم ضبط الملف على أنّه قابل للكتابة من قِبل الجميع.

المعلمات
`file`	‫`File`: `ERROR(/File)` لجعل كل من المالك والمجموعة قابلَين للكتابة

المرتجعات
`boolean`	`true` إذا تم منح المجموعة إذن الوصول للكتابة في الملف بنجاح، `false` بخلاف ذلك

chmodGroupRWX

public static boolean chmodGroupRWX (File file)

يبذل قصارى جهده لجعل مجموعة الملفات المحدّدة قابلة للتنفيذ والقراءة والكتابة.

إذا لم يكن الأمر "chmod" متوافقًا مع نظام التشغيل الأساسي، سيتم محاولة ضبط الأذونات لجميع المستخدمين.

المعلمات
`file`	‫`File`: `ERROR(/File)` لجعل كل من المالك والمجموعة قابلَين للكتابة

المرتجعات
`boolean`	`true` إذا تم ضبط الأذونات بنجاح، `false` بخلاف ذلك

chmodRWXRecursively

public static boolean chmodRWXRecursively (File file)

المعلمات
`file`	`File`

المرتجعات
`boolean`

closeZip

public static void closeZip (ZipFile zipFile)

تم إيقاف هذه الطريقة نهائيًا.
تم نقله إلى ZipUtil.closeZip(ZipFile).

إغلاق ERROR(/ZipFile) مفتوح، مع تجاهل أي استثناءات

المعلمات
`zipFile`	`ZipFile`: الملف المطلوب إغلاقه

collectJars

public static  collectJars (File dir)

عرض جميع ملفات jar التي تم العثور عليها في الدليل المحدّد

المعلمات
`dir`	`File`

المرتجعات

compareFileContents

public static boolean compareFileContents (File file1, 
                File file2)

طريقة مساعدة لإجراء مقارنة بين محتوى ملفَّين حسب البايت

المعلمات
`file1`	`File`
`file2`	`File`

المرتجعات
`boolean`	`true` إذا كانت محتويات الملفات متطابقة

convertSizeToBytes

public static long convertSizeToBytes (String sizeString)

الدالة العكسية لدالة convertToReadableSize(long) لتحويل التنسيق القابل للقراءة الموضّح في convertToReadableSize(long) إلى قيمة بايت.

المعلمات
`sizeString`	`String`: وصف السلسلة للحجم

المرتجعات
`long`	الحجم بالبايت

عمليات الرمي
`IllegalArgumentException`	إذا تعذّر التعرّف على الحجم

convertToDiskSpaceIfNeeded

public static IOException convertToDiskSpaceIfNeeded (IOException e)

تُغلِّف هذه الوظيفة الخطأ في خطأ مساحة القرص إذا لزم الأمر.

المعلمات
`e`	`IOException`

المرتجعات
`IOException`

convertToReadableSize

public static String convertToReadableSize (long sizeLong)

تحويل حجم الملف المحدَّد بالبايت إلى تنسيق يسهل قراءته بالتنسيق X.Y[KMGT]

المعلمات
`sizeLong`	‫`long`: حجم الملف بالبايت

المرتجعات
`String`	سلسلة وصفية لحجم الملف

copyFile

public static void copyFile (File origFile, 
                File destFile)

طريقة مساعدة لنسخ محتوى ملف إلى ملف على الجهاز

المعلمات
`origFile`	`File`: الملف الأصلي المطلوب نسخه
`destFile`	`File`: الملف الوجهة

عمليات الرمي
	في حال تعذّر نسخ الملف

createNamedTempDir

public static File createNamedTempDir (File parentDir, 
                String name)

دالة مساعدة لإنشاء دليل مُعنوَن داخل مجلد

لن يتم إنشاء اسم عشوائي لهذا الدليل. إذا كان الدليل متوفّرًا، سيتم إرجاعه.

المعلمات
`parentDir`	`File`: الدليل الذي سيتم إنشاء الدليل فيه. إذا كان الدليل فارغًا، سيتم إنشاء الدليل في ‎ /tmp
`name`	`String`: اسم الدليل الذي تريد إنشاؤه في المجلد الرئيسي

المرتجعات
`File`	الدليل الذي تم إنشاؤه

createNamedTempDir

public static File createNamedTempDir (String name)

دالة مساعدة لإنشاء دليل مُعنوَن داخل المجلد المؤقت

لن يتم إنشاء اسم عشوائي لهذا الدليل. إذا كان الدليل متوفّرًا، سيتم إرجاعه.

المعلمات
`name`	`String`: اسم الدليل الذي سيتم إنشاؤه في مجلد tmp.

المرتجعات
`File`	الدليل الذي تم إنشاؤه

createTempDir

public static File createTempDir (String prefix)

وظيفة مساعدة لإنشاء دليل مؤقت في دليل الملفات المؤقتة التلقائي للنظام

المعلمات
`prefix`	`String`: سلسلة البادئة التي سيتم استخدامها في إنشاء اسم الملف، ويجب أن تتألف من ثلاثة أحرف على الأقل

المرتجعات
`File`	الدليل الذي تم إنشاؤه

عمليات الرمي
	إذا تعذّر إنشاء الملف

createTempDir

public static File createTempDir (String prefix, 
                File parentDir)

دالة مساعدة لإنشاء دليل مؤقت

المعلمات
`prefix`	`String`: سلسلة البادئة التي سيتم استخدامها في إنشاء اسم الملف، ويجب أن تتألف من ثلاثة أحرف على الأقل
`parentDir`	`File`: الدليل الرئيسي الذي سيتم إنشاء الدليل فيه. إذا كان `null`، سيتم استخدام الدليل المؤقت التلقائي للنظام.

المرتجعات
`File`	الدليل الذي تم إنشاؤه

عمليات الرمي
	إذا تعذّر إنشاء الملف

createTempFile

public static File createTempFile (String prefix, 
                String suffix, 
                File parentDir)

دالة مساعدة ملف تعريف حول ERROR(/File#createTempFile(String, String, File)) التي تتحقّق من احتمالية حدوث سيناريو عدم توفّر مساحة على القرص.

المعلمات
`prefix`	`String`
`suffix`	`String`
`parentDir`	`File`

المرتجعات
`File`

عمليات الرمي
`FileUtil.LowDiskSpaceException`	إذا كانت مساحة القرص في القسم أقل من الحد الأدنى المسموح به

راجِع أيضًا:

ERROR(/File#createTempFile(String, String, File))

createTempFile

public static File createTempFile (String prefix, 
                String suffix)

دالة مساعدة ملف تعريف حول ERROR(/File#createTempFile(String, String)) التي تتحقّق من سيناريو نقص مساحة القرص المحتمل.

المعلمات
`prefix`	`String`
`suffix`	`String`

المرتجعات
`File`

عمليات الرمي
`FileUtil.LowDiskSpaceException`	إذا كانت مساحة القرص في القسم المؤقت أقل من الحد الأدنى المسموح به

راجِع أيضًا:

ERROR(/File#createTempFile(String, String))

createTempFileForRemote

public static File createTempFileForRemote (String remoteFilePath, 
                File parentDir)

طريقة مساعدة لإنشاء ملف فريد على القرص المؤقت، والذي يتطابق اسمه بقدرٍ ممكن مع اسم الملف الذي يقدّمه مسار الملف البعيد

المعلمات
`remoteFilePath`	`String`: المسار البعيد المنفصل بفاصل "/" لإنشاء الاسم منه
`parentDir`	`File`: الدليل الرئيسي لإنشاء الملف فيه `null` لاستخدام الدليل المؤقت التلقائي

المرتجعات
`File`

createZip

public static File createZip (File dir)

تم إيقاف هذه الطريقة نهائيًا.
تم نقله إلى ZipUtil.createZip(File).

طريقة مساعدة لإنشاء ملف zip مؤقت يحتوي على الدليل المحدّد وجميع محتوياته.

المعلمات
`dir`	`File`: الدليل الذي سيتم ضغطه

المرتجعات
`File`	ملف zip مؤقت `ERROR(/File)` يحتوي على محتوى الدليل

عمليات الرمي
	في حال تعذّر إنشاء ملف zip

createZip

public static void createZip (File dir, 
                File zipFile)

تم إيقاف هذه الطريقة نهائيًا.
تم نقله إلى ZipUtil.createZip(File, File).

طريقة مساعدة لإنشاء ملف zip يتضمّن الدليل المحدّد وكل محتوياته

المعلمات
`dir`	`File`: الدليل الذي سيتم ضغطه
`zipFile`	`File`: ملف zip المطلوب إنشاؤه، ويجب ألا يكون متوفّرًا

عمليات الرمي
	في حال تعذّر إنشاء ملف zip

deleteFile

public static void deleteFile (File file)

حاوِل حذف ملف. يُستخدَم عند تنظيف في finally مقطع.

المعلمات
`file`	`File`: قد تكون فارغة.

ensureGroupRWX

public static boolean ensureGroupRWX (File file)

تبذل هذه الوظيفة قصارى جهدها لضمان إمكانية تنفيذ مجموعة الملفات المحدّدة وقراءتها وكتابتها.

إذا لم يكن الأمر "chmod" متوافقًا مع نظام التشغيل الأساسي، سيتم محاولة ضبط الأذونات لجميع المستخدمين. تتم مزامنة العملية لمنع حدوث حالة تعارض في المعالجة التي تحدث عند الوصول إلى الملفات من ذاكرة التخزين المؤقت، على سبيل المثال: GCSFileDownloader

المعلمات
`file`	‫`File`: `ERROR(/File)` لجعل كل من المالك والمجموعة قابلَين للكتابة

المرتجعات
`boolean`	`true` إذا تم ضبط الأذونات بنجاح، `false` بخلاف ذلك

extractFileFromZip

public static File extractFileFromZip (ZipFile zipFile, 
                String filePath)

تم إيقاف هذه الطريقة نهائيًا.
تم نقله إلى ZipUtil.extractFileFromZip(ZipFile, String).

طريقة مساعدة لاستخراج ملف واحد محدّد من ملف zip إلى ملف tmp

المعلمات
`zipFile`	`ZipFile`: `ERROR(/ZipFile)` المطلوب استخراجه
`filePath`	`String`: filePath المطلوب استخراجه

المرتجعات
`File`	`ERROR(/File)` أو القيمة الخالية إذا لم يتم العثور عليه

عمليات الرمي
	في حال تعذّر استخراج الملف

extractZip

public static void extractZip (ZipFile zipFile, 
                File destDir)

تم إيقاف هذه الطريقة نهائيًا.
تم نقله إلى ZipUtil.extractZip(ZipFile, File).

طريقة مساعدة لاستخراج محتوى ملف zip بالكامل في دليل معيّن

المعلمات
`zipFile`	`ZipFile`: `ERROR(/ZipFile)` المطلوب استخراجه
`destDir`	`File`: الدليل المحلي لاستخراج الملف إليه

عمليات الرمي
	في حال تعذّر استخراج الملف

findDirectory

public static File findDirectory (String dirName, 
                File... dirs)

البحث عن الدليل الأول ERROR(/File) وإظهاره بين الدلائل الأخرى

المعلمات
`dirName`	`String`: اسم الدليل الذي نبحث عنه.
`dirs`	`File`: قائمة الأدلة التي نبحث فيها

المرتجعات
`File`	`ERROR(/File)` مع الدليل الذي تم العثور عليه أو Null إذا لم يتم العثور عليه

عمليات الرمي
	IOException

findDirsUnder

public static  findDirsUnder (File rootDir, 
                File relativeParent)

العثور بشكل متكرر على جميع الدلائل ضمن rootDir المحدَّد

المعلمات
`rootDir`	`File`: الدليل الجذري الذي يتم البحث فيه
`relativeParent`	`File`: سمة اختيارية لجميع `ERROR(/File)` التي يتم عرضها. في حال عدم تحديد قيمة، ستكون جميع القيم في `ERROR(/File)` نسبية إلى `rootDir`.

المرتجعات
	مجموعة من `ERROR(/File)`s، التي تمثّل جميع الدلائل ضمن `rootDir`، بما في ذلك `rootDir` نفسه. إذا كانت `rootDir` فارغة، يتم عرض مجموعة فارغة.

findFile

public static File findFile (String fileName, 
                IAbi abi, 
                File... dirs)

الحصول على جميع مسارات الملفات في الدليل المحدّد التي تحمل اسمًا مطابقًا للفلترة المحدّدة، وفلترة الملف الذي تم العثور عليه أيضًا حسب abi arch إذا لم يكن abi فارغًا عرض أول ملف مطابق تم العثور عليه

المعلمات
`fileName`	`String`: `String` للتعبير العادي لمطابقة مسار الملف
`abi`	‫`IAbi`: `IAbi` عنصر abi لمطابقة الهدف
`dirs`	`File`: صفيف متغيرات غير محدّدة من عنصر `ERROR(/File)` للمجلدات للبحث عن الملفات

المرتجعات
`File`	`ERROR(/File)` أو `null` في حال تعذّر العثور عليه

findFile

public static File findFile (File dir, 
                String fileName)

البحث بشكل متكرر في الدليل المحدّد عن الملف الأول الذي يحمل الاسم المحدّد

المعلمات
`dir`	`File`: الدليل المطلوب البحث فيه
`fileName`	`String`: اسم الملف المطلوب البحث عنه

المرتجعات
`File`	`ERROR(/File)` أو `null` في حال تعذّر العثور عليه

findFiles

public static  findFiles (String fileName, 
                IAbi abi, 
                boolean includeDirectory, 
                File... dirs)

الحصول على جميع الملفات في الدليل المحدّد التي تحمل اسمًا مطابقًا للفلترة المحدّدة، وكذلك فلترة الملفات التي تم العثور عليها حسب abi arch إذا لم يكن abi فارغًا

المعلمات
`fileName`	`String`: `String` للتعبير العادي لمطابقة مسار الملف
`abi`	‫`IAbi`: `IAbi` عنصر abi لمطابقة الهدف
`includeDirectory`	‫`boolean`: ما إذا كان سيتم تضمين الأدلة في نتيجة البحث
`dirs`	`File`: صفيف من عناصر `ERROR(/File)` للمجلدات للبحث عن الملفات

المرتجعات
	مجموعة من `ERROR(/File)` أو فارغة إذا تعذّر العثور عليها

findFiles

public static  findFiles (File dir, 
                String filter)

الحصول على جميع مسارات الملفات في الدليل المحدّد التي تحمل اسمًا مطابقًا للفلترة المحدّدة

المعلمات
`dir`	`File`: عنصر `ERROR(/File)` للدليل للبحث عن الملفات بشكل متكرر
`filter`	`String`: `String` من التعبير العادي لمطابقة أسماء الملفات

المرتجعات
	مجموعة من `String` من مسارات الملفات

findFilesObject

public static  findFilesObject (File dir, 
                String filter)

الحصول على جميع مسارات الملفات في الدليل المحدّد التي تحمل اسمًا مطابقًا للفلترة المحدّدة

المعلمات
`dir`	`File`: عنصر `ERROR(/File)` للدليل للبحث عن الملفات بشكل متكرر
`filter`	`String`: `String` من التعبير العادي لمطابقة أسماء الملفات

المرتجعات
	مجموعة من `ERROR(/File)` من عناصر الملفات ‎@See `findFiles(File, String)`

findFilesObject

public static  findFilesObject (File dir, 
                String filter, 
                boolean includeDirectory)

الحصول على جميع مسارات الملفات في الدليل المحدّد التي تحمل اسمًا مطابقًا للفلترة المحدّدة

المعلمات
`dir`	`File`: عنصر `ERROR(/File)` للدليل للبحث عن الملفات بشكل متكرر
`filter`	`String`: `String` من التعبير العادي لمطابقة أسماء الملفات
`includeDirectory`	‫`boolean`: ما إذا كان سيتم تضمين الأدلة في نتيجة البحث

المرتجعات
	مجموعة من `ERROR(/File)` من عناصر الملفات ‎@See `findFiles(File, String)`

getBaseName

public static String getBaseName (String fileName)

تحصل على الاسم الأساسي لاسم الملف المحدَّد بدون امتداده.

على سبيل المثال، سيعرض getBaseName("file.txt") القيمة "file".

المرتجعات
`String`	الاسم الأساسي

getContentType

public static String getContentType (String filePath)

الحصول على نوع محتوى الملف استنادًا إلى امتداده

المعلمات
`filePath`	`String`: مسار الملف

المرتجعات
`String`	نوع المحتوى

getExtension

public static String getExtension (String fileName)

تحصل على امتداد اسم الملف المحدَّد.

المرتجعات
`String`	يشير إلى امتداد الملف أو سلسلة فارغة إذا لم يكن للملف امتداد

getFileForPath

public static File getFileForPath (File parentDir, 
                String... pathSegments)

طريقة مساعدة لإنشاء ملف يعتمد على النظام

المعلمات
`parentDir`	‫`File`: الدليل الرئيسي المطلوب استخدامه
`pathSegments`	`String`: شرائح المسار النسبي المطلوب استخدامها

المرتجعات
`File`	يمثّل الرمز `ERROR(/File)` المسار المحدّد، ويتم فصل كل `pathSegment` برمز `ERROR(/File#separatorChar)`.

getPath

public static String getPath (String... pathSegments)

طريقة مساعدة لإنشاء مسار نسبي يعتمد على النظام

المعلمات
`pathSegments`	`String`: شرائح المسار النسبي المطلوب استخدامها

المرتجعات
`String`	يمثّل الرمز `String` المسار المحدّد، ويتم فصل كل `pathSegment` برمز `ERROR(/File#separatorChar)`.

gzipFile

public static void gzipFile (File file, 
                File gzipFile)

تم إيقاف هذه الطريقة نهائيًا.
تم نقله إلى ZipUtil.gzipFile(File, File).

طريقة مساعدة لإنشاء نسخة مضغوطة بتنسيق gzip من ملف واحد

المعلمات
`file`	`File`: الملف الأصلي
`gzipFile`	‫`File`: الملف الذي سيتم وضع المحتوى المضغوط فيه

عمليات الرمي
	IOException

hardlinkFile

public static void hardlinkFile (File origFile, 
                File destFile)

طريقة مساعدة تربط ملفًا بملف آخر. النسخ الاحتياطي في حال ربط أقسام مختلفة

المعلمات
`origFile`	`File`: الملف الأصلي
`destFile`	`File`: الملف الوجهة

عمليات الرمي
	if failed to hardlink file

hardlinkFile

public static void hardlinkFile (File origFile, 
                File destFile, 
                boolean ignoreExistingFile)

طريقة مساعدة تربط ملفًا بملف آخر. النسخ الاحتياطي في حال ربط أقسام مختلفة

المعلمات
`origFile`	`File`: الملف الأصلي
`destFile`	`File`: الملف الوجهة
`ignoreExistingFile`	`boolean`: إذا كان القيمة "صحيح" وكان الملف الذي يتم الربط به متوفّرًا، تخطّى الاستثناء.

عمليات الرمي
	if failed to hardlink file

isDiskSpaceError

public static boolean isDiskSpaceError (String message)

تعرِض هذه الدالة القيمة "صحيح" إذا كانت الرسالة خطأ في مساحة القرص.

المعلمات
`message`	`String`

المرتجعات
`boolean`

mkdirsRWX

public static boolean mkdirsRWX (File file)

طريقة لإنشاء سلسلة من الأدلة وضبطها جميعًا على تنفيذ/قراءة/كتابة المجموعة أثناء إنشائها، من خلال استدعاء chmodGroupRWX(File) هو في الأساس إصدار من ERROR(/File#mkdirs()) يعمل أيضًا على chmod(File, String).

المعلمات
`file`	`File`: اسم الدليل الذي تريد إنشاؤه، مع تضمين أدلة غير متوفّرة بعد

المرتجعات
`boolean`	`true` إذا كان `file` متوفّرًا وكان دليلاً، `false` بخلاف ذلك

readStringFromFile

public static String readStringFromFile (File sourceFile, 
                long startOffset, 
                long length)

طريقة مساعدة لقراءة بيانات سلسلة جزئية من ملف

المعلمات
`sourceFile`	`File`: الملف المطلوب القراءة منه
`startOffset`	`long`: بدء التقديم أو الإيقاف للقراءة من الملف
`length`	‫`long`: عدد البايتات المطلوب قراءتها من الملف

المرتجعات
`String`

عمليات الرمي
	IOException
	FileNotFoundException

readStringFromFile

public static String readStringFromFile (File sourceFile)

طريقة مساعدة لقراءة بيانات السلاسل من ملف

المعلمات
`sourceFile`	`File`: الملف المطلوب القراءة منه

المرتجعات
`String`

عمليات الرمي
	IOException
	FileNotFoundException

recursiveCopy

public static void recursiveCopy (File sourceDir, 
                File destDir)

نسخ محتويات المجلد بشكل متكرر

لا تتيح هذه الطريقة سوى نسخ الملفات والمجلدات، ولا يتم نسخ الروابط الرمزية. إذا لم يكن دليل الوجهة متوفّرًا، سيتم إنشاؤه.

المعلمات
`sourceDir`	`File`: المجلد الذي يحتوي على الملفات المطلوب نسخها
`destDir`	`File`: مجلد الوجهة

عمليات الرمي
	IOException

recursiveDelete

public static void recursiveDelete (File rootDir)

حذف الملف أو الدليل المحدَّد وجميع محتوياته بشكل متكرّر

المعلمات
`rootDir`	`File`: الدليل أو الملف المطلوب حذفه، ويمكن أن يكون فارغًا

recursiveHardlink

public static void recursiveHardlink (File sourceDir, 
                File destDir)

إنشاء روابط صلبة لمحتوى المجلدات بشكل تسلسلي

المعلمات
`sourceDir`	`File`: المجلد الذي يحتوي على الملفات المطلوب نسخها
`destDir`	`File`: مجلد الوجهة

عمليات الرمي
	IOException

recursiveHardlink

public static void recursiveHardlink (File sourceDir, 
                File destDir, 
                boolean ignoreExistingFile)

إنشاء روابط صلبة لمحتوى المجلدات بشكل تسلسلي

لا تتيح هذه الطريقة سوى نسخ الملفات والمجلدات، ولا يتم نسخ الروابط الرمزية. إذا لم يكن الدليل الوجهة متوفّرًا، سيتم إنشاؤه.

المعلمات
`sourceDir`	`File`: المجلد الذي يحتوي على الملفات المطلوب نسخها
`destDir`	`File`: مجلد الوجهة
`ignoreExistingFile`	`boolean`: إذا كان القيمة "صحيح" وكان الملف الذي يتم الربط به متوفّرًا، تخطّى الاستثناء.

عمليات الرمي
	IOException

رابط_تسلسلي

public static void recursiveSymlink (File sourceDir, 
                File destDir)

إنشاء روابط تشعبية لمحتوى المجلد بشكل تسلسلي

المعلمات
`sourceDir`	`File`: المجلد الذي يحتوي على الملفات المطلوب نسخها
`destDir`	`File`: مجلد الوجهة

عمليات الرمي
	IOException

saveResourceFile

public static File saveResourceFile (InputStream resourceStream, 
                File destDir, 
                String targetFileName)

احفظ ملف مورد في دليل.

المعلمات
`resourceStream`	‫`InputStream`: عنصر {link InputStream} للمورد الذي سيتم حفظه
`destDir`	`File`: عنصر `ERROR(/File)` لمجلد سيتم حفظ ملف المرجع فيه
`targetFileName`	‫`String`: `String` لاسم الملف الذي سيتم حفظه فيه

المرتجعات
`File`	عنصر `ERROR(/File)` من الملف المحفوظ

عمليات الرمي
	إذا تعذّر حفظ الملف

setReadableRecursive

public static void setReadableRecursive (File file)

ضبط أذونات القراءة والتنفيذ (إذا كان المجلد) بشكل متكرر للملف المحدّد

المعلمات
`file`	`File`

sizeOfDirectory

public static Long sizeOfDirectory (File directory)

لعرض الحجم الذي يُبلغ عنه الدليل.

المعلمات
`directory`	`File`

المرتجعات
`Long`

symlinkFile

public static void symlinkFile (File origFile, 
                File destFile)

طريقة مساعدة تربط ملفًا بملف آخر

المعلمات
`origFile`	`File`: الملف الأصلي
`destFile`	`File`: الملف الوجهة

عمليات الرمي
	في حال تعذّر إنشاء رابط رمزي للملف

unixModeToPosix

public static  unixModeToPosix (int mode)

لتحويل عدد صحيح يمثّل وضع Unix إلى مجموعة من ERROR(/PosixFilePermission)

المعلمات
`mode`	`int`

المرتجعات

writeToFile

public static void writeToFile (String inputString, 
                File destFile, 
                boolean append)

طريقة مساعدة لكتابة بيانات السلسلة أو إلحاقها بالملف

المعلمات
`inputString`	`String`: الإدخال `String`
`destFile`	`File`: الملف الوجهة المطلوب الكتابة إليه أو إلحاق البيانات به
`append`	`boolean`: إلحاق البيانات بنهاية الملف إذا كانت القيمة صحيحة، أو استبدالها بخلاف ذلك

writeToFile

public static void writeToFile (String inputString, 
                File destFile)

طريقة مساعدة لكتابة بيانات السلسلة في ملف

المعلمات
`inputString`	`String`: الإدخال `String`
`destFile`	`File`: الملف الوجهة المطلوب الكتابة فيه

writeToFile

public static void writeToFile (InputStream input, 
                File destFile, 
                boolean append, 
                long startOffset, 
                long size)

طريقة مساعدة لكتابة بيانات مصدر البيانات إلى ملف

المعلمات
`input`	‫`InputStream`: بث الإدخال غير المحفوظ مؤقتًا
`destFile`	`File`: الملف الوجهة المطلوب الكتابة إليه أو إلحاق البيانات به
`append`	`boolean`: إلحاق البيانات بنهاية الملف إذا كانت القيمة صحيحة، أو استبدالها بخلاف ذلك
`startOffset`	‫`long`: إزاحة بداية مصدر الإدخال لاسترداد البيانات
`size`	‫`long`: عدد وحدات البايت التي سيتم استرجاعها من بث الإدخال، اضبطها على قيمة سلبية ل retrieving all content starting at the given offset.

writeToFile

public static void writeToFile (InputStream input, 
                File destFile)

طريقة مساعدة لكتابة بيانات مصدر البيانات إلى ملف

المعلمات
`input`	‫`InputStream`: بث الإدخال غير المحفوظ في الذاكرة
`destFile`	`File`: الملف الوجهة المطلوب الكتابة فيه

writeToFile

public static void writeToFile (InputStream input, 
                File destFile, 
                boolean append)

طريقة مساعدة لكتابة بيانات مصدر البيانات إلى ملف

المعلمات
`input`	‫`InputStream`: بث الإدخال غير المحفوظ مؤقتًا
`destFile`	`File`: الملف الوجهة المطلوب الكتابة إليه أو إلحاق البيانات به
`append`	`boolean`: إلحاق البيانات بنهاية الملف إذا كانت القيمة صحيحة، أو استبدال البيانات في حال عدم صحتها

الطرق المحمية

chmodExists

protected static boolean chmodExists ()

مساعد داخلي لتحديد ما إذا كان chmod متاحًا على نظام التشغيل للنظام

المرتجعات
`boolean`

setChmodBinary

protected static void setChmodBinary (String chmodName)

تمّ عرضها للاختبار. يسمح بتعديل اسم ثنائي chmod الذي نبحث عنه، من أجل اختبار النظام بدون دعم chmod.

المعلمات
`chmodName`	`String`

FileUtil

ملخّص

الفئات المُدمجة

الثوابت

وظائف الإنشاء العامة

الطرق العامة

الطرق المحمية

الثوابت

FILESYSTEM_FILENAME_MAX_LENGTH

وظائف الإنشاء العامة

FileUtil

الطرق العامة

calculateBase64Md5

calculateCrc32

calculateMd5

chmod

chmodGroupRW

chmodGroupRWX

chmodRWXRecursively

closeZip

collectJars

compareFileContents

convertSizeToBytes

convertToDiskSpaceIfNeeded

convertToReadableSize

copyFile

createNamedTempDir

createNamedTempDir

createTempDir

createTempDir

createTempFile

createTempFile

createTempFileForRemote

createZip

createZip

deleteFile

ensureGroupRWX

extractFileFromZip

extractZip

findDirectory

findDirsUnder

findFile

findFile

findFiles

findFiles

findFilesObject

findFilesObject

getBaseName

getContentType

getExtension

getFileForPath

getPath

gzipFile

hardlinkFile

hardlinkFile

isDiskSpaceError

mkdirsRWX

readStringFromFile

readStringFromFile

recursiveCopy

recursiveDelete

recursiveHardlink

recursiveHardlink

رابط_تسلسلي

saveResourceFile

setReadableRecursive

sizeOfDirectory

symlinkFile

unixModeToPosix

writeToFile

writeToFile

writeToFile

writeToFile

writeToFile

الطرق المحمية

chmodExists

setChmodBinary