FileUtil

public class FileUtil
extends Object

java.lang.Object
   ↳ com.android.tradefed.util.FileUtil

מחלקת עזר לפעולות שקשורות לקבצים

סיכום

כיתות מוטמעות

class FileUtil.LowDiskSpaceException

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

ערכים קבועים

int FILESYSTEM_FILENAME_MAX_LENGTH

‫Constructors ציבוריים

FileUtil()

‫methods ציבוריים

static String calculateBase64Md5(File file)

שיטת עזר לחישוב MD5 ב-Base64 עבור קובץ.

static long calculateCrc32(File file)

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

static String calculateMd5(File file)

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

static boolean chmod(File file, String perms)
static boolean chmodGroupRW(File file)

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

static boolean chmodGroupRWX(File file)

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

static boolean chmodRWXRecursively(File file)
static void closeZip(ZipFile zipFile)

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

static List<File> collectJars(File dir)

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

static boolean compareFileContents(File file1, File file2)

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

static long convertSizeToBytes(String sizeString)

ההפך מconvertToReadableSize(long).

static IOException convertToDiskSpaceIfNeeded(IOException e)

עוטף את השגיאה בשגיאה של חוסר מקום בדיסק, אם צריך.

static String convertToReadableSize(long sizeLong)

המרת גודל הקובץ שצוין בבייטים לפורמט קריא יותר בפורמט X.Y[KMGT].

static void copyFile(File origFile, File destFile)

שיטת עזר להעתקת התוכן של קובץ לקובץ מקומי

static File createNamedTempDir(File parentDir, String name)

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

static File createNamedTempDir(String name)

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

static File createTempDir(String prefix)

פונקציית עזר ליצירת ספרייה זמנית בספרייה הזמנית שמוגדרת כברירת המחדל של המערכת.

static File createTempDir(String prefix, File parentDir)

פונקציית עזר ליצירת ספריית temp.

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

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

static File createTempFile(String prefix, String suffix)

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

static File createTempFileForRemote(String remoteFilePath, File parentDir)

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

static File createZip(File dir)

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

static void createZip(File dir, File zipFile)

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

static void deleteFile(File file)

מנסים למחוק קובץ.

static boolean ensureGroupRWX(File file)

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

static File extractFileFromZip(ZipFile zipFile, String filePath)

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

static void extractZip(ZipFile zipFile, File destDir)

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

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

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

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

חיפוש רקורסיבי של כל הספריות מתחת ל-rootDir

static File findFile(File dir, String fileName)

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

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

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

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

מקבל את כל הקבצים בספרייה הנתונה עם שם שתואם למסנן הנתון, ומסנן גם את הקבצים שנמצאו לפי ארכיטקטורת ה-ABI אם ה-ABI לא ריק.

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

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

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

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

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

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

static String getBaseName(String fileName)

מחזירה את שם הבסיס, ללא הסיומת, של שם הקובץ שצוין.

static String getContentType(String filePath)

קבלת סוג התוכן של קובץ על סמך הסיומת שלו.

static String getExtension(String fileName)

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

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

שיטת עזר ליצירת קובץ שתלויה במערכת

static String getPath(String... pathSegments)

שיטת עזר ליצירת נתיב יחסי שתלוי במערכת

static void gzipFile(File file, File gzipFile)

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

static void hardlinkFile(File origFile, File destFile)

שיטת עזר שיוצרת קישור קשיח מקובץ לקובץ אחר.

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

שיטת עזר שיוצרת קישור קשיח מקובץ לקובץ אחר.

static boolean isDiskSpaceError(String message)

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

ממירה מספר שלם שמייצג מצב של מערכת Unix לקבוצה של PosixFilePermission

static void writeToFile(String inputString, File destFile)

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

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

שיטת עזר לכתיבת נתוני מקור לתוך קובץ

static void writeToFile(InputStream input, File destFile)

שיטת עזר לכתיבת נתוני מקור לתוך קובץ

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

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

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

שיטת עזר לכתיבת נתוני מקור לתוך קובץ

שיטות מוגנות

static boolean chmodExists()

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

static void setChmodBinary(String chmodName)

חשוף לבדיקה.

ערכים קבועים

FILESYSTEM_FILENAME_MAX_LENGTH

public static final int FILESYSTEM_FILENAME_MAX_LENGTH

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

‫constructors ציבוריים

FileUtil

public FileUtil ()

‫methods ציבוריים

calculateBase64Md5

public static String calculateBase64Md5 (File file)

שיטת עזר לחישוב MD5 ב-Base64 עבור קובץ.

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

calculateCrc32

public static long calculateCrc32 (File file)

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

החזרות
long ‫CRC-32 של הקובץ
הקפצת הודעות שגיאה (throw)
java.io.IOException
IOException

calculateMd5

public static String calculateMd5 (File file)

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

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

chmod

public static boolean chmod (File file, 
                String perms)

פרמטרים
file File

perms String

החזרות
boolean

chmodGroupRW

public static boolean chmodGroupRW (File file)

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

הערה: כדי לאפשר גישה לספריות, צריך לתת הרשאת הפעלה. מידע נוסף זמין במאמר chmodGroupRWX(File).

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

פרמטרים
file ‫File: File כדי להגדיר את הבעלים ואת הקבוצה כבעלי הרשאת כתיבה
החזרות
boolean ‫true אם הקובץ הוגדר בהצלחה כקובץ שניתן לכתיבה על ידי קבוצה, false אחרת

chmodGroupRWX

public static boolean chmodGroupRWX (File file)

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

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

פרמטרים
file ‫File: File כדי להגדיר את הבעלים ואת הקבוצה כבעלי הרשאת כתיבה
החזרות
boolean ‫true אם ההרשאות הוגדרו בהצלחה, false אחרת

chmodRWXRecursively

public static boolean chmodRWXRecursively (File file)

פרמטרים
file File

החזרות
boolean

closeZip

public static void closeZip (ZipFile zipFile)

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

סגירה של ZipFile פתוח, תוך התעלמות מחריגים.

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

collectJars

public static List<File> collectJars (File dir)

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

פרמטרים
dir File

החזרות
List<File>

compareFileContents

public static boolean compareFileContents (File file1, 
                File file2)

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

פרמטרים
file1 File

file2 File

החזרות
boolean true אם התוכן של הקבצים זהה
הקפצת הודעות שגיאה (throw)
IOException

convertSizeToBytes

public static long convertSizeToBytes (String sizeString)

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

פרמטרים
sizeString ‫String: תיאור המחרוזת של הגודל.
החזרות
long הגודל בבייטים
הקפצת הודעות שגיאה (throw)
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: קובץ היעד
הקפצת הודעות שגיאה (throw)
IOException אם העתקת הקובץ נכשלה

createNamedTempDir

public static File createNamedTempDir (File parentDir, 
                String name)

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

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

פרמטרים
parentDir ‫File: הספרייה שבה ייצור את הספרייה. אם הערך הוא Null, הספרייה תהיה ב-‎ /tmp
name ‫String: השם של הספרייה שרוצים ליצור בתיקיית האב
החזרות
File הספרייה שנוצרה
הקפצת הודעות שגיאה (throw)
IOException

createNamedTempDir

public static File createNamedTempDir (String name)

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

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

פרמטרים
name ‫String: השם של הספרייה שרוצים ליצור בתיקיית ה-tmp.
החזרות
File הספרייה שנוצרה
הקפצת הודעות שגיאה (throw)
IOException

createTempDir

public static File createTempDir (String prefix)

פונקציית עזר ליצירת ספרייה זמנית בספרייה הזמנית שמוגדרת כברירת המחדל של המערכת.

פרמטרים
prefix ‫String: מחרוזת התחילית שתשמש ליצירת שם הקובץ. המחרוזת צריכה לכלול לפחות שלושה תווים.
החזרות
File הספרייה שנוצרה
הקפצת הודעות שגיאה (throw)
IOException אם אי אפשר ליצור את הקובץ

createTempDir

public static File createTempDir (String prefix, 
                File parentDir)

פונקציית עזר ליצירת ספריית temp.

פרמטרים
prefix ‫String: מחרוזת התחילית שתשמש ליצירת שם הקובץ. המחרוזת צריכה לכלול לפחות שלושה תווים.
parentDir ‫File: ספריית האב שבה רוצים ליצור את הספרייה. אם null לא מוגדרת ספרייה זמנית, המערכת תשתמש בספרייה הזמנית שמוגדרת כברירת מחדל.
החזרות
File הספרייה שנוצרה
הקפצת הודעות שגיאה (throw)
IOException אם אי אפשר ליצור את הקובץ

createTempFile

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

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

פרמטרים
prefix String

suffix String

parentDir File

החזרות
File

הקפצת הודעות שגיאה (throw)
FileUtil.LowDiskSpaceException אם נפח האחסון במחיצה קטן מהנפח המינימלי המותר
IOException

createTempFile

public static File createTempFile (String prefix, 
                String suffix)

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

פרמטרים
prefix String

suffix String

החזרות
File

הקפצת הודעות שגיאה (throw)
FileUtil.LowDiskSpaceException אם נפח האחסון במחיצה הזמנית קטן מהנפח המינימלי המותר
IOException

createTempFileForRemote

public static File createTempFileForRemote (String remoteFilePath, 
                File parentDir)

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

פרמטרים
remoteFilePath ‫String: הנתיב המרוחק שמופרד באמצעות '/' כדי ליצור את השם
parentDir ‫File: ספריית האב שבה ייצור הקובץ. ‫null כדי להשתמש בספרייה הזמנית שמוגדרת כברירת מחדל
החזרות
File

הקפצת הודעות שגיאה (throw)
IOException

createZip

public static File createZip (File dir)

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

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

פרמטרים
dir File: הספרייה שרוצים להוסיף לקובץ ZIP
החזרות
File קובץ ZIP זמני File שמכיל את התוכן של הספרייה
הקפצת הודעות שגיאה (throw)
IOException אם לא הצלחנו ליצור קובץ zip

createZip

public static void createZip (File dir, 
                File zipFile)

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

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

פרמטרים
dir File: הספרייה שרוצים להוסיף לקובץ ZIP
zipFile ‫File: קובץ ה-ZIP שרוצים ליצור – הוא לא יכול להיות קיים כבר
הקפצת הודעות שגיאה (throw)
IOException אם לא הצלחנו ליצור קובץ zip

deleteFile

public static void deleteFile (File file)

מנסים למחוק קובץ. מיועד לשימוש כשמנקים פסקאות של finally.

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

ensureGroupRWX

public static boolean ensureGroupRWX (File file)

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

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

פרמטרים
file ‫File: File כדי להגדיר את הבעלים ואת הקבוצה כבעלי הרשאת כתיבה
החזרות
boolean ‫true אם ההרשאות הוגדרו בהצלחה, false אחרת

extractFileFromZip

public static File extractFileFromZip (ZipFile zipFile, 
                String filePath)

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

שיטת כלי עזר לחילוץ קובץ ספציפי מקובץ ZIP לקובץ tmp

פרמטרים
zipFile ‫ZipFile: ZipFile לחילוץ
filePath ‫String: הנתיב של הקובץ לחילוץ
החזרות
File הערך File או null אם לא נמצא
הקפצת הודעות שגיאה (throw)
IOException אם חילוץ הקובץ נכשל

extractZip

public static void extractZip (ZipFile zipFile, 
                File destDir)

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

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

פרמטרים
zipFile ‫ZipFile: ZipFile לחילוץ
destDir File: ספרייה מקומית לחילוץ הקובץ
הקפצת הודעות שגיאה (throw)
IOException אם חילוץ הקובץ נכשל

findDirectory

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

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

פרמטרים
dirName ‫String: שם הספרייה שאנחנו מחפשים.
dirs ‫File: רשימת הספריות שאנחנו מחפשים בהן.
החזרות
File מחזירה File עם הספרייה שנמצאה או Null אם לא נמצאה ספרייה.
הקפצת הודעות שגיאה (throw)
java.io.IOException
IOException

findDirsUnder

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

חיפוש רקורסיבי של כל הספריות מתחת ל-rootDir

פרמטרים
rootDir ‫File: תיקיית השורש שבה רוצים לחפש
relativeParent ‫File: הורה אופציונלי לכל Files שמוחזרים. אם לא מציינים את הפרמטר הזה, כל File יהיו יחסיים ל-rootDir.
החזרות
Set<File> קבוצה של File, שמייצגת את כל הספריות שמתחת ל-rootDir, כולל rootDir עצמו. אם rootDir הוא null, מוחזרת קבוצה ריקה.

findFile

public static File findFile (File dir, 
                String fileName)

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

פרמטרים
dir ‫File: הספרייה שרוצים לחפש
fileName String: שם הקובץ לחיפוש
החזרות
File הערך File או null אם לא נמצא

findFile

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

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

פרמטרים
fileName ‫String: String של הביטוי הרגולרי להתאמה לנתיב הקובץ
abi ‫IAbi: אובייקט IAbi של ה-ABI שצריך להתאים ליעד
dirs ‫File: מערך varargs של אובייקט File של התיקיות שבהן יתבצע חיפוש של קבצים
החזרות
File הערך File או null אם לא נמצא
הקפצת הודעות שגיאה (throw)
IOException

findFiles

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

מקבל את כל הקבצים בספרייה הנתונה עם שם שתואם למסנן הנתון, ומסנן גם את הקבצים שנמצאו לפי ארכיטקטורת ה-ABI אם ה-ABI לא ריק.

פרמטרים
fileName ‫String: String של הביטוי הרגולרי להתאמה לנתיב הקובץ
abi ‫IAbi: אובייקט IAbi של ה-ABI שצריך להתאים ליעד
includeDirectory boolean: האם לכלול ספריות בתוצאות החיפוש
dirs ‫File: מערך של File אובייקט של התיקיות שבהן יתבצע חיפוש של קבצים
החזרות
Set<File> קבוצה של File או קבוצה ריקה אם לא נמצאה
הקפצת הודעות שגיאה (throw)
IOException

findFiles

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

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

פרמטרים
dir ‫File: אובייקט File של הספרייה שבה יתבצע חיפוש רקורסיבי של קבצים
filter ‫String: String של הביטוי הרגולרי להתאמה לשמות קבצים
החזרות
Set<String> קבוצה של String מנתיבי הקבצים
הקפצת הודעות שגיאה (throw)
IOException

findFilesObject

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

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

פרמטרים
dir ‫File: אובייקט File של הספרייה שבה יתבצע חיפוש רקורסיבי של קבצים
filter ‫String: String של הביטוי הרגולרי להתאמה לשמות קבצים
includeDirectory boolean: האם לכלול ספריות בתוצאות החיפוש
החזרות
Set<File> קבוצה של File אובייקטים של הקובץ. @See findFiles(File,String)
הקפצת הודעות שגיאה (throw)
IOException

findFilesObject

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

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

פרמטרים
dir ‫File: אובייקט File של הספרייה שבה יתבצע חיפוש רקורסיבי של קבצים
filter ‫String: String של הביטוי הרגולרי להתאמה לשמות קבצים
החזרות
Set<File> קבוצה של File אובייקטים של הקובץ. @See findFiles(File,String)
הקפצת הודעות שגיאה (throw)
IOException

getBaseName

public static String getBaseName (String fileName)

מחזירה את שם הבסיס, ללא הסיומת, של שם הקובץ שצוין.

לדוגמה, getBaseName("file.txt") תחזיר "file"

החזרות
String שם הבסיס

getContentType

public static String getContentType (String filePath)

קבלת סוג התוכן של קובץ על סמך הסיומת שלו.

פרמטרים
filePath String: הנתיב לקובץ
החזרות
String סוג תוכן

getExtension

public static String getExtension (String fileName)

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

החזרות
String הסיומת או מחרוזת ריקה אם לקובץ אין סיומת

getFileForPath

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

שיטת עזר ליצירת קובץ שתלויה במערכת

פרמטרים
parentDir ‫File: ספריית האם שבה רוצים להשתמש.
pathSegments ‫String: פלחים של נתיב יחסי לשימוש
החזרות
File ‫File שמייצג את הנתיב הנתון, כאשר כל pathSegment מופרד באמצעות File.separatorChar

getPath

public static String getPath (String... pathSegments)

שיטת עזר ליצירת נתיב יחסי שתלוי במערכת

פרמטרים
pathSegments ‫String: פלחים של נתיב יחסי לשימוש
החזרות
String ‫String שמייצג את הנתיב הנתון, כאשר כל pathSegment מופרד באמצעות File.separatorChar

gzipFile

public static void gzipFile (File file, 
                File gzipFile)

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

שיטת עזר ליצירת גרסה דחוסה ב-gzip של קובץ יחיד.

פרמטרים
file ‫File: הקובץ המקורי
gzipFile File: הקובץ שבו ימוקם התוכן הדחוס
הקפצת הודעות שגיאה (throw)
java.io.IOException
IOException

hardlinkFile

public static void hardlinkFile (File origFile, 
                File destFile)

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

פרמטרים
origFile ‫File: הקובץ המקורי
destFile File: קובץ היעד
הקפצת הודעות שגיאה (throw)
IOException if failed to hardlink file

hardlinkFile

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

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

פרמטרים
origFile ‫File: הקובץ המקורי
destFile File: קובץ היעד
ignoreExistingFile ‫boolean: אם הערך הוא True והקובץ שמקושר כבר קיים, המערכת מדלגת על החריגה.
הקפצת הודעות שגיאה (throw)
IOException 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). בעצם, גרסה של 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

הקפצת הודעות שגיאה (throw)
FileNotFoundException
java.io.IOException
IOException

readStringFromFile

public static String readStringFromFile (File sourceFile)

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

פרמטרים
sourceFile ‫File: הקובץ שממנו קוראים
החזרות
String

הקפצת הודעות שגיאה (throw)
FileNotFoundException
java.io.IOException
IOException

recursiveCopy

public static void recursiveCopy (File sourceDir, 
                File destDir)

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

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

פרמטרים
sourceDir ‫File: התיקייה שמכילה את הקבצים להעתקה
destDir ‫File: תיקיית היעד
הקפצת הודעות שגיאה (throw)
java.io.IOException
IOException

recursiveDelete

public static void recursiveDelete (File rootDir)

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

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

recursiveHardlink

public static void recursiveHardlink (File sourceDir, 
                File destDir)

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

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

פרמטרים
sourceDir ‫File: התיקייה שמכילה את הקבצים להעתקה
destDir ‫File: תיקיית היעד
הקפצת הודעות שגיאה (throw)
java.io.IOException
IOException

recursiveHardlink

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

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

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

פרמטרים
sourceDir ‫File: התיקייה שמכילה את הקבצים להעתקה
destDir ‫File: תיקיית היעד
ignoreExistingFile ‫boolean: אם הערך הוא True והקובץ שמקושר כבר קיים, המערכת מדלגת על החריגה.
הקפצת הודעות שגיאה (throw)
java.io.IOException
IOException

recursiveSymlink

public static void recursiveSymlink (File sourceDir, 
                File destDir)

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

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

פרמטרים
sourceDir ‫File: התיקייה שמכילה את הקבצים להעתקה
destDir ‫File: תיקיית היעד
הקפצת הודעות שגיאה (throw)
java.io.IOException
IOException

saveResourceFile

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

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

פרמטרים
resourceStream ‫InputStream: אובייקט {link InputStream} למשאב שרוצים לשמור.
destDir ‫File: אובייקט File של ספרייה שבה יישמר קובץ המשאב.
targetFileName ‫String: String לשם הקובץ שבו רוצים לשמור את המפתח.
החזרות
File אובייקט File של הקובץ שנשמר.
הקפצת הודעות שגיאה (throw)
IOException אם הקובץ לא נשמר.

setReadableRecursive

public static void setReadableRecursive (File file)

הגדרת הרשאות קריאה והרשאות הפעלה (אם מדובר בתיקייה) לקובץ הנתון באופן רקורסיבי.

פרמטרים
file File

sizeOfDirectory

public static Long sizeOfDirectory (File directory)

הגודל שמדווח בספרייה.

פרמטרים
directory File

החזרות
Long

symlinkFile

public static void symlinkFile (File origFile, 
                File destFile)

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

פרמטרים
origFile ‫File: הקובץ המקורי
destFile File: קובץ היעד
הקפצת הודעות שגיאה (throw)
IOException אם יצירת הקישור הסמלי לקובץ נכשלה

unixModeToPosix

public static Set<PosixFilePermission> unixModeToPosix (int mode)

ממירה מספר שלם שמייצג מצב של מערכת Unix לקבוצה של PosixFilePermission

פרמטרים
mode int

החזרות
Set<PosixFilePermission>

writeToFile

public static void writeToFile (String inputString, 
                File destFile)

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

פרמטרים
inputString ‫String: הקלט String
destFile ‫File: קובץ היעד שאליו רוצים לכתוב
הקפצת הודעות שגיאה (throw)
IOException

writeToFile

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

שיטת עזר לכתיבת נתוני מקור לתוך קובץ

פרמטרים
input ‫InputStream: זרם הקלט שלא נשמר במאגר
destFile ‫File: קובץ היעד שאליו ייכתב או יצורף המידע
append ‫boolean: אם הערך הוא true, המידע יצורף לסוף הקובץ. אחרת, המידע יכתוב על הקובץ.
הקפצת הודעות שגיאה (throw)
IOException

writeToFile

public static void writeToFile (InputStream input, 
                File destFile)

שיטת עזר לכתיבת נתוני מקור לתוך קובץ

פרמטרים
input ‫InputStream: זרם הקלט שלא נשמר במאגר
destFile ‫File: קובץ היעד שאליו רוצים לכתוב
הקפצת הודעות שגיאה (throw)
IOException

writeToFile

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

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

פרמטרים
inputString ‫String: הקלט String
destFile ‫File: קובץ היעד שאליו ייכתב או יצורף המידע
append ‫boolean: אם הערך הוא true, המידע יצורף לסוף הקובץ. אחרת, המידע יכתוב על הקובץ.
הקפצת הודעות שגיאה (throw)
IOException

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

שיטות מוגנות

chmodExists

protected static boolean chmodExists ()

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

החזרות
boolean

setChmodBinary

protected static void setChmodBinary (String chmodName)

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

פרמטרים
chmodName String