All Downloads are FREE. Search and download functionalities are using the official Maven repository.

com.xiaoleilu.hutool.io.FileUtil Maven / Gradle / Ivy

There is a newer version: 3.3.2
Show newest version
package com.xiaoleilu.hutool.io;

import java.io.BufferedInputStream;
import java.io.BufferedOutputStream;
import java.io.BufferedReader;
import java.io.BufferedWriter;
import java.io.File;
import java.io.FileFilter;
import java.io.FileInputStream;
import java.io.FileOutputStream;
import java.io.IOException;
import java.io.InputStream;
import java.io.OutputStream;
import java.io.PrintWriter;
import java.net.URI;
import java.net.URL;
import java.nio.charset.Charset;
import java.nio.file.CopyOption;
import java.nio.file.DirectoryStream;
import java.nio.file.Files;
import java.nio.file.LinkOption;
import java.nio.file.Path;
import java.nio.file.Paths;
import java.nio.file.StandardCopyOption;
import java.nio.file.attribute.BasicFileAttributes;
import java.text.DecimalFormat;
import java.util.ArrayList;
import java.util.Collection;
import java.util.Collections;
import java.util.Date;
import java.util.LinkedList;
import java.util.List;
import java.util.jar.JarEntry;
import java.util.jar.JarFile;

import com.xiaoleilu.hutool.io.file.FileCopier;
import com.xiaoleilu.hutool.io.file.FileReader;
import com.xiaoleilu.hutool.io.file.FileReader.ReaderHandler;
import com.xiaoleilu.hutool.io.file.FileWriter;
import com.xiaoleilu.hutool.io.file.LineSeparator;
import com.xiaoleilu.hutool.lang.Assert;
import com.xiaoleilu.hutool.util.ArrayUtil;
import com.xiaoleilu.hutool.util.CharsetUtil;
import com.xiaoleilu.hutool.util.ClassUtil;
import com.xiaoleilu.hutool.util.CollectionUtil;
import com.xiaoleilu.hutool.util.StrUtil;
import com.xiaoleilu.hutool.util.URLUtil;

/**
 * 文件工具类
 * 
 * @author xiaoleilu
 *
 */
public final class FileUtil {

	private FileUtil() {
	}

	/** The Unix separator character. */
	private static final char UNIX_SEPARATOR = '/';
	/** The Windows separator character. */
	private static final char WINDOWS_SEPARATOR = '\\';

	/** Class文件扩展名 */
	public static final String CLASS_EXT = ".class";
	/** Jar文件扩展名 */
	public static final String JAR_FILE_EXT = ".jar";
	/** 在Jar中的路径jar的扩展名形式 */
	public static final String JAR_PATH_EXT = ".jar!";
	/** 当Path为文件形式时, path会加入一个表示文件的前缀 */
	public static final String PATH_FILE_PRE = URLUtil.FILE_URL_PREFIX;

	/**
	 * 是否为Windows环境
	 * 
	 * @return 是否为Windows环境
	 * @since 3.0.9
	 */
	public static boolean isWindows() {
		return '\\' == File.separatorChar;
	}

	/**
	 * 列出目录文件
* 给定的绝对路径不能是压缩包中的路径 * * @param path 目录绝对路径或者相对路径 * @return 文件列表(包含目录) */ public static File[] ls(String path) { if (path == null) { return null; } path = getAbsolutePath(path); File file = file(path); if (file.isDirectory()) { return file.listFiles(); } throw new IORuntimeException(StrUtil.format("Path [{}] is not directory!", path)); } /** * 文件是否为空
* 目录:里面没有文件时为空 文件:文件大小为0时为空 * * @param file 文件 * @return 是否为空,当提供非目录时,返回false */ public static boolean isEmpty(File file) { if (null == file) { return true; } if (file.isDirectory()) { String[] subFiles = file.list(); if (ArrayUtil.isEmpty(subFiles)) { return true; } } else if (file.isFile()) { return file.length() <= 0; } return false; } /** * 目录是否为空 * * @param file 目录 * @return 是否为空,当提供非目录时,返回false */ public static boolean isNotEmpty(File file) { return false == isEmpty(file); } /** * 目录是否为空 * * @param dirPath 目录 * @return 是否为空 * @exception IORuntimeException IOException */ public static boolean isDirEmpty(Path dirPath) { try (DirectoryStream dirStream = Files.newDirectoryStream(dirPath)) { return false == dirStream.iterator().hasNext(); } catch (IOException e) { throw new IORuntimeException(e); } } /** * 目录是否为空 * * @param dir 目录 * @return 是否为空 */ public static boolean isDirEmpty(File dir) { return isDirEmpty(dir.toPath()); } /** * 递归遍历目录以及子目录中的所有文件
* 如果提供file为文件,直接返回过滤结果 * * @param file 当前遍历文件或目录 * @param fileFilter 文件过滤规则对象,选择要保留的文件,只对文件有效,不过滤目录 * @return 文件列表 */ public static List loopFiles(File file, FileFilter fileFilter) { List fileList = new ArrayList(); if (null == file) { return fileList; } else if (false == file.exists()) { return fileList; } if (file.isDirectory()) { for (File tmp : file.listFiles()) { fileList.addAll(loopFiles(tmp, fileFilter)); } } else { if (null == fileFilter || fileFilter.accept(file)) { fileList.add(file); } } return fileList; } /** * 递归遍历目录以及子目录中的所有文件 * * @param file 当前遍历文件 * @return 文件列表 */ public static List loopFiles(File file) { return loopFiles(file, null); } /** * 获得指定目录下所有文件
* 不会扫描子目录 * * @param path 相对ClassPath的目录或者绝对路径目录 * @return 文件路径列表(如果是jar中的文件,则给定类似.jar!/xxx/xxx的路径) * @throws IORuntimeException IO异常 */ public static List listFileNames(String path) throws IORuntimeException { if (path == null) { return null; } path = getAbsolutePath(path); if (false == path.endsWith(String.valueOf(UNIX_SEPARATOR))) { path = path + UNIX_SEPARATOR; } List paths = new ArrayList(); int index = path.lastIndexOf(FileUtil.JAR_PATH_EXT); if (index == -1) { // 普通目录路径 File[] files = ls(path); for (File file : files) { if (file.isFile()) { paths.add(file.getName()); } } } else { // jar文件中的路径 index = index + FileUtil.JAR_FILE_EXT.length(); JarFile jarFile = null; try { jarFile = new JarFile(path.substring(0, index)); final String subPath = path.substring(index + 2); for (JarEntry entry : Collections.list(jarFile.entries())) { final String name = entry.getName(); if (name.startsWith(subPath)) { final String nameSuffix = StrUtil.removePrefix(name, subPath); if (nameSuffix.contains(String.valueOf(UNIX_SEPARATOR)) == false) { paths.add(nameSuffix); } } } } catch (IOException e) { throw new IORuntimeException(StrUtil.format("Can not read file path of [{}]", path), e); } finally { IoUtil.close(jarFile); } } return paths; } /** * 创建File对象,自动识别相对或绝对路径,相对路径将自动从ClassPath下寻找 * * @param path 文件路径 * @return File */ public static File file(String path) { if (StrUtil.isBlank(path)) { throw new NullPointerException("File path is blank!"); } return new File(getAbsolutePath(path)); } /** * 创建File对象 * * @param parent 父目录 * @param path 文件路径 * @return File */ public static File file(String parent, String path) { if (StrUtil.isBlank(path)) { throw new NullPointerException("File path is blank!"); } return new File(parent, path); } /** * 创建File对象 * * @param parent 父文件对象 * @param path 文件路径 * @return File */ public static File file(File parent, String path) { if (StrUtil.isBlank(path)) { throw new NullPointerException("File path is blank!"); } return new File(parent, path); } /** * 创建File对象 * * @param uri 文件URI * @return File */ public static File file(URI uri) { if (uri == null) { throw new NullPointerException("File uri is null!"); } return new File(uri); } /** * 创建File对象 * * @param url 文件URL * @return File */ public static File file(URL url) { return new File(URLUtil.toURI(url)); } /** * 判断文件是否存在,如果path为null,则返回false * * @param path 文件路径 * @return 如果存在返回true */ public static boolean exist(String path) { return (path == null) ? false : file(path).exists(); } /** * 判断文件是否存在,如果file为null,则返回false * * @param file 文件 * @return 如果存在返回true */ public static boolean exist(File file) { return (file == null) ? false : file.exists(); } /** * 是否存在匹配文件 * * @param directory 文件夹路径 * @param regexp 文件夹中所包含文件名的正则表达式 * @return 如果存在匹配文件返回true */ public static boolean exist(String directory, String regexp) { File file = new File(directory); if (!file.exists()) { return false; } String[] fileList = file.list(); if (fileList == null) { return false; } for (String fileName : fileList) { if (fileName.matches(regexp)) { return true; } } return false; } /** * 指定文件最后修改时间 * * @param file 文件 * @return 最后修改时间 */ public static Date lastModifiedTime(File file) { if (!exist(file)) { return null; } return new Date(file.lastModified()); } /** * 指定路径文件最后修改时间 * * @param path 绝对路径 * @return 最后修改时间 */ public static Date lastModifiedTime(String path) { return lastModifiedTime(new File(path)); } /** * 计算目录或文件的总大小
* 当给定对象为文件时,直接调用 {@link File#length()}
* 当给定对象为目录时,遍历目录下的所有文件和目录,递归计算其大小,求和返回 * * @param file 目录或文件 * @return 总大小,bytes长度 */ public static long size(File file) { Assert.notNull(file, "file argument is null !"); if (false == file.exists()) { throw new IllegalArgumentException(StrUtil.format("File [{}] not exist !", file.getAbsolutePath())); } if (file.isDirectory()) { long size = 0L; File[] subFiles = file.listFiles(); if (ArrayUtil.isEmpty(subFiles)) { return 0L;// empty directory } for (int i = 0; i < subFiles.length; i++) { size += size(subFiles[i]); } return size; } else { return file.length(); } } /** * 给定文件或目录的最后修改时间是否晚于给定时间 * * @param file 文件或目录 * @param reference 参照文件 * @return 是否晚于给定时间 */ public static boolean newerThan(File file, File reference) { if (null == file || false == reference.exists()) { return true;// 文件一定比一个不存在的文件新 } return newerThan(file, reference.lastModified()); } /** * 给定文件或目录的最后修改时间是否晚于给定时间 * * @param file 文件或目录 * @param timeMillis 做为对比的时间 * @return 是否晚于给定时间 */ public static boolean newerThan(File file, long timeMillis) { if (null == file || false == file.exists()) { return false;// 不存在的文件一定比任何时间旧 } return file.lastModified() > timeMillis; } /** * 创建文件及其父目录,如果这个文件存在,直接返回这个文件
* 此方法不对File对象类型做判断,如果File不存在,无法判断其类型 * * @param fullFilePath 文件的全路径,使用POSIX风格 * @return 文件,若路径为null,返回null * @throws IORuntimeException IO异常 */ public static File touch(String fullFilePath) throws IORuntimeException { if (fullFilePath == null) { return null; } return touch(file(fullFilePath)); } /** * 创建文件及其父目录,如果这个文件存在,直接返回这个文件
* 此方法不对File对象类型做判断,如果File不存在,无法判断其类型 * * @param file 文件对象 * @return 文件,若路径为null,返回null * @throws IORuntimeException IO异常 */ public static File touch(File file) throws IORuntimeException { if (null == file) { return null; } if (false == file.exists()) { mkParentDirs(file); try { file.createNewFile(); } catch (Exception e) { throw new IORuntimeException(e); } } return file; } /** * 创建文件及其父目录,如果这个文件存在,直接返回这个文件
* 此方法不对File对象类型做判断,如果File不存在,无法判断其类型 * * @param parent 父文件对象 * @param path 文件路径 * @return File * @throws IORuntimeException IO异常 */ public static File touch(File parent, String path) throws IORuntimeException { return touch(file(parent, path)); } /** * 创建文件及其父目录,如果这个文件存在,直接返回这个文件
* 此方法不对File对象类型做判断,如果File不存在,无法判断其类型 * * @param parent 父文件对象 * @param path 文件路径 * @return File * @throws IORuntimeException IO异常 */ public static File touch(String parent, String path) throws IORuntimeException { return touch(file(parent, path)); } /** * 创建所给文件或目录的父目录 * * @param file 文件或目录 * @return 父目录 */ public static File mkParentDirs(File file) { final File parentFile = file.getParentFile(); if (null != parentFile && false == parentFile.exists()) { parentFile.mkdirs(); } return parentFile; } /** * 创建父文件夹,如果存在直接返回此文件夹 * * @param path 文件夹路径,使用POSIX格式,无论哪个平台 * @return 创建的目录 */ public static File mkParentDirs(String path) { if (path == null) { return null; } return mkParentDirs(file(path)); } /** * 删除文件或者文件夹
* 路径如果为相对路径,会转换为ClassPath路径! 注意:删除文件夹时不会判断文件夹是否为空,如果不空则递归删除子文件或文件夹
* 某个文件删除失败会终止删除操作 * * @param fullFileOrDirPath 文件或者目录的路径 * @return 成功与否 * @throws IORuntimeException IO异常 */ public static boolean del(String fullFileOrDirPath) throws IORuntimeException { return del(file(fullFileOrDirPath)); } /** * 删除文件或者文件夹
* 注意:删除文件夹时不会判断文件夹是否为空,如果不空则递归删除子文件或文件夹
* 某个文件删除失败会终止删除操作 * * @param file 文件对象 * @return 成功与否 * @throws IORuntimeException IO异常 */ public static boolean del(File file) throws IORuntimeException { if (file == null || false == file.exists()) { return false; } if (file.isDirectory()) { clean(file); } try { Files.delete(file.toPath()); } catch (IOException e) { throw new IORuntimeException(e); } return true; } /** * 清空文件夹
* 注意:清空文件夹时不会判断文件夹是否为空,如果不空则递归删除子文件或文件夹
* 某个文件删除失败会终止删除操作 * * @param directory 文件夹 * @return 成功与否 * @throws IORuntimeException IO异常 * @since 3.0.6 */ public static boolean clean(File directory) throws IORuntimeException { if (directory == null || directory.exists() == false || false == directory.isDirectory()) { return true; } final File[] files = directory.listFiles(); for (File childFile : files) { boolean isOk = del(childFile); if (isOk == false) { // 删除一个出错则本次删除任务失败 return false; } } return true; } /** * 创建文件夹,如果存在直接返回此文件夹
* 此方法不对File对象类型做判断,如果File不存在,无法判断其类型 * * @param dirPath 文件夹路径,使用POSIX格式,无论哪个平台 * @return 创建的目录 */ public static File mkdir(String dirPath) { if (dirPath == null) { return null; } final File dir = file(dirPath); return mkdir(dir); } /** * 创建文件夹,会递归自动创建其不存在的父文件夹,如果存在直接返回此文件夹
* 此方法不对File对象类型做判断,如果File不存在,无法判断其类型 * * @param dir 目录 * @return 创建的目录 */ public static File mkdir(File dir) { if (dir == null) { return null; } if (false == dir.exists()) { dir.mkdirs(); } return dir; } /** * 创建临时文件
* 创建后的文件名为 prefix[Randon].tmp * * @param dir 临时文件创建的所在目录 * @return 临时文件 * @throws IORuntimeException IO异常 */ public static File createTempFile(File dir) throws IORuntimeException { return createTempFile("hutool", null, dir, true); } /** * 创建临时文件
* 创建后的文件名为 prefix[Randon].tmp * * @param dir 临时文件创建的所在目录 * @param isReCreat 是否重新创建文件(删掉原来的,创建新的) * @return 临时文件 * @throws IORuntimeException IO异常 */ public static File createTempFile(File dir, boolean isReCreat) throws IORuntimeException { return createTempFile("hutool", null, dir, isReCreat); } /** * 创建临时文件
* 创建后的文件名为 prefix[Randon].suffix From com.jodd.io.FileUtil * * @param prefix 前缀,至少3个字符 * @param suffix 后缀,如果null则使用默认.tmp * @param dir 临时文件创建的所在目录 * @param isReCreat 是否重新创建文件(删掉原来的,创建新的) * @return 临时文件 * @throws IORuntimeException IO异常 */ public static File createTempFile(String prefix, String suffix, File dir, boolean isReCreat) throws IORuntimeException { int exceptionsCount = 0; while (true) { try { File file = File.createTempFile(prefix, suffix, dir).getCanonicalFile(); if (isReCreat) { file.delete(); file.createNewFile(); } return file; } catch (IOException ioex) { // fixes java.io.WinNTFileSystem.createFileExclusively access denied if (++exceptionsCount >= 50) { throw new IORuntimeException(ioex); } } } } /** * 通过JDK7+的 {@link Files#copy(Path, Path, CopyOption...)} 方法拷贝文件 * * @param src 源文件路径 * @param dest 目标文件或目录路径,如果为目录使用与源文件相同的文件名 * @param options {@link StandardCopyOption} * @return File * @throws IORuntimeException IO异常 */ public static File copyFile(String src, String dest, StandardCopyOption... options) throws IORuntimeException { Assert.notBlank(src, "Source File path is blank !"); Assert.notNull(src, "Destination File path is null !"); return copyFile(Paths.get(src), Paths.get(dest), options).toFile(); } /** * 通过JDK7+的 {@link Files#copy(Path, Path, CopyOption...)} 方法拷贝文件 * * @param src 源文件 * @param dest 目标文件或目录,如果为目录使用与源文件相同的文件名 * @param options {@link StandardCopyOption} * @return 目标文件 * @throws IORuntimeException IO异常 */ public static File copyFile(File src, File dest, StandardCopyOption... options) throws IORuntimeException { // check Assert.notNull(src, "Source File is null !"); if (false == src.exists()) { throw new IORuntimeException("File not exist: " + src); } Assert.notNull(dest, "Destination File or directiory is null !"); if (equals(src, dest)) { throw new IORuntimeException("Files '{}' and '{}' are equal", src, dest); } return copyFile(src.toPath(), dest.toPath(), options).toFile(); } /** * 通过JDK7+的 {@link Files#copy(Path, Path, CopyOption...)} 方法拷贝文件 * * @param src 源文件路径 * @param dest 目标文件或目录,如果为目录使用与源文件相同的文件名 * @param options {@link StandardCopyOption} * @return Path * @throws IORuntimeException IO异常 */ public static Path copyFile(Path src, Path dest, StandardCopyOption... options) throws IORuntimeException { Assert.notNull(src, "Source File is null !"); Assert.notNull(dest, "Destination File or directiory is null !"); Path destPath = dest.toFile().isDirectory() ? dest.resolve(src.getFileName()) : dest; try { return Files.copy(src, destPath, options); } catch (IOException e) { throw new IORuntimeException(e); } } /** * 复制文件或目录
* 如果目标文件为目录,则将源文件以相同文件名拷贝到目标目录 * * @param srcPath 源文件或目录 * @param destPath 目标文件或目录,目标不存在会自动创建(目录、文件都创建) * @param isOverride 是否覆盖目标文件 * @return 目标目录或文件 * @throws IORuntimeException IO异常 */ public static File copy(String srcPath, String destPath, boolean isOverride) throws IORuntimeException { return copy(file(srcPath), file(destPath), isOverride); } /** * 复制文件或目录
* 情况如下: * *
	 * 1、src和dest都为目录,则将src目录及其目录下所有文件目录拷贝到dest下
	 * 2、src和dest都为文件,直接复制,名字为dest
	 * 3、src为文件,dest为目录,将src拷贝到dest目录下
	 * 
* * @param src 源文件 * @param dest 目标文件或目录,目标不存在会自动创建(目录、文件都创建) * @param isOverride 是否覆盖目标文件 * @return 目标目录或文件 * @throws IORuntimeException IO异常 */ public static File copy(File src, File dest, boolean isOverride) throws IORuntimeException { return FileCopier.create(src, dest).setOverride(isOverride).copy(); } /** * 复制文件或目录
* 情况如下: * *
	 * 1、src和dest都为目录,则讲src下所有文件目录拷贝到dest下
	 * 2、src和dest都为文件,直接复制,名字为dest
	 * 3、src为文件,dest为目录,将src拷贝到dest目录下
	 * 
* * @param src 源文件 * @param dest 目标文件或目录,目标不存在会自动创建(目录、文件都创建) * @param isOverride 是否覆盖目标文件 * @return 目标目录或文件 * @throws IORuntimeException IO异常 */ public static File copyContent(File src, File dest, boolean isOverride) { return FileCopier.create(src, dest).setCopyContentIfDir(true).setOverride(isOverride).copy(); } /** * 移动文件或者目录 * * @param src 源文件或者目录 * @param dest 目标文件或者目录 * @param isOverride 是否覆盖目标,只有目标为文件才覆盖 * @throws IORuntimeException IO异常 */ public static void move(File src, File dest, boolean isOverride) throws IORuntimeException { // check if (false == src.exists()) { throw new IORuntimeException("File not found: " + src); } // 来源为文件夹,目标为文件 if (src.isDirectory() && dest.isFile()) { throw new IORuntimeException(StrUtil.format("Can not move directory [{}] to file [{}]", src, dest)); } if (isOverride && dest.isFile()) {// 只有目标为文件的情况下覆盖之 dest.delete(); } // 来源为文件,目标为文件夹 if (src.isFile() && dest.isDirectory()) { dest = new File(dest, src.getName()); } if (false == src.renameTo(dest)) { // 在文件系统不同的情况下,renameTo会失败,此时使用copy,然后删除原文件 try { copy(src, dest, isOverride); src.delete(); } catch (Exception e) { throw new IORuntimeException(StrUtil.format("Move [{}] to [{}] failed!", src, dest), e); } } } /** * 修改文件或目录的文件名,不变更路径,只是简单修改文件名
* 重命名有两种模式:
* 1、isRetainExt为true时,保留原扩展名: * *
	 * FileUtil.rename(file, "aaa", true) xx/xx.png =》xx/aaa.png
	 * 
* * 2、isRetainExt为false时,不保留原扩展名,需要在newName中 * *
	 * FileUtil.rename(file, "aaa.jpg", false) xx/xx.png =》xx/aaa.jpg
	 * 
* * @param file 被修改的文件 * @param newName 新的文件名,包括扩展名 * @param isRetainExt 是否保留原文件的扩展名,如果保留,则newName不需要加扩展名 * @param isOverride 是否覆盖目标文件 * @return 目标文件 * @since 3.0.9 */ public static File rename(File file, String newName, boolean isRetainExt, boolean isOverride) { if (isRetainExt) { newName = newName.concat(".").concat(FileUtil.extName(file)); } final Path path = file.toPath(); final CopyOption[] options = isOverride ? new CopyOption[] { StandardCopyOption.REPLACE_EXISTING } : new CopyOption[] {}; try { return Files.move(path, path.resolveSibling(newName), options).toFile(); } catch (IOException e) { throw new IORuntimeException(e); } } /** * 获取绝对路径
* 此方法不会判定给定路径是否有效(文件或目录存在) * * @param path 相对路径 * @param baseClass 相对路径所相对的类 * @return 绝对路径 */ public static String getAbsolutePath(String path, Class baseClass) { if (path == null) { path = StrUtil.EMPTY; } else { path = normalize(path); if (StrUtil.C_SLASH == path.charAt(0) || path.matches("^[a-zA-Z]:/.*")) { // 给定的路径已经是绝对路径了 return path; } } // 兼容Spring风格的ClassPath路径,去除前缀,不区分大小写 path = StrUtil.removePrefixIgnoreCase(path, "classpath:"); path = StrUtil.removePrefix(path, StrUtil.SLASH); // 相对于ClassPath路径 final URL url = ClassUtil.getResourceUrl(path, baseClass); if (null != url) { // since 3.0.8 解决中文或空格路径被编码的问题 return URLUtil.getDecodedPath(url); } else { // 如果资源不存在,则返回一个拼接的资源绝对路径 final String classPath = ClassUtil.getClassPath(); if (null == classPath) { throw new NullPointerException("ClassPath is null !"); } return classPath.concat(path); } } /** * 获取绝对路径,相对于ClassPath的目录
* 如果给定就是绝对路径,则返回原路径,原路径把所有\替换为/
* 兼容Spring风格的路径表示,例如:classpath:config/example.setting也会被识别后转换 * * @param path 相对路径 * @return 绝对路径 */ public static String getAbsolutePath(String path) { return getAbsolutePath(path, null); } /** * 获取标准的绝对路径 * * @param file 文件 * @return 绝对路径 */ public static String getAbsolutePath(File file) { if (file == null) { return null; } try { return file.getCanonicalPath(); } catch (IOException e) { return file.getAbsolutePath(); } } /** * 给定路径已经是绝对路径
* 此方法并没有针对路径做标准化,建议先执行{@link #normalize(String)}方法标准化路径后判断 * * @param path 需要检查的Path * @return 是否已经是绝对路径 */ public static boolean isAbsolutePath(String path) { if (StrUtil.C_SLASH == path.charAt(0) || path.matches("^[a-zA-Z]:/.*")) { // 给定的路径已经是绝对路径了 return true; } return false; } /** * 判断是否为目录,如果path为null,则返回false * * @param path 文件路径 * @return 如果为目录true */ public static boolean isDirectory(String path) { return (path == null) ? false : file(path).isDirectory(); } /** * 判断是否为目录,如果file为null,则返回false * * @param file 文件 * @return 如果为目录true */ public static boolean isDirectory(File file) { return (file == null) ? false : file.isDirectory(); } /** * 判断是否为目录,如果file为null,则返回false * * @param path {@link Path} * @param isFollowLinks 是否追踪到软链对应的真实地址 * @return 如果为目录true * @since 3.1.0 */ public static boolean isDirectory(Path path, boolean isFollowLinks) { if (null == path) { return false; } final LinkOption[] options = isFollowLinks ? new LinkOption[0] : new LinkOption[] { LinkOption.NOFOLLOW_LINKS }; return Files.isDirectory(path, options); } /** * 判断是否为文件,如果path为null,则返回false * * @param path 文件路径 * @return 如果为文件true */ public static boolean isFile(String path) { return (path == null) ? false : file(path).isFile(); } /** * 判断是否为文件,如果file为null,则返回false * * @param file 文件 * @return 如果为文件true */ public static boolean isFile(File file) { return (file == null) ? false : file.isFile(); } /** * 判断是否为文件,如果file为null,则返回false * * @param path 文件 * @return 如果为文件true */ public static boolean isFile(Path path, boolean isFollowLinks) { if (null == path) { return false; } final LinkOption[] options = isFollowLinks ? new LinkOption[0] : new LinkOption[] { LinkOption.NOFOLLOW_LINKS }; return Files.isRegularFile(path, options); } /** * 检查两个文件是否是同一个文件
* 所谓文件相同,是指File对象是否指向同一个文件或文件夹 * * @param file1 文件1 * @param file2 文件2 * @return 是否相同 * @throws IORuntimeException IO异常 * @see Files#isSameFile(Path, Path) */ public static boolean equals(File file1, File file2) throws IORuntimeException { Assert.notNull(file1); Assert.notNull(file2); if (false == file1.exists() || false == file2.exists()) { // 两个文件都不存在判断其路径是否相同 if (false == file1.exists() && false == file2.exists() && pathEquals(file1, file2)) { return true; } // 对于一个存在一个不存在的情况,一定不相同 return false; } try { return Files.isSameFile(file1.toPath(), file2.toPath()); } catch (IOException e) { throw new IORuntimeException(e); } } /** * 文件路径是否相同
* 取两个文件的绝对路径比较,在Windows下忽略大小写,在Linux下不忽略。 * * @param file1 文件1 * @param file2 文件2 * @return 文件路径是否相同 * @since 3.0.9 */ public static boolean pathEquals(File file1, File file2) { if (isWindows()) { // Windows环境 try { if (StrUtil.equalsIgnoreCase(file1.getCanonicalPath(), file2.getCanonicalPath())) { return true; } } catch (Exception e) { if (StrUtil.equalsIgnoreCase(file1.getAbsolutePath(), file2.getAbsolutePath())) { return true; } } } else { // 类Unix环境 try { if (StrUtil.equals(file1.getCanonicalPath(), file2.getCanonicalPath())) { return true; } } catch (Exception e) { if (StrUtil.equals(file1.getAbsolutePath(), file2.getAbsolutePath())) { return true; } } } return false; } /** * 获得最后一个文件路径分隔符的位置 * * @param filePath 文件路径 * @return 最后一个文件路径分隔符的位置 */ public static int lastIndexOfSeparator(String filePath) { if (filePath == null) { return -1; } int lastUnixPos = filePath.lastIndexOf(UNIX_SEPARATOR); int lastWindowsPos = filePath.lastIndexOf(WINDOWS_SEPARATOR); return (lastUnixPos >= lastWindowsPos) ? lastUnixPos : lastWindowsPos; } /** * 判断文件是否被改动
* 如果文件对象为 null 或者文件不存在,被视为改动 * * @param file 文件对象 * @param lastModifyTime 上次的改动时间 * @return 是否被改动 */ public static boolean isModifed(File file, long lastModifyTime) { if (null == file || false == file.exists()) { return true; } return file.lastModified() != lastModifyTime; } /** * 修复路径
* 如果原路径尾部有分隔符,则保留为标准分隔符(/),否则不保留 *
    *
  1. 1. 统一用 /
  2. *
  3. 2. 多个 / 转换为一个 /
  4. *
  5. 3. 去除两边空格
  6. *
  7. 4. .. 和 . 转换为绝对路径,当..多于已有路径时,直接返回根路径
  8. *
* * 栗子: *
	 * "/foo//" =》 "/foo/"
	 * "/foo/./" =》 "/foo/"
	 * "/foo/../bar" =》 "/bar"
	 * "/foo/../bar/" =》 "/bar/"
	 * "/foo/../bar/../baz" =》 "/baz"
	 * "/../" =》 "/"
	 * "foo/bar/.." =》 "foo"
	 * "foo/../bar" =》 "bar"
	 * "foo/../../bar" =》 "bar"
	 * "//server/foo/../bar" =》 "/server/bar"
	 * "//server/../bar" =》 "/bar"
	 * "C:\\foo\\..\\bar" =》 "C:/bar"
	 * "C:\\..\\bar" =》 "C:/bar"
	 * "~/foo/../bar/" =》 "~/bar/"
	 * "~/../bar" =》 "bar"
	 * 
* * @param path 原路径 * @return 修复后的路径 */ public static String normalize(String path) { if (path == null) { return null; } String pathToUse = path.replaceAll("[/\\\\]{1,}", "/").trim(); int prefixIndex = pathToUse.indexOf(StrUtil.COLON); String prefix = ""; if (prefixIndex > -1) { prefix = pathToUse.substring(0, prefixIndex + 1); if (false == prefix.contains("/")) { pathToUse = pathToUse.substring(prefixIndex + 1); } } if (pathToUse.startsWith(StrUtil.SLASH)) { prefix += StrUtil.SLASH; pathToUse = pathToUse.substring(1); } List pathList = StrUtil.split(pathToUse, StrUtil.C_SLASH); List pathElements = new LinkedList(); int tops = 0; String element; for (int i = pathList.size() - 1; i >= 0; i--) { element = pathList.get(i); if (StrUtil.DOT.equals(element)) { // 当前目录,丢弃 } else if (StrUtil.DOUBLE_DOT.equals(element)) { tops++; } else { if (tops > 0) { // Merging path element with element corresponding to top path. tops--; } else { // Normal path element found. pathElements.add(0, element); } } } return prefix + CollectionUtil.join(pathElements, StrUtil.SLASH); } /** * 获得相对子路径 * * @param rootDir 绝对父路径 * @param filePath 文件路径 * @return 相对子路径 */ public static String subPath(String rootDir, String filePath) { return subPath(rootDir, file(filePath)); } /** * 获得相对子路径 * * @param rootDir 绝对父路径 * @param file 文件 * @return 相对子路径 */ public static String subPath(String rootDir, File file) { if (StrUtil.isEmpty(rootDir)) { } String subPath = null; try { subPath = file.getCanonicalPath(); } catch (IOException e) { throw new IORuntimeException(e); } if (StrUtil.isNotEmpty(rootDir) && StrUtil.isNotEmpty(subPath)) { rootDir = normalize(rootDir); subPath = normalize(subPath); if (subPath != null && subPath.toLowerCase().startsWith(subPath.toLowerCase())) { subPath = subPath.substring(rootDir.length() + 1); } } return subPath; } // -------------------------------------------------------------------------------------------- name start /** * 返回主文件名 * * @param file 文件 * @return 主文件名 */ public static String mainName(File file) { if (file.isDirectory()) { return file.getName(); } return mainName(file.getName()); } /** * 返回主文件名 * * @param fileName 完整文件名 * @return 主文件名 */ public static String mainName(String fileName) { if (StrUtil.isBlank(fileName) || false == fileName.contains(StrUtil.DOT)) { return fileName; } return StrUtil.subPre(fileName, fileName.lastIndexOf(StrUtil.DOT)); } /** * 获取文件扩展名,扩展名不带“.” * * @param file 文件 * @return 扩展名 */ public static String extName(File file) { if (null == file) { return null; } if (file.isDirectory()) { return null; } return extName(file.getName()); } /** * 获得文件的扩展名,扩展名不带“.” * * @param fileName 文件名 * @return 扩展名 */ public static String extName(String fileName) { if (fileName == null) { return null; } int index = fileName.lastIndexOf(StrUtil.DOT); if (index == -1) { return StrUtil.EMPTY; } else { String ext = fileName.substring(index + 1); // 扩展名中不能包含路径相关的符号 return (ext.contains(String.valueOf(UNIX_SEPARATOR)) || ext.contains(String.valueOf(WINDOWS_SEPARATOR))) ? StrUtil.EMPTY : ext; } } // -------------------------------------------------------------------------------------------- name end /** * 判断文件路径是否有指定后缀,忽略大小写
* 常用语判断扩展名 * * @param file 文件或目录 * @param suffix 后缀 * @return 是否有指定后缀 */ public static boolean pathEndsWith(File file, String suffix) { return file.getPath().toLowerCase().endsWith(suffix); } /** * 根据文件流的头部信息获得文件类型 * * @see FileTypeUtil#getType(File) * * @param file 文件 {@link File} * @return 类型,文件的扩展名,未找到为null * @throws IORuntimeException IO异常 */ public static String getType(File file) { try { return FileTypeUtil.getType(file); } catch (IOException e) { throw new IORuntimeException(e); } } /** * 获取文件属性 * * @param path 文件路径{@link Path} * @param isFollowLinks 是否跟踪到软链对应的真实路径 * @return {@link BasicFileAttributes} * @throws IORuntimeException IO异常 * @since 3.1.0 */ public static BasicFileAttributes getAttributes(Path path, boolean isFollowLinks) throws IORuntimeException { if (null == path) { return null; } final LinkOption[] options = isFollowLinks ? new LinkOption[0] : new LinkOption[] { LinkOption.NOFOLLOW_LINKS }; try { return Files.readAttributes(path, BasicFileAttributes.class, options); } catch (IOException e) { throw new IORuntimeException(e); } } // -------------------------------------------------------------------------------------------- in start /** * 获得输入流 * * @param file 文件 * @return 输入流 * @throws IORuntimeException 文件未找到 */ public static BufferedInputStream getInputStream(File file) throws IORuntimeException { try { return new BufferedInputStream(new FileInputStream(file)); } catch (IOException e) { throw new IORuntimeException(e); } } /** * 获得输入流 * * @param path 文件路径 * @return 输入流 * @throws IORuntimeException 文件未找到 */ public static BufferedInputStream getInputStream(String path) throws IORuntimeException { return getInputStream(file(path)); } /** * 获得BOM输入流,用于处理带BOM头的文件 * * @param file 文件 * @return 输入流 * @throws IORuntimeException 文件未找到 */ public static BOMInputStream getBOMInputStream(File file) throws IORuntimeException { try { return new BOMInputStream(new FileInputStream(file)); } catch (IOException e) { throw new IORuntimeException(e); } } /** * 获得一个文件读取器 * * @param file 文件 * @return BufferedReader对象 * @throws IORuntimeException IO异常 */ public static BufferedReader getUtf8Reader(File file) throws IORuntimeException { return getReader(file, CharsetUtil.CHARSET_UTF_8); } /** * 获得一个文件读取器 * * @param path 文件路径 * @return BufferedReader对象 * @throws IORuntimeException IO异常 */ public static BufferedReader getUtf8Reader(String path) throws IORuntimeException { return getReader(path, CharsetUtil.CHARSET_UTF_8); } /** * 获得一个文件读取器 * * @param file 文件 * @param charsetName 字符集 * @return BufferedReader对象 * @throws IORuntimeException IO异常 */ public static BufferedReader getReader(File file, String charsetName) throws IORuntimeException { return IoUtil.getReader(getInputStream(file), charsetName); } /** * 获得一个文件读取器 * * @param file 文件 * @param charset 字符集 * @return BufferedReader对象 * @throws IORuntimeException IO异常 */ public static BufferedReader getReader(File file, Charset charset) throws IORuntimeException { return IoUtil.getReader(getInputStream(file), charset); } /** * 获得一个文件读取器 * * @param path 绝对路径 * @param charsetName 字符集 * @return BufferedReader对象 * @throws IORuntimeException IO异常 */ public static BufferedReader getReader(String path, String charsetName) throws IORuntimeException { return getReader(file(path), charsetName); } /** * 获得一个文件读取器 * * @param path 绝对路径 * @param charset 字符集 * @return BufferedReader对象 * @throws IORuntimeException IO异常 */ public static BufferedReader getReader(String path, Charset charset) throws IORuntimeException { return getReader(file(path), charset); } // -------------------------------------------------------------------------------------------- in end /** * 读取文件所有数据
* 文件的长度不能超过Integer.MAX_VALUE * * @param file 文件 * @return 字节码 * @throws IORuntimeException IO异常 */ public static byte[] readBytes(File file) throws IORuntimeException { return FileReader.create(file).readBytes(); } /** * 读取文件内容 * * @param file 文件 * @return 内容 * @throws IORuntimeException IO异常 */ public static String readUtf8String(File file) throws IORuntimeException { return readString(file, CharsetUtil.CHARSET_UTF_8); } /** * 读取文件内容 * * @param path 文件路径 * @return 内容 * @throws IORuntimeException IO异常 */ public static String readUtf8String(String path) throws IORuntimeException { return readString(path, CharsetUtil.CHARSET_UTF_8); } /** * 读取文件内容 * * @param file 文件 * @param charsetName 字符集 * @return 内容 * @throws IORuntimeException IO异常 */ public static String readString(File file, String charsetName) throws IORuntimeException { return readString(file, CharsetUtil.charset(charsetName)); } /** * 读取文件内容 * * @param file 文件 * @param charset 字符集 * @return 内容 * @throws IORuntimeException IO异常 */ public static String readString(File file, Charset charset) throws IORuntimeException { return FileReader.create(file, charset).readString(); } /** * 读取文件内容 * * @param path 文件路径 * @param charsetName 字符集 * @return 内容 * @throws IORuntimeException IO异常 */ public static String readString(String path, String charsetName) throws IORuntimeException { return readString(file(path), charsetName); } /** * 读取文件内容 * * @param path 文件路径 * @param charset 字符集 * @return 内容 * @throws IORuntimeException IO异常 */ public static String readString(String path, Charset charset) throws IORuntimeException { return readString(file(path), charset); } /** * 读取文件内容 * * @param url 文件URL * @param charset 字符集 * @return 内容 * @throws IORuntimeException IO异常 */ public static String readString(URL url, String charset) throws IORuntimeException { if (url == null) { throw new NullPointerException("Empty url provided!"); } InputStream in = null; try { in = url.openStream(); return IoUtil.read(in, charset); } catch (IOException e) { throw new IORuntimeException(e); } finally { IoUtil.close(in); } } /** * 从文件中读取每一行数据 * * @param 集合类型 * @param path 文件路径 * @param charset 字符集 * @param collection 集合 * @return 文件中的每行内容的集合 * @throws IORuntimeException IO异常 */ public static > T readLines(String path, String charset, T collection) throws IORuntimeException { return readLines(file(path), charset, collection); } /** * 从文件中读取每一行数据 * * @param 集合类型 * @param path 文件路径 * @param charset 字符集 * @param collection 集合 * @return 文件中的每行内容的集合 * @throws IORuntimeException IO异常 */ public static > T readLines(String path, Charset charset, T collection) throws IORuntimeException { return readLines(file(path), charset, collection); } /** * 从文件中读取每一行数据 * * @param 集合类型 * @param file 文件路径 * @param charset 字符集 * @param collection 集合 * @return 文件中的每行内容的集合 * @throws IORuntimeException IO异常 */ public static > T readLines(File file, String charset, T collection) throws IORuntimeException { return FileReader.create(file, CharsetUtil.charset(charset)).readLines(collection); } /** * 从文件中读取每一行数据 * * @param 集合类型 * @param file 文件路径 * @param charset 字符集 * @param collection 集合 * @return 文件中的每行内容的集合 * @throws IORuntimeException IO异常 */ public static > T readLines(File file, Charset charset, T collection) throws IORuntimeException { return FileReader.create(file, charset).readLines(collection); } /** * 从文件中读取每一行数据 * * @param 集合类型 * @param url 文件的URL * @param charset 字符集 * @param collection 集合 * @return 文件中的每行内容的集合 * @throws IORuntimeException IO异常 */ public static > T readLines(URL url, String charset, T collection) throws IORuntimeException { InputStream in = null; try { in = url.openStream(); return IoUtil.readLines(in, charset, collection); } catch (IOException e) { throw new IORuntimeException(e); } finally { IoUtil.close(in); } } /** * 从文件中读取每一行数据 * * @param url 文件的URL * @param charset 字符集 * @return 文件中的每行内容的集合List * @throws IORuntimeException IO异常 */ public static List readLines(URL url, String charset) throws IORuntimeException { return readLines(url, charset, new ArrayList()); } /** * 从文件中读取每一行数据 * * @param path 文件路径 * @param charset 字符集 * @return 文件中的每行内容的集合List * @throws IORuntimeException IO异常 */ public static List readLines(String path, String charset) throws IORuntimeException { return readLines(path, charset, new ArrayList()); } /** * 从文件中读取每一行数据 * * @param file 文件 * @param charset 字符集 * @return 文件中的每行内容的集合List * @throws IORuntimeException IO异常 */ public static List readLines(File file, String charset) throws IORuntimeException { return readLines(file, charset, new ArrayList()); } /** * 从文件中读取每一行数据 * * @param file 文件 * @param charset 字符集 * @return 文件中的每行内容的集合List * @throws IORuntimeException IO异常 */ public static List readLines(File file, Charset charset) throws IORuntimeException { return readLines(file, charset, new ArrayList()); } /** * 按行处理文件内容 * * @param file 文件 * @param charset 编码 * @param lineHandler {@link LineHandler}行处理器 * @throws IORuntimeException IO异常 */ public static void readLines(File file, Charset charset, LineHandler lineHandler) throws IORuntimeException { FileReader.create(file, charset).readLines(lineHandler); } /** * 按照给定的readerHandler读取文件中的数据 * * @param 集合类型 * @param readerHandler Reader处理类 * @param path 文件的绝对路径 * @param charset 字符集 * @return 从文件中load出的数据 * @throws IORuntimeException IO异常 */ public static T load(ReaderHandler readerHandler, String path, String charset) throws IORuntimeException { return FileReader.create(file(path), CharsetUtil.charset(charset)).read(readerHandler); } // -------------------------------------------------------------------------------------------- out start /** * 获得一个输出流对象 * * @param file 文件 * @return 输出流对象 * @throws IORuntimeException IO异常 */ public static BufferedOutputStream getOutputStream(File file) throws IORuntimeException { try { return new BufferedOutputStream(new FileOutputStream(touch(file))); } catch (Exception e) { throw new IORuntimeException(e); } } /** * 获得一个输出流对象 * * @param path 输出到的文件路径,绝对路径 * @return 输出流对象 * @throws IORuntimeException IO异常 */ public static BufferedOutputStream getOutputStream(String path) throws IORuntimeException { return getOutputStream(touch(path)); } /** * 获得一个带缓存的写入对象 * * @param path 输出路径,绝对路径 * @param charsetName 字符集 * @param isAppend 是否追加 * @return BufferedReader对象 * @throws IORuntimeException IO异常 */ public static BufferedWriter getWriter(String path, String charsetName, boolean isAppend) throws IORuntimeException { return getWriter(touch(path), Charset.forName(charsetName), isAppend); } /** * 获得一个带缓存的写入对象 * * @param path 输出路径,绝对路径 * @param charset 字符集 * @param isAppend 是否追加 * @return BufferedReader对象 * @throws IORuntimeException IO异常 */ public static BufferedWriter getWriter(String path, Charset charset, boolean isAppend) throws IORuntimeException { return getWriter(touch(path), charset, isAppend); } /** * 获得一个带缓存的写入对象 * * @param file 输出文件 * @param charsetName 字符集 * @param isAppend 是否追加 * @return BufferedReader对象 * @throws IORuntimeException IO异常 */ public static BufferedWriter getWriter(File file, String charsetName, boolean isAppend) throws IORuntimeException { return getWriter(file, Charset.forName(charsetName), isAppend); } /** * 获得一个带缓存的写入对象 * * @param file 输出文件 * @param charset 字符集 * @param isAppend 是否追加 * @return BufferedReader对象 * @throws IORuntimeException IO异常 */ public static BufferedWriter getWriter(File file, Charset charset, boolean isAppend) throws IORuntimeException { return FileWriter.create(file, charset).getWriter(isAppend); } /** * 获得一个打印写入对象,可以有print * * @param path 输出路径,绝对路径 * @param charset 字符集 * @param isAppend 是否追加 * @return 打印对象 * @throws IORuntimeException IO异常 */ public static PrintWriter getPrintWriter(String path, String charset, boolean isAppend) throws IORuntimeException { return new PrintWriter(getWriter(path, charset, isAppend)); } /** * 获得一个打印写入对象,可以有print * * @param file 文件 * @param charset 字符集 * @param isAppend 是否追加 * @return 打印对象 * @throws IORuntimeException IO异常 */ public static PrintWriter getPrintWriter(File file, String charset, boolean isAppend) throws IORuntimeException { return new PrintWriter(getWriter(file, charset, isAppend)); } // -------------------------------------------------------------------------------------------- out end /** * 将String写入文件,覆盖模式,字符集为UTF-8 * * @param content 写入的内容 * @param path 文件路径 * @return 写入的文件 * @throws IORuntimeException IO异常 */ public static File writeUtf8String(String content, String path) throws IORuntimeException { return writeString(content, path, CharsetUtil.CHARSET_UTF_8); } /** * 将String写入文件,覆盖模式,字符集为UTF-8 * * @param content 写入的内容 * @param file 文件 * @return 写入的文件 * @throws IORuntimeException IO异常 */ public static File writeUtf8String(String content, File file) throws IORuntimeException { return writeString(content, file, CharsetUtil.CHARSET_UTF_8); } /** * 将String写入文件,覆盖模式 * * @param content 写入的内容 * @param path 文件路径 * @param charset 字符集 * @return 写入的文件 * @throws IORuntimeException IO异常 */ public static File writeString(String content, String path, String charset) throws IORuntimeException { return writeString(content, touch(path), charset); } /** * 将String写入文件,覆盖模式 * * @param content 写入的内容 * @param path 文件路径 * @param charset 字符集 * @return 写入的文件 * @throws IORuntimeException IO异常 */ public static File writeString(String content, String path, Charset charset) throws IORuntimeException { return writeString(content, touch(path), charset); } /** * 将String写入文件,覆盖模式 * * * @param content 写入的内容 * @param file 文件 * @param charset 字符集 * @return 被写入的文件 * @throws IORuntimeException IO异常 */ public static File writeString(String content, File file, String charset) throws IORuntimeException { return FileWriter.create(file, CharsetUtil.charset(charset)).write(content); } /** * 将String写入文件,覆盖模式 * * * @param content 写入的内容 * @param file 文件 * @param charset 字符集 * @return 被写入的文件 * @throws IORuntimeException IO异常 */ public static File writeString(String content, File file, Charset charset) throws IORuntimeException { return FileWriter.create(file, charset).write(content); } /** * 将String写入文件,追加模式 * * @param content 写入的内容 * @param path 文件路径 * @param charset 字符集 * @return 写入的文件 * @throws IORuntimeException IO异常 */ public static File appendString(String content, String path, String charset) throws IORuntimeException { return appendString(content, touch(path), charset); } /** * 将String写入文件,追加模式 * * @param content 写入的内容 * @param path 文件路径 * @param charset 字符集 * @return 写入的文件 * @throws IORuntimeException IO异常 */ public static File appendString(String content, String path, Charset charset) throws IORuntimeException { return appendString(content, touch(path), charset); } /** * 将String写入文件,追加模式 * * @param content 写入的内容 * @param file 文件 * @param charset 字符集 * @return 写入的文件 * @throws IORuntimeException IO异常 */ public static File appendString(String content, File file, String charset) throws IORuntimeException { return FileWriter.create(file, CharsetUtil.charset(charset)).append(content); } /** * 将String写入文件,追加模式 * * @param content 写入的内容 * @param file 文件 * @param charset 字符集 * @return 写入的文件 * @throws IORuntimeException IO异常 */ public static File appendString(String content, File file, Charset charset) throws IORuntimeException { return FileWriter.create(file, charset).append(content); } /** * 将列表写入文件,覆盖模式 * * @param 集合元素类型 * @param list 列表 * @param path 绝对路径 * @param charset 字符集 * @throws IORuntimeException IO异常 */ public static void writeLines(Collection list, String path, String charset) throws IORuntimeException { writeLines(list, path, charset, false); } /** * 将列表写入文件,覆盖模式 * * @param 集合元素类型 * @param list 列表 * @param path 绝对路径 * @param charset 字符集 * @throws IORuntimeException IO异常 */ public static void writeLines(Collection list, String path, Charset charset) throws IORuntimeException { writeLines(list, path, charset, false); } /** * 将列表写入文件,追加模式 * * @param 集合元素类型 * @param list 列表 * @param path 绝对路径 * @param charset 字符集 * @throws IORuntimeException IO异常 */ public static void appendLines(Collection list, String path, String charset) throws IORuntimeException { writeLines(list, path, charset, true); } /** * 将列表写入文件,追加模式 * * @param 集合元素类型 * @param list 列表 * @param path 绝对路径 * @param charset 字符集 * @throws IORuntimeException IO异常 */ public static void appendLines(Collection list, String path, Charset charset) throws IORuntimeException { writeLines(list, path, charset, true); } /** * 将列表写入文件 * * @param 集合元素类型 * @param list 列表 * @param path 文件路径 * @param charset 字符集 * @param isAppend 是否追加 * @return 文件 * @throws IORuntimeException IO异常 */ public static File writeLines(Collection list, String path, String charset, boolean isAppend) throws IORuntimeException { return writeLines(list, file(path), charset, isAppend); } /** * 将列表写入文件 * * @param 集合元素类型 * @param list 列表 * @param path 文件路径 * @param charset 字符集 * @param isAppend 是否追加 * @return 文件 * @throws IORuntimeException IO异常 */ public static File writeLines(Collection list, String path, Charset charset, boolean isAppend) throws IORuntimeException { return writeLines(list, file(path), charset, isAppend); } /** * 将列表写入文件 * * @param 集合元素类型 * @param list 列表 * @param file 文件 * @param charset 字符集 * @param isAppend 是否追加 * @return 文件 * @throws IORuntimeException IO异常 */ public static File writeLines(Collection list, File file, String charset, boolean isAppend) throws IORuntimeException { return FileWriter.create(file, CharsetUtil.charset(charset)).writeLines(list, isAppend); } /** * 将列表写入文件 * * @param 集合元素类型 * @param list 列表 * @param file 文件 * @param charset 字符集 * @param isAppend 是否追加 * @return 文件 * @throws IORuntimeException IO异常 */ public static File writeLines(Collection list, File file, Charset charset, boolean isAppend) throws IORuntimeException { return FileWriter.create(file, charset).writeLines(list, isAppend); } /** * 写数据到文件中 * * @param data 数据 * @param path 目标文件 * @return 文件 * @throws IORuntimeException IO异常 */ public static File writeBytes(byte[] data, String path) throws IORuntimeException { return writeBytes(data, touch(path)); } /** * 写数据到文件中 * * @param dest 目标文件 * @param data 数据 * @return dest * @throws IORuntimeException IO异常 */ public static File writeBytes(byte[] data, File dest) throws IORuntimeException { return writeBytes(data, dest, 0, data.length, false); } /** * 写入数据到文件 * * @param data 数据 * @param dest 目标文件 * @param off 数据开始位置 * @param len 数据长度 * @param isAppend 是否追加模式 * @return File * @throws IORuntimeException IO异常 */ public static File writeBytes(byte[] data, File dest, int off, int len, boolean isAppend) throws IORuntimeException { return FileWriter.create(dest).write(data, off, len, isAppend); } /** * 将流的内容写入文件
* * @param dest 目标文件 * @param in 输入流 * @return dest * @throws IORuntimeException IO异常 */ public static File writeFromStream(InputStream in, File dest) throws IORuntimeException { return FileWriter.create(dest).writeFromStream(in); } /** * 将流的内容写入文件
* * @param in 输入流 * @param fullFilePath 文件绝对路径 * @return dest * @throws IORuntimeException IO异常 */ public static File writeFromStream(InputStream in, String fullFilePath) throws IORuntimeException { return writeFromStream(in, touch(fullFilePath)); } /** * 将文件写入流中 * * @param file 文件 * @param out 流 * @return File * @throws IORuntimeException IO异常 */ public static File writeToStream(File file, OutputStream out) throws IORuntimeException { return FileReader.create(file).writeToStream(out); } /** * 将流的内容写入文件
* * @param fullFilePath 文件绝对路径 * @param out 输出流 * @throws IORuntimeException IO异常 */ public static void writeToStream(String fullFilePath, OutputStream out) throws IORuntimeException { writeToStream(touch(fullFilePath), out); } /** * 可读的文件大小 * * @param file 文件 * @return 大小 */ public static String readableFileSize(File file) { return readableFileSize(file.length()); } /** * 可读的文件大小
* 参考 http://stackoverflow.com/questions/3263892/format-file-size-as-mb-gb-etc * * @param size Long类型大小 * @return 大小 */ public static String readableFileSize(long size) { if (size <= 0) return "0"; final String[] units = new String[] { "B", "kB", "MB", "GB", "TB", "EB" }; int digitGroups = (int) (Math.log10(size) / Math.log10(1024)); return new DecimalFormat("#,##0.##").format(size / Math.pow(1024, digitGroups)) + " " + units[digitGroups]; } /** * 转换文件编码
* 此方法用于转换文件编码,读取的文件实际编码必须与指定的srcCharset编码一致,否则导致乱码 * * @param file 文件 * @param srcCharset 原文件的编码,必须与文件内容的编码保持一致 * @param destCharset 转码后的编码 * @return 被转换编码的文件 * @see CharsetUtil#convert(File, Charset, Charset) * @since 3.1.0 */ public static File convertCharset(File file, Charset srcCharset, Charset destCharset) { return CharsetUtil.convert(file, srcCharset, destCharset); } /** * 转换换行符
* 将给定文件的换行符转换为指定换行符 * * @param file 文件 * @param charset 编码 * @param lineSeparator 换行符枚举{@link LineSeparator} * @return 被修改的文件 * @since 3.1.0 */ public static File convertLineSeparator(File file, Charset charset, LineSeparator lineSeparator) { final List lines = readLines(file, charset); return FileWriter.create(file, charset).writeLines(lines, lineSeparator, false); } }




© 2015 - 2024 Weber Informatics LLC | Privacy Policy