ファイルやディレクトリのコピー

ディレクトリのコピーは可能ですが、ディレクトリ内のファイルはコピーされません。このため、元のディレクトリにファイルが含まれている場合でも新しいディレクトリは空になります。

シンボリック・リンクをコピーする場合は、リンク先がコピーされます。 リンク先ではなくリンク自体をコピーするには、NOFOLLOW_LINKSオプションかREPLACE_EXISTINGオプションを指定します。

このメソッドは可変引数を取ります。 StandardCopyOption列挙型とLinkOption列挙型の次の定数を使用できます。

• REPLACE_EXISTING – コピー先ファイルがすでに存在する場合でもコピーを実行します。 コピー先がシンボリック・リンクの場合は、リンク自体がコピーされ、リンク先はコピーされません。 コピー先が空でないディレクトリの場合は、FileAlreadyExistsException例外が発生してコピーが失敗します。
• COPY_ATTRIBUTES – ファイルに関連付けられたファイル属性をコピー先ファイルにコピーします。 サポートされるファイル属性はファイル・システムおよびプラットフォームによって異なりますが、last-modified-timeはすべてのプラットフォームでサポートされ、コピー先ファイルにコピーされます。
• NOFOLLOW_LINKS – シンボリック・リンクをたどらないことを指定します。 つまり、コピー元のファイルがシンボリック・リンクの場合は、リンク自体がコピーされ、リンク先はコピーされません。

copyメソッドは、次のコードのように使用します。

import static java.nio.file.StandardCopyOption.*;
...
Files.copy(source, target, REPLACE_EXISTING);

Filesクラスには、ファイルのコピーだけでなく、ファイルとストリームの間でのコピーに使用できるメソッドも定義されています。 copy(InputStream, Path, CopyOptions...)メソッドを使用すると、入力ストリームからファイルにすべてのバイトをコピーできます。 copy(Path, OutputStream)メソッドを使用すると、ファイルから出力ストリームにすべてのバイトをコピーできます。

サンプルのCopyでは、copyメソッドとFiles.walkFileTreeメソッドを使用して、コピーを再帰的に行っています。 詳細は、『ファイル・ツリーの探索』を参照してください。