FileUtil

public class FileUtil
extends Object

JavaScript.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)

פונקציית wrapper של עזרה בסביבות ERROR(/File#createTempFile(String, String, File)) שבודקת אם מתאפשרת תרחיש פוטנציאלי שנפח האחסון הפנוי בכונן הוא חסר.

static File createTempFile(String prefix, String suffix)

פונקציית wrapper של Assistant סביב 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)

תוכן תיקייה עם קישור סימבולי באופן רקורסיבי.

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)

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

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

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

static void writeToFile(String inputString, File destFile)

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

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

שיטה מסייעת לכתיבת נתוני סטרימינג בקובץ

static void writeToFile(InputStream input, File destFile)

שיטה מסייעת לכתיבת נתוני סטרימינג בקובץ

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

שיטה מסייעת לכתיבת נתוני סטרימינג בקובץ

שיטות מוגנות

static boolean chmodExists()

עוזר פנימי לקבוע אם 'chmod' זמין במערכת ההפעלה.

static void setChmodBinary(String chmodName)

חשיפה לבדיקה.

קבועים

FILESYSTEM_FILENAME_MAX_LENGTH

public static final int FILESYSTEM_FILENAME_MAX_LENGTH

ערך קבוע: 255 (0x000000ff)

בנאים ציבוריים

FileUtil

public FileUtil ()

שיטות ציבוריות

חישובBase64Md5

public static String calculateBase64Md5 (File file)

שיטת העזרה לחישוב base64 md5 לקובץ.

החזרות
String md5 של הקובץ

חישובCrc32

public static long calculateCrc32 (File file)

שיטת העוזר הדיגיטלי לחישוב CRC-32 בקובץ.

החזרות
long CRC-32 של הקובץ

קליעות
חריגת IO

מחושב Md5

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

chmodRWXRecursivity

public static boolean chmodRWXRecursively (File file)

פרמטרים
file File

החזרות
boolean

סגירת ה-Zip

public static void closeZip (ZipFile zipFile)

השיטה הזו הוצאה משימוש.
הועברה אל ZipUtil#closeZip(ZipFile).

סוגרים ERROR(/ZipFile) פתוח, תוך התעלמות מכל החריגים.

פרמטרים
zipFile ZipFile: הקובץ לסגירה

collectedJars

public static  collectJars (File dir)

פונקציה זו מחזירה את כל קובצי ה-jar שנמצאו בספרייה נתונה

פרמטרים
dir File

החזרות

השוואתFileContents

public static boolean compareFileContents (File file1, 
                File file2)

שיטת שירות להשוואה בין שני קבצים מבחינת בייטים.

פרמטרים
file1 File

file2 File

החזרות
boolean true אם תוכן הקובץ זהה

conversionSizeToBytes

public static long convertSizeToBytes (String sizeString)

הערך ההופכי של הערך convertToReadableSize(long). ממירה את הפורמט הקריא המתואר ב-convertToReadableSize(long) לערך של בייט.

פרמטרים
sizeString String: תיאור המחרוזת של המידה.

החזרות
long הגודל בבייטים

קליעות
IllegalArgumentException אם לא ניתן לזהות גודל

convertToDiskSpaceIfNeeded

public static IOException convertToDiskSpaceIfNeeded (IOException e)

במקרה הצורך, מתבצעת גלישת שגיאה לתוך שגיאה של מקום בכונן.

פרמטרים
e IOException

החזרות
IOException

conversionToReadableSize

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: הספרייה שבה יוצרים את ה-dir. אם הערך הוא 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)

פונקציית wrapper של עזרה בסביבות ERROR(/File#createTempFile(String, String, File)) שבודקת אם מתאפשרת תרחיש פוטנציאלי שנפח האחסון הפנוי בכונן הוא חסר.

פרמטרים
prefix String

suffix String

parentDir File

החזרות
File

קליעות
FileUtil.LowDiskSpaceException אם מקום האחסון במחיצה קטן מהמינימום המותר

קובץ createTempFile

public static File createTempFile (String prefix, 
                String suffix)

פונקציית wrapper של Assistant סביב 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: יכול להיות null.

להבטיחGroupRWX

public static boolean ensureGroupRWX (File file)

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

אם 'chmod' פקודת המערכת אינה נתמכת על ידי מערכת ההפעלה הבסיסית, היא תנסה להגדיר הרשאות לכל המשתמשים. הפעולה מסונכרנת כדי למנוע מרוץ תהליכים באמצעות גישה לקבצים ממטמון, למשל GCSFileDownloader.

פרמטרים
file File: ERROR(/File) כדי להפוך את הבעלים והקבוצה לניתן לכתיבה

החזרות
boolean true אם ההרשאות הוגדרו בהצלחה, אחרת false

exportFileFromZip

public static File extractFileFromZip (ZipFile zipFile, 
                String filePath)

השיטה הזו הוצאה משימוש.
הועברה אל ZipUtil#extractFileFromZip(ZipFile, String).

שיטת שירות לחילוץ קובץ ספציפי אחד מקובץ ZIP לקובץ tmp

פרמטרים
zipFile ZipFile: ERROR(/ZipFile) לחילוץ

filePath String: הנתיב של הקובץ לחילוץ

החזרות
File ERROR(/File) או null אם לא נמצא

קליעות
אם חילוץ הקובץ נכשל

חילוץ Zip

public static void extractZip (ZipFile zipFile, 
                File destDir)

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

שיטת שירות לחילוץ התוכן כולו של קובץ ZIP לספרייה נתונה

פרמטרים
zipFile ZipFile: ERROR(/ZipFile) לחילוץ

destDir File: ה-dir המקומי שאליו רוצים לחלץ את הקובץ

קליעות
אם חילוץ הקובץ נכשל

חיפוש ספרייה

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

חיפוש והחזרה של הספרייה הראשונה ERROR(/File) בין שאר הספריות.

פרמטרים
dirName String: שם הספרייה שאנחנו מחפשים.

dirs File: רשימת הספריות שאנחנו מחפשים.

החזרות
File ERROR(/File) עם הספרייה נמצאה או Null אם לא נמצא.

קליעות
חריגת IO

findDirsunder

public static  findDirsUnder (File rootDir, 
                File relativeParent)

למצוא באופן רקורסיבי את כל הספריות תחת rootDir הנתון

פרמטרים
rootDir File: תיקיית השורש שבה רוצים לחפש

relativeParent File: הורה אופציונלי לכל הפריטים מסוג ERROR(/File) שהוחזרו. אם לא מציינים זאת, כל הערכים של 'ERROR(/File)' יהיו ביחס ל-rootDir.

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

קליעות
חריגת IO

HardlinkFile (קובץ)

public static void hardlinkFile (File origFile, 
                File destFile)

שיטה מסייעת ליצירת קישור קשיח של קובץ לקובץ אחר. חלופי להעתקה במקרה של צולב קישור בין מחיצות.

פרמטרים
origFile File: הקובץ המקורי

destFile File: קובץ היעד

קליעות
אם הקישור בתוך הקובץ נכשל,

HardlinkFile (קובץ)

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

שיטה מסייעת ליצירת קישור קשיח של קובץ לקובץ אחר. חלופי להעתקה במקרה של צולב קישור בין מחיצות.

פרמטרים
origFile File: הקובץ המקורי

destFile File: קובץ היעד

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

קליעות
אם הקישור בתוך הקובץ נכשל,

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

קליעות
חריגת IO
FileNotFoundError

readStringFromFile

public static String readStringFromFile (File sourceFile)

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

פרמטרים
sourceFile File: הקובץ שממנו רוצים לקרוא

החזרות
String

קליעות
חריגת IO
FileNotFoundError

עותק רקורסיבי

public static void recursiveCopy (File sourceDir, 
                File destDir)

מעתיקים באופן רקורסיבי את תוכן התיקייה.

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

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

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

קליעות
חריגת IO

רקורסיבי

public static void recursiveDelete (File rootDir)

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

פרמטרים
rootDir File: הספרייה או הקובץ שרוצים למחוק. יכול להיות null

קישור רקורסיבי

public static void recursiveHardlink (File sourceDir, 
                File destDir)

לקשר באופן רקורסיבי את תוכן התיקייה.

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

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

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

קליעות
חריגת IO

קישור רקורסיבי

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

לקשר באופן רקורסיבי את תוכן התיקייה.

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

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

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

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

קליעות
חריגת IO

קישור רקורסיבי

public static void recursiveSymlink (File sourceDir, 
                File destDir)

תוכן תיקייה עם קישור סימבולי באופן רקורסיבי.

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

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

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

קליעות
חריגת IO

SaveResourceFile

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

לשמור קובץ משאבים בספרייה.

פרמטרים
resourceStream InputStream: אובייקט {link קלטStream} למשאב שיישמר.

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

קובץ symlink

public static void symlinkFile (File origFile, 
                File destFile)

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

פרמטרים
origFile File: הקובץ המקורי

destFile File: קובץ היעד

קליעות
אם הקישור הסימבולי של הקובץ נכשל

unixModeToPosix

public static  unixModeToPosix (int mode)

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

פרמטרים
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