تمت ترجمة هذه الصفحة بواسطة 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)` طريقة مساعدة لحساب base64 md5 لأحد الملفات.
`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 إذا لم يكن 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)` يتم ضبط أذونات القراءة والتنفيذ (if مجلد) بشكل متكرر لملف معيّن.
`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 ()

الطرق العامة

حساب Base64Md5

public static String calculateBase64Md5 (File file)

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

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

حساب Crc32

public static long calculateCrc32 (File file)

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

المرتجعات
`long`	CRC-32 من الملف

الرميات
	IOاستثناء

حساب متوسّط 5

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` بخلاف ذلك

chmodRWXRecurively

public static boolean chmodRWXRecursively (File file)

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

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

إغلاق

public static void closeZip (ZipFile zipFile)

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

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

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

مجموعة جرار

public static  collectJars (File dir)

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

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

المرتجعات

مقارنة محتوى الملف

public static boolean compareFileContents (File file1, 
                File file2)

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

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

المرتجعات
`boolean`	`true` في حال كان محتوى الملف متطابقًا

changeSizeToBytes

public static long convertSizeToBytes (String sizeString)

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

المعلمات
`sizeString`	`String`: وصف السلسلة الخاص بالمقاس

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

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

_conversionToDiskSpaceIfبحed

public static IOException convertToDiskSpaceIfNeeded (IOException e)

يتم التفاف الخطأ في مساحة قرص إذا لزم الأمر.

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

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

changeToReadableSize

public static String convertToReadableSize (long sizeLong)

تحويل حجم الملف المعين بالبايت إلى تنسيق أكثر قابلية للقراءة بتنسيق X.Y[KMGT]

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

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

نسخ الملف

public static void copyFile (File origFile, 
                File destFile)

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

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

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

إنشاء نسخة جديدة من بياناتك

public static File createNamedTempDir (File parentDir, 
                String name)

دالة مساعد لإنشاء دليل مُسمّى داخل مجلد.

لن يتم ترتيب اسم هذا الدليل عشوائيًا. في حالة وجود الدليل بالفعل، وإرجاعه.

المعلمات
`parentDir`	`File`: الدليل حيث يتم إنشاء dir إذا كانت القيمة خالية، ستكون بتنسيق /tmp
`name`	`String`: اسم الدليل المراد إنشاؤه في المجلد الرئيسي

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

إنشاء نسخة جديدة من بياناتك

public static File createNamedTempDir (String name)

دالة مساعد لإنشاء دليل مُسمّى داخل المجلد المؤقت الخاص بك.

لن يتم ترتيب اسم هذا الدليل عشوائيًا. في حالة وجود الدليل بالفعل، وإرجاعه.

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

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

إنشاء TempDir

public static File createTempDir (String prefix)

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

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

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

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

إنشاء TempDir

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`

إنشاء Zip

public static File createZip (File dir)

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

الأداة المساعدة لإنشاء ملف ZIP مؤقت يحتوي على الدليل المحدد بكل محتوياتها.

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

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

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

إنشاء Zip

public static void createZip (File dir, 
                File zipFile)

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

الأداة المساعدة لإنشاء ملف ZIP يحتوي على الدليل المحدد بكل محتوياتها.

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

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

حذف الملف

public static void deleteFile (File file)

جرِّب حذف ملف. مخصَّصة للاستخدام عند التنظيف في finally مقاطع.

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

ضمانGroupRWX

public static boolean ensureGroupRWX (File file)

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

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

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

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

استخراجملف منZip

public static File extractFileFromZip (ZipFile zipFile, 
                String filePath)

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

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

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

المرتجعات
`File`	في حال عدم العثور على السمة `ERROR(/File)` أو قيمة فارغة

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

استخراج ملفات ضغط

public static void extractZip (ZipFile zipFile, 
                File destDir)

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

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

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

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

دليل البحث

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

ابحث عن الدليل الأول ERROR(/File) من بين الأدلة الأخرى واعرِضه.

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

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

الرميات
	IOاستثناء

العثور على ديرات

public static  findDirsUnder (File rootDir, 
                File relativeParent)

البحث بشكل متكرر عن جميع الأدلة ضمن rootDir المحدّد

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

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

العثور على الملف

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

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

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

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

العثور على الملف

public static File findFile (File dir, 
                String fileName)

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

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

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

العثور على الملفات

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)` أو فارغة إذا تعذّر العثور عليها

العثور على الملفات

public static  findFiles (File dir, 
                String filter)

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

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

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

كائن العثور علىالملفات

public static  findFilesObject (File dir, 
                String filter)

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

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

المرتجعات
	مجموعة مؤلفة من `ERROR(/File)` من كائنات الملفات. @الاطّلاع على `findFiles(File, String)`

كائن العثور علىالملفات

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

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

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

المرتجعات
	مجموعة مؤلفة من `ERROR(/File)` من كائنات الملفات. @الاطّلاع على `findFiles(File, String)`

الحصول على BaseName

public static String getBaseName (String fileName)

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

مثلاً: ستعرض getBaseName("file.txt") "file"

المرتجعات
`String`	اسم القاعدة

الحصول على نوع المحتوى

public static String getContentType (String filePath)

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

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

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

الحصول على الإضافة

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)`

الحصول على مسار

public static String getPath (String... pathSegments)

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

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

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

ملف gzip

public static void gzipFile (File file, 
                File gzipFile)

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

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

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

الرميات
	IOاستثناء

ملف الثابت

public static void hardlinkFile (File origFile, 
                File destFile)

يشير ذلك المصطلح إلى طريقة مساعِدة تربط ملفًا ثابتًا بملف آخر. الإجراء الاحتياطي للنسخ في حالة وجود تقاطع وربط الأقسام.

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

الرميات
	في حال تعذّر ربط الملف

ملف الثابت

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

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

الرميات
	في حال تعذّر ربط الملف

خطأ isDiskSpace

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`

الرميات
	IOاستثناء
	لم يتم العثور على الملف.

readStringFromFile

public static String readStringFromFile (File sourceFile)

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

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

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

الرميات
	IOاستثناء
	لم يتم العثور على الملف.

تكراري

public static void recursiveCopy (File sourceDir, 
                File destDir)

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

تدعم فقط نسخ الملفات والأدلة - لا يتم نسخ الارتباطات الرمزية. إذا كانت الوجهة الدليل غير موجود، سيتم إنشاؤه.

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

الرميات
	IOاستثناء

حذف متكرر

public static void recursiveDelete (File rootDir)

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

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

تكراري ثابت

public static void recursiveHardlink (File sourceDir, 
                File destDir)

محتوى المجلد المرتبط بشكل متكرر

تدعم فقط نسخ الملفات والأدلة - لا يتم نسخ الارتباطات الرمزية. إذا كانت الوجهة الدليل غير موجود، سيتم إنشاؤه.

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

الرميات
	IOاستثناء

تكراري ثابت

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

محتوى المجلد المرتبط بشكل متكرر

تدعم فقط نسخ الملفات والأدلة - لا يتم نسخ الارتباطات الرمزية. إذا كانت دليل الوجهة غير موجود، سيتم إنشاؤه.

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

الرميات
	IOاستثناء

رابط رمزي تكراري

public static void recursiveSymlink (File sourceDir, 
                File destDir)

ترميز محتويات المجلد بشكل متكرر.

تدعم فقط نسخ الملفات والأدلة - لا يتم نسخ الارتباطات الرمزية. إذا كانت دليل الوجهة غير موجود، سيتم إنشاؤه.

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

الرميات
	IOاستثناء

حفظ الموارد

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

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

المعلمات
`resourceStream`	`InputStream`: كائن {link InsertStream} للمورد المطلوب حفظه
`destDir`	`File`: كائن `ERROR(/File)` لدليل حيث سيتم حفظ ملف المورد
`targetFileName`	`String`: عنصر `String` لاسم الملف الذي تريد الحفظ فيه.

المرتجعات
`File`	تم حفظ كائن `ERROR(/File)` من الملف.

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

تعيين قابلة للقراءة

public static void setReadableRecursive (File file)

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

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

حجم الدليل

public static Long sizeOfDirectory (File directory)

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

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

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

ملف symlink

public static void symlinkFile (File origFile, 
                File destFile)

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

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

الرميات
	في حال تعذّر الربط الرمزي للملف

UnixModeToPosix

public static  unixModeToPosix (int mode)

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

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

المرتجعات

كتابة إلى الملف

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

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

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

كتابة إلى الملف

public static void writeToFile (String inputString, 
                File destFile)

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

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

كتابة إلى الملف

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

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

المعلمات
`input`	`InputStream`: مصدر بيانات الإدخال غير المخزَّن مؤقتًا
`destFile`	`File`: الملف الوجهة للكتابة أو الإلحاق
`append`	`boolean`: إلحاقها بنهاية الملف في حال الضبط على القيمة "صحيح"، واستبدالها بخلاف ذلك
`startOffset`	`long`: إزاحة بداية مصدر البيانات المُدخل لاسترداد البيانات
`size`	`long`: عدد وحدات البايت المراد استردادها من مصدر البيانات المُدخَل، يُرجى ضبطه على قيمة سالبة على لاسترداد كل المحتوى بدءًا من الإزاحة المحددة.

كتابة إلى الملف

public static void writeToFile (InputStream input, 
                File destFile)

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

المعلمات
`input`	`InputStream`: مصدر بيانات الإدخال غير المخزَّن مؤقتًا
`destFile`	`File`: الملف الوجهة الذي تريد الكتابة إليه

كتابة إلى الملف

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

الطرق العامة

حساب Base64Md5

حساب Crc32

حساب متوسّط 5

أمر chmod

أمر chmodGroupRW

أمر chmodGroupRWX

chmodRWXRecurively

إغلاق

مجموعة جرار

مقارنة محتوى الملف

changeSizeToBytes

_conversionToDiskSpaceIfبحed

changeToReadableSize

نسخ الملف

إنشاء نسخة جديدة من بياناتك

إنشاء نسخة جديدة من بياناتك

إنشاء TempDir

إنشاء TempDir

ملف createTempFile

ملف createTempFile

createTempFileForRemote

إنشاء Zip

إنشاء Zip

حذف الملف

ضمانGroupRWX

استخراجملف منZip

استخراج ملفات ضغط

دليل البحث

العثور على ديرات

العثور على الملف

العثور على الملف

العثور على الملفات

العثور على الملفات

كائن العثور علىالملفات

كائن العثور علىالملفات

الحصول على BaseName

الحصول على نوع المحتوى

الحصول على الإضافة

الطريقة getFileForPath

الحصول على مسار

ملف gzip

ملف الثابت

ملف الثابت

خطأ isDiskSpace

أمر mkdirsRWX

readStringFromFile

readStringFromFile

تكراري

حذف متكرر

تكراري ثابت

تكراري ثابت

رابط رمزي تكراري

حفظ الموارد

تعيين قابلة للقراءة

حجم الدليل

ملف symlink

UnixModeToPosix

كتابة إلى الملف

كتابة إلى الملف

كتابة إلى الملف

كتابة إلى الملف

كتابة إلى الملف

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

مؤسسة chmodExists

مجموعة setChmodBinary