Em 2026, para nos alinharmos ao nosso modelo de desenvolvimento estável e garantir a estabilidade da plataforma para o ecossistema, vamos publicar o código-fonte no AOSP no segundo e quarto trimestres. Para criar e contribuir com o AOSP, use android-latest-release. A ramificação de manifesto android-latest-release sempre vai referenciar a versão mais recente enviada ao AOSP. Para mais informações, consulte Mudanças no 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

Uma classe auxiliar para operações relacionadas a arquivos.

Resumo

Classes aninhadas
`class`	`FileUtil.LowDiskSpaceException` Gerado se o espaço em disco utilizável estiver abaixo do limite mínimo.

Constantes
`int`	`FILESYSTEM_FILENAME_MAX_LENGTH`

Construtores públicos
`FileUtil()`

Métodos públicos
`static String`	`calculateBase64Md5(File file)` Método auxiliar para calcular o MD5 base64 de um arquivo.
`static long`	`calculateCrc32(File file)` Método auxiliar para calcular o CRC-32 de um arquivo.
`static String`	`calculateMd5(File file)` Método auxiliar para calcular o MD5 de um arquivo.
`static boolean`	`chmod(File file, String perms)`
`static boolean`	`chmodGroupRW(File file)` Faz uma tentativa de melhor esforço para tornar o grupo de arquivos legível e gravável.
`static boolean`	`chmodGroupRWX(File file)` Faz uma tentativa de melhor esforço para tornar o grupo de arquivos executável, legível e gravável.
`static boolean`	`chmodRWXRecursively(File file)`
`static void`	`closeZip(ZipFile zipFile)` Esse método foi descontinuado. Movida para `ZipUtil.closeZip(ZipFile)`.
`static List<File>`	`collectJars(File dir)` Retorna todos os arquivos JAR encontrados no diretório especificado.
`static boolean`	`compareFileContents(File file1, File file2)` Método utilitário para fazer a comparação de conteúdo byte a byte de dois arquivos.
`static long`	`convertSizeToBytes(String sizeString)` O inverso de `convertToReadableSize(long)`.
`static IOException`	`convertToDiskSpaceIfNeeded(IOException e)` Encapsula o erro em um erro de espaço em disco, se necessário.
`static String`	`convertToReadableSize(long sizeLong)` Converte o tamanho do arquivo em bytes para um formato mais legível no formato X.Y[KMGT].
`static void`	`copyFile(File origFile, File destFile)` Um método auxiliar que copia o conteúdo de um arquivo para um arquivo local
`static File`	`createNamedTempDir(File parentDir, String name)` Função auxiliar para criar um diretório nomeado dentro de uma pasta.
`static File`	`createNamedTempDir(String name)` Função auxiliar para criar um diretório nomeado na pasta temporária.
`static File`	`createTempDir(String prefix)` Função auxiliar para criar um diretório temporário no diretório de arquivos temporários padrão do sistema.
`static File`	`createTempDir(String prefix, File parentDir)` Função auxiliar para criar um diretório temporário.
`static File`	`createTempFile(String prefix, String suffix, File parentDir)` Função wrapper auxiliar em torno de `File.createTempFile(String,String,File)` que audita possíveis cenários de falta de espaço em disco.
`static File`	`createTempFile(String prefix, String suffix)` Função wrapper auxiliar em torno de `File.createTempFile(String,String)` que audita possíveis cenários de falta de espaço em disco.
`static File`	`createTempFileForRemote(String remoteFilePath, File parentDir)` Método auxiliar que cria um arquivo exclusivo no disco temporário, cujo nome corresponde o mais próximo possível ao nome do arquivo fornecido pelo caminho do arquivo remoto.
`static File`	`createZip(File dir)` Esse método foi descontinuado. Movida para `ZipUtil.createZip(File)`.
`static void`	`createZip(File dir, File zipFile)` Esse método foi descontinuado. Movida para `ZipUtil.createZip(File,File)`.
`static void`	`deleteFile(File file)` Tente excluir um arquivo.
`static boolean`	`ensureGroupRWX(File file)` Faz uma tentativa de melhor esforço para garantir que o grupo de arquivos especificado seja executável, legível e gravável.
`static File`	`extractFileFromZip(ZipFile zipFile, String filePath)` Esse método foi descontinuado. Movida para `ZipUtil.extractFileFromZip(ZipFile,String)`.
`static void`	`extractZip(ZipFile zipFile, File destDir)` Esse método foi descontinuado. Movida para `ZipUtil.extractZip(ZipFile,File)`.
`static File`	`findDirectory(String dirName, File... dirs)` Pesquise e retorne o primeiro diretório `File` entre outros diretórios.
`static Set<File>`	`findDirsUnder(File rootDir, File relativeParent)` Encontra recursivamente todos os diretórios em um determinado `rootDir`
`static File`	`findFile(File dir, String fileName)` Pesquisa recursivamente o diretório especificado pelo primeiro arquivo com o nome especificado.
`static File`	`findFile(String fileName, IAbi abi, File... dirs)` Receba todos os caminhos de arquivos no diretório especificado com nome correspondente ao filtro especificado e também filtre o arquivo encontrado por arquitetura ABI se a ABI não for nula.
`static Set<File>`	`findFiles(String fileName, IAbi abi, boolean includeDirectory, File... dirs)` Receba todos os arquivos no diretório especificado com nome correspondente ao filtro especificado e também filtre os arquivos encontrados por arquitetura ABI se a ABI não for nula.
`static Set<String>`	`findFiles(File dir, String filter)` Receba todos os caminhos de arquivos no diretório especificado com nomes que correspondem ao filtro especificado.
`static Set<File>`	`findFilesObject(File dir, String filter, boolean includeDirectory)` Receba todos os caminhos de arquivos no diretório especificado com nomes que correspondem ao filtro especificado.
`static Set<File>`	`findFilesObject(File dir, String filter)` Receba todos os caminhos de arquivos no diretório especificado com nomes que correspondem ao filtro especificado.
`static String`	`getBaseName(String fileName)` Recebe o nome base, sem extensão, do nome de arquivo especificado.
`static String`	`getContentType(String filePath)` Recebe o tipo de conteúdo do arquivo com base na extensão dele.
`static String`	`getExtension(String fileName)` Recebe a extensão do nome de arquivo especificado.
`static File`	`getFileForPath(File parentDir, String... pathSegments)` Método auxiliar para criar um arquivo dependente do sistema
`static String`	`getPath(String... pathSegments)` Método auxiliar para criar um caminho relativo dependente do sistema
`static void`	`gzipFile(File file, File gzipFile)` Esse método foi descontinuado. Movida para `ZipUtil.gzipFile(File,File)`.
`static void`	`hardlinkFile(File origFile, File destFile)` Um método auxiliar que cria um link físico de um arquivo para outro.
`static void`	`hardlinkFile(File origFile, File destFile, boolean ignoreExistingFile)` Um método auxiliar que cria um link físico de um arquivo para outro.
`static boolean`	`isDiskSpaceError(String message)` Retorna "true" se a mensagem for um erro de espaço em disco.
`static boolean`	`mkdirsRWX(File file)` Método para criar uma cadeia de diretórios e definir todos eles como executáveis/legíveis/graváveis em grupo à medida que são criados, chamando `chmodGroupRWX(File)`.
`static String`	`readStringFromFile(File sourceFile, long startOffset, long length)` Um método auxiliar para ler dados de string parcial de um arquivo.
`static String`	`readStringFromFile(File sourceFile)` Um método auxiliar para ler dados de string de um arquivo
`static void`	`recursiveCopy(File sourceDir, File destDir)` Copiar recursivamente o conteúdo da pasta.
`static void`	`recursiveDelete(File rootDir)` Exclui recursivamente o arquivo ou diretório especificado e todo o conteúdo dele.
`static void`	`recursiveHardlink(File sourceDir, File destDir)` Cria links físicos recursivamente para o conteúdo da pasta.
`static void`	`recursiveHardlink(File sourceDir, File destDir, boolean ignoreExistingFile)` Cria links físicos recursivamente para o conteúdo da pasta.
`static void`	`recursiveSymlink(File sourceDir, File destDir)` Cria links simbólicos recursivamente para o conteúdo da pasta.
`static File`	`saveResourceFile(InputStream resourceStream, File destDir, String targetFileName)` Salve um arquivo de recurso em um diretório.
`static void`	`setReadableRecursive(File file)` Define recursivamente as permissões de leitura e execução (se for pasta) para o arquivo especificado.
`static Long`	`sizeOfDirectory(File directory)` Retorna o tamanho informado pelo diretório.
`static void`	`symlinkFile(File origFile, File destFile)` Um método auxiliar que cria um link simbólico de um arquivo para outro.
`static Set<PosixFilePermission>`	`unixModeToPosix(int mode)` Converte um número inteiro que representa o modo Unix em um conjunto de `PosixFilePermission`s.
`static void`	`writeToFile(String inputString, File destFile)` Um método auxiliar para gravar dados de string em um arquivo.
`static void`	`writeToFile(InputStream input, File destFile, boolean append)` Um método auxiliar para gravar dados de fluxo em um arquivo.
`static void`	`writeToFile(InputStream input, File destFile)` Um método auxiliar para gravar dados de fluxo em um arquivo.
`static void`	`writeToFile(String inputString, File destFile, boolean append)` Um método auxiliar para gravar ou anexar dados de string a um arquivo.
`static void`	`writeToFile(InputStream input, File destFile, boolean append, long startOffset, long size)` Um método auxiliar para gravar dados de fluxo em um arquivo.

Métodos protegidos
`static boolean`	`chmodExists()` Assistente interno para determinar se "chmod" está disponível no SO do sistema.
`static void`	`setChmodBinary(String chmodName)` Exposto para testes.

Constantes

FILESYSTEM_FILENAME_MAX_LENGTH

public static final int FILESYSTEM_FILENAME_MAX_LENGTH

Valor da constante: 255 (0x000000ff)

Construtores públicos

FileUtil

public FileUtil ()

Métodos públicos

calculateBase64Md5

public static String calculateBase64Md5 (File file)

Método auxiliar para calcular o MD5 base64 de um arquivo.

Retorna
`String`	MD5 do arquivo

calculateCrc32

public static long calculateCrc32 (File file)

Método auxiliar para calcular o CRC-32 de um arquivo.

Retorna
`long`	CRC-32 do arquivo

Gera
	java.io.IOException
`IOException`

calculateMd5

public static String calculateMd5 (File file)

Método auxiliar para calcular o MD5 de um arquivo.

Retorna
`String`	MD5 do arquivo

chmod

public static boolean chmod (File file, 
                String perms)

Parâmetros
`file`	`File`
`perms`	`String`

Retorna
`boolean`

chmodGroupRW

public static boolean chmodGroupRW (File file)

Faz uma tentativa de melhor esforço para tornar o grupo de arquivos legível e gravável.

A permissão de execução é necessária para tornar os diretórios acessíveis. Consulte chmodGroupRWX(File).

Se o comando do sistema "chmod" não for compatível com o SO subjacente, o arquivo será definido como gravável por todos.

Parâmetros
`file`	`File`: o `File` para tornar o proprietário e o grupo graváveis

Retorna
`boolean`	`true` se o arquivo foi gravado com sucesso no grupo. Caso contrário, `false`.

chmodGroupRWX

public static boolean chmodGroupRWX (File file)

Faz uma tentativa de melhor esforço para tornar o grupo de arquivos executável, legível e gravável.

Se o comando do sistema "chmod" for indisponível no SO subjacente, tentaremos definir permissões para todos os usuários.

Parâmetros
`file`	`File`: o `File` para tornar o proprietário e o grupo graváveis

Retorna
`boolean`	`true` se as permissões foram definidas com sucesso. Caso contrário, `false`.

chmodRWXRecursively

public static boolean chmodRWXRecursively (File file)

Parâmetros
`file`	`File`

Retorna
`boolean`

closeZip

public static void closeZip (ZipFile zipFile)

Esse método foi descontinuado.
Movido para ZipUtil.closeZip(ZipFile).

Fecha um ZipFile aberto, ignorando exceções.

Parâmetros
`zipFile`	`ZipFile`: o arquivo a ser fechado

collectJars

public static List<File> collectJars (File dir)

Retorna todos os arquivos JAR encontrados no diretório especificado.

Parâmetros
`dir`	`File`

Retorna
`List<File>`

compareFileContents

public static boolean compareFileContents (File file1, 
                File file2)

Método utilitário para fazer a comparação de conteúdo byte a byte de dois arquivos.

Parâmetros
`file1`	`File`
`file2`	`File`

Retorna
`boolean`	`true` se o conteúdo dos arquivos for idêntico

Gera
`IOException`

convertSizeToBytes

public static long convertSizeToBytes (String sizeString)

O inverso de convertToReadableSize(long). Converte o formato legível descrito em convertToReadableSize(long) em um valor de byte.

Parâmetros
`sizeString`	`String`: a descrição da string do tamanho.

Retorna
`long`	o tamanho em bytes

Gera
`IllegalArgumentException`	se não for possível reconhecer o tamanho

convertToDiskSpaceIfNeeded

public static IOException convertToDiskSpaceIfNeeded (IOException e)

Encapsula o erro em um erro de espaço em disco, se necessário.

Parâmetros
`e`	`IOException`

Retorna
`IOException`

convertToReadableSize

public static String convertToReadableSize (long sizeLong)

Converte o tamanho do arquivo em bytes para um formato mais legível no formato X.Y[KMGT].

Parâmetros
`sizeLong`	`long`: tamanho do arquivo em bytes

Retorna
`String`	string descritiva do tamanho do arquivo

copyFile

public static void copyFile (File origFile, 
                File destFile)

Um método auxiliar que copia o conteúdo de um arquivo para um arquivo local

Parâmetros
`origFile`	`File`: o arquivo original a ser copiado
`destFile`	`File`: o arquivo de destino

Gera
`IOException`	se houver falha ao copiar o arquivo

createNamedTempDir

public static File createNamedTempDir (File parentDir, 
                String name)

Função auxiliar para criar um diretório nomeado dentro de uma pasta.

O nome desse diretório não será aleatório. Se o diretório já existir, ele será retornado.

Parâmetros
`parentDir`	`File`: o diretório em que o diretório será criado. Se for nulo, será em /tmp
`name`	`String`: o nome do diretório a ser criado na pasta mãe.

Retorna
`File`	o diretório criado

Gera
`IOException`

createNamedTempDir

public static File createNamedTempDir (String name)

Função auxiliar para criar um diretório nomeado na pasta temporária.

O nome desse diretório não será aleatório. Se o diretório já existir, ele será retornado.

Parâmetros
`name`	`String`: o nome do diretório a ser criado na pasta tmp.

Retorna
`File`	o diretório criado

Gera
`IOException`

createTempDir

public static File createTempDir (String prefix)

Função auxiliar para criar um diretório temporário no diretório de arquivos temporários padrão do sistema.

Parâmetros
`prefix`	`String`: a string de prefixo a ser usada na geração do nome do arquivo. Ela precisa ter pelo menos três caracteres.

Retorna
`File`	o diretório criado

Gera
`IOException`	se não for possível criar o arquivo

createTempDir

public static File createTempDir (String prefix, 
                File parentDir)

Função auxiliar para criar um diretório temporário.

Parâmetros
`prefix`	`String`: a string de prefixo a ser usada na geração do nome do arquivo. Ela precisa ter pelo menos três caracteres.
`parentDir`	`File`: o diretório principal em que o diretório será criado. Se `null`, o diretório temporário padrão do sistema será usado.

Retorna
`File`	o diretório criado

Gera
`IOException`	se não for possível criar o arquivo

createTempFile

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

Função wrapper auxiliar em torno de File.createTempFile(String,String,File) que audita possíveis cenários de falta de espaço em disco.

Parâmetros
`prefix`	`String`
`suffix`	`String`
`parentDir`	`File`

Retorna
`File`

Gera
`FileUtil.LowDiskSpaceException`	se o espaço em disco na partição for menor que o mínimo permitido
`IOException`

Confira também:

File.createTempFile(String,String,File)

createTempFile

public static File createTempFile (String prefix, 
                String suffix)

Função wrapper auxiliar em torno de File.createTempFile(String,String) que audita possíveis cenários de falta de espaço em disco.

Parâmetros
`prefix`	`String`
`suffix`	`String`

Retorna
`File`

Gera
`FileUtil.LowDiskSpaceException`	se o espaço em disco na partição temporária for menor que o mínimo permitido
`IOException`

Confira também:

File.createTempFile(String,String)

createTempFileForRemote

public static File createTempFileForRemote (String remoteFilePath, 
                File parentDir)

Método auxiliar que cria um arquivo exclusivo no disco temporário, cujo nome corresponde o mais próximo possível ao nome do arquivo fornecido pelo caminho do arquivo remoto.

Parâmetros
`remoteFilePath`	`String`: o caminho remoto separado por "/" para construir o nome.
`parentDir`	`File`: o diretório principal em que o arquivo será criado. `null` para usar o diretório temporário padrão

Retorna
`File`

Gera
`IOException`

createZip

public static File createZip (File dir)

Esse método foi descontinuado.
Movido para ZipUtil.createZip(File).

Método utilitário para criar um arquivo ZIP temporário contendo o diretório especificado e todo o conteúdo dele.

Parâmetros
`dir`	`File`: o diretório a ser compactado

Retorna
`File`	um zip temporário `File` com o conteúdo do diretório

Gera
`IOException`	se não for possível criar o arquivo ZIP

createZip

public static void createZip (File dir, 
                File zipFile)

Esse método foi descontinuado.
Movido para ZipUtil.createZip(File,File).

Método utilitário para criar um arquivo ZIP que contenha o diretório especificado e todo o conteúdo dele.

Parâmetros
`dir`	`File`: o diretório a ser compactado
`zipFile`	`File`: o arquivo ZIP a ser criado. Ele não pode existir.

Gera
`IOException`	se não for possível criar o arquivo ZIP

deleteFile

public static void deleteFile (File file)

Tente excluir um arquivo. Destinado ao uso na limpeza em estrofes finally.

Parâmetros
`file`	`File`: pode ser nulo.

ensureGroupRWX

public static boolean ensureGroupRWX (File file)

Faz uma tentativa de melhor esforço para garantir que o grupo de arquivos especificado seja executável, legível e gravável.

Se o comando do sistema "chmod" não for compatível com o SO subjacente, tentará definir permissões para todos os usuários. A operação é sincronizada para evitar a condição de disputa introduzida ao acessar arquivos de um cache, por exemplo, GCSFileDownloader.

Parâmetros
`file`	`File`: o `File` para tornar o proprietário e o grupo graváveis

Retorna
`boolean`	`true` se as permissões foram definidas com sucesso. Caso contrário, `false`.

extractFileFromZip

public static File extractFileFromZip (ZipFile zipFile, 
                String filePath)

Esse método foi descontinuado.
Movido para ZipUtil.extractFileFromZip(ZipFile,String).

Método utilitário para extrair um arquivo específico de um arquivo ZIP para um arquivo temporário.

Parâmetros
`zipFile`	`ZipFile`: o `ZipFile` a ser extraído
`filePath`	`String`: o caminho do arquivo a ser extraído

Retorna
`File`	o `File` ou nulo se não for encontrado

Gera
`IOException`	se houver falha ao extrair o arquivo

extractZip

public static void extractZip (ZipFile zipFile, 
                File destDir)

Esse método foi descontinuado.
Movido para ZipUtil.extractZip(ZipFile,File).

Método utilitário para extrair todo o conteúdo do arquivo ZIP para o diretório especificado.

Parâmetros
`zipFile`	`ZipFile`: o `ZipFile` a ser extraído
`destDir`	`File`: o diretório local para extrair o arquivo

Gera
`IOException`	se houver falha ao extrair o arquivo

findDirectory

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

Pesquise e retorne o primeiro diretório File entre outros diretórios.

Parâmetros
`dirName`	`String`: o nome do diretório que estamos procurando.
`dirs`	`File`: a lista de diretórios que estamos pesquisando.

Retorna
`File`	Um `File` com o diretório encontrado ou Null, se não for encontrado.

Gera
	java.io.IOException
`IOException`

findDirsUnder

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

Encontra recursivamente todos os diretórios em um determinado rootDir

Parâmetros
`rootDir`	`File`: o diretório raiz em que pesquisar
`relativeParent`	`File`: um elemento pai opcional para todos os `File`s retornados. Se não for especificado, todos os `File`s serão relativos a `rootDir`.

Retorna
`Set<File>`	Um conjunto de `File`s, representando todos os diretórios em `rootDir`, incluindo o próprio `rootDir`. Se `rootDir` for nulo, um conjunto vazio será retornado.

findFile

public static File findFile (File dir, 
                String fileName)

Pesquisa recursivamente o diretório especificado pelo primeiro arquivo com o nome especificado.

Parâmetros
`dir`	`File`: o diretório a ser pesquisado
`fileName`	`String`: o nome do arquivo a ser pesquisado

Retorna
`File`	o `File` ou `null`, se não for possível encontrar

findFile

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

Receba todos os caminhos de arquivos no diretório especificado com nome correspondente ao filtro especificado e também filtre o arquivo encontrado por arquitetura ABI se a ABI não for nula. Retorna o primeiro arquivo de correspondência encontrado.

Parâmetros
`fileName`	`String`: `String` da regex para corresponder ao caminho do arquivo
`abi`	`IAbi`: objeto `IAbi` da ABI para corresponder ao destino
`dirs`	`File`: uma matriz varargs de objetos `File` dos diretórios em que os arquivos serão pesquisados.

Retorna
`File`	o `File` ou `null`, se não for possível encontrar

Gera
`IOException`

findFiles

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

Receba todos os arquivos no diretório especificado com nome correspondente ao filtro especificado e também filtre os arquivos encontrados por arquitetura ABI se a ABI não for nula.

Parâmetros
`fileName`	`String`: `String` da regex para corresponder ao caminho do arquivo
`abi`	`IAbi`: objeto `IAbi` da ABI para corresponder ao destino
`includeDirectory`	`boolean`: se os diretórios devem ser incluídos no resultado da pesquisa
`dirs`	`File`: uma matriz de objetos `File` dos diretórios em que os arquivos serão pesquisados.

Retorna
`Set<File>`	um conjunto de `File`s ou vazio se não for encontrado

Gera
`IOException`

findFiles

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

Receba todos os caminhos de arquivos no diretório especificado com nomes que correspondem ao filtro especificado.

Parâmetros
`dir`	`File`: objeto `File` do diretório para pesquisar arquivos de forma recursiva
`filter`	`String`: `String` da regex para corresponder a nomes de arquivos

Retorna
`Set<String>`	um conjunto de `String` dos caminhos de arquivo

Gera
`IOException`

findFilesObject

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

Receba todos os caminhos de arquivos no diretório especificado com nomes que correspondem ao filtro especificado.

Parâmetros
`dir`	`File`: objeto `File` do diretório para pesquisar arquivos de forma recursiva
`filter`	`String`: `String` da regex para corresponder a nomes de arquivos
`includeDirectory`	`boolean`: se os diretórios devem ser incluídos no resultado da pesquisa

Retorna
`Set<File>`	um conjunto de `File` dos objetos de arquivo. @Consulte `findFiles(File,String)`

Gera
`IOException`

findFilesObject

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

Receba todos os caminhos de arquivos no diretório especificado com nomes que correspondem ao filtro especificado.

Parâmetros
`dir`	`File`: objeto `File` do diretório para pesquisar arquivos de forma recursiva
`filter`	`String`: `String` da regex para corresponder a nomes de arquivos

Retorna
`Set<File>`	um conjunto de `File` dos objetos de arquivo. @Consulte `findFiles(File,String)`

Gera
`IOException`

getBaseName

public static String getBaseName (String fileName)

Recebe o nome base, sem extensão, do nome de arquivo especificado.

Por exemplo, getBaseName("file.txt") retorna "file"

Retorna
`String`	o nome base

getContentType

public static String getContentType (String filePath)

Recebe o tipo de conteúdo do arquivo com base na extensão dele.

Parâmetros
`filePath`	`String`: o caminho do arquivo

Retorna
`String`	tipo de conteúdo

getExtension

public static String getExtension (String fileName)

Recebe a extensão do nome de arquivo especificado.

Retorna
`String`	a extensão ou uma string vazia se o arquivo não tiver uma extensão

getFileForPath

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

Método auxiliar para criar um arquivo dependente do sistema

Parâmetros
`parentDir`	`File`: o diretório principal a ser usado.
`pathSegments`	`String`: os segmentos de caminho relativo a serem usados

Retorna
`File`	o `File` que representa o caminho especificado, com cada `pathSegment` separado por `File.separatorChar`

getPath

public static String getPath (String... pathSegments)

Método auxiliar para criar um caminho relativo dependente do sistema

Parâmetros
`pathSegments`	`String`: os segmentos de caminho relativo a serem usados

Retorna
`String`	o `String` que representa o caminho especificado, com cada `pathSegment` separado por `File.separatorChar`

gzipFile

public static void gzipFile (File file, 
                File gzipFile)

Esse método foi descontinuado.
Movido para ZipUtil.gzipFile(File,File).

Método auxiliar para criar uma versão compactada com gzip de um único arquivo.

Parâmetros
`file`	`File`: o arquivo original
`gzipFile`	`File`: o arquivo em que o conteúdo compactado será colocado

Gera
	java.io.IOException
`IOException`

hardlinkFile

public static void hardlinkFile (File origFile, 
                File destFile)

Um método auxiliar que cria um link físico de um arquivo para outro. Volte a copiar em caso de vinculação entre partições.

Parâmetros
`origFile`	`File`: o arquivo original
`destFile`	`File`: o arquivo de destino

Gera
`IOException`	se não for possível criar um hardlink do arquivo

hardlinkFile

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

Um método auxiliar que cria um link físico de um arquivo para outro. Volte a copiar em caso de vinculação entre partições.

Parâmetros
`origFile`	`File`: o arquivo original
`destFile`	`File`: o arquivo de destino
`ignoreExistingFile`	`boolean`: se for "True" e o arquivo vinculado já existir, ignore a exceção.

Gera
`IOException`	se não for possível criar um hardlink do arquivo

isDiskSpaceError

public static boolean isDiskSpaceError (String message)

Retorna "true" se a mensagem for um erro de espaço em disco.

Parâmetros
`message`	`String`

Retorna
`boolean`

mkdirsRWX

public static boolean mkdirsRWX (File file)

Método para criar uma cadeia de diretórios e definir todos eles como executáveis/legíveis/graváveis em grupo à medida que são criados, chamando chmodGroupRWX(File). Basicamente, uma versão de File.mkdirs() que também executa chmod(File,String).

Parâmetros
`file`	`File`: o nome do diretório a ser criado, possivelmente com diretórios que ainda não existem.

Retorna
`boolean`	`true` se `file` existir e for um diretório. Caso contrário, `false`.

readStringFromFile

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

Um método auxiliar para ler dados de string parcial de um arquivo.

Parâmetros
`sourceFile`	`File`: o arquivo a ser lido
`startOffset`	`long`: o deslocamento inicial para leitura do arquivo.
`length`	`long`: o número de bytes a serem lidos do arquivo.

Retorna
`String`

Gera
	FileNotFoundException
	java.io.IOException
`IOException`

readStringFromFile

public static String readStringFromFile (File sourceFile)

Um método auxiliar para ler dados de string de um arquivo

Parâmetros
`sourceFile`	`File`: o arquivo a ser lido

Retorna
`String`

Gera
	FileNotFoundException
	java.io.IOException
`IOException`

recursiveCopy

public static void recursiveCopy (File sourceDir, 
                File destDir)

Copiar recursivamente o conteúdo da pasta.

Só é possível copiar arquivos e diretórios. Links simbólicos não são copiados. Se o diretório de destino não existir, ele será criado.

Parâmetros
`sourceDir`	`File`: a pasta que contém os arquivos a serem copiados
`destDir`	`File`: a pasta de destino

Gera
	java.io.IOException
`IOException`

recursiveDelete

public static void recursiveDelete (File rootDir)

Exclui recursivamente o arquivo ou diretório especificado e todo o conteúdo dele.

Parâmetros
`rootDir`	`File`: o diretório ou arquivo a ser excluído. Pode ser nulo.

recursiveHardlink

public static void recursiveHardlink (File sourceDir, 
                File destDir)

Cria links físicos recursivamente para o conteúdo da pasta.

Só é possível copiar arquivos e diretórios. Links simbólicos não são copiados. Se o diretório de destino não existir, ele será criado.

Parâmetros
`sourceDir`	`File`: a pasta que contém os arquivos a serem copiados
`destDir`	`File`: a pasta de destino

Gera
	java.io.IOException
`IOException`

recursiveHardlink

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

Cria links físicos recursivamente para o conteúdo da pasta.

Só é possível copiar arquivos e diretórios. Links simbólicos não são copiados. Se o diretório de destino não existir, ele será criado.

Parâmetros
`sourceDir`	`File`: a pasta que contém os arquivos a serem copiados
`destDir`	`File`: a pasta de destino
`ignoreExistingFile`	`boolean`: se for "True" e o arquivo vinculado já existir, ignore a exceção.

Gera
	java.io.IOException
`IOException`

recursiveSymlink

public static void recursiveSymlink (File sourceDir, 
                File destDir)

Cria links simbólicos recursivamente para o conteúdo da pasta.

Só é possível copiar arquivos e diretórios. Links simbólicos não são copiados. Se o diretório de destino não existir, ele será criado.

Parâmetros
`sourceDir`	`File`: a pasta que contém os arquivos a serem copiados
`destDir`	`File`: a pasta de destino

Gera
	java.io.IOException
`IOException`

saveResourceFile

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

Salve um arquivo de recurso em um diretório.

Parâmetros
`resourceStream`	`InputStream`: um objeto {link InputStream} para o recurso a ser salvo.
`destDir`	`File`: um objeto `File` de um diretório em que o arquivo de recursos será salvo.
`targetFileName`	`String`: um `String` para o nome do arquivo a ser salvo.

Retorna
`File`	um objeto `File` do arquivo salvo.

Gera
`IOException`	se o arquivo não foi salvo.

setReadableRecursive

public static void setReadableRecursive (File file)

Define recursivamente as permissões de leitura e execução (se for pasta) para o arquivo especificado.

Parâmetros
`file`	`File`

sizeOfDirectory

public static Long sizeOfDirectory (File directory)

Retorna o tamanho informado pelo diretório.

Parâmetros
`directory`	`File`

Retorna
`Long`

symlinkFile

public static void symlinkFile (File origFile, 
                File destFile)

Um método auxiliar que cria um link simbólico de um arquivo para outro.

Parâmetros
`origFile`	`File`: o arquivo original
`destFile`	`File`: o arquivo de destino

Gera
`IOException`	se não for possível criar um link simbólico para o arquivo

unixModeToPosix

public static Set<PosixFilePermission> unixModeToPosix (int mode)

Converte um número inteiro que representa o modo Unix em um conjunto de PosixFilePermissions.

Parâmetros
`mode`	`int`

Retorna
`Set<PosixFilePermission>`

writeToFile

public static void writeToFile (String inputString, 
                File destFile)

Um método auxiliar para gravar dados de string em um arquivo.

Parâmetros
`inputString`	`String`: a `String` de entrada
`destFile`	`File`: o arquivo de destino em que gravar

Gera
`IOException`

writeToFile

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

Um método auxiliar para gravar dados de fluxo em um arquivo.

Parâmetros
`input`	`InputStream`: o fluxo de entrada não armazenado em buffer
`destFile`	`File`: o arquivo de destino para gravar ou anexar
`append`	`boolean`: adiciona ao final do arquivo se for verdadeiro, caso contrário, substitui

Gera
`IOException`

writeToFile

public static void writeToFile (InputStream input, 
                File destFile)

Um método auxiliar para gravar dados de fluxo em um arquivo.

Parâmetros
`input`	`InputStream`: o fluxo de entrada não armazenado em buffer
`destFile`	`File`: o arquivo de destino em que gravar

Gera
`IOException`

writeToFile

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

Um método auxiliar para gravar ou anexar dados de string a um arquivo.

Parâmetros
`inputString`	`String`: a `String` de entrada
`destFile`	`File`: o arquivo de destino para gravar ou anexar
`append`	`boolean`: adiciona ao final do arquivo se for verdadeiro, caso contrário, substitui

Gera
`IOException`

writeToFile

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

Um método auxiliar para gravar dados de fluxo em um arquivo.

Parâmetros
`input`	`InputStream`: o fluxo de entrada não armazenado em buffer
`destFile`	`File`: o arquivo de destino para gravar ou anexar
`append`	`boolean`: adiciona ao final do arquivo se for verdadeiro, caso contrário, substitui
`startOffset`	`long`: o deslocamento inicial do fluxo de entrada para recuperar dados
`size`	`long`: número de bytes a serem recuperados do fluxo de entrada. Defina como um valor negativo para recuperar todo o conteúdo a partir do deslocamento especificado.

Gera
`IOException`

Métodos protegidos

chmodExists

protected static boolean chmodExists ()

Assistente interno para determinar se "chmod" está disponível no SO do sistema.

Retorna
`boolean`

setChmodBinary

protected static void setChmodBinary (String chmodName)

Exposto para testes. Permite modificar o nome binário do chmod que procuramos para testar o sistema sem suporte a chmod.

Parâmetros
`chmodName`	`String`

FileUtil

Resumo

Classes aninhadas

Constantes

Construtores públicos

Métodos públicos

Métodos protegidos

Constantes

FILESYSTEM_FILENAME_MAX_LENGTH

Construtores públicos

FileUtil

Métodos públicos

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

Métodos protegidos

chmodExists

setChmodBinary