| « Simple way of sharing files on a home network | Automatically showing the Editor's file in Eclipse's Package Explorer » |
Java's File.renameTo fails on Windows
February 2nd, 2010I had a problem with renaming a properties file. Java’s File.renameTo() always failed and returned false. There was no explanation as to why it failed, so it left me stuck with no idea what to do.
Windows has a different file locking policy to Unix (and everyone else). Under Windows, if a process has a file open no other process can rename, move or delete the file until that process has closed all handles to it. As if that wasn’t bad enough, if you do leave a file open and your code finishes running the file will still be locked after an unknown amount of time. It could be 30 seconds or it could be never. Hurray for windows 
So you must ensure that the file you are trying to rename is completely closed. My problem turned out to be in the loading and saving of properties files. Almost all the example code you download relating to reading and writing properties is wrong. Properties.load() and Properties.store() both take file streams. If the stream is still open then the file will be locked.
Most of the examples tell you to load the properties like this:
Code:
Properties properties = new Properties(); | |
properties.load(new FileInputStream("filename.properties")); |
and save them like this:
Code:
Properties properties = new Properties(); | |
properties.store(new FileOutputStream("filename.properties")); |
I was under the impression that store and load closed down the stream after they had done their business, but this is not the case. The streams are left open. So when you use the methods above to create a file and read from a file you are leaving the handle open. What’s worse is that because the FileInputStream and FileOutputStream are in-line there is no reference available to close the streams down - and you are stuffed!
The correct method of reading from a Properties file is:
Code:
FileInputStream in = null; | |
Properties properties = new Properties(); | |
try | |
{ | |
in = new FileInputStream("file.properties"); | |
properties.load(in); | |
} | |
finally | |
{ | |
if (in != null) in.close(); | |
} |
and similarly, writing to a Properties file:
Code:
FileOutputStream out = null; | |
Properties properties = new Properties(); | |
try | |
{ | |
out = new FileOutputStream("file.properties"); | |
properties.store(out); | |
} | |
finally | |
{ | |
if (out != null) out.close(); | |
} |
Now, after reading and writing, you have explicitly closed the file and you are free to rename the file without error.
9 comments
Thanks for this!!! I was having the exact same problem with the delete always returning false for what seemed like no good reason. Behold - the FileInputStream was still open from reading the properties file! 
Thanks a lot for the information. This problem was driving me mad. 
http://bugs.sun.com/bugdatabase/view_bug.do?bug_id=6213298I had the same problem with writing data to a new file and than try to renam it.
This worked for me:
try {
fos.close(); // fos is a FileOutputStream
} catch (Exception e) {}
System.gc();
try {
Thread.sleep(50);
} catch (InterruptedException e) {
}
hth
Regards
Excellent, because I'm having this problem right now.. I'm glad I found this.. woohoo..Thanks a bunch..
Perfecto!!! ahora entiendo porque no podia hacer el rename.Thanks a bunch!!
Hi, I am trying to rename the sub folders in about 10 parent folders in the loop. Meanwhile I am uploading the files in to the sub folders and downloading the files, but closing the files. But rename fails some times for 1 or two sub folders randomly if I continuously doing uploading, renaming and downloading. How to solve this problem? 
Check that you are closing after an exception.Check that you are not trying to rename a folder while you are touching any of the files contained within it. Under Unix this will be fine but windows is useless and won't let you alter parents of filesystem entities.
File o=new File("d:/old.txt");File n=new File("d:/new.txt");
n.delete();
o.renameTo(n);
n.delete() : We need to delete the file(new.txt) if exists.
o.rename(n) : so that the file(old.txt) is renamed as new.txt
thanks a lot ... it really saved the day for me once again thanks:) 
Comment feed for this post
