Move or rename a file to a target file. This method works in exactly the
manner specified by the Files.move
method except that both the
source and target paths must be associated with this provider.
source
| the path to the file to move | |
target
| the path to the target file | |
options
| options specifying how the move should be done |
UnsupportedOperationException
| if the array contains a copy option that is not supported | |
FileAlreadyExistsException
| if the target file exists but cannot be replaced because the
REPLACE_EXISTING option is not specified (optional
specific exception) | |
DirectoryNotEmptyException
| the REPLACE_EXISTING option is specified but the file
cannot be replaced because it is a non-empty directory
(optional specific exception) | |
AtomicMoveNotSupportedException
| if the options array contains the ATOMIC_MOVE option but
the file cannot be moved as an atomic file system operation. | |
IOException
| if an I/O error occurs | |
SecurityException
| In the case of the default provider, and a security manager is
installed, the checkWrite
method is invoked to check write access to both the source and
target file. |
Diagram: FileSystem