此页面由 Cloud Translation API 翻译。

FileUtil

public class FileUtil
extends Object

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

用于文件相关操作的辅助类

摘要

嵌套类
`class`	`FileUtil.LowDiskSpaceException` 如果可用磁盘空间低于最低阈值，则会抛出此异常。

常量
`int`	`FILESYSTEM_FILENAME_MAX_LENGTH`

公共构造函数
`FileUtil()`

公共方法
`static String`	`calculateBase64Md5(File file)` 用于计算文件 base64 md5 的辅助方法。
`static long`	`calculateCrc32(File file)` 用于计算文件 CRC-32 的辅助方法。
`static String`	`calculateMd5(File file)` 用于计算文件 md5 的辅助方法。
`static boolean`	`chmod(File file, String perms)`
`static boolean`	`chmodGroupRW(File file)` 会尽最大努力使指定文件群组可读写。
`static boolean`	`chmodGroupRWX(File file)` 会尽最大努力使给定文件组可执行、可读取和可写入。
`static boolean`	`chmodRWXRecursively(File file)`
`static void`	`closeZip(ZipFile zipFile)` 此方法已废弃。已移至 `ZipUtil.closeZip(ZipFile)`。
`static`	`collectJars(File dir)` 返回在给定目录中找到的所有 jar 文件
`static boolean`	`compareFileContents(File file1, File file2)` 用于对两个文件进行字节级内容比较的实用程序方法。
`static long`	`convertSizeToBytes(String sizeString)` `convertToReadableSize(long)` 的反函数。
`static IOException`	`convertToDiskSpaceIfNeeded(IOException e)` 如有必要，将错误封装到磁盘可用空间错误中。
`static String`	`convertToReadableSize(long sizeLong)` 将给定文件大小（以字节为单位）转换为更易读的 X.Y[KMGT] 格式。
`static void`	`copyFile(File origFile, File destFile)` 用于将文件内容复制到本地文件的辅助方法
`static File`	`createNamedTempDir(File parentDir, String name)` 用于在文件夹中创建命名目录的辅助函数。
`static File`	`createNamedTempDir(String name)` 用于在临时文件夹中创建命名目录的辅助函数。
`static File`	`createTempDir(String prefix)` 用于在系统默认临时文件目录中创建临时目录的辅助函数。
`static File`	`createTempDir(String prefix, File parentDir)` 用于创建临时目录的辅助函数。
`static File`	`createTempFile(String prefix, String suffix, File parentDir)` 围绕 `ERROR(/File#createTempFile(String, String, File))` 的辅助封装容器函数，用于审核潜在的磁盘空间不足情况。
`static File`	`createTempFile(String prefix, String suffix)` 围绕 `ERROR(/File#createTempFile(String, String))` 的辅助封装容器函数，用于审核潜在的磁盘空间不足情况。
`static File`	`createTempFileForRemote(String remoteFilePath, File parentDir)` 在临时磁盘上构建唯一文件的辅助方法，其名称与远程文件路径给出的文件名称尽可能相符
`static File`	`createZip(File dir)` 此方法已废弃。已移至 `ZipUtil.createZip(File)`。
`static void`	`createZip(File dir, File zipFile)` 此方法已废弃。已移至 `ZipUtil.createZip(File, File)`。
`static void`	`deleteFile(File file)` 尝试删除文件。
`static boolean`	`ensureGroupRWX(File file)` 会尽最大努力确保给定文件组可执行、可读取和可写入。
`static File`	`extractFileFromZip(ZipFile zipFile, String filePath)` 此方法已废弃。已移至 `ZipUtil.extractFileFromZip(ZipFile, String)`。
`static void`	`extractZip(ZipFile zipFile, File destDir)` 此方法已废弃。已移至 `ZipUtil.extractZip(ZipFile, File)`。
`static File`	`findDirectory(String dirName, File... dirs)` 搜索并返回其他目录中的第一个目录 `ERROR(/File)`。
`static`	`findDirsUnder(File rootDir, File relativeParent)` 以递归方式查找指定 `rootDir` 下的所有目录
`static File`	`findFile(String fileName, IAbi abi, File... dirs)` 获取给定目录中与给定过滤条件匹配的名称的所有文件的文件路径，并根据 abi（如果不为 null）过滤找到的文件。
`static File`	`findFile(File dir, String fileName)` 递归搜索给定目录，查找具有给定名称的第一个文件
`static`	`findFiles(String fileName, IAbi abi, boolean includeDirectory, File... dirs)` 获取给定目录中与给定过滤条件匹配的名称的所有文件，并按 abi arch 过滤找到的文件（如果 abi 不为 null）。
`static`	`findFiles(File dir, String filter)` 获取给定目录中与给定过滤条件匹配的文件的所有文件路径
`static`	`findFilesObject(File dir, String filter)` 获取给定目录中与给定过滤条件匹配的文件的所有文件路径
`static`	`findFilesObject(File dir, String filter, boolean includeDirectory)` 获取给定目录中与给定过滤条件匹配的文件的所有文件路径
`static String`	`getBaseName(String fileName)` 获取给定文件名的不带扩展名的文件名。
`static String`	`getContentType(String filePath)` 根据文件扩展名获取文件的内容类型。
`static String`	`getExtension(String fileName)` 获取给定文件名的扩展名。
`static File`	`getFileForPath(File parentDir, String... pathSegments)` 用于构建系统依赖文件的辅助方法
`static String`	`getPath(String... pathSegments)` 用于构建系统相关相对路径的辅助方法
`static void`	`gzipFile(File file, File gzipFile)` 此方法已废弃。已移至 `ZipUtil.gzipFile(File, File)`。
`static void`	`hardlinkFile(File origFile, File destFile)` 用于将文件硬链接到另一个文件的辅助方法。
`static void`	`hardlinkFile(File origFile, File destFile, boolean ignoreExistingFile)` 用于将文件硬链接到另一个文件的辅助方法。
`static boolean`	`isDiskSpaceError(String message)` 如果消息是磁盘空间错误，则返回 true。
`static boolean`	`mkdirsRWX(File file)` 用于通过调用 `chmodGroupRWX(File)` 创建目录链，并在创建时将所有目录设置为群组执行/读取/写入权限的方法。
`static String`	`readStringFromFile(File sourceFile, long startOffset, long length)` 用于从文件中读取部分字符串数据的辅助方法
`static String`	`readStringFromFile(File sourceFile)` 用于从文件读取字符串数据的辅助方法
`static void`	`recursiveCopy(File sourceDir, File destDir)` 递归复制文件夹内容。
`static void`	`recursiveDelete(File rootDir)` 递归删除指定文件或目录及其所有内容。
`static void`	`recursiveHardlink(File sourceDir, File destDir)` 以递归方式硬链接文件夹内容。
`static void`	`recursiveHardlink(File sourceDir, File destDir, boolean ignoreExistingFile)` 以递归方式硬链接文件夹内容。
`static void`	`recursiveSymlink(File sourceDir, File destDir)` 以递归方式符号链接文件夹内容。
`static File`	`saveResourceFile(InputStream resourceStream, File destDir, String targetFileName)` 将资源文件保存到目录中。
`static void`	`setReadableRecursive(File file)` 递归设置给定文件的读取和执行（如果是文件夹）权限。
`static Long`	`sizeOfDirectory(File directory)` 返回目录报告的大小。
`static void`	`symlinkFile(File origFile, File destFile)` 用于将文件符号链接到另一个文件的辅助方法
`static`	`unixModeToPosix(int mode)` 将表示 Unix 模式的整数转换为一组 `ERROR(/PosixFilePermission)`
`static void`	`writeToFile(String inputString, File destFile, boolean append)` 用于将字符串数据写入或附加到文件的辅助方法
`static void`	`writeToFile(String inputString, File destFile)` 用于将字符串数据写入文件的辅助方法
`static void`	`writeToFile(InputStream input, File destFile, boolean append, long startOffset, long size)` 用于将流式数据写入文件的辅助方法
`static void`	`writeToFile(InputStream input, File destFile)` 用于将流式数据写入文件的辅助方法
`static void`	`writeToFile(InputStream input, File destFile, boolean append)` 用于将流式数据写入文件的辅助方法

受保护的方法
`static boolean`	`chmodExists()` 用于确定系统操作系统上是否有“chmod”命令的内部帮助程序。
`static void`	`setChmodBinary(String chmodName)` 公开以供测试。

常量

FILESYSTEM_FILENAME_MAX_LENGTH

public static final int FILESYSTEM_FILENAME_MAX_LENGTH

常量值： 255 (0x000000ff)

公共构造函数

FileUtil

public FileUtil ()

公共方法

calculateBase64Md5

public static String calculateBase64Md5 (File file)

用于计算文件 base64 md5 的辅助方法。

返回
`String`	文件的 md5

calculateCrc32

public static long calculateCrc32 (File file)

用于计算文件 CRC-32 的辅助方法。

返回
`long`	文件的 CRC-32

抛出
	IOException

calculateMd5

public static String calculateMd5 (File file)

用于计算文件 md5 的辅助方法。

返回
`String`	文件的 md5

chmod

public static boolean chmod (File file, 
                String perms)

参数
`file`	`File`
`perms`	`String`

返回
`boolean`

chmodGroupRW

public static boolean chmodGroupRW (File file)

会尽最大努力使给定文件组可读写。

请注意，必须拥有执行权限才能访问目录。请参阅 chmodGroupRWX(File)。

如果底层操作系统不支持“chmod”系统命令，则将文件设为可供所有用户写入。

参数
`file`	`File`：用于使所有者和群组具有写入权限的 `ERROR(/File)`

返回
`boolean`	如果文件成功设为群组可写，则为 `true`；否则为 `false`

chmodGroupRWX

public static boolean chmodGroupRWX (File file)

会尽力使给定文件组可执行、可读取和可写入。

如果底层操作系统不支持“chmod”系统命令，则会尝试为所有用户设置权限。

参数
`file`	`File`：用于使所有者和群组具有写入权限的 `ERROR(/File)`

返回
`boolean`	如果成功设置权限，则为 `true`；否则，为 `false`

chmodRWXRecursively

public static boolean chmodRWXRecursively (File file)

参数
`file`	`File`

返回
`boolean`

closeZip

public static void closeZip (ZipFile zipFile)

此方法已废弃。
已移至 ZipUtil.closeZip(ZipFile)。

关闭打开的 ERROR(/ZipFile)，忽略所有异常。

参数
`zipFile`	`ZipFile`：要关闭的文件

collectJars

public static  collectJars (File dir)

返回在给定目录中找到的所有 jar 文件

参数
`dir`	`File`

返回

compareFileContents

public static boolean compareFileContents (File file1, 
                File file2)

用于对两个文件进行字节级内容比较的实用程序方法。

参数
`file1`	`File`
`file2`	`File`

返回
`boolean`	如果文件内容相同，则返回 `true`

convertSizeToBytes

public static long convertSizeToBytes (String sizeString)

convertToReadableSize(long) 的反函数。将 convertToReadableSize(long) 中所述的可读格式转换为字节值。

参数
`sizeString`	`String`：大小的字符串说明。

返回
`long`	大小（以字节为单位）

抛出
`IllegalArgumentException`	如果无法识别尺寸

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`：目标文件

抛出
	如果复制文件失败

createNamedTempDir

public static File createNamedTempDir (File parentDir, 
                String name)

用于在文件夹中创建命名目录的辅助函数。

此目录的名称不会随机生成。如果目录已存在，则会返回该目录。

参数
`parentDir`	`File`：要创建目录的目录。如果为 null，则在 /tmp 中
`name`	`String`：要在父文件夹中创建的目录的名称

返回
`File`	创建的目录

createNamedTempDir

public static File createNamedTempDir (String name)

用于在临时文件夹中创建命名目录的辅助函数。

此目录的名称不会随机生成。如果目录已存在，则会返回该目录。

参数
`name`	`String`：要在 tmp 文件夹中创建的目录的名称。

返回
`File`	创建的目录

createTempDir

public static File createTempDir (String prefix)

用于在系统默认临时文件目录中创建临时目录的辅助函数。

参数
`prefix`	`String`：用于生成文件名称的前缀字符串；必须至少包含 3 个字符

返回
`File`	创建的目录

抛出
	如果无法创建文件

createTempDir

public static File createTempDir (String prefix, 
                File parentDir)

用于创建临时目录的辅助函数。

参数
`prefix`	`String`：用于生成文件名称的前缀字符串；必须至少包含 3 个字符
`parentDir`	`File`：要创建目录的父级目录。如果为 `null`，则系统将使用默认的临时目录。

返回
`File`	创建的目录

抛出
	如果无法创建文件

createTempFile

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

围绕 ERROR(/File#createTempFile(String, String, File)) 的辅助封装容器函数，用于审核潜在的磁盘空间不足情况。

参数
`prefix`	`String`
`suffix`	`String`
`parentDir`	`File`

返回
`File`

抛出
`FileUtil.LowDiskSpaceException`	如果分区上的磁盘空间低于允许的最低值

另见：

ERROR(/File#createTempFile(String, String, File))

createTempFile

public static File createTempFile (String prefix, 
                String suffix)

围绕 ERROR(/File#createTempFile(String, String)) 的辅助封装容器函数，用于审核潜在的磁盘空间不足情况。

参数
`prefix`	`String`
`suffix`	`String`

返回
`File`

抛出
`FileUtil.LowDiskSpaceException`	如果临时分区上的磁盘空间低于允许的最低值

另见：

ERROR(/File#createTempFile(String, String))

createTempFileForRemote

public static File createTempFileForRemote (String remoteFilePath, 
                File parentDir)

辅助方法，用于在临时磁盘上构建唯一文件，其名称与远程文件路径给出的文件名称尽可能相符

参数
`remoteFilePath`	`String`：用于构建名称的以“/”分隔的远程路径
`parentDir`	`File`：用于创建文件的父目录。`null` 以使用默认临时目录

返回
`File`

createZip

public static File createZip (File dir)

此方法已废弃。
已移至 ZipUtil.createZip(File)。

用于创建包含给定目录及其所有内容的临时 ZIP 文件的实用程序方法。

参数
`dir`	`File`：要压缩的目录

返回
`File`	包含目录内容的临时 ZIP 文件 `ERROR(/File)`

抛出
	如果未能创建 ZIP 文件

createZip

public static void createZip (File dir, 
                File zipFile)

此方法已废弃。
已移至 ZipUtil.createZip(File, File)。

用于创建包含给定目录及其所有内容的 ZIP 文件的实用程序方法。

参数
`dir`	`File`：要压缩的目录
`zipFile`	`File`：要创建的 ZIP 文件 - 该文件不应已存在

抛出
	如果未能创建 ZIP 文件

deleteFile

public static void deleteFile (File file)

尝试删除文件。适用于在 finally 诗节中进行清理时使用。

参数
`file`	`File`：可以为 null。

ensureGroupRWX

public static boolean ensureGroupRWX (File file)

会尽最大努力确保给定文件组可执行、可读取和可写入。

如果底层操作系统不支持“chmod”系统命令，则会尝试为所有用户设置权限。该操作会同步执行，以防止因从缓存访问文件而引入竞态条件，例如GCSFileDownloader。

参数
`file`	`File`：用于使所有者和群组具有写入权限的 `ERROR(/File)`

返回
`boolean`	如果成功设置权限，则为 `true`；否则，为 `false`

extractFileFromZip

public static File extractFileFromZip (ZipFile zipFile, 
                String filePath)

此方法已废弃。
已移至 ZipUtil.extractFileFromZip(ZipFile, String)。

用于将特定文件从 ZIP 文件提取到临时文件的实用程序方法

参数
`zipFile`	`ZipFile`：要提取的 `ERROR(/ZipFile)`
`filePath`	`String`：要提取的文件路径

返回
`File`	`ERROR(/File)`，如果未找到则返回 null

抛出
	如果解压文件失败

extractZip

public static void extractZip (ZipFile zipFile, 
                File destDir)

此方法已废弃。
已移至 ZipUtil.extractZip(ZipFile, File)。

用于将 ZIP 文件的全部内容解压缩到给定目录的实用程序方法

参数
`zipFile`	`ZipFile`：要提取的 `ERROR(/ZipFile)`
`destDir`	`File`：要将文件解压到的本地目录

抛出
	如果解压文件失败

findDirectory

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

搜索并返回其他目录中的第一个目录 ERROR(/File)。

参数
`dirName`	`String`：我们要查找的目录名称。
`dirs`	`File`：要搜索的目录列表。

返回
`File`	包含找到的目录的 `ERROR(/File)`，如果未找到，则返回 null。

抛出
	IOException

findDirsUnder

public static  findDirsUnder (File rootDir, 
                File relativeParent)

以递归方式查找指定 rootDir 下的所有目录

参数
`rootDir`	`File`：要搜索的根目录
`relativeParent`	`File`：所有返回的 `ERROR(/File)` 的可选父级。如果未指定，则所有 `ERROR(/File)` 都将相对于 `rootDir`。

返回
	一组 `ERROR(/File)`，表示 `rootDir` 下的所有目录，包括 `rootDir` 本身。如果 `rootDir` 为 null，则返回空集。

findFile

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

获取给定目录中与给定过滤条件匹配的名称的文件的所有文件路径，并根据 abi（如果不为 null）过滤找到的文件。返回找到的第一个匹配文件。

参数
`fileName`	`String`：用于匹配文件路径的正则表达式的 `String`
`abi`	`IAbi`：与目标匹配的 ABI 的 `IAbi` 对象
`dirs`	`File`：要搜索文件的目录的 `ERROR(/File)` 对象的 varargs 数组

返回
`File`	`ERROR(/File)` 或 `null`（如果找不到）

findFile

public static File findFile (File dir, 
                String fileName)

递归搜索指定目录，查找具有指定名称的第一个文件

参数
`dir`	`File`：要搜索的目录
`fileName`	`String`：要搜索的文件的名称

返回
`File`	`ERROR(/File)` 或 `null`（如果找不到）

findFiles

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

获取给定目录中与给定过滤条件匹配的所有文件，并按 abi arch（如果 abi 不为 null）过滤找到的文件。

参数
`fileName`	`String`：用于匹配文件路径的正则表达式的 `String`
`abi`	`IAbi`：与目标匹配的 ABI 的 `IAbi` 对象
`includeDirectory`	`boolean`：是否在搜索结果中包含目录
`dirs`	`File`：要搜索文件的目录的 `ERROR(/File)` 对象数组

返回
	一组 `ERROR(/File)`；如果找不到，则为空

findFiles

public static  findFiles (File dir, 
                String filter)

获取给定目录中与给定过滤条件匹配的名称的文件的所有文件路径

参数
`dir`	`File`：要递归搜索文件的目录的 `ERROR(/File)` 对象
`filter`	`String`：用于匹配文件名的正则表达式的 `String`

返回
	一组文件路径的 `String`

findFilesObject

public static  findFilesObject (File dir, 
                String filter)

获取给定目录中与给定过滤条件匹配的名称的文件的所有文件路径

参数
`dir`	`File`：要递归搜索文件的目录的 `ERROR(/File)` 对象
`filter`	`String`：用于匹配文件名的正则表达式的 `String`

返回
	一组文件对象的 `ERROR(/File)`。@请参阅 `findFiles(File, String)`

findFilesObject

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

获取给定目录中与给定过滤条件匹配的名称的文件的所有文件路径

参数
`dir`	`File`：要递归搜索文件的目录的 `ERROR(/File)` 对象
`filter`	`String`：用于匹配文件名的正则表达式的 `String`
`includeDirectory`	`boolean`：是否在搜索结果中包含目录

返回
	一组文件对象的 `ERROR(/File)`。@请参阅 `findFiles(File, String)`

getBaseName

public static String getBaseName (String fileName)

获取给定文件名的不带扩展名的文件名。

例如，getBaseName("file.txt") 将返回“file”

返回
`String`	基准名称

getContentType

public static String getContentType (String filePath)

根据文件扩展名获取文件的内容类型。

参数
`filePath`	`String`：文件路径

返回
`String`	内容类型

getExtension

public static String getExtension (String fileName)

获取给定文件名的扩展名。

返回
`String`	扩展名，如果文件没有扩展名，则为空字符串

getFileForPath

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

用于构建系统依赖文件的辅助方法

参数
`parentDir`	`File`：要使用的父级目录。
`pathSegments`	`String`：要使用的相对路径细分

返回
`File`	表示给定路径的 `ERROR(/File)`，每个 `pathSegment` 之间由 `ERROR(/File#separatorChar)` 分隔

getPath

public static String getPath (String... pathSegments)

用于构建系统相关相对路径的辅助方法

参数
`pathSegments`	`String`：要使用的相对路径细分

返回
`String`	表示给定路径的 `String`，每个 `pathSegment` 之间由 `ERROR(/File#separatorChar)` 分隔

gzipFile

public static void gzipFile (File file, 
                File gzipFile)

此方法已废弃。
已移至 ZipUtil.gzipFile(File, File)。

用于创建单个文件的 GZIP 版本的辅助方法。

参数
`file`	`File`：原始文件
`gzipFile`	`File`：要将压缩内容放入其中的文件

抛出
	IOException

hardlinkFile

public static void hardlinkFile (File origFile, 
                File destFile)

用于将文件硬链接到另一个文件的辅助方法。在发生跨分区关联时回退到复制。

参数
`origFile`	`File`：原始文件
`destFile`	`File`：目标文件

抛出
	如果无法硬链接文件

hardlinkFile

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

用于将文件硬链接到另一个文件的辅助方法。在发生跨分区关联时回退到复制。

参数
`origFile`	`File`：原始文件
`destFile`	`File`：目标文件
`ignoreExistingFile`	`boolean`：如果为 True 且要关联的文件已存在，则跳过异常。

抛出
	如果无法硬链接文件

isDiskSpaceError

public static boolean isDiskSpaceError (String message)

如果消息是磁盘空间错误，则返回 true。

参数
`message`	`String`

返回
`boolean`

mkdirsRWX

public static boolean mkdirsRWX (File file)

用于通过调用 chmodGroupRWX(File) 创建目录链，并在创建时将所有目录都设置为可执行/可读/可写的组。本质上是同时运行 chmod(File, String) 的 ERROR(/File#mkdirs()) 版本。

参数
`file`	`File`：要创建的目录的名称，可能包含尚不存在的目录。

返回
`boolean`	如果 `file` 存在且为目录，则为 `true`；否则为 `false`。

readStringFromFile

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

用于从文件中读取部分字符串数据的辅助方法

参数
`sourceFile`	`File`：要读取的文件
`startOffset`	`long`：从文件读取的起始偏移量。
`length`	`long`：要读取的文件字节数。

返回
`String`

抛出
	IOException
	FileNotFoundException

readStringFromFile

public static String readStringFromFile (File sourceFile)

用于从文件读取字符串数据的辅助方法

参数
`sourceFile`	`File`：要读取的文件

返回
`String`

抛出
	IOException
	FileNotFoundException

recursiveCopy

public static void recursiveCopy (File sourceDir, 
                File destDir)

递归复制文件夹内容。

仅支持复制文件和目录，不支持复制符号链接。如果目标目录不存在，系统将会创建该目录。

参数
`sourceDir`	`File`：包含要复制的文件的文件夹
`destDir`	`File`：目标文件夹

抛出
	IOException

recursiveDelete

public static void recursiveDelete (File rootDir)

以递归方式删除指定文件或目录及其所有内容。

参数
`rootDir`	`File`：要删除的目录或文件；可以为 null

recursiveHardlink

public static void recursiveHardlink (File sourceDir, 
                File destDir)

以递归方式硬链接文件夹内容。

仅支持复制文件和目录，不支持复制符号链接。如果目标目录不存在，系统将会创建该目录。

参数
`sourceDir`	`File`：包含要复制的文件的文件夹
`destDir`	`File`：目标文件夹

抛出
	IOException

recursiveHardlink

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

以递归方式硬链接文件夹内容。

仅支持复制文件和目录，不支持复制符号链接。如果目标目录不存在，系统将会创建该目录。

参数
`sourceDir`	`File`：包含要复制的文件的文件夹
`destDir`	`File`：目标文件夹
`ignoreExistingFile`	`boolean`：如果为 True 且要关联的文件已存在，则跳过异常。

抛出
	IOException

recursiveSymlink

public static void recursiveSymlink (File sourceDir, 
                File destDir)

以递归方式符号链接文件夹内容。

仅支持复制文件和目录，不支持复制符号链接。如果目标目录不存在，系统将会创建该目录。

参数
`sourceDir`	`File`：包含要复制的文件的文件夹
`destDir`	`File`：目标文件夹

抛出
	IOException

saveResourceFile

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

将资源文件保存到目录中。

参数
`resourceStream`	`InputStream`：指向要保存的资源的 {link InputStream} 对象。
`destDir`	`File`：要将资源文件保存到的目录的 `ERROR(/File)` 对象。
`targetFileName`	`String`：用于指定要保存到的文件名称的 `String`。

返回
`File`	已保存文件的 `ERROR(/File)` 对象。

抛出
	文件未能保存。

setReadableRecursive

public static void setReadableRecursive (File file)

递归设置给定文件的读取和执行（如果是文件夹）权限。

参数
`file`	`File`

sizeOfDirectory

public static Long sizeOfDirectory (File directory)

返回目录报告的大小。

参数
`directory`	`File`

返回
`Long`

symlinkFile

public static void symlinkFile (File origFile, 
                File destFile)

用于将文件符号链接到另一个文件的辅助方法

参数
`origFile`	`File`：原始文件
`destFile`	`File`：目标文件

抛出
	如果无法创建符号链接文件

unixModeToPosix

public static  unixModeToPosix (int mode)

将表示 Unix 模式的整数转换为一组 ERROR(/PosixFilePermission)

参数
`mode`	`int`

返回

writeToFile

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

用于将字符串数据写入或附加到文件的辅助方法

参数
`inputString`	`String`：输入 `String`
`destFile`	`File`：要写入或附加到的目标文件
`append`	`boolean`：如果为 true，则附加到文件末尾；否则，覆盖

writeToFile

public static void writeToFile (String inputString, 
                File destFile)

用于将字符串数据写入文件的辅助方法

参数
`inputString`	`String`：输入 `String`
`destFile`	`File`：要写入到的目标文件

writeToFile

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

用于将流式数据写入文件的辅助方法

参数
`input`	`InputStream`：未缓冲的输入流
`destFile`	`File`：要写入或附加到的目标文件
`append`	`boolean`：如果为 true，则附加到文件末尾；否则，覆盖
`startOffset`	`long`：要检索数据的输入流的起始偏移量
`size`	`long`：要从输入流检索的字节数，将其设置为负值可检索从给定偏移量开始的所有内容。

writeToFile

public static void writeToFile (InputStream input, 
                File destFile)

用于将流式数据写入文件的辅助方法

参数
`input`	`InputStream`：未缓冲的输入流
`destFile`	`File`：要写入到的目标文件

writeToFile

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

用于将流式数据写入文件的辅助方法

参数
`input`	`InputStream`：未缓冲的输入流
`destFile`	`File`：要写入或附加到的目标文件
`append`	`boolean`：如果为 true，则附加到文件末尾；否则，覆盖

受保护的方法

chmodExists

protected static boolean chmodExists ()

用于确定系统操作系统上是否有“chmod”命令的内部帮助程序。

返回
`boolean`

setChmodBinary

protected static void setChmodBinary (String chmodName)

公开以供测试。允许修改我们要查找的 chmod 二进制名称，以便测试不支持 chmod 的系统。

参数
`chmodName`	`String`

FileUtil

摘要

嵌套类

常量

公共构造函数

公共方法

受保护的方法

常量

FILESYSTEM_FILENAME_MAX_LENGTH

公共构造函数

FileUtil

公共方法

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

受保护的方法

chmodExists

setChmodBinary