A partire dal 2026, per allinearci al nostro modello di sviluppo trunk stabile e garantire la stabilità della piattaforma per l'ecosistema, pubblicheremo il codice sorgente su AOSP nel secondo e nel quarto trimestre. Per compilare e contribuire ad AOSP, utilizza android-latest-release. Il branch del manifest android-latest-release farà sempre riferimento alla release più recente pubblicata su AOSP. Per saperne di più, consulta la sezione Modifiche ad AOSP.

Google uses AI technology to translate content into your preferred language. AI translations can contain errors.

FileUtil

public class FileUtil
extends Object

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

Una classe helper per le operazioni relative ai file

Riepilogo

Classi nidificate
`class`	`FileUtil.LowDiskSpaceException` Generata se lo spazio su disco utilizzabile è inferiore alla soglia minima.

Costanti
`int`	`FILESYSTEM_FILENAME_MAX_LENGTH`

Costruttori pubblici
`FileUtil()`

Metodi pubblici
`static String`	`calculateBase64Md5(File file)` Metodo helper per calcolare l'MD5 base64 per un file.
`static long`	`calculateCrc32(File file)` Metodo helper per calcolare il CRC-32 di un file.
`static String`	`calculateMd5(File file)` Metodo helper per calcolare l'MD5 di un file.
`static boolean`	`chmod(File file, String perms)`
`static boolean`	`chmodGroupRW(File file)` Esegue un tentativo ottimale per rendere leggibile e scrivibile il gruppo di file specificato.
`static boolean`	`chmodGroupRWX(File file)` Esegue un tentativo ottimale per rendere il gruppo di file specificato eseguibile, leggibile e scrivibile.
`static boolean`	`chmodRWXRecursively(File file)`
`static void`	`closeZip(ZipFile zipFile)` Questo metodo è obsoleto. Spostamento in `ZipUtil.closeZip(ZipFile)` eseguito.
`static List<File>`	`collectJars(File dir)` Restituisce tutti i file JAR trovati nella directory specificata
`static boolean`	`compareFileContents(File file1, File file2)` Metodo di utilità per eseguire il confronto byte per byte dei contenuti di due file.
`static long`	`convertSizeToBytes(String sizeString)` L'inverso di `convertToReadableSize(long)`.
`static IOException`	`convertToDiskSpaceIfNeeded(IOException e)` Se necessario, inserisce l'errore in un errore di spazio su disco.
`static String`	`convertToReadableSize(long sizeLong)` Converti le dimensioni del file specificate in byte in un formato più leggibile nel formato X.Y[KMGT].
`static void`	`copyFile(File origFile, File destFile)` Un metodo helper che copia i contenuti di un file in un file locale
`static File`	`createNamedTempDir(File parentDir, String name)` Funzione helper per creare una directory denominata all'interno di una cartella.
`static File`	`createNamedTempDir(String name)` Funzione helper per creare una directory denominata all'interno della cartella temporanea.
`static File`	`createTempDir(String prefix)` Funzione helper per creare una directory temporanea nella directory dei file temporanei predefinita del sistema.
`static File`	`createTempDir(String prefix, File parentDir)` Funzione helper per creare una directory temporanea.
`static File`	`createTempFile(String prefix, String suffix, File parentDir)` Funzione wrapper helper intorno a `File.createTempFile(String,String,File)` che esegue l'audit per potenziali scenari di spazio su disco insufficiente.
`static File`	`createTempFile(String prefix, String suffix)` Funzione wrapper helper intorno a `File.createTempFile(String,String)` che esegue il controllo per potenziali scenari di spazio su disco insufficiente.
`static File`	`createTempFileForRemote(String remoteFilePath, File parentDir)` Metodo helper che crea un file univoco sul disco temporaneo, il cui nome corrisponde il più possibile al nome file fornito dal percorso del file remoto
`static File`	`createZip(File dir)` Questo metodo è obsoleto. Spostamento in `ZipUtil.createZip(File)` eseguito.
`static void`	`createZip(File dir, File zipFile)` Questo metodo è obsoleto. Spostamento in `ZipUtil.createZip(File,File)` eseguito.
`static void`	`deleteFile(File file)` Prova a eliminare un file.
`static boolean`	`ensureGroupRWX(File file)` Esegue un tentativo con il massimo impegno per garantire che il gruppo di file specificato sia eseguibile, leggibile e scrivibile.
`static File`	`extractFileFromZip(ZipFile zipFile, String filePath)` Questo metodo è obsoleto. Spostamento in `ZipUtil.extractFileFromZip(ZipFile,String)` eseguito.
`static void`	`extractZip(ZipFile zipFile, File destDir)` Questo metodo è obsoleto. Spostamento in `ZipUtil.extractZip(ZipFile,File)` eseguito.
`static File`	`findDirectory(String dirName, File... dirs)` Cerca e restituisce la prima directory `File` tra le altre directory.
`static Set<File>`	`findDirsUnder(File rootDir, File relativeParent)` Trova in modo ricorsivo tutte le directory sotto il `rootDir` specificato
`static File`	`findFile(File dir, String fileName)` Cerca in modo ricorsivo nella directory specificata il primo file con il nome specificato
`static File`	`findFile(String fileName, IAbi abi, File... dirs)` Recupera tutti i percorsi dei file nella directory specificata con nome corrispondente al filtro specificato e filtra anche il file trovato in base all'architettura ABI se l'ABI non è null.
`static Set<File>`	`findFiles(String fileName, IAbi abi, boolean includeDirectory, File... dirs)` Recupera tutti i file nella directory specificata con nome corrispondente al filtro specificato e filtra anche i file trovati in base all'architettura ABI se ABI non è null.
`static Set<String>`	`findFiles(File dir, String filter)` Ottieni tutti i percorsi dei file nella directory specificata con nome corrispondente al filtro specificato
`static Set<File>`	`findFilesObject(File dir, String filter, boolean includeDirectory)` Ottieni tutti i percorsi dei file nella directory specificata con nome corrispondente al filtro specificato
`static Set<File>`	`findFilesObject(File dir, String filter)` Ottieni tutti i percorsi dei file nella directory specificata con nome corrispondente al filtro specificato
`static String`	`getBaseName(String fileName)` Restituisce il nome base, senza estensione, del nome file specificato.
`static String`	`getContentType(String filePath)` Ottieni il tipo di contenuti del file in base alla sua estensione.
`static String`	`getExtension(String fileName)` Recupera l'estensione per il nome file specificato.
`static File`	`getFileForPath(File parentDir, String... pathSegments)` Metodo helper per creare un file dipendente dal sistema
`static String`	`getPath(String... pathSegments)` Metodo helper per creare un percorso relativo dipendente dal sistema
`static void`	`gzipFile(File file, File gzipFile)` Questo metodo è obsoleto. Spostamento in `ZipUtil.gzipFile(File,File)` eseguito.
`static void`	`hardlinkFile(File origFile, File destFile)` Un metodo helper che crea un hard link di un file a un altro file.
`static void`	`hardlinkFile(File origFile, File destFile, boolean ignoreExistingFile)` Un metodo helper che crea un hard link di un file a un altro file.
`static boolean`	`isDiskSpaceError(String message)` Restituisce true se il messaggio è un errore di spazio su disco.
`static boolean`	`mkdirsRWX(File file)` Metodo per creare una catena di directory e impostarle tutte come eseguibili/leggibili/scrivibili dal gruppo durante la creazione chiamando `chmodGroupRWX(File)`.
`static String`	`readStringFromFile(File sourceFile, long startOffset, long length)` Un metodo helper per leggere i dati parziali delle stringhe da un file
`static String`	`readStringFromFile(File sourceFile)` Un metodo helper per leggere i dati stringa da un file
`static void`	`recursiveCopy(File sourceDir, File destDir)` Copia in modo ricorsivo i contenuti della cartella.
`static void`	`recursiveDelete(File rootDir)` Elimina in modo ricorsivo il file o la directory specificati e tutti i relativi contenuti.
`static void`	`recursiveHardlink(File sourceDir, File destDir)` Collega in modo ricorsivo i contenuti della cartella.
`static void`	`recursiveHardlink(File sourceDir, File destDir, boolean ignoreExistingFile)` Collega in modo ricorsivo i contenuti della cartella.
`static void`	`recursiveSymlink(File sourceDir, File destDir)` Crea un collegamento simbolico ricorsivo ai contenuti della cartella.
`static File`	`saveResourceFile(InputStream resourceStream, File destDir, String targetFileName)` Salva un file di risorse in una directory.
`static void`	`setReadableRecursive(File file)` Imposta in modo ricorsivo le autorizzazioni di lettura ed esecuzione (se cartella) per il file specificato.
`static Long`	`sizeOfDirectory(File directory)` Restituisce le dimensioni riportate dalla directory.
`static void`	`symlinkFile(File origFile, File destFile)` Un metodo helper che crea un collegamento simbolico a un altro file
`static Set<PosixFilePermission>`	`unixModeToPosix(int mode)` Converte un numero intero che rappresenta la modalità Unix in un insieme di `PosixFilePermission`
`static void`	`writeToFile(String inputString, File destFile)` Un metodo helper per scrivere dati stringa nel file
`static void`	`writeToFile(InputStream input, File destFile, boolean append)` Un metodo helper per scrivere i dati dello stream nel file
`static void`	`writeToFile(InputStream input, File destFile)` Un metodo helper per scrivere i dati dello stream nel file
`static void`	`writeToFile(String inputString, File destFile, boolean append)` Un metodo helper per scrivere o aggiungere dati stringa al file
`static void`	`writeToFile(InputStream input, File destFile, boolean append, long startOffset, long size)` Un metodo helper per scrivere i dati dello stream nel file

Metodi protetti
`static boolean`	`chmodExists()` Helper interno per determinare se "chmod" è disponibile sul sistema operativo.
`static void`	`setChmodBinary(String chmodName)` Esposto per i test.

Costanti

FILESYSTEM_FILENAME_MAX_LENGTH

public static final int FILESYSTEM_FILENAME_MAX_LENGTH

Valore costante: 255 (0x000000ff)

Costruttori pubblici

FileUtil

public FileUtil ()

Metodi pubblici

calculateBase64Md5

public static String calculateBase64Md5 (File file)

Metodo helper per calcolare l'MD5 base64 per un file.

Resi
`String`	md5 del file

calculateCrc32

public static long calculateCrc32 (File file)

Metodo helper per calcolare il CRC-32 di un file.

Resi
`long`	CRC-32 del file

Genera
	java.io.IOException
`IOException`

calculateMd5

public static String calculateMd5 (File file)

Metodo helper per calcolare l'MD5 di un file.

Resi
`String`	md5 del file

chmod

public static boolean chmod (File file, 
                String perms)

Parametri
`file`	`File`
`perms`	`String`

Resi
`boolean`

chmodGroupRW

public static boolean chmodGroupRW (File file)

Esegue un tentativo ottimale per rendere leggibile e scrivibile il gruppo di file specificato.

Tieni presente che l'autorizzazione di esecuzione è necessaria per rendere accessibili le directory. Vedi chmodGroupRWX(File).

Se il comando di sistema "chmod" non è supportato dal sistema operativo sottostante, il file verrà impostato in modo che sia scrivibile da tutti.

Parametri
`file`	`File`: il `File` per rendere scrivibili il proprietario e il gruppo

Resi
`boolean`	`true` se il file è stato reso scrivibile dal gruppo, `false` altrimenti

chmodGroupRWX

public static boolean chmodGroupRWX (File file)

Esegue un tentativo ottimale per rendere il gruppo di file specificato eseguibile, leggibile e scrivibile.

Se il comando di sistema "chmod" non è supportato dal sistema operativo sottostante, verrà tentato di impostare le autorizzazioni per tutti gli utenti.

Parametri
`file`	`File`: il `File` per rendere scrivibili il proprietario e il gruppo

Resi
`boolean`	`true` se le autorizzazioni sono state impostate correttamente, `false` in caso contrario

chmodRWXRecursively

public static boolean chmodRWXRecursively (File file)

Parametri
`file`	`File`

Resi
`boolean`

closeZip

public static void closeZip (ZipFile zipFile)

Questo metodo è obsoleto.
Spostato in ZipUtil.closeZip(ZipFile).

Chiudi un ZipFile aperto, ignorando eventuali eccezioni.

Parametri
`zipFile`	`ZipFile`: il file da chiudere

collectJars

public static List<File> collectJars (File dir)

Restituisce tutti i file JAR trovati nella directory specificata

Parametri
`dir`	`File`

Resi
`List<File>`

compareFileContents

public static boolean compareFileContents (File file1, 
                File file2)

Metodo di utilità per eseguire il confronto byte per byte del contenuto di due file.

Parametri
`file1`	`File`
`file2`	`File`

Resi
`boolean`	`true` se i contenuti del file sono identici

Genera
`IOException`

convertSizeToBytes

public static long convertSizeToBytes (String sizeString)

L'inverso di convertToReadableSize(long). Converte il formato leggibile descritto in convertToReadableSize(long) in un valore byte.

Parametri
`sizeString`	`String`: la descrizione della stringa della dimensione.

Resi
`long`	le dimensioni in byte

Genera
`IllegalArgumentException`	se non è possibile riconoscere le dimensioni

convertToDiskSpaceIfNeeded

public static IOException convertToDiskSpaceIfNeeded (IOException e)

Se necessario, inserisce l'errore in un errore di spazio su disco.

Parametri
`e`	`IOException`

Resi
`IOException`

convertToReadableSize

public static String convertToReadableSize (long sizeLong)

Converti le dimensioni del file specificate in byte in un formato più leggibile nel formato X.Y[KMGT].

Parametri
`sizeLong`	`long`: dimensioni del file in byte

Resi
`String`	stringa descrittiva delle dimensioni del file

copyFile

public static void copyFile (File origFile, 
                File destFile)

Un metodo helper che copia i contenuti di un file in un file locale

Parametri
`origFile`	`File`: il file originale da copiare
`destFile`	`File`: il file di destinazione

Genera
`IOException`	if failed to copy file

createNamedTempDir

public static File createNamedTempDir (File parentDir, 
                String name)

Funzione helper per creare una directory denominata all'interno di una cartella.

Il nome di questa directory non verrà randomizzato. Se la directory esiste già, verrà restituita.

Parametri
`parentDir`	`File`: la directory in cui creare la directory. Se è null, verrà creata in /tmp
`name`	`String`: Il nome della directory da creare nella cartella principale

Resi
`File`	la directory creata

Genera
`IOException`

createNamedTempDir

public static File createNamedTempDir (String name)

Funzione helper per creare una directory denominata all'interno della cartella temporanea.

Il nome di questa directory non verrà randomizzato. Se la directory esiste già, verrà restituita.

Parametri
`name`	`String`: il nome della directory da creare nella cartella tmp.

Resi
`File`	la directory creata

Genera
`IOException`

createTempDir

public static File createTempDir (String prefix)

Funzione helper per creare una directory temporanea nella directory dei file temporanei predefinita del sistema.

Parametri
`prefix`	`String`: la stringa del prefisso da utilizzare per generare il nome del file; deve contenere almeno tre caratteri

Resi
`File`	la directory creata

Genera
`IOException`	se non è stato possibile creare il file

createTempDir

public static File createTempDir (String prefix, 
                File parentDir)

Funzione helper per creare una directory temporanea.

Parametri
`prefix`	`String`: la stringa del prefisso da utilizzare per generare il nome del file; deve contenere almeno tre caratteri
`parentDir`	`File`: la directory principale in cui creare la directory. Se `null` viene utilizzato il percorso temporaneo predefinito del sistema.

Resi
`File`	la directory creata

Genera
`IOException`	se non è stato possibile creare il file

createTempFile

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

Funzione wrapper helper intorno a File.createTempFile(String,String,File) che esegue l'audit per potenziali scenari di spazio su disco insufficiente.

Parametri
`prefix`	`String`
`suffix`	`String`
`parentDir`	`File`

Resi
`File`

Genera
`FileUtil.LowDiskSpaceException`	se lo spazio su disco della partizione è inferiore al minimo consentito
`IOException`

Vedi anche:

File.createTempFile(String,String,File)

createTempFile

public static File createTempFile (String prefix, 
                String suffix)

Funzione wrapper helper intorno a File.createTempFile(String,String) che esegue il controllo per potenziali scenari di spazio su disco insufficiente.

Parametri
`prefix`	`String`
`suffix`	`String`

Resi
`File`

Genera
`FileUtil.LowDiskSpaceException`	se lo spazio su disco nella partizione temporanea è inferiore al minimo consentito
`IOException`

Vedi anche:

File.createTempFile(String,String)

createTempFileForRemote

public static File createTempFileForRemote (String remoteFilePath, 
                File parentDir)

Metodo helper che crea un file univoco sul disco temporaneo, il cui nome corrisponde il più possibile al nome file fornito dal percorso del file remoto

Parametri
`remoteFilePath`	`String`: il percorso remoto separato da '/' da cui costruire il nome
`parentDir`	`File`: la directory principale in cui creare il file. `null` per utilizzare la directory temporanea predefinita

Resi
`File`

Genera
`IOException`

createZip

public static File createZip (File dir)

Questo metodo è obsoleto.
Spostato in ZipUtil.createZip(File).

Metodo di utilità per creare un file ZIP temporaneo contenente la directory specificata e tutti i relativi contenuti.

Parametri
`dir`	`File`: la directory da comprimere

Resi
`File`	un file zip temporaneo `File` contenente i contenuti della directory

Genera
`IOException`	se la creazione del file ZIP non è riuscita

createZip

public static void createZip (File dir, 
                File zipFile)

Questo metodo è obsoleto.
Spostato in ZipUtil.createZip(File,File).

Metodo di utilità per creare un file zip contenente la directory specificata e tutti i relativi contenuti.

Parametri
`dir`	`File`: la directory da comprimere
`zipFile`	`File`: il file ZIP da creare, che non deve esistere già

Genera
`IOException`	se la creazione del file ZIP non è riuscita

deleteFile

public static void deleteFile (File file)

Prova a eliminare un file. Da utilizzare durante la pulizia nelle strofe finally.

Parametri
`file`	`File`: può essere null.

ensureGroupRWX

public static boolean ensureGroupRWX (File file)

Esegue un tentativo con il massimo impegno per garantire che il gruppo di file specificato sia eseguibile, leggibile e scrivibile.

Se il comando di sistema "chmod" non è supportato dal sistema operativo sottostante, verrà tentato di impostare le autorizzazioni per tutti gli utenti. L'operazione viene sincronizzata per evitare la race condition introdotta dall'accesso ai file da una cache, ad esempio GCSFileDownloader.

Parametri
`file`	`File`: il `File` per rendere scrivibili il proprietario e il gruppo

Resi
`boolean`	`true` se le autorizzazioni sono state impostate correttamente, `false` in caso contrario

extractFileFromZip

public static File extractFileFromZip (ZipFile zipFile, 
                String filePath)

Questo metodo è obsoleto.
Spostato in ZipUtil.extractFileFromZip(ZipFile,String).

Metodo di utilità per estrarre un file specifico dal file zip in un file temporaneo

Parametri
`zipFile`	`ZipFile`: il `ZipFile` da estrarre
`filePath`	`String`: il percorso del file da estrarre

Resi
`File`	`File` o null se non trovato

Genera
`IOException`	se l'estrazione del file non è riuscita

extractZip

public static void extractZip (ZipFile zipFile, 
                File destDir)

Questo metodo è obsoleto.
Spostato in ZipUtil.extractZip(ZipFile,File).

Metodo di utilità per estrarre l'intero contenuto del file zip in una determinata directory

Parametri
`zipFile`	`ZipFile`: il `ZipFile` da estrarre
`destDir`	`File`: la directory locale in cui estrarre il file

Genera
`IOException`	se l'estrazione del file non è riuscita

findDirectory

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

Cerca e restituisce la prima directory File tra le altre directory.

Parametri
`dirName`	`String`: il nome della directory che stiamo cercando.
`dirs`	`File`: l'elenco delle directory in cui eseguiamo la ricerca.

Resi
`File`	un `File` con la directory trovata o Null se non trovata.

Genera
	java.io.IOException
`IOException`

findDirsUnder

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

Trova in modo ricorsivo tutte le directory sotto il rootDir specificato

Parametri
`rootDir`	`File`: la directory root in cui eseguire la ricerca
`relativeParent`	`File`: un elemento principale facoltativo per tutti gli `File` restituiti. Se non specificato, tutti i `File` saranno relativi a `rootDir`.

Resi
`Set<File>`	Un insieme di `File`, che rappresentano tutte le directory in `rootDir`, inclusa la directory `rootDir` stessa. Se `rootDir` è null, viene restituito un insieme vuoto.

findFile

public static File findFile (File dir, 
                String fileName)

Cerca in modo ricorsivo nella directory specificata il primo file con il nome specificato

Parametri
`dir`	`File`: la directory in cui eseguire la ricerca
`fileName`	`String`: il nome del file da cercare

Resi
`File`	`File` o `null` se non è stato possibile trovarlo

findFile

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

Recupera tutti i percorsi dei file nella directory specificata con nome corrispondente al filtro specificato e filtra anche il file trovato in base all'architettura ABI se l'ABI non è null. Restituisce il primo file di corrispondenza trovato.

Parametri
`fileName`	`String`: `String` dell'espressione regolare per la corrispondenza del percorso del file
`abi`	`IAbi`: `IAbi` oggetto dell'ABI da abbinare alla destinazione
`dirs`	`File`: un array varargs di oggetti `File` delle directory in cui cercare i file

Resi
`File`	`File` o `null` se non è stato possibile trovarlo

Genera
`IOException`

findFiles

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

Recupera tutti i file nella directory specificata con nome corrispondente al filtro specificato e filtra anche i file trovati in base all'architettura ABI se ABI non è null.

Parametri
`fileName`	`String`: `String` dell'espressione regolare per la corrispondenza del percorso del file
`abi`	`IAbi`: `IAbi` oggetto dell'ABI da abbinare alla destinazione
`includeDirectory`	`boolean`: indica se includere le directory nel risultato di ricerca
`dirs`	`File`: un array di oggetti `File` delle directory in cui cercare i file

Resi
`Set<File>`	un insieme di `File` o vuoto se non è stato possibile trovarlo

Genera
`IOException`

findFiles

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

Ottieni tutti i percorsi dei file nella directory specificata con nome corrispondente al filtro specificato

Parametri
`dir`	`File`: oggetto `File` della directory in cui cercare i file in modo ricorsivo
`filter`	`String`: `String` dell'espressione regolare per la corrispondenza dei nomi dei file

Resi
`Set<String>`	un insieme di `String` dei percorsi dei file

Genera
`IOException`

findFilesObject

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

Ottieni tutti i percorsi dei file nella directory specificata con nome corrispondente al filtro specificato

Parametri
`dir`	`File`: oggetto `File` della directory in cui cercare i file in modo ricorsivo
`filter`	`String`: `String` dell'espressione regolare per la corrispondenza dei nomi dei file
`includeDirectory`	`boolean`: indica se includere le directory nel risultato di ricerca

Resi
`Set<File>`	un insieme di `File` degli oggetti file. @See `findFiles(File,String)`

Genera
`IOException`

findFilesObject

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

Ottieni tutti i percorsi dei file nella directory specificata con nome corrispondente al filtro specificato

Parametri
`dir`	`File`: oggetto `File` della directory in cui cercare i file in modo ricorsivo
`filter`	`String`: `String` dell'espressione regolare per la corrispondenza dei nomi dei file

Resi
`Set<File>`	un insieme di `File` degli oggetti file. @See `findFiles(File,String)`

Genera
`IOException`

getBaseName

public static String getBaseName (String fileName)

Restituisce il nome base, senza estensione, del nome file specificato.

ad es. getBaseName("file.txt") restituirà "file"

Resi
`String`	il nome di base

getContentType

public static String getContentType (String filePath)

Ottieni il tipo di contenuti del file in base alla sua estensione.

Parametri
`filePath`	`String`: il percorso del file

Resi
`String`	tipo di contenuti

getExtension

public static String getExtension (String fileName)

Recupera l'estensione per il nome file specificato.

Resi
`String`	l'estensione o la stringa vuota se il file non ha estensione

getFileForPath

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

Metodo helper per creare un file dipendente dal sistema

Parametri
`parentDir`	`File`: la directory principale da utilizzare.
`pathSegments`	`String`: i segmenti di percorso relativo da utilizzare

Resi
`File`	il `File` che rappresenta il percorso specificato, con ogni `pathSegment` separato da `File.separatorChar`

getPath

public static String getPath (String... pathSegments)

Metodo helper per creare un percorso relativo dipendente dal sistema

Parametri
`pathSegments`	`String`: i segmenti di percorso relativo da utilizzare

Resi
`String`	il `String` che rappresenta il percorso specificato, con ogni `pathSegment` separato da `File.separatorChar`

gzipFile

public static void gzipFile (File file, 
                File gzipFile)

Questo metodo è obsoleto.
Spostato in ZipUtil.gzipFile(File,File).

Metodo helper per creare una versione compressa con Gzip di un singolo file.

Parametri
`file`	`File`: il file originale
`gzipFile`	`File`: il file in cui inserire i contenuti compressi

Genera
	java.io.IOException
`IOException`

hardlinkFile

public static void hardlinkFile (File origFile, 
                File destFile)

Un metodo helper che crea un hard link di un file a un altro file. Esegui il fallback alla copia in caso di collegamento tra partizioni.

Parametri
`origFile`	`File`: il file originale
`destFile`	`File`: il file di destinazione

Genera
`IOException`	se non è stato possibile creare un hardlink del file

hardlinkFile

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

Un metodo helper che crea un hard link di un file a un altro file. Esegui il fallback alla copia in caso di collegamento tra partizioni.

Parametri
`origFile`	`File`: il file originale
`destFile`	`File`: il file di destinazione
`ignoreExistingFile`	`boolean`: se True e il file a cui viene creato il link esiste già, ignora l'eccezione.

Genera
`IOException`	se non è stato possibile creare un hardlink del file

isDiskSpaceError

public static boolean isDiskSpaceError (String message)

Restituisce true se il messaggio è un errore di spazio su disco.

Parametri
`message`	`String`

Resi
`boolean`

mkdirsRWX

public static boolean mkdirsRWX (File file)

Metodo per creare una catena di directory e impostarle tutte come eseguibili/leggibili/scrivibili dal gruppo durante la creazione chiamando chmodGroupRWX(File). In sostanza, una versione di File.mkdirs() che esegue anche chmod(File,String).

Parametri
`file`	`File`: il nome della directory da creare, possibilmente con le directory contenitrici che non esistono ancora.

Resi
`boolean`	`true` se `file` esiste ed è una directory, `false` altrimenti.

readStringFromFile

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

Un metodo helper per leggere i dati parziali delle stringhe da un file

Parametri
`sourceFile`	`File`: il file da cui leggere
`startOffset`	`long`: l'offset iniziale da cui leggere il file.
`length`	`long`: il numero di byte da leggere del file.

Resi
`String`

Genera
	FileNotFoundException
	java.io.IOException
`IOException`

readStringFromFile

public static String readStringFromFile (File sourceFile)

Un metodo helper per leggere i dati stringa da un file

Parametri
`sourceFile`	`File`: il file da cui leggere

Resi
`String`

Genera
	FileNotFoundException
	java.io.IOException
`IOException`

recursiveCopy

public static void recursiveCopy (File sourceDir, 
                File destDir)

Copia in modo ricorsivo i contenuti della cartella.

Supporta solo la copia di file e directory. I collegamenti simbolici non vengono copiati. Se la directory di destinazione non esiste, verrà creata.

Parametri
`sourceDir`	`File`: la cartella che contiene i file da copiare
`destDir`	`File`: la cartella di destinazione

Genera
	java.io.IOException
`IOException`

recursiveDelete

public static void recursiveDelete (File rootDir)

Elimina in modo ricorsivo il file o la directory specificati e tutti i relativi contenuti.

Parametri
`rootDir`	`File`: la directory o il file da eliminare; può essere null

recursiveHardlink

public static void recursiveHardlink (File sourceDir, 
                File destDir)

Collega in modo ricorsivo i contenuti della cartella.

Supporta solo la copia di file e directory. I collegamenti simbolici non vengono copiati. Se la directory di destinazione non esiste, verrà creata.

Parametri
`sourceDir`	`File`: la cartella che contiene i file da copiare
`destDir`	`File`: la cartella di destinazione

Genera
	java.io.IOException
`IOException`

recursiveHardlink

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

Collega in modo ricorsivo i contenuti della cartella.

Supporta solo la copia di file e directory. I collegamenti simbolici non vengono copiati. Se la directory di destinazione non esiste, verrà creata.

Parametri
`sourceDir`	`File`: la cartella che contiene i file da copiare
`destDir`	`File`: la cartella di destinazione
`ignoreExistingFile`	`boolean`: se True e il file a cui viene creato il link esiste già, ignora l'eccezione.

Genera
	java.io.IOException
`IOException`

recursiveSymlink

public static void recursiveSymlink (File sourceDir, 
                File destDir)

Crea un collegamento simbolico ricorsivo ai contenuti della cartella.

Supporta solo la copia di file e directory. I collegamenti simbolici non vengono copiati. Se la directory di destinazione non esiste, verrà creata.

Parametri
`sourceDir`	`File`: la cartella che contiene i file da copiare
`destDir`	`File`: la cartella di destinazione

Genera
	java.io.IOException
`IOException`

saveResourceFile

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

Salva un file di risorse in una directory.

Parametri
`resourceStream`	`InputStream`: un oggetto {link InputStream} alla risorsa da salvare.
`destDir`	`File`: un oggetto `File` di una directory in cui verrà salvato il file della risorsa.
`targetFileName`	`String`: un `String` per il nome del file in cui salvare i dati.

Resi
`File`	un oggetto `File` del file salvato.

Genera
`IOException`	se il salvataggio del file non è riuscito.

setReadableRecursive

public static void setReadableRecursive (File file)

Imposta in modo ricorsivo le autorizzazioni di lettura ed esecuzione (se cartella) per il file specificato.

Parametri
`file`	`File`

sizeOfDirectory

public static Long sizeOfDirectory (File directory)

Restituisce le dimensioni riportate dalla directory.

Parametri
`directory`	`File`

Resi
`Long`

symlinkFile

public static void symlinkFile (File origFile, 
                File destFile)

Un metodo helper che crea un collegamento simbolico a un altro file

Parametri
`origFile`	`File`: il file originale
`destFile`	`File`: il file di destinazione

Genera
`IOException`	se non è stato possibile creare il collegamento simbolico del file

unixModeToPosix

public static Set<PosixFilePermission> unixModeToPosix (int mode)

Converte un numero intero che rappresenta la modalità Unix in un insieme di PosixFilePermission

Parametri
`mode`	`int`

Resi
`Set<PosixFilePermission>`

writeToFile

public static void writeToFile (String inputString, 
                File destFile)

Un metodo helper per scrivere dati stringa nel file

Parametri
`inputString`	`String`: l'input `String`
`destFile`	`File`: il file di destinazione in cui scrivere

Genera
`IOException`

writeToFile

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

Un metodo helper per scrivere i dati dello stream nel file

Parametri
`input`	`InputStream`: il flusso di input non memorizzato nel buffer
`destFile`	`File`: il file di destinazione in cui scrivere o aggiungere dati
`append`	`boolean`: aggiungi alla fine del file se true, sovrascrivi altrimenti

Genera
`IOException`

writeToFile

public static void writeToFile (InputStream input, 
                File destFile)

Un metodo helper per scrivere i dati dello stream nel file

Parametri
`input`	`InputStream`: il flusso di input non memorizzato nel buffer
`destFile`	`File`: il file di destinazione in cui scrivere

Genera
`IOException`

writeToFile

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

Un metodo helper per scrivere o aggiungere dati stringa al file

Parametri
`inputString`	`String`: l'input `String`
`destFile`	`File`: il file di destinazione in cui scrivere o aggiungere dati
`append`	`boolean`: aggiungi alla fine del file se true, sovrascrivi altrimenti

Genera
`IOException`

writeToFile

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

Un metodo helper per scrivere i dati dello stream nel file

Parametri
`input`	`InputStream`: il flusso di input non memorizzato nel buffer
`destFile`	`File`: il file di destinazione in cui scrivere o aggiungere dati
`append`	`boolean`: aggiungi alla fine del file se true, sovrascrivi altrimenti
`startOffset`	`long`: l'offset iniziale dello stream di input per recuperare i dati
`size`	`long`: numero di byte da recuperare dal flusso di input. Imposta un valore negativo per recuperare tutti i contenuti a partire dall'offset specificato.

Genera
`IOException`

Metodi protetti

chmodExists

protected static boolean chmodExists ()

Helper interno per determinare se "chmod" è disponibile sul sistema operativo.

Resi
`boolean`

setChmodBinary

protected static void setChmodBinary (String chmodName)

Esposto per i test. Consente di modificare il nome del file binario chmod che cerchiamo, per testare il sistema senza supporto chmod.

Parametri
`chmodName`	`String`

FileUtil

Riepilogo

Classi nidificate

Costanti

Costruttori pubblici

Metodi pubblici

Metodi protetti

Costanti

FILESYSTEM_FILENAME_MAX_LENGTH

Costruttori pubblici

FileUtil

Metodi pubblici

calculateBase64Md5

calculateCrc32

calculateMd5

chmod

chmodGroupRW

chmodGroupRWX

chmodRWXRecursively

closeZip

collectJars

compareFileContents

convertSizeToBytes

convertToDiskSpaceIfNeeded

convertToReadableSize

copyFile

createNamedTempDir

createNamedTempDir

createTempDir

createTempDir

createTempFile

createTempFile

createTempFileForRemote

createZip

createZip

deleteFile

ensureGroupRWX

extractFileFromZip

extractZip

findDirectory

findDirsUnder

findFile

findFile

findFiles

findFiles

findFilesObject

findFilesObject

getBaseName

getContentType

getExtension

getFileForPath

getPath

gzipFile

hardlinkFile

hardlinkFile

isDiskSpaceError

mkdirsRWX

readStringFromFile

readStringFromFile

recursiveCopy

recursiveDelete

recursiveHardlink

recursiveHardlink

recursiveSymlink

saveResourceFile

setReadableRecursive

sizeOfDirectory

symlinkFile

unixModeToPosix

writeToFile

writeToFile

writeToFile

writeToFile

writeToFile

Metodi protetti

chmodExists

setChmodBinary