【Java】renameToを使ってファイル/ディレクトリの名前を変更する!

ファイル/ディレクトリの名前を変更するにはFileクラスのrenameToメソッドを使用します。

FileクラスのrenameToメソッドは、対象のファイル(またはディレクトリ)の名前を変更するメソッドとなります。

また、renameTメソッドは戻り値として変更できた場合はtrue、変更できなかった場合はfalseを返すため、ファイル名の変更ができたかどうかをログに残すことができます。

今回はFileクラスのrenameToメソッドを使って以下の場合でファイル/ディレクトリの名前を変していきます。

⚫︎ ファイル/ディレクトリの名前を変更する場合
⚫︎ 変更するファイル/ディレクトリが既に存在する場合
⚫︎ 指定したファイル/ディレクトリが存在しない場合

また、Java7から使用できるようになったFileクラスのmoveメソッドを使って、ファイル/ディレクトリの名前を変更する方法についても紹介していきます。

renameToメソッドとは

FileクラスのrenameToメソッドとは、対象のファイル(またはディレクトリ)の名前を変更するメソッドになります。

renameToメソッドの書き方

FileクラスのrenameToメソッドの構文は下記となります。

まず、renameToメソッドが使用できるようにFileクラスをインポートします。

そして、renameToの()にパラメータとして変更後のファイル名を指定することで変更前のファイル名をを変更後のファイルの名へと変更します。

また、返り値として変更できた場合はtrueを返し、変更できなかった場合はfalseを返します。

ファイル/ディレクトリの名前を変更するサンプルコード

ファイル/ディレクトリの名前を変更するサンプルコードを紹介します。

ファイル/ディレクトリの名前を変更する場合

コンソールから実行する場合、カレントディレクトリに「oldFile.txt」を用意します。
また、Eclipseで実行する場合、プロジェクト直下に「oldFile.txt」を用意します。

出力結果

名前変更成功

renameToメソッドによって「oldNameFile.txt」のファイル名が「newNameFile.txt」に変更されます。
また、コンソールには、「名前変更成功」と表示されます。

変更するファイル/ディレクトリが既に存在する場合

コンソールから実行する場合、カレントディレクトリに「newFile.txt」を用意します。
また、Eclipseで実行する場合、プロジェクト直下に「newFile.txt」を用意します。

出力結果

名前変更失敗

windiws系の場合では名前の変更が行われず、falseを返します。
しかし、Unix系の環境では上書きで名前が変更されてtrueを返すようになります。

指定したファイル/ディレクトリが存在しない場合

出力結果

名前変更失敗

指定したファイルやディレクトリが存在しない場合はfalseを返します。

NIO.2(Filesクラス)でファイル/ディレクトリの名前を変更する場合

NIO.2とはJava7で導入された「java.nio.file」パッケージとそのサブパッケージとを合わせたものであり、NIO.2のFilesクラスを使用することでとても簡単にファイル処理を行うことができます。

そのため、Filesクラスのmoveメソッドを呼び出すことによって、ファイル、または、ディレクトリの名前を変更することができます。

Filesクラスのmoveメソッドのパラメータとして、次のオプションを指定することができます。

オプション 説明
StandardCopyOption.REPLACE_EXISTING 移動先にすでにファイルが存在する 場合に上書きする。
StandardCopyOption.ATOMIC_MOVE アトミックオペレーションとして移動する。
このパラメータオプションを指定すると、他のパラメータオプションはすべて無視される。
また、別ドライブヘアトミックな移動を行った場合は例外が発生する(アトミックの場合はコピーを行う必要がある)

Unix系の環境で名前変更後のファイル、または、ディレクトリがすでにFileクラスのrenameToメソッドでは例外は発生しませんが、Filesクラスのmoveメソッドではパラメータオプションである「StandardCopyOption.REPLACE_EXISTING」と例外が発生します。

Main.java

出力結果

newFile.txt

コンソールから実行する場合は、カレントディレクトリに「oldNameFile.txt」を用意します。
ttle Eclipseで実行する場合は、プロジェクト直下に「oldNameFile.txt」を用意します。
その状態でMain.javaを実行すると、「oldFile.txt」のファイル名が「newNameFile.txt」に変更されます。

また、コンソールに、変更後のファイル名(newNameFile.txt)が表示されます。

今回のポイント

renameToでファイル/ディレクトリの名前を変更

ファイル/ディレクトリの名前を変更するにはFileクラスのrenameToメソッドを使用する。

⚫︎ FileクラスのrenameToメソッドを呼び出すことによって、ファイル、または、ディレクトリの名前を変更する

⚫︎ renameToメソッドのパラメータは変更後のファイル名を持つ「File」インスタンスを指定する

⚫︎ renameToメソッドで正常に名前が変更された場合には「true」を返し、正常に名前が変更されなかった場合には「false」を返す

⚫︎ 名前変更後のファイル、または、ディレクトリがすでに存在する場合、Windows系の環境では名前の変更が行われず、「false」を返すが、Unix系の環境では上書きで名前が変更されて「true」が返す

⚫︎ renameToメソッドで指定したファイルが存在しない場合には「false」を返す

⚫︎ ファイル、または、ディレクトリの名前を変更できない場合は、例外が発生する

moveでファイル/ディレクトリの名前を変更

⚫︎ Filesクラスのmoveメソッドでファイル、または、ディレクトリの名前を変更することができる

⚫︎ moveメソッドはオ複数のプションをパラメータに指定できる

Writer
壷井

壷井

株式会社flyhawkの壷井です。フライテックメディア事業部でのメディア運営・ライター業務なども担当。愛機はMac Book AirとThinkPad。好きな言語:swift、JS系(Node.js等)。好きなサーバー:AWS。受託開発やプログラミングスクールの運営をしております。ご気軽にお問い合わせください。

最新の案件情報

フリーランスエンジニアの案件探し