Copies the file represented by this store to the provided destination store. Copying occurs with best-effort semantics; if some files cannot be copied, exceptions are recorded but other files will continue to be copied if possible.
The {@link EFS#OVERWRITE} option flag indicates howthis method deals with files that already exist at the copy destination. If the OVERWRITE
flag is present, then existing files at the destination are overwritten with the corresponding files from the source of the copy operation. When this flag is not present, existing files at the destination are not overwritten and an exception is thrown indicating what files could not be copied.
The {@link EFS#SHALLOW} option flag indicates howthis method deals with copying of directories. If the SHALLOW
flag is present, then a directory will be copied but the files and directories within it will not. When this flag is not present, all child directories and files of a directory are copied recursively.
@param destination The destination of the copy.
@param options bit-wise or of option flag constants ({@link EFS#OVERWRITE} or {@link EFS#SHALLOW}).
@param monitor a progress monitor, or
null
if progressreporting and cancellation are not desired
@exception CoreException if this method fails. Reasons include:
- This store does not exist.
- The parent of the destination file store does not exist.
- The
OVERWRITE
flag is not specified and a file of the same name already exists at the copy destination.