com.github.jarvisframework.tool.core.io.file

类 FileCopier

java.lang.Object

com.github.jarvisframework.tool.core.lang.copier.SrcToDestCopier<File,FileCopier>

com.github.jarvisframework.tool.core.io.file.FileCopier

所有已实现的接口:

Copier<File>, Serializable

public class FileCopier
extends SrcToDestCopier<File,FileCopier>

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

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

从以下版本开始:

1.0, 2020-07-30 12:02:37

作者:

Doug Wang

另请参阅:

序列化表格

字段概要

字段

限定符和类型	字段和说明
private boolean	isCopyAttributes 是否拷贝所有属性
private boolean	isCopyContentIfDir 当拷贝来源是目录时是否只拷贝目录下的内容
private boolean	isOnlyCopyFile 当拷贝来源是目录时是否只拷贝文件而忽略子目录
private boolean	isOverride 是否覆盖目标文件
private static long	serialVersionUID

从类继承的字段 com.github.jarvisframework.tool.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) 新建一个文件复制器
private void	internalCopyDirContent(File src, File dest) 拷贝目录内容，只用于内部，不做任何安全检查 拷贝内容的意思为源目录下的所有文件和目录拷贝到另一个目录下，而不拷贝源目录本身
private void	internalCopyFile(File src, File dest) 拷贝文件，只用于内部，不做任何安全检查 情况如下： 1、如果目标是一个不存在的路径，则目标以文件对待（自动创建父级目录）比如：/dest/aaa，如果aaa不存在，则aaa被当作文件名 2、如果目标是一个已存在的目录，则文件拷贝到此目录下，文件名与原文件名一致
boolean	isCopyAttributes() 是否拷贝所有属性
boolean	isCopyContentIfDir() 当拷贝来源是目录时是否只拷贝目录下的内容
boolean	isOnlyCopyFile() 当拷贝来源是目录时是否只拷贝文件而忽略子目录
boolean	isOverride() 是否覆盖目标文件
FileCopier	setCopyAttributes(boolean isCopyAttributes) 设置是否拷贝所有属性
FileCopier	setCopyContentIfDir(boolean isCopyContentIfDir) 当拷贝来源是目录时是否只拷贝目录下的内容
FileCopier	setOnlyCopyFile(boolean isOnlyCopyFile) 设置当拷贝来源是目录时是否只拷贝文件而忽略子目录
FileCopier	setOverride(boolean isOverride) 设置是否覆盖目标文件

从类继承的方法 com.github.jarvisframework.tool.core.lang.copier.SrcToDestCopier

getCopyFilter, getDest, getSrc, setCopyFilter, setDest, setSrc

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

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

字段详细资料

serialVersionUID

private static final long serialVersionUID

另请参阅:

常量字段值

isOverride

private boolean isOverride

是否覆盖目标文件

isCopyAttributes

private boolean isCopyAttributes

是否拷贝所有属性

isCopyContentIfDir

private boolean isCopyContentIfDir

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

isOnlyCopyFile

private boolean isOnlyCopyFile

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

构造器详细资料

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 - 当拷贝来源是目录时是否只拷贝文件而忽略子目录

返回:

this

从以下版本开始:

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异常

internalCopyDirContent

private void internalCopyDirContent(File src,
                                    File dest)
                             throws IORuntimeException

拷贝目录内容，只用于内部，不做任何安全检查
拷贝内容的意思为源目录下的所有文件和目录拷贝到另一个目录下，而不拷贝源目录本身

参数:

src - 源目录

dest - 目标目录

抛出:

IORuntimeException - IO异常

internalCopyFile

private void internalCopyFile(File src,
                              File dest)
                       throws IORuntimeException

拷贝文件，只用于内部，不做任何安全检查
情况如下：

 1、如果目标是一个不存在的路径，则目标以文件对待（自动创建父级目录）比如：/dest/aaa，如果aaa不存在，则aaa被当作文件名
 2、如果目标是一个已存在的目录，则文件拷贝到此目录下，文件名与原文件名一致
 

参数:

src - 源文件，必须为文件

dest - 目标文件，如果非覆盖模式必须为目录

抛出:

IORuntimeException - IO异常