فایل‌یوتی

public class FileUtil
extends 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)

اندازه فایل داده شده بر حسب بایت را به فرمتی خواناتر با فرمت XY[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)

تابع کمکیِ پوشش‌دهنده‌ی 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 arch فیلتر کنید.

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

تمام فایل‌های موجود در دایرکتوری داده شده که نامشان با فیلتر داده شده مطابقت دارد را دریافت می‌کند و همچنین اگر abi مقدار null ندارد، فایل‌های یافت شده را بر اساس abi arch فیلتر می‌کند.

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)

اگر پیام مربوط به خطای فضای دیسک باشد، مقدار true را برمی‌گرداند.

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)

به صورت بازگشتی، محتویات پوشه را hardlink می‌کند.

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

به صورت بازگشتی، محتویات پوشه را hardlink می‌کند.

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)

یک عدد صحیح که نشان دهنده حالت یونیکس است را به مجموعه‌ای از 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)

برای آزمایش در معرض دید قرار گرفت.

ثابت‌ها

حداکثر طول نام فایل سیستم فایل 

public static final int FILESYSTEM_FILENAME_MAX_LENGTH

مقدار ثابت: ۲۵۵ (۰x۰۰۰۰۰۰ff)

سازندگان عمومی

فایل‌یوتی 

public FileUtil ()

روش‌های عمومی

محاسبهBase64Md5 

public static String calculateBase64Md5 (File file)

روش کمکی برای محاسبه md5 از base64 برای یک فایل.

بازگشت‌ها
String md5 فایل

محاسبهCrc32 

public static long calculateCrc32 (File file)

روش کمکی برای محاسبه CRC-32 برای یک فایل.

بازگشت‌ها
long CRC-32 پرونده

پرتاب‌ها
استثنای java.io.IO
IOException

محاسبه‌ی Md5 

public static String calculateMd5 (File file)

روش کمکی برای محاسبه md5 برای یک فایل.

بازگشت‌ها
String md5 فایل

سطح دسترسی 

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

chmodRWX به صورت بازگشتی 

public static boolean chmodRWXRecursively (File file)

پارامترها
file File

بازگشت‌ها
boolean

بستن زیپ 

public static void closeZip (ZipFile zipFile)

این روش منسوخ شده است.
به ZipUtil.closeZip(ZipFile) منتقل شد.

یک ZipFile باز را بدون در نظر گرفتن هرگونه استثنا، ببندید.

پارامترها
zipFile ZipFile : فایلی که باید بسته شود

جمع آوری کوزه ها 

public static List<File> collectJars (File dir)

تمام فایل‌های jar موجود در دایرکتوری داده شده را برمی‌گرداند。

پارامترها
dir File

بازگشت‌ها
List<File>

مقایسه محتویات فایل 

public static boolean compareFileContents (File file1, 
                File file2)

روشی کاربردی برای مقایسه محتوای دو فایل به صورت بایت به بایت.

پارامترها
file1 File

file2 File

بازگشت‌ها
boolean اگر محتوای فایل یکسان باشد، true

پرتاب‌ها
IOException

تبدیل اندازه به بایت 

public static long convertSizeToBytes (String sizeString)

معکوس تابع convertToReadableSize(long) است. فرمت قابل خواندن شرح داده شده در convertToReadableSize(long) را به مقدار بایت تبدیل می‌کند.

پارامترها
sizeString String : توصیف رشته‌ای اندازه.

بازگشت‌ها
long اندازه به بایت

پرتاب‌ها
IllegalArgumentException اگر نتواند اندازه را تشخیص دهد

تبدیل به فضای دیسکدر صورت نیاز 

public static IOException convertToDiskSpaceIfNeeded (IOException e)

در صورت نیاز، خطا را در یک خطای فضای دیسک قرار می‌دهد.

پارامترها
e IOException

بازگشت‌ها
IOException

تبدیل به اندازه قابل خواندن 

public static String convertToReadableSize (long sizeLong)

اندازه فایل داده شده بر حسب بایت را به فرمتی خواناتر با فرمت XY[KMGT] تبدیل کنید.

پارامترها
sizeLong long : اندازه فایل بر حسب بایت

بازگشت‌ها
String رشته توصیفی از اندازه فایل

کپی‌فایل 

public static void copyFile (File origFile, 
                File destFile)

یک متد کمکی که محتویات یک فایل را در یک فایل محلی کپی می‌کند.

پارامترها
origFile File : فایل اصلی که قرار است کپی شود

destFile File : فایل مقصد

پرتاب‌ها
IOException اگر کپی کردن فایل ناموفق بود

ایجاد دایرکتوری موقت 

public static File createNamedTempDir (File parentDir, 
                String name)

تابع کمکی برای ایجاد یک دایرکتوری نامگذاری شده درون یک پوشه.

نام این دایرکتوری تصادفی نخواهد بود. اگر دایرکتوری از قبل وجود داشته باشد، آن را برمی‌گرداند.

پارامترها
parentDir File : دایرکتوری که دایرکتوری در آن ایجاد می‌شود. اگر تهی باشد، در /tmp خواهد بود.

name String : نام دایرکتوری که قرار است در پوشه والد ایجاد شود.

بازگشت‌ها
File دایرکتوری ایجاد شده

پرتاب‌ها
IOException

ایجاد دایرکتوری موقت 

public static File createNamedTempDir (String name)

تابع کمکی برای ایجاد یک دایرکتوری نامگذاری شده در داخل پوشه موقت شما.

نام این دایرکتوری تصادفی نخواهد بود. اگر دایرکتوری از قبل وجود داشته باشد، آن را برمی‌گرداند.

پارامترها
name String : نام دایرکتوری که قرار است در پوشه tmp شما ایجاد شود.

بازگشت‌ها
File دایرکتوری ایجاد شده

پرتاب‌ها
IOException

ایجاد دایرکتوری موقت 

public static File createTempDir (String prefix)

تابع کمکی برای ایجاد یک دایرکتوری موقت در دایرکتوری پیش‌فرض فایل‌های موقت سیستم.

پارامترها
prefix String : رشته پیشوندی که برای تولید نام فایل استفاده می‌شود؛ باید حداقل سه کاراکتر داشته باشد

بازگشت‌ها
File دایرکتوری ایجاد شده

پرتاب‌ها
IOException اگر فایل ایجاد نشد

ایجاد دایرکتوری موقت 

public static File createTempDir (String prefix, 
                File parentDir)

تابع کمکی برای ایجاد یک دایرکتوری موقت.

پارامترها
prefix String : رشته پیشوندی که برای تولید نام فایل استفاده می‌شود؛ باید حداقل سه کاراکتر داشته باشد

parentDir File : دایرکتوری والد که قرار است دایرکتوری در آن ایجاد شود. اگر null دایرکتوری موقت پیش‌فرض سیستم استفاده خواهد شد.

بازگشت‌ها
File دایرکتوری ایجاد شده

پرتاب‌ها
IOException اگر فایل ایجاد نشد

ایجاد فایل موقت 

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

همچنین ببینید:

ایجاد فایل موقت 

public static File createTempFile (String prefix, 
                String suffix)

تابع کمکیِ پوشش‌دهنده‌ی File.createTempFile(String,String) که سناریوی احتمالیِ کمبود فضای دیسک را بررسی می‌کند.

پارامترها
prefix String

suffix String

بازگشت‌ها
File

پرتاب‌ها
FileUtil.LowDiskSpaceException اگر فضای دیسک روی پارتیشن موقت کمتر از حداقل مجاز باشد
IOException

همچنین ببینید:

ایجاد فایل موقت برای ریموت 

public static File createTempFileForRemote (String remoteFilePath, 
                File parentDir)

متد کمکی که یک فایل منحصر به فرد روی دیسک موقت می‌سازد، که نام آن تا حد امکان با نام فایل داده شده توسط مسیر فایل راه دور مطابقت دارد.

پارامترها
remoteFilePath String : مسیر دوردست جدا شده با '/' برای ساخت نام از

parentDir File : دایرکتوری والد برای ایجاد فایل. null برای استفاده از دایرکتوری موقت پیش‌فرض

بازگشت‌ها
File

پرتاب‌ها
IOException

ایجادZip 

public static File createZip (File dir)

این روش منسوخ شده است.
به ZipUtil.createZip(File) منتقل شد.

روشی کاربردی برای ایجاد یک فایل زیپ موقت حاوی دایرکتوری داده شده و تمام محتویات آن.

پارامترها
dir File : دایرکتوری که باید فشرده شود

بازگشت‌ها
File یک File زیپ موقت حاوی محتویات دایرکتوری

پرتاب‌ها
IOException اگر نتوانستید فایل زیپ ایجاد کنید

ایجادZip 

public static void createZip (File dir, 
                File zipFile)

این روش منسوخ شده است.
به ZipUtil.createZip(File,File) منتقل شد.

روشی کاربردی برای ایجاد یک فایل زیپ حاوی دایرکتوری داده شده و تمام محتویات آن.

پارامترها
dir File : دایرکتوری که باید فشرده شود

zipFile File : فایل زیپی که باید ایجاد شود - نباید از قبل وجود داشته باشد

پرتاب‌ها
IOException اگر نتوانستید فایل زیپ ایجاد کنید

حذف فایل 

public static void deleteFile (File file)

سعی کنید یک فایل را حذف کنید. این دستور برای استفاده هنگام تمیز کردن در بخش‌های finally در نظر گرفته شده است.

پارامترها
file File : ممکن است تهی باشد.

sureGroupRWX 

public static boolean ensureGroupRWX (File file)

تمام تلاش خود را می‌کند تا از قابل اجرا، قابل خواندن و قابل نوشتن بودن فایل گروه داده شده اطمینان حاصل کند.

اگر دستور سیستمی 'chmod' توسط سیستم عامل اصلی پشتیبانی نشود، سعی می‌کند مجوزها را برای همه کاربران تنظیم کند. این عملیات برای جلوگیری از شرایط رقابتی ایجاد شده توسط دسترسی به فایل‌ها از یک حافظه پنهان، مانند GCSFileDownloader، هماهنگ می‌شود.

پارامترها
file File : File که مالک و گروه را قابل نوشتن می‌کند.

بازگشت‌ها
boolean اگر مجوزها با موفقیت تنظیم شده باشند، true و در غیر این صورت false

استخراج فایل از زیپ 

public static File extractFileFromZip (ZipFile zipFile, 
                String filePath)

این روش منسوخ شده است.
به ZipUtil.extractFileFromZip(ZipFile,String) منتقل شد.

روش کاربردی برای استخراج یک فایل خاص از فایل زیپ به یک فایل tmp

پارامترها
zipFile ZipFile : ZipFile که قرار است استخراج شود

filePath String : مسیر فایلی که قرار است استخراج شود

بازگشت‌ها
File File یا اگر یافت نشد، null

پرتاب‌ها
IOException اگر فایل استخراج نشد

استخراج زیپ 

public static void extractZip (ZipFile zipFile, 
                File destDir)

این روش منسوخ شده است.
به ZipUtil.extractZip(ZipFile,File) منتقل شد.

روش کاربردی برای استخراج کل محتویات فایل زیپ در دایرکتوری داده شده

پارامترها
zipFile ZipFile : ZipFile که قرار است استخراج شود

destDir File : دایرکتوری محلی برای استخراج فایل به آن

پرتاب‌ها
IOException اگر فایل استخراج نشد

پیدا کردن دایرکتوری 

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

جستجو و بازگرداندن اولین دایرکتوری File در میان سایر دایرکتوری‌ها.

پارامترها
dirName String : نام دایرکتوری که به دنبال آن هستیم.

dirs File : فهرست دایرکتوری‌هایی که ما جستجو می‌کنیم.

بازگشت‌ها
File File که دایرکتوری آن پیدا شده یا در صورت پیدا نشدن، Null .

پرتاب‌ها
استثنای java.io.IO
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 تهی (null) باشد، یک مجموعه‌ی خالی برگردانده می‌شود.

پیدا کردن فایل 

public static File findFile (File dir, 
                String fileName)

به صورت بازگشتی، دایرکتوری داده شده را برای اولین فایل با نام داده شده جستجو کنید.

پارامترها
dir File : دایرکتوری مورد جستجو

fileName String : نام فایلی که باید جستجو شود

بازگشت‌ها
File File یا اگر پیدا نشد null

پیدا کردن فایل 

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

تمام مسیرهای فایل‌ها در دایرکتوری داده شده که نام آنها با فیلتر داده شده مطابقت دارد را دریافت کنید و همچنین اگر abi تهی نباشد، فایل یافت شده را با abi arch فیلتر کنید. اولین فایل منطبق یافت شده را برگردانید.

پارامترها
fileName String : String از عبارت منظم (regex) که با مسیر فایل مطابقت دارد.

abi IAbi : شیء IAbi از abi برای تطبیق با هدف

dirs File : آرایه‌ای از متغیرها از شیء File مربوط به دایرکتوری‌ها برای جستجوی فایل‌ها

بازگشت‌ها
File File یا اگر پیدا نشد null

پرتاب‌ها
IOException

پیدا کردن فایل‌ها 

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

تمام فایل‌های موجود در دایرکتوری داده شده که نامشان با فیلتر داده شده مطابقت دارد را دریافت می‌کند و همچنین اگر abi مقدار null ندارد، فایل‌های یافت شده را بر اساس abi arch فیلتر می‌کند.

پارامترها
fileName String : String از عبارت منظم (regex) که با مسیر فایل مطابقت دارد.

abi IAbi : شیء IAbi از abi برای تطبیق با هدف

includeDirectory boolean : آیا دایرکتوری‌ها در نتیجه جستجو لحاظ شوند یا خیر

dirs File : آرایه‌ای از شیء File از دایرکتوری‌ها برای جستجوی فایل‌ها

بازگشت‌ها
Set<File> مجموعه‌ای از File یا اگر پیدا نشد، خالی

پرتاب‌ها
IOException

پیدا کردن فایل‌ها 

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

تمام مسیرهای فایل‌ها را در دایرکتوری داده شده که نام آنها با فیلتر داده شده مطابقت دارد، دریافت کنید.

پارامترها
dir File : شیء File از دایرکتوری برای جستجوی بازگشتی فایل‌ها

filter String : String از عبارت منظم برای تطبیق نام فایل‌ها

بازگشت‌ها
Set<String> مجموعه‌ای از String مسیرهای فایل

پرتاب‌ها
IOException

شیء findFiles 

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

شیء findFiles 

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

تمام مسیرهای فایل‌ها را در دایرکتوری داده شده که نام آنها با فیلتر داده شده مطابقت دارد، دریافت کنید.

پارامترها
dir File : شیء File از دایرکتوری برای جستجوی بازگشتی فایل‌ها

filter String : String از عبارت منظم برای تطبیق نام فایل‌ها

بازگشت‌ها
Set<File> مجموعه‌ای از اشیاء فایل به نام File . @See findFiles(File,String)

پرتاب‌ها
IOException

دریافت نام پایه 

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 پسوند یا رشته خالی اگر فایل پسوندی نداشته باشد

دریافت فایل برای مسیر 

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

روش کمکی برای ساخت یک فایل وابسته به سیستم

پارامترها
parentDir File : دایرکتوری والد مورد استفاده.

pathSegments String : بخش‌های مسیر نسبی مورد استفاده

بازگشت‌ها
File File که مسیر داده شده را نشان می‌دهد، که هر pathSegment با File.separatorChar از آن جدا شده است.

مسیر دریافت 

public static String getPath (String... pathSegments)

روش کمکی برای ساخت یک مسیر نسبی وابسته به سیستم

پارامترها
pathSegments String : بخش‌های مسیر نسبی مورد استفاده

بازگشت‌ها
String String که مسیر داده شده را نشان می‌دهد، که هر pathSegment با File.separatorChar از آن جدا شده است

فایل gzip 

public static void gzipFile (File file, 
                File gzipFile)

این روش منسوخ شده است.
به ZipUtil.gzipFile(File,File) منتقل شد.

متد کمکی برای ایجاد یک نسخه gzip شده از یک فایل واحد.

پارامترها
file File : فایل اصلی

gzipFile File : فایلی که محتوای فشرده شده در آن قرار می‌گیرد

پرتاب‌ها
استثنای java.io.IO
IOException

هاردلینک فایل 

public static void hardlinkFile (File origFile, 
                File destFile)

یک متد کمکی که یک فایل را به فایل دیگر hardlink می‌کند. در صورت نیاز به کپی کردن در صورت اتصال پارتیشن‌های متقاطع، از آن استفاده می‌شود.

پارامترها
origFile File : فایل اصلی

destFile File : فایل مقصد

پرتاب‌ها
IOException اگر فایل hardlink نشد

هاردلینک فایل 

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

یک متد کمکی که یک فایل را به فایل دیگر hardlink می‌کند. در صورت نیاز به کپی کردن در صورت اتصال پارتیشن‌های متقاطع، از آن استفاده می‌شود.

پارامترها
origFile File : فایل اصلی

destFile File : فایل مقصد

ignoreExistingFile boolean : اگر True باشد و فایلی که لینک می‌شود از قبل وجود داشته باشد، از استثنا صرف نظر کن.

پرتاب‌ها
IOException اگر فایل hardlink نشد

خطای isDiskSpaceError 

public static boolean isDiskSpaceError (String message)

اگر پیام مربوط به خطای فضای دیسک باشد، مقدار true را برمی‌گرداند.

پارامترها
message String

بازگشت‌ها
boolean

mkdirsRWX 

public static boolean mkdirsRWX (File file)

روشی برای ایجاد زنجیره‌ای از دایرکتوری‌ها و تنظیم گروه‌های اجرا/خواندن/نوشتن برای همه آنها هنگام ایجاد، با فراخوانی chmodGroupRWX(File) . اساساً نسخه‌ای از File.mkdirs() است که chmod(File,String) را نیز اجرا می‌کند.

پارامترها
file File : نام دایرکتوری که باید ایجاد شود، احتمالاً حاوی دایرکتوری‌هایی که هنوز وجود ندارند.

بازگشت‌ها
boolean اگر file وجود داشته باشد و یک دایرکتوری باشد، true و در غیر این صورت false .

خواندن رشته از فایل 

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

یک متد کمکی برای خواندن داده‌های رشته‌ای جزئی از یک فایل

پارامترها
sourceFile File : فایلی که قرار است از آن خوانده شود

startOffset long : نقطه شروع برای خواندن از فایل.

length long : تعداد بایت‌هایی که باید از فایل خوانده شوند.

بازگشت‌ها
String

پرتاب‌ها
استثنای فایل پیدا نشد
استثنای java.io.IO
IOException

خواندن رشته از فایل 

public static String readStringFromFile (File sourceFile)

یک متد کمکی برای خواندن داده‌های رشته‌ای از یک فایل

پارامترها
sourceFile File : فایلی که قرار است از آن خوانده شود

بازگشت‌ها
String

پرتاب‌ها
استثنای فایل پیدا نشد
استثنای java.io.IO
IOException

کپی بازگشتی 

public static void recursiveCopy (File sourceDir, 
                File destDir)

کپی کردن بازگشتی محتویات پوشه

فقط از کپی کردن فایل‌ها و دایرکتوری‌ها پشتیبانی می‌کند - لینک‌های نمادین کپی نمی‌شوند. اگر دایرکتوری مقصد وجود نداشته باشد، ایجاد خواهد شد.

پارامترها
sourceDir File : پوشه‌ای که فایل‌های مورد نظر برای کپی در آن قرار دارند

destDir File : پوشه مقصد

پرتاب‌ها
استثنای java.io.IO
IOException

حذف بازگشتی 

public static void recursiveDelete (File rootDir)

حذف بازگشتی فایل یا دایرکتوری داده شده و تمام محتویات آن.

پارامترها
rootDir File : دایرکتوری یا فایلی که قرار است حذف شود؛ می‌تواند تهی (null) باشد.

بازگشتی هاردلینک 

public static void recursiveHardlink (File sourceDir, 
                File destDir)

به صورت بازگشتی، محتویات پوشه را hardlink می‌کند.

فقط از کپی کردن فایل‌ها و دایرکتوری‌ها پشتیبانی می‌کند - لینک‌های نمادین کپی نمی‌شوند. اگر دایرکتوری مقصد وجود نداشته باشد، ایجاد خواهد شد.

پارامترها
sourceDir File : پوشه‌ای که فایل‌های مورد نظر برای کپی در آن قرار دارند

destDir File : پوشه مقصد

پرتاب‌ها
استثنای java.io.IO
IOException

بازگشتی هاردلینک 

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

به صورت بازگشتی، محتویات پوشه را hardlink می‌کند.

فقط از کپی کردن فایل‌ها و دایرکتوری‌ها پشتیبانی می‌کند - لینک‌های نمادین کپی نمی‌شوند. اگر دایرکتوری مقصد وجود نداشته باشد، ایجاد خواهد شد.

پارامترها
sourceDir File : پوشه‌ای که فایل‌های مورد نظر برای کپی در آن قرار دارند

destDir File : پوشه مقصد

ignoreExistingFile boolean : اگر True باشد و فایلی که لینک می‌شود از قبل وجود داشته باشد، از استثنا صرف نظر کن.

پرتاب‌ها
استثنای java.io.IO
IOException

سیملینک بازگشتی 

public static void recursiveSymlink (File sourceDir, 
                File destDir)

به صورت بازگشتی، محتویات پوشه را به هم پیوند می‌دهد.

فقط از کپی کردن فایل‌ها و دایرکتوری‌ها پشتیبانی می‌کند - لینک‌های نمادین کپی نمی‌شوند. اگر دایرکتوری مقصد وجود نداشته باشد، ایجاد خواهد شد.

پارامترها
sourceDir File : پوشه‌ای که فایل‌های مورد نظر برای کپی در آن قرار دارند

destDir File : پوشه مقصد

پرتاب‌ها
استثنای java.io.IO
IOException

ذخیره فایل منبع 

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

اندازه دایرکتوری 

public static Long sizeOfDirectory (File directory)

اندازه گزارش شده توسط دایرکتوری را برمی‌گرداند.

پارامترها
directory File

بازگشت‌ها
Long

فایل پیوند نمادین 

public static void symlinkFile (File origFile, 
                File destFile)

یک متد کمکی که یک فایل را به فایل دیگر پیوند نمادین می‌دهد

پارامترها
origFile File : فایل اصلی

destFile File : فایل مقصد

پرتاب‌ها
IOException اگر نتوانستید فایل را به سیملینک تبدیل کنید

unixModeToPosix 

public static Set<PosixFilePermission> unixModeToPosix (int mode)

یک عدد صحیح که نشان دهنده حالت یونیکس است را به مجموعه‌ای از PosixFilePermission تبدیل می‌کند.

پارامترها
mode int

بازگشت‌ها
Set<PosixFilePermission>

نوشتن به فایل 

public static void writeToFile (String inputString, 
                File destFile)

یک متد کمکی برای نوشتن داده‌های رشته‌ای در فایل

پارامترها
inputString String : String ورودی

destFile File : فایل مقصد برای نوشتن در آن

پرتاب‌ها
IOException

نوشتن به فایل 

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

یک متد کمکی برای نوشتن داده‌های جریانی در فایل

پارامترها
input InputStream : جریان ورودی بافر نشده

destFile File : فایل مقصد برای نوشتن یا الحاق به آن

append boolean : اگر درست باشد به انتهای فایل اضافه می‌شود، در غیر این صورت بازنویسی می‌شود

پرتاب‌ها
IOException

نوشتن به فایل 

public static void writeToFile (InputStream input, 
                File destFile)

یک متد کمکی برای نوشتن داده‌های جریانی در فایل

پارامترها
input InputStream : جریان ورودی بافر نشده

destFile File : فایل مقصد برای نوشتن در آن

پرتاب‌ها
IOException

نوشتن به فایل 

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

یک متد کمکی برای نوشتن یا اضافه کردن داده‌های رشته‌ای به فایل

پارامترها
inputString String : String ورودی

destFile File : فایل مقصد برای نوشتن یا الحاق به آن

append boolean : اگر درست باشد به انتهای فایل اضافه می‌شود، در غیر این صورت بازنویسی می‌شود

پرتاب‌ها
IOException

نوشتن به فایل 

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