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 إذا كانت مساحة القرص في القسم أقل من الحد الأدنى المسموح به

createTempFile

public static File createTempFile (String prefix, 
                String suffix)

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

المعلمات
prefix String

suffix String

المرتجعات
File

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

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