cn.hutool.core.io.file

类 FileCopier

java.lang.Object

cn.hutool.core.lang.copier.SrcToDestCopier<File,FileCopier>

cn.hutool.core.io.file.FileCopier

所有已实现的接口:

Copier<File>, Serializable

public class FileCopier
extends SrcToDestCopier<File,FileCopier>

文件拷贝器
支持以下几种情况：

 1、文件复制到文件
 2、文件复制到目录
 3、目录复制到目录
 4、目录下的文件和目录复制到另一个目录
 

从以下版本开始:

3.0.9

作者:

Looly

另请参阅:

序列化表格

字段概要

从类继承的字段 cn.hutool.core.lang.copier.SrcToDestCopier

copyFilter, dest, src

构造器概要

构造器

构造器和说明
FileCopier(File src, File dest) 构造

方法概要

方法

限定符和类型	方法和说明
File	copy() 执行拷贝 拷贝规则为： 1、源为文件，目标为已存在目录，则拷贝到目录下，文件名不变 2、源为文件，目标为不存在路径，则目标以文件对待（自动创建父级目录）比如：/dest/aaa，如果aaa不存在，则aaa被当作文件名 3、源为文件，目标是一个已存在的文件，则当setOverride(boolean)设为true时会被覆盖，默认不覆盖 4、源为目录，目标为已存在目录，当setCopyContentIfDir(boolean)为true时，只拷贝目录中的内容到目标目录中，否则整个源目录连同其目录拷贝到目标目录中 5、源为目录，目标为不存在路径，则自动创建目标为新目录，然后按照规则4复制 6、源为目录，目标为文件，抛出IO异常 7、源路径和目标路径相同时，抛出IO异常
static FileCopier	create(File src, File dest) 新建一个文件复制器
static FileCopier	create(String srcPath, String destPath) 新建一个文件复制器
boolean	isCopyAttributes() 是否拷贝所有属性
boolean	isCopyContentIfDir() 当拷贝来源是目录时是否只拷贝目录下的内容
boolean	isOnlyCopyFile() 当拷贝来源是目录时是否只拷贝文件而忽略子目录
boolean	isOverride() 是否覆盖目标文件
FileCopier	setCopyAttributes(boolean isCopyAttributes) 设置是否拷贝所有属性
FileCopier	setCopyContentIfDir(boolean isCopyContentIfDir) 当拷贝来源是目录时是否只拷贝目录下的内容
FileCopier	setOnlyCopyFile(boolean isOnlyCopyFile) 设置当拷贝来源是目录时是否只拷贝文件而忽略子目录
FileCopier	setOverride(boolean isOverride) 设置是否覆盖目标文件

从类继承的方法 cn.hutool.core.lang.copier.SrcToDestCopier

getCopyFilter, getDest, getSrc, setCopyFilter, setDest, setSrc

从类继承的方法 java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

构造器详细资料

FileCopier

public FileCopier(File src,
          File dest)

构造

参数:

src - 源文件

dest - 目标文件

方法详细资料

create

public static FileCopier create(String srcPath,
                String destPath)

新建一个文件复制器

参数:

srcPath - 源文件路径（相对ClassPath路径或绝对路径）

destPath - 目标文件路径（相对ClassPath路径或绝对路径）

返回:

FileCopier

create

public static FileCopier create(File src,
                File dest)

新建一个文件复制器

参数:

src - 源文件

dest - 目标文件

返回:

FileCopier

isOverride

public boolean isOverride()

是否覆盖目标文件

返回:

是否覆盖目标文件

setOverride

public FileCopier setOverride(boolean isOverride)

设置是否覆盖目标文件

参数:

isOverride - 是否覆盖目标文件

返回:

this

isCopyAttributes

public boolean isCopyAttributes()

是否拷贝所有属性

返回:

是否拷贝所有属性

setCopyAttributes

public FileCopier setCopyAttributes(boolean isCopyAttributes)

设置是否拷贝所有属性

参数:

isCopyAttributes - 是否拷贝所有属性

返回:

this

isCopyContentIfDir

public boolean isCopyContentIfDir()

当拷贝来源是目录时是否只拷贝目录下的内容

返回:

当拷贝来源是目录时是否只拷贝目录下的内容

setCopyContentIfDir

public FileCopier setCopyContentIfDir(boolean isCopyContentIfDir)

当拷贝来源是目录时是否只拷贝目录下的内容

参数:

isCopyContentIfDir - 是否只拷贝目录下的内容

返回:

this

isOnlyCopyFile

public boolean isOnlyCopyFile()

当拷贝来源是目录时是否只拷贝文件而忽略子目录

返回:

当拷贝来源是目录时是否只拷贝文件而忽略子目录

从以下版本开始:

4.1.5

setOnlyCopyFile

public FileCopier setOnlyCopyFile(boolean isOnlyCopyFile)

设置当拷贝来源是目录时是否只拷贝文件而忽略子目录

参数:

isOnlyCopyFile - 当拷贝来源是目录时是否只拷贝文件而忽略子目录

从以下版本开始:

4.1.5

copy

public File copy()
          throws IORuntimeException

执行拷贝
拷贝规则为：

 1、源为文件，目标为已存在目录，则拷贝到目录下，文件名不变
 2、源为文件，目标为不存在路径，则目标以文件对待（自动创建父级目录）比如：/dest/aaa，如果aaa不存在，则aaa被当作文件名
 3、源为文件，目标是一个已存在的文件，则当setOverride(boolean)设为true时会被覆盖，默认不覆盖
 4、源为目录，目标为已存在目录，当setCopyContentIfDir(boolean)为true时，只拷贝目录中的内容到目标目录中，否则整个源目录连同其目录拷贝到目标目录中
 5、源为目录，目标为不存在路径，则自动创建目标为新目录，然后按照规则4复制
 6、源为目录，目标为文件，抛出IO异常
 7、源路径和目标路径相同时，抛出IO异常
 

返回:

拷贝后目标的文件或目录

抛出:

IORuntimeException - IO异常