If OVERWRITE option is not passed as an argument, rename fails if the dst already exists.
If OVERWRITE option is passed as an argument, rename overwrites the dst if it is a file or an empty directory. Rename fails if dst is a non-empty directory.
Note that atomicity of rename is dependent on the file system implementation. Please refer to the file system documentation for details
@param src path to be renamed
@param dst new path after rename
@throws AccessControlException If access is denied
@throws FileAlreadyExistsException If dst already exists andoptions has {@link Options.Rename#OVERWRITE} option false.
@throws FileNotFoundException If src does not exist
@throws ParentNotDirectoryException If parent of dst is not adirectory
@throws UnsupportedFileSystemException If file system for srcand dst is not supported
@throws IOException If an I/O error occurredExceptions applicable to file systems accessed over RPC:
@throws RpcClientException If an exception occurred in the RPC client
@throws RpcServerException If an exception occurred in the RPC server
@throws UnexpectedServerException If server implementation throwsundeclared exception to RPC server
| |
| |