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 arch אם abi לא null.

static File findFile(File dir, String fileName)

חיפוש רספונסיבי בספרייה נתונה של הקובץ הראשון עם השם הנתון

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

הצגת כל הקבצים בספרייה שצוינה עם שם תואם למסנן שצוין, וגם סינון הקבצים שנמצאו לפי abi arch אם abi לא null.

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)

הפונקציה מחזירה את הערך 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)

קישורים קשיחים רפלקטיבים של תוכן התיקיות.

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

קישורים קשיחים רפלקטיבים של תוכן התיקיות.

static void recursiveSymlink(File sourceDir, File destDir)

קישורים סימטריים (symlink) של תוכן תיקיות באופן רקורסיבי.

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

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)

שיטה מסייעת לחישוב base64 md5 של קובץ.

החזרות
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 if cannot recognize size

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: קובץ היעד

זריקות
if failed to copy file

createNamedTempDir

public static File createNamedTempDir (File parentDir, 
                String name)

פונקציית עזר ליצירת ספרייה בעלת שם בתוך תיקייה.

השם של הספרייה הזו לא יהיה אקראי. אם הספרייה כבר קיימת, היא תוחזר.

פרמטרים
parentDir File: הספרייה שבה ייווצר הספרייה. אם הערך הוא null, הספרייה תיווצר ב-/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) שמכיל את תוכן הספרייה

זריקות
if failed to create zip file

createZip

public static void createZip (File dir, 
                File zipFile)

השיטה הזו הוצאה משימוש.
הועבר אל ZipUtil.createZip(File, File).

שיטה שימושית ליצירת קובץ ZIP שמכיל את הספרייה הנתונה ואת כל התוכן שלה.

פרמטרים
dir File: הספרייה שרוצים לדחוס

zipFile File: קובץ ה-zip שייווצר – הוא לא אמור להתקיים כבר

זריקות
if failed to create zip file

deleteFile

public static void deleteFile (File file)

מנסים למחוק קובץ. מיועד לשימוש בזמן ניקוי ב-finally stanzas.

פרמטרים
file File: יכול להיות null.

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) או null אם לא נמצא

זריקות
אם לא ניתן לחלץ את הקובץ

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 הוא null, מוחזר קבוצה ריקה.

findFile

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

הפונקציה מקבלת את כל נתיבי הקבצים בספרייה שצוינה עם שם שתואם לסינון שצוין, וגם מסננת את הקובץ שנמצא לפי abi arch אם abi לא null. הפונקציה מחזירה את קובץ ההתאמה הראשון שנמצא.

פרמטרים
fileName String: String של הביטוי הרגולרי להתאמה לנתיב הקובץ

abi IAbi: אובייקט IAbi של ה-abi שתואם ליעד

dirs File: מערך varargs של אובייקט 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 לא null.

פרמטרים
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) מאובייקטי הקבצים. findFiles(File, String)

findFilesObject

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

אחזור כל נתיבי הקבצים של קבצים בספרייה הנתונה עם שם שתואם לסינון הנתון

פרמטרים
dir File: אובייקט ERROR(/File) של הספרייה לחיפוש קבצים באופן רפלוקטיבי

filter String: String של הביטוי הרגולרי להתאמה לשמות של קבצים

includeDirectory boolean: האם לכלול ספריות בתוצאת החיפוש

החזרות
קבוצה של ERROR(/File) מאובייקטי הקבצים. 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: אם הערך הוא True והקובץ שאליו מקשרים כבר קיים, מדלגים על החרגה.

זריקות
if failed to hardlink file

isDiskSpaceError

public static boolean isDiskSpaceError (String message)

הפונקציה מחזירה את הערך True אם ההודעה היא שגיאה לגבי נפח האחסון בדיסק.

פרמטרים
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: הספרייה או הקובץ שרוצים למחוק. יכול להיות ערך null.

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)

קישורים קשיחים חזרה (recursively) לתוכן התיקיות.

הכלי תומך רק בהעתקה של קבצים וספריות – קישורי סימון לא מועתקים. אם ספריית היעד לא קיימת, היא תיווצר.

פרמטרים
sourceDir File: התיקייה שמכילה את הקבצים שרוצים להעתיק

destDir File: תיקיית היעד

ignoreExistingFile boolean: אם הערך הוא True והקובץ שאליו מקשרים כבר קיים, מדלגים על החרגה.

זריקות
IOException

recursiveSymlink

public static void recursiveSymlink (File sourceDir, 
                File destDir)

קישורים שרירותיים (symlink) של תוכן תיקיות באופן רקורסיבי.

הכלי תומך רק בהעתקה של קבצים וספריות – קישורי סימון לא מועתקים. אם ספריית היעד לא קיימת, היא תיווצר.

פרמטרים
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: קובץ היעד

זריקות
if failed to symlink file

unixModeToPosix

public static  unixModeToPosix (int mode)

המרה של מספר שלם שמייצג את מצב Unix לקבוצה של ERROR(/PosixFilePermission)s

פרמטרים
mode int

החזרות

writeToFile

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

שיטה מסייעת לכתיבה או להוספה של נתוני מחרוזת לקובץ

פרמטרים
inputString String: הקלט String

destFile File: קובץ היעד שבו רוצים לכתוב או לצרף את הקובץ

append boolean: הוספה לסוף הקובץ אם הערך הוא true, מחיקה והוספה אם הערך הוא אחר

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: הוספה לסוף הקובץ אם הערך הוא true, מחיקה והוספה אם הערך הוא אחר

startOffset long: ההתחלה של מקור הנתונים לאחזור נתונים

size long: מספר הבייטים לאחזור מזרם הקלט. מגדירים אותו לערך שלילי כדי לאחזר את כל התוכן החל מההיסט שצוין.

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: הוספה לסוף הקובץ אם הערך הוא true, מחיקה והוספה אם הערך הוא אחר

שיטות מוגנות

chmodExists

protected static boolean chmodExists ()

פונקציית עזר פנימית שבודקת אם הפקודה chmod זמינה במערכת ההפעלה של המערכת.

החזרות
boolean

setChmodBinary

protected static void setChmodBinary (String chmodName)

חשוף לבדיקה. מאפשר לשנות את השם הבינארי של chmod שאנחנו מחפשים, כדי לבדוק את המערכת ללא תמיכה ב-chmod.

פרמטרים
chmodName String