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 List<File> 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)

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

static File createTempDir(String prefix)

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

static File createTempDir(String prefix, File parentDir)

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

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

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

static File createTempFile(String prefix, String suffix)

دالة تضمين مساعدة حول 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)

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

static Set<File> findDirsUnder(File rootDir, File relativeParent)

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

static File findFile(File dir, String fileName)

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

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

الحصول على جميع مسارات الملفات في الدليل المحدّد التي يتطابق اسمها مع الفلتر المحدّد، بالإضافة إلى فلترة الملف الذي تم العثور عليه حسب بنية واجهة التطبيق الثنائية (ABI) إذا لم تكن ABI فارغة

static Set<File> findFiles(String fileName, IAbi abi, boolean includeDirectory, File... dirs)

الحصول على جميع الملفات في الدليل المحدّد التي يتطابق اسمها مع الفلتر المحدّد، بالإضافة إلى فلترة الملفات التي تم العثور عليها حسب بنية واجهة التطبيق الثنائية (ABI) إذا لم تكن ABI فارغة

static Set<String> findFiles(File dir, String filter)

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

static Set<File> findFilesObject(File dir, String filter, boolean includeDirectory)

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

static Set<File> findFilesObject(File dir, String filter)

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

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 Set<PosixFilePermission> unixModeToPosix(int mode)

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

static void writeToFile(String inputString, File destFile)

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

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

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

static void writeToFile(InputStream input, File destFile)

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

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

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

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

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

طُرق محمية

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) للملف
عمليات الطرح
java.io.IOException
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: File لجعل المالك والمجموعة قابلَين للكتابة
المرتجعات
boolean ‫true إذا تم بنجاح جعل الملف قابلاً للكتابة من قِبل المجموعة، false في الحالات الأخرى

chmodGroupRWX

public static boolean chmodGroupRWX (File file)

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

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

المعلَمات
file File: File لجعل المالك والمجموعة قابلَين للكتابة
المرتجعات
boolean ‫true إذا تم ضبط الأذونات بنجاح، أو false في الحالات الأخرى

chmodRWXRecursively

public static boolean chmodRWXRecursively (File file)

المعلَمات
file File

المرتجعات
boolean

closeZip

public static void closeZip (ZipFile zipFile)

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

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

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

collectJars

public static List<File> collectJars (File dir)

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

المعلَمات
dir File

المرتجعات
List<File>

compareFileContents

public static boolean compareFileContents (File file1, 
                File file2)

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

المعلَمات
file1 File

file2 File

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

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: ملف الوجهة
عمليات الطرح
IOException في حال تعذُّر نسخ الملف

createNamedTempDir

public static File createNamedTempDir (File parentDir, 
                String name)

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

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

المعلَمات
parentDir ‫File: الدليل الذي سيتم فيه إنشاء الدليل. إذا كانت القيمة فارغة، سيتم إنشاؤه في /tmp
name String: اسم الدليل الذي سيتم إنشاؤه في المجلد الرئيسي
المرتجعات
File الدليل الذي تم إنشاؤه
عمليات الطرح
IOException

createNamedTempDir

public static File createNamedTempDir (String name)

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

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

المعلَمات
name String: اسم الدليل الذي سيتم إنشاؤه في مجلد tmp.
المرتجعات
File الدليل الذي تم إنشاؤه
عمليات الطرح
IOException

createTempDir

public static File createTempDir (String prefix)

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

المعلَمات
prefix String: سلسلة البادئة التي سيتم استخدامها في إنشاء اسم الملف، ويجب أن تتألف من ثلاثة أحرف على الأقل
المرتجعات
File الدليل الذي تم إنشاؤه
عمليات الطرح
IOException إذا تعذّر إنشاء الملف

createTempDir

public static File createTempDir (String prefix, 
                File parentDir)

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

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

createTempFile

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

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

المعلَمات
prefix String

suffix String

parentDir File

القيم المُعادة
File

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

يُرجى الاطّلاع أيضًا على:

createTempFile

public static File createTempFile (String prefix, 
                String suffix)

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

المعلَمات
prefix String

suffix String

القيم المُعادة
File

عمليات الطرح
FileUtil.LowDiskSpaceException if disk space on temporary partition is lower than minimum allowed
IOException

يُرجى الاطّلاع أيضًا على:

createTempFileForRemote

public static File createTempFileForRemote (String remoteFilePath, 
                File parentDir)

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

المعلَمات
remoteFilePath ‫String: المسار البعيد المفصول بعلامة "/" لإنشاء الاسم منه
parentDir File: المجلد الرئيسي الذي سيتم إنشاء الملف فيه. null لاستخدام الدليل المؤقت التلقائي
المرتجعات
File

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

createZip

public static File createZip (File dir)

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

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

المعلَمات
dir ‫File: الدليل الذي سيتم ضغطه
المرتجعات
File ملف zip مؤقت File يحتوي على محتوى الدليل
عمليات الطرح
IOException في حال تعذّر إنشاء ملف zip

createZip

public static void createZip (File dir, 
                File zipFile)

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

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

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

deleteFile

public static void deleteFile (File file)

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

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

ensureGroupRWX

public static boolean ensureGroupRWX (File file)

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

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

المعلَمات
file File: File لجعل المالك والمجموعة قابلَين للكتابة
المرتجعات
boolean ‫true إذا تم ضبط الأذونات بنجاح، أو false في الحالات الأخرى

extractFileFromZip

public static File extractFileFromZip (ZipFile zipFile, 
                String filePath)

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

طريقة مساعدة لاستخراج ملف معيّن من ملف ZIP إلى ملف مؤقت

المعلَمات
zipFile ZipFile: ZipFile المطلوب استخراجه
filePath String: مسار الملف المطلوب استخراجه
المرتجعات
File File أو قيمة فارغة إذا لم يتم العثور على السمة
عمليات الطرح
IOException في حال تعذّر استخراج الملف

extractZip

public static void extractZip (ZipFile zipFile, 
                File destDir)

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

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

المعلَمات
zipFile ZipFile: ZipFile المطلوب استخراجه
destDir ‫File: المجلد المحلي الذي سيتم استخراج الملف إليه
عمليات الطرح
IOException في حال تعذّر استخراج الملف

findDirectory

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

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

المعلَمات
dirName ‫String: اسم الدليل الذي نبحث عنه.
dirs ‫File: قائمة الأدلة التي نبحث فيها.
المرتجعات
File File مع الدليل الذي تم العثور عليه أو Null إذا لم يتم العثور عليه.
عمليات الطرح
java.io.IOException
IOException

findDirsUnder

public static Set<File> findDirsUnder (File rootDir, 
                File relativeParent)

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

المعلَمات
rootDir ‫File: الدليل الجذر الذي سيتم البحث فيه
relativeParent ‫File: عنصر رئيسي اختياري لجميع عناصر File التي تم عرضها. في حال عدم تحديدها، ستكون جميع قيم File مرتبطة بقيمة rootDir.
المرتجعات
Set<File> مجموعة من File تمثّل جميع الدلائل ضمن rootDir، بما في ذلك rootDir نفسه. إذا كانت rootDir فارغة، يتم عرض مجموعة فارغة.

findFile

public static File findFile (File dir, 
                String fileName)

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

المعلَمات
dir ‫File: الدليل الذي تريد البحث فيه
fileName String: اسم الملف المطلوب البحث عنه
المرتجعات
File File أو null إذا تعذّر العثور عليه

findFile

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

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

المعلَمات
fileName String: String الخاص بالتعبير العادي لمطابقة مسار الملف
abi ‫IAbi: عنصر IAbi الخاص بواجهة التطبيق الثنائية (ABI) المطلوب مطابقته مع الهدف
dirs ‫File: صفيف varargs لعناصر File من الدلائل التي سيتم البحث فيها عن الملفات
المرتجعات
File File أو null إذا تعذّر العثور عليه
عمليات الطرح
IOException

findFiles

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

الحصول على جميع الملفات في الدليل المحدّد التي يتطابق اسمها مع الفلتر المحدّد، بالإضافة إلى فلترة الملفات التي تم العثور عليها حسب بنية واجهة التطبيق الثنائية (ABI) إذا لم تكن ABI فارغة

المعلَمات
fileName String: String الخاص بالتعبير العادي لمطابقة مسار الملف
abi ‫IAbi: عنصر IAbi الخاص بواجهة التطبيق الثنائية (ABI) المطلوب مطابقته مع الهدف
includeDirectory ‫boolean: تحدّد هذه السمة ما إذا كان سيتم تضمين الأدلة في نتيجة البحث.
dirs File: صفيف من عناصر File الخاصة بالأدلة التي سيتم البحث فيها عن الملفات
المرتجعات
Set<File> مجموعة من Files أو فارغة إذا تعذّر العثور عليها
عمليات الطرح
IOException

findFiles

public static Set<String> findFiles (File dir, 
                String filter)

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

المعلَمات
dir File: عنصر File في الدليل للبحث عن الملفات بشكل متكرر
filter String: String الخاص بالتعبير العادي لمطابقة أسماء الملفات
المرتجعات
Set<String> مجموعة من String من مسارات الملفات
عمليات الطرح
IOException

findFilesObject

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

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

المعلَمات
dir File: عنصر File في الدليل للبحث عن الملفات بشكل متكرر
filter String: String الخاص بالتعبير العادي لمطابقة أسماء الملفات
includeDirectory ‫boolean: تحدّد هذه السمة ما إذا كان سيتم تضمين الأدلة في نتيجة البحث.
المرتجعات
Set<File> مجموعة من File من عناصر الملفات @See findFiles(File,String)
عمليات الطرح
IOException

findFilesObject

public static Set<File> findFilesObject (File dir, 
                String filter)

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

المعلَمات
dir File: عنصر File في الدليل للبحث عن الملفات بشكل متكرر
filter String: String الخاص بالتعبير العادي لمطابقة أسماء الملفات
المرتجعات
Set<File> مجموعة من File من عناصر الملفات @See findFiles(File,String)
عمليات الطرح
IOException

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 File الذي يمثّل المسار المحدّد، مع فصل كل pathSegment بواسطة File.separatorChar

getPath

public static String getPath (String... pathSegments)

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

المعلَمات
pathSegments ‫String: شرائح المسار النسبي المطلوب استخدامها
المرتجعات
String String الذي يمثّل المسار المحدّد، مع فصل كل pathSegment بواسطة File.separatorChar

gzipFile

public static void gzipFile (File file, 
                File gzipFile)

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

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

المعلَمات
file ‫File: الملف الأصلي
gzipFile File: الملف الذي سيتم وضع المحتوى المضغوط فيه
عمليات الطرح
java.io.IOException
IOException

hardlinkFile

public static void hardlinkFile (File origFile, 
                File destFile)

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

المعلَمات
origFile ‫File: الملف الأصلي
destFile File: ملف الوجهة
عمليات الطرح
IOException في حال تعذّر إنشاء رابط ثابت للملف

hardlinkFile

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

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

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

isDiskSpaceError

public static boolean isDiskSpaceError (String message)

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

المعلَمات
message String

المرتجعات
boolean

mkdirsRWX

public static boolean mkdirsRWX (File file)

طريقة لإنشاء سلسلة من الأدلة، وضبطها كلها على إذن التنفيذ/القراءة/الكتابة للمجموعة عند إنشائها، وذلك من خلال استدعاء chmodGroupRWX(File). وهو في الأساس إصدار من 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

عمليات الطرح
FileNotFoundException
java.io.IOException
IOException

readStringFromFile

public static String readStringFromFile (File sourceFile)

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

المعلَمات
sourceFile ‫File: الملف الذي سيتم القراءة منه
المرتجعات
String

عمليات الطرح
FileNotFoundException
java.io.IOException
IOException

recursiveCopy

public static void recursiveCopy (File sourceDir, 
                File destDir)

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

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

المعلَمات
sourceDir File: المجلد الذي يحتوي على الملفات المطلوب نسخها
destDir File: مجلد الوجهة
عمليات الطرح
java.io.IOException
IOException

recursiveDelete

public static void recursiveDelete (File rootDir)

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

المعلَمات
rootDir ‫File: الدليل أو الملف المطلوب حذفه، ويمكن أن تكون القيمة فارغة

recursiveHardlink

public static void recursiveHardlink (File sourceDir, 
                File destDir)

إنشاء روابط ثابتة بشكل متكرّر لمحتوى المجلد

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

المعلَمات
sourceDir File: المجلد الذي يحتوي على الملفات المطلوب نسخها
destDir File: مجلد الوجهة
عمليات الطرح
java.io.IOException
IOException

recursiveHardlink

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

إنشاء روابط ثابتة بشكل متكرّر لمحتوى المجلد

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

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

recursiveSymlink

public static void recursiveSymlink (File sourceDir, 
                File destDir)

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

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

المعلَمات
sourceDir File: المجلد الذي يحتوي على الملفات المطلوب نسخها
destDir File: مجلد الوجهة
عمليات الطرح
java.io.IOException
IOException

saveResourceFile

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

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

المعلَمات
resourceStream ‫InputStream: كائن {link InputStream} للمورد المطلوب حفظه.
destDir ‫File: عنصر File يمثّل دليلاً سيتم حفظ ملف المورد فيه.
targetFileName String: String لاسم الملف الذي سيتم الحفظ فيه
المرتجعات
File كائن File للملف المحفوظ
عمليات الطرح
IOException إذا تعذّر حفظ الملف

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: ملف الوجهة
عمليات الطرح
IOException في حال تعذُّر إنشاء رابط رمزي للملف

unixModeToPosix

public static Set<PosixFilePermission> unixModeToPosix (int mode)

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

المعلَمات
mode int

المرتجعات
Set<PosixFilePermission>

writeToFile

public static void writeToFile (String inputString, 
                File destFile)

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

المعلَمات
inputString String: الإدخال String
destFile ‫File: ملف الوجهة الذي سيتم الكتابة إليه
عمليات الطرح
IOException

writeToFile

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

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

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

writeToFile

public static void writeToFile (InputStream input, 
                File destFile)

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

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

writeToFile

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

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

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

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: عدد وحدات البايت المطلوب استردادها من دفق الإدخال، اضبطها على قيمة سالبة لاسترداد كل المحتوى بدءًا من الإزاحة المحدّدة.
عمليات الطرح
IOException

طُرق محمية

chmodExists

protected static boolean chmodExists ()

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

المرتجعات
boolean

setChmodBinary

protected static void setChmodBinary (String chmodName)

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

المعلَمات
chmodName String