Java – Rename or Move a File – Java –重命名或移动一个文件

最后修改: 2014年 6月 25日


1. Overview


In this quick tutorial, we’re going to look at renaming / moving a File in Java.


We’ll first look into using the Files and Path classes from NIO, then the Java File class, Google Guava, and finally the Apache Commons IO library.

我们将首先研究使用NIO的FilesPath类,然后是JavaFile类、Google Guava,最后是Apache Commons IO库。

This article is part of the Java – Back to Basic” series here on Baeldung.

本文是Java – Back to Basic“系列的一部分,位于Baeldung。

2. Setup


In the examples, we’ll use the following setup, which consists of 2 constants for the source and destination file name and a clean-up step to be able to run the tests multiple times:


private final String FILE_TO_MOVE = "src/test/resources/originalFileToMove.txt";
private final String TARGET_FILE = "src/test/resources/targetFileToMove.txt";

public void createFileToMove() throws IOException {
    File fileToMove = new File(FILE_TO_MOVE);

public void cleanUpFiles() {
    File targetFile = new File(TARGET_FILE);

3. Using the NIO Paths and Files Classes


Let’s start by using the Files.move() method from the Java NIO package:

让我们从使用Java NIO包中的Files.move()方法开始。

public void givenUsingNio_whenMovingFile_thenCorrect() throws IOException {
    Path fileToMovePath = Paths.get(FILE_TO_MOVE);
    Path targetPath = Paths.get(TARGET_FILE);
    Files.move(fileToMovePath, targetPath);

In JDK7 the NIO package was significantly updated, and the Path class added. This provides methods for convenient manipulation of File System artifacts.


Note that both the file and the target directory should exist.


4. Using the File Class


Let’s now look at how we can do the same using the File.renameTo() method:


public void givenUsingFileClass_whenMovingFile_thenCorrect() throws IOException {
    File fileToMove = new File(FILE_TO_MOVE);
    boolean isMoved = fileToMove.renameTo(new File(TARGET_FILE));
    if (!isMoved) {
        throw new FileSystemException(TARGET_FILE);

In this example, the file to be moved does exist, as well as the target directory.


Note that renameTo() only throws two types of exceptions:


  • SecurityException – if a security manager denies writing access to either the source or to the destination
  • NullPointerException – in case the parameter target is null

If the target does not exist in a file system – no exception will be thrown – and you will have to check the returned success flag of the method.


5. Using Guava


Next – let’s take a look at the Guava solution, which provides a convenient Files.move() method:


public void givenUsingGuava_whenMovingFile_thenCorrect()
        throws IOException {
    File fileToMove = new File(FILE_TO_MOVE);
    File targetFile = new File(TARGET_FILE);, targetFile);

Again, in this example, the file to be moved and the target directory need to exist.


6. With Commons IO

6.有Commons IO

Finally, let’s take a look at a solution with Apache Commons IO – probably the simplest one:

最后,让我们来看看用Apache Commons IO的解决方案–可能是最简单的一个。

public void givenUsingApache_whenMovingFile_thenCorrect() throws IOException {
    FileUtils.moveFile(FileUtils.getFile(FILE_TO_MOVE), FileUtils.getFile(TARGET_FILE));

This one line will, of course, allow both moving or renaming, depending on if the target directory is the same or not.


Alternatively – here’s a solution for moving specifically, also enabling us to automatically create the destination directory if it doesn’t already exist:


public void givenUsingApache_whenMovingFileApproach2_thenCorrect() throws IOException {
      FileUtils.getFile("src/main/resources/"), true);

6. Conclusion


In this article, we looked at different solutions for moving a file in Java. We focused on renaming in these code snippets, but moving is, of course, the same, only the target directory needs to be different.


The code for the examples is available over on GitHub.