jp.co.intra_mart.foundation.service.client.file

インタフェース Storage<T extends Storage<T>>

型パラメータ:

T - Storageインタフェースを継承したクラス

すべてのスーパーインタフェース:

Comparable<T>, Serializable

既知の実装クラスのリスト:

AbstractStorage, AbstractSynchronizedStorage, BoxStorage, PublicStorage, SessionScopeStorage, SharePointStorage, SynchronizedPublicStorage, SynchronizedSystemStorage, SystemStorage

public interface Storage<T extends Storage<T>>
extends Serializable, Comparable<T>

Storageを扱うためのインタフェースを提供します。

導入されたバージョン:

8.0.0

バージョン:

8.0.12

フィールドのサマリー

フィールド

修飾子とタイプ	フィールドと説明
static Charset	CHARSET キャラセット
static String	FILE_SEPARATOR ファイルセパレータ
static char	FILE_SEPARATOR_CHAR ファイルセパレータ

メソッドのサマリー

修飾子とタイプ	メソッドと説明
OutputStream	append() このストレージの出力ストリームを追記モードで取得します。
void	append(CharSequence src) 文字列を標準のキャラセットでこのストレージに追記します。
void	append(CharSequence src, Charset charset) 文字列を指定されたキャラセットで変換しこのストレージに追記します。
void	append(CharSequence src, String charsetName) 文字列を指定されたキャラセット名で変換しこのストレージに追記します。
int	compareTo(T storage) 2 つのストレージを語彙的に比較します。
void	copy(T to, boolean overwrite) このファイル、またはディレクトリを引数で指定された対象にコピーします。
OutputStream	create() このストレージの出力ストリームを取得します。
Collection<String>	directories() このストレージが示すディレクトリの配下にあるディレクトリのパスのコレクションを返します。
Collection<String>	directories(boolean recursive) このストレージが示すディレクトリの配下にあるディレクトリのパスのコレクションを返します。
Collection<T>	directoriesStorages() このストレージが示すディレクトリ内のディレクトリを示すストレージのコレクションを返します。
Collection<T>	directoriesStorages(boolean recursive) このストレージが示すディレクトリ内のディレクトリを示すストレージのコレクションを返します。
boolean	equals(Object obj) このオブジェクトと「等価」になるオブジェクトがあるかどうかを示します。
boolean	exists() このストレージが示すファイルまたはディレクトリが存在するかどうかを判定します。
Collection<String>	files() このストレージが示すディレクトリの配下にあるファイルのパスのコレクションを返します。
Collection<String>	files(boolean recursive) このストレージが示すディレクトリの配下にあるファイルのパスのコレクションを返します。
Collection<T>	filesStorages() このストレージが示すディレクトリ内のファイルを示すストレージのコレクションを返します。
Collection<T>	filesStorages(boolean recursive) このストレージが示すディレクトリ内のファイルを示すストレージのコレクションを返します。
String	getCanonicalPath() 正規化したパスを返します。
String	getName() このストレージが示すファイルまたはディレクトリの名前を返します。
String	getParent() 親パスを返します。
T	getParentStorage() 親ストレージを返します。
String	getPath() パス名文字列を返します。
String	getRelativePath(T target) このストレージとの相対パスを返します。
T	getRootStorage() ルートストレージを返します。
int	hashCode() オブジェクトのハッシュコード値を返します。
boolean	isDirectory() このストレージが示すファイルがディレクトリであるかどうかを判定します。
boolean	isFile() このストレージが示すファイルが普通のファイルかどうかを判定します。
long	lastModified() このストレージが示すファイルが最後に変更された時刻を返します。
long	length() このストレージが指定されているファイルの長さを返します。
Collection<String>	list() このストレージが示すディレクトリの配下にあるファイル、および、ディレクトリのパスのコレクションを返します。
Collection<String>	list(boolean recursive) このストレージが示すディレクトリの配下にあるファイル、および、ディレクトリのパスのコレクションを返します。
Collection<String>	list(StoragenameFilter<T> filter) このストレージが示すディレクトリにあるファイルおよびディレクトリの中で、指定されたフィルタの基準を満たすもののパスのコレクションを返します。
Collection<T>	listStorages() このストレージが示すディレクトリ内のファイルおよびディレクトリを示すストレージのコレクションを返します。
Collection<T>	listStorages(boolean recursive) このストレージが示すディレクトリ内のファイルおよびディレクトリを示すストレージのコレクションを返します。
Collection<T>	listStorages(StorageFilter<T> filter) このストレージが示すディレクトリにあるファイルおよびディレクトリの中で、指定されたフィルタの基準を満たすもののストレージのコレクションを返します。
Collection<T>	listStorages(StoragenameFilter<T> filter) このストレージが示すディレクトリにあるファイルおよびディレクトリの中で、指定されたフィルタの基準を満たすもののストレージのコレクションを返します。
byte[]	load() このストレージの内容をバイト配列で取得します。
boolean	makeDirectories() このストレージが示すディレクトリを生成します。
boolean	move(CharSequence newPath) このストレージが示すファイルを移動します。
InputStream	open() このストレージの入力ストリームを取得します。
String	read() このストレージの内容を標準のキャラセットで変換し文字列で取得します。
String	read(Charset charset) このストレージの内容を指定されたキャラセットで変換し文字列で取得します。
String	read(String charsetName) このストレージの内容を指定されたキャラセット名で変換し文字列で取得します。
boolean	remove() このストレージが示すファイルまたはディレクトリを削除します。
boolean	remove(boolean recursive) このストレージが示すファイルまたはディレクトリを削除します。
T	resolve(CharSequence other) このストレージから相対ストレージを返します。
void	save(byte[] byteArray) バイト配列をこのストレージに書き込みます。
void	write(CharSequence src) 文字列を標準のキャラセットでこのストレージに書き込みます。
void	write(CharSequence src, Charset charset) 文字列を指定されたキャラセットでこのストレージに書き込みます。
void	write(CharSequence src, String charsetName) 文字列を指定されたキャラセット名でこのストレージに書き込みます。

フィールドの詳細

FILE_SEPARATOR_CHAR

static final char FILE_SEPARATOR_CHAR

ファイルセパレータ

関連項目:

定数フィールド値

FILE_SEPARATOR

static final String FILE_SEPARATOR

ファイルセパレータ

CHARSET

static final Charset CHARSET

キャラセット

メソッドの詳細

getName

String getName()

このストレージが示すファイルまたはディレクトリの名前を返します。

戻り値:

ファイルまたはディレクトリの名前

getRootStorage

T getRootStorage()
          throws IOException

ルートストレージを返します。

戻り値:

ルートストレージ

例外:

IOException - ルートストレージの取得に失敗した場合

getParent

String getParent()

親パスを返します。

戻り値:

親パス

getParentStorage

T getParentStorage()
            throws IOException

親ストレージを返します。

戻り値:

親ストレージ。このストレージがルートストレージだった場合は、null

例外:

IOException - 親ストレージの取得に失敗した場合

resolve

T resolve(CharSequence other)
   throws IOException

このストレージから相対ストレージを返します。

パラメータ:

other - このストレージからの相対パス

戻り値:

このストレージからの相対ストレージ

例外:

IOException - 相対ストレージの取得に失敗した場合

getPath

String getPath()

パス名文字列を返します。

戻り値:

パス名文字列

getCanonicalPath

String getCanonicalPath()
                 throws IOException

正規化したパスを返します。
パスをセパレータ（区切り文字）とセグメント（区切り文字の間の文字列）に分割し、解析を行い正規化されたパスを返します。
正規化されたパスでは、以下の特殊セグメントが解釈されたパスです。

• .
• ..

先頭および末尾に付与されているセパレータはトリムされます。

戻り値:

正規化したパス

例外:

IOException - 正規化したパスの取得に失敗した場合

getRelativePath

String getRelativePath(T target)
                throws IOException

このストレージとの相対パスを返します。

パラメータ:

target - 比較対象ストレージ

戻り値:

このストレージとの相対パスを返します。

例外:

IOException - 相対パスの取得に失敗した場合

exists

boolean exists()
        throws IOException

このストレージが示すファイルまたはディレクトリが存在するかどうかを判定します。

戻り値:

ファイルまたはディレクトリが存在する場合は true、そうでない場合は false

例外:

IOException - 判定に失敗した場合

isDirectory

boolean isDirectory()
             throws IOException

このストレージが示すファイルがディレクトリであるかどうかを判定します。

戻り値:

このストレージが示すファイルが存在し、さらにそれがディレクトリである場合は true、そうでない場合は false

例外:

IOException - 判定に失敗した場合

isFile

boolean isFile()
        throws IOException

このストレージが示すファイルが普通のファイルかどうかを判定します。ファイルは、それがディレクトリではなく、システムに依存するほかの基準を満たす場合に「普通」のファイルと見なされます。Java アプリケーションが生成したディレクトリ以外のファイルは、必ず普通のファイルです。

戻り値:

このストレージが示すファイルが存在し、さらにそれが普通のファイルである場合は true、そうでない場合は false

例外:

IOException - 判定に失敗した場合

lastModified

long lastModified()
           throws IOException

このストレージが示すファイルが最後に変更された時刻を返します。

戻り値:

ファイルが最後に変更された時刻を表す long 値。エポック (1970 年 1 月 1 日 0 時 0 分 0 秒、グリニッジ標準時) からミリ秒単位で測定。ファイルが存在しないか、入出力エラーが発生した場合は 0L

例外:

IOException - 取得に失敗した場合

length

long length()
     throws IOException

このストレージが指定されているファイルの長さを返します。パス名にディレクトリが指定されている場合、戻り値は指定されません。

戻り値:

このストレージが示すファイルの長さ (バイト単位)。ファイルが存在しない場合は 0L。一部のオペレーティングシステムでは、デバイスやパイプなどのシステム依存エンティティーを示すパス名について 0L を返すことがある

例外:

IOException - 取得に失敗した場合

list

Collection<String> list()
                 throws IOException

このストレージが示すディレクトリの配下にあるファイル、および、ディレクトリのパスのコレクションを返します。
パスは、このストレージのパスからの相対パスです。
このメソッドは、list(false)と動作は一緒です。

戻り値:

このストレージが示すディレクトリの配下にあるファイル、および、ディレクトリの相対パスのコレクション。コレクションは、ディレクトリが空の場合は空になります。このストレージがディレクトリを示さない場合は null

例外:

IOException - 取得に失敗した場合

list

Collection<String> list(boolean recursive)
                 throws IOException

このストレージが示すディレクトリの配下にあるファイル、および、ディレクトリのパスのコレクションを返します。
パスは、このストレージのパスからの相対パスです。

 ROOT
 ┗directory-1
   ┗directory-1-1
     ┣directory-1-1-1
     ┃┣directory-1-1-1-1
     ┃┗file-1-1-1-2
     ┣directory-1-1-2
     ┣file-1-1-3
     ┗file-1-1-4
 

上記のようなファイル構成である場合、
directory-1-1に対してlist(false)を実行した場合の戻り値は以下の通りです。

• directory-1-1-1
• directory-1-1-2
• file-1-1-3
• file-1-1-4

directory-1-1に対してlist(true)を実行した場合の戻り値は以下の通りです。

• directory-1-1-1
• directory-1-1-1/directory-1-1-1-1
• directory-1-1-1/file-1-1-1-2
• directory-1-1-2
• file-1-1-3
• file-1-1-4

パラメータ:

recursive - ディレクトリを再帰的に探索する場合は true、そうでない場合は false

戻り値:

このストレージが示すディレクトリの配下にあるファイル、および、ディレクトリの相対パスのコレクション。コレクションは、ディレクトリが空の場合は空になります。このストレージがディレクトリを示さない場合は null

例外:

IOException - 取得に失敗した場合

list

Collection<String> list(StoragenameFilter<T> filter)
                 throws IOException

このストレージが示すディレクトリにあるファイルおよびディレクトリの中で、指定されたフィルタの基準を満たすもののパスのコレクションを返します。

パラメータ:

filter - パスフィルタ

戻り値:

指定された filter によって受け入れられた、このストレージが示すディレクトリ内のファイルおよびディレクトリを示すパスのコレクション。コレクションは、ディレクトリが空の場合またはフィルタがどの名前も受け入れない場合は空になる 。このストレージがディレクトリを示さない場合、または入出力エラーが発生した場合は null

例外:

IOException - 取得に失敗した場合

listStorages

Collection<T> listStorages()
                    throws IOException

このストレージが示すディレクトリ内のファイルおよびディレクトリを示すストレージのコレクションを返します。

戻り値:

このストレージが示すディレクトリ内のファイルおよびディレクトリを示すストレージのコレクション。コレクションは、ディレクトリが空の場合は空になる。このストレージがディレクトリを示さない場合、または入出力エラーが発生した場合は null

例外:

IOException - 取得に失敗した場合

listStorages

Collection<T> listStorages(boolean recursive)
                    throws IOException

このストレージが示すディレクトリ内のファイルおよびディレクトリを示すストレージのコレクションを返します。

パラメータ:

recursive - ディレクトリを再帰的に探索する場合は true、そうでない場合は false

戻り値:

このストレージが示すディレクトリ内のファイルおよびディレクトリを示すストレージのコレクション。コレクションは、ディレクトリが空の場合は空になる。このストレージがディレクトリを示さない場合、または入出力エラーが発生した場合は null

例外:

IOException - 取得に失敗した場合

listStorages

Collection<T> listStorages(StoragenameFilter<T> filter)
                    throws IOException

このストレージが示すディレクトリにあるファイルおよびディレクトリの中で、指定されたフィルタの基準を満たすもののストレージのコレクションを返します。

パラメータ:

filter - ストレージフィルタ

戻り値:

このストレージが示すディレクトリ内のファイルおよびディレクトリを示すストレージのコレクション。コレクションは、ディレクトリが空の場合は空になる。このストレージがディレクトリを示さない場合、または入出力エラーが発生した場合は null

例外:

IOException - 取得に失敗した場合

listStorages

Collection<T> listStorages(StorageFilter<T> filter)
                    throws IOException

このストレージが示すディレクトリにあるファイルおよびディレクトリの中で、指定されたフィルタの基準を満たすもののストレージのコレクションを返します。

パラメータ:

filter - ストレージフィルタ

戻り値:

このストレージが示すディレクトリ内のファイルおよびディレクトリを示すストレージのコレクション。コレクションは、ディレクトリが空の場合は空になる。このストレージがディレクトリを示さない場合、または入出力エラーが発生した場合は null

例外:

IOException - 取得に失敗した場合

compareTo

int compareTo(T storage)

2 つのストレージを語彙的に比較します。

定義:

compareTo インタフェース内 Comparable<T extends Storage<T>>

パラメータ:

storage - このストレージと比較されるストレージ

戻り値:

引数がこのストレージと等しい場合は 0。このストレージが引数より語彙的に小さい場合は負の値。このストレージが引数より語彙的に大きい場合は正の値

関連項目:

Comparable.compareTo(java.lang.Object)

equals

boolean equals(Object obj)

このオブジェクトと「等価」になるオブジェクトがあるかどうかを示します。

オーバーライド:

equals クラス内 Object

パラメータ:

obj - 比較対象の参照オブジェクト

戻り値:

obj 引数に指定されたオブジェクトとこのオブジェクトが等しい場合は true、そうでない場合は false

hashCode

int hashCode()

オブジェクトのハッシュコード値を返します。

オーバーライド:

hashCode クラス内 Object

戻り値:

このオブジェクトのハッシュコード値

append

void append(CharSequence src)
     throws IOException

文字列を標準のキャラセットでこのストレージに追記します。

パラメータ:

src - 文字列

例外:

IOException - 追記に失敗した場合

append

void append(CharSequence src,
            String charsetName)
     throws IOException

文字列を指定されたキャラセット名で変換しこのストレージに追記します。

パラメータ:

src - 文字列

charsetName - キャラセット名

例外:

IOException - 追記に失敗した場合

append

void append(CharSequence src,
            Charset charset)
     throws IOException

文字列を指定されたキャラセットで変換しこのストレージに追記します。

パラメータ:

src - 文字列

charset - キャラセット

例外:

IOException - 追記に失敗した場合

directories

Collection<String> directories()
                        throws IOException

このストレージが示すディレクトリの配下にあるディレクトリのパスのコレクションを返します。
パスは、このストレージのパスからの相対パスです。
このメソッドは、directories(false)と動作は一緒です。

戻り値:

このストレージが示すディレクトリの配下にあるディレクトリの相対パスのコレクション。コレクションは、ディレクトリが空の場合は空になります。このストレージがディレクトリを示さない場合、または入出力エラーが発生した場合は null

例外:

IOException - 取得に失敗した場合

directories

Collection<String> directories(boolean recursive)
                        throws IOException

このストレージが示すディレクトリの配下にあるディレクトリのパスのコレクションを返します。
パスは、このストレージのパスからの相対パスです。

 ROOT
 ┗directory-1
   ┗directory-1-1
     ┣directory-1-1-1
     ┃┣directory-1-1-1-1
     ┃┗file-1-1-1-2
     ┣directory-1-1-2
     ┣file-1-1-3
     ┗file-1-1-4
 

上記のようなファイル構成である場合、
directory-1-1に対してdirectories(false)を実行した場合の戻り値は以下の通りです。

• directory-1-1-1
• directory-1-1-2

directory-1-1に対してdirectories(true)を実行した場合の戻り値は以下の通りです。

• directory-1-1-1
• directory-1-1-1/directory-1-1-1-1
• directory-1-1-2

パラメータ:

recursive - ディレクトリを再帰的に探索する場合は true、そうでない場合は false

戻り値:

このストレージが示すディレクトリの配下にあるディレクトリの相対パスのコレクション。コレクションは、ディレクトリが空の場合は空になります。このストレージがディレクトリを示さない場合、 または入出力エラーが発生した場合は null

例外:

IOException - 取得に失敗した場合

files

Collection<String> files()
                  throws IOException

このストレージが示すディレクトリの配下にあるファイルのパスのコレクションを返します。
パスは、このストレージのパスからの相対パスです。
このメソッドは、files(false)と動作は一緒です。

戻り値:

このストレージが示すディレクトリの配下にあるファイルの相対パスのコレクション。コレクションは、ディレクトリが空の場合は空になります。このストレージがディレクトリを示さない場合、または入出力エラーが発生した場合は null

例外:

IOException - 取得に失敗した場合

files

Collection<String> files(boolean recursive)
                  throws IOException

このストレージが示すディレクトリの配下にあるファイルのパスのコレクションを返します。
パスは、このストレージのパスからの相対パスです。

 ROOT
 ┗directory-1
   ┗directory-1-1
     ┣directory-1-1-1
     ┃┣directory-1-1-1-1
     ┃┗file-1-1-1-2
     ┣directory-1-1-2
     ┣file-1-1-3
     ┗file-1-1-4
 

上記のようなファイル構成である場合、
directory-1-1に対してfiles(false)を実行した場合の戻り値は以下の通りです。

• file-1-1-3
• file-1-1-4

directory-1-1に対してfiles(true)を実行した場合の戻り値は以下の通りです。

• directory-1-1-1/file-1-1-1-2
• file-1-1-3
• file-1-1-4

パラメータ:

recursive - ディレクトリを再帰的に探索する場合は true、そうでない場合は false

戻り値:

このストレージが示すディレクトリの配下にあるファイルの相対パスのコレクション。コレクションは、ディレクトリが空の場合は空になります。このストレージがディレクトリを示さない場合、または入出力エラーが発生した場合は null

例外:

IOException - 取得に失敗した場合

directoriesStorages

Collection<T> directoriesStorages()
                           throws IOException

このストレージが示すディレクトリ内のディレクトリを示すストレージのコレクションを返します。

戻り値:

このストレージが示すディレクトリ内のディレクトリを示すストレージのコレクション。コレクションは、ディレクトリが空の場合は空になる。このストレージがディレクトリを示さない場合、または入出力エラーが発生した場合は null

例外:

IOException - 取得に失敗した場合

directoriesStorages

Collection<T> directoriesStorages(boolean recursive)
                           throws IOException

このストレージが示すディレクトリ内のディレクトリを示すストレージのコレクションを返します。

パラメータ:

recursive - ディレクトリを再帰的に探索する場合は true、そうでない場合は false

戻り値:

このストレージが示すディレクトリ内のディレクトリを示すストレージのコレクション。コレクションは、ディレクトリが空の場合は空になる。このストレージがディレクトリを示さない場合、または入出力エラーが発生した場合は null

例外:

IOException - 取得に失敗した場合

filesStorages

Collection<T> filesStorages()
                     throws IOException

このストレージが示すディレクトリ内のファイルを示すストレージのコレクションを返します。

戻り値:

このストレージが示すディレクトリ内のファイルを示すストレージのコレクション。コレクションは、ディレクトリが空の場合は空になる。このストレージがディレクトリを示さない場合、または入出力エラーが発生した場合は null

例外:

IOException - 取得に失敗した場合

filesStorages

Collection<T> filesStorages(boolean recursive)
                     throws IOException

このストレージが示すディレクトリ内のファイルを示すストレージのコレクションを返します。

パラメータ:

recursive - ディレクトリを再帰的に探索する場合は true、そうでない場合は false

戻り値:

このストレージが示すディレクトリ内のファイルを示すストレージのコレクション。コレクションは、ディレクトリが空の場合は空になる。このストレージがディレクトリを示さない場合、または入出力エラーが発生した場合は null

例外:

IOException - 取得に失敗した場合

load

byte[] load()
     throws IOException

このストレージの内容をバイト配列で取得します。

戻り値:

ストレージの内容のバイト配列

例外:

IOException - 取得に失敗した場合

makeDirectories

boolean makeDirectories()
                 throws IOException

このストレージが示すディレクトリを生成します。

戻り値:

必要なすべての親ディレクトリを含めてディレクトリが生成された場合は true、そうでない場合は false

例外:

IOException - 作成に失敗した場合

move

boolean move(CharSequence newPath)
      throws IOException

このストレージが示すファイルを移動します。

パラメータ:

newPath - このストレージの新しいパス

戻り値:

移動が成功した場合は true、そうでない場合は false

例外:

IOException - 移動に失敗した場合

read

String read()
     throws IOException

このストレージの内容を標準のキャラセットで変換し文字列で取得します。

戻り値:

ストレージの内容の文字列

例外:

IOException - 取得に失敗した場合

read

String read(String charsetName)
     throws IOException

このストレージの内容を指定されたキャラセット名で変換し文字列で取得します。

パラメータ:

charsetName - キャラセット名

戻り値:

ストレージの内容の文字列

例外:

IOException - 取得に失敗した場合

read

String read(Charset charset)
     throws IOException

このストレージの内容を指定されたキャラセットで変換し文字列で取得します。

パラメータ:

charset - キャラセット

戻り値:

ストレージの内容の文字列

例外:

IOException - 取得に失敗した場合

remove

boolean remove()
        throws IOException

このストレージが示すファイルまたはディレクトリを削除します。 このメソッドは再帰的な削除は行いません。

戻り値:

ファイルまたはディレクトリが正常に削除された場合は true、そうでない場合は false

例外:

IOException - 削除に失敗した場合

remove

boolean remove(boolean recursive)
        throws IOException

このストレージが示すファイルまたはディレクトリを削除します。

パラメータ:

recursive - 再帰的に削除する場合はtrueを指定してください

戻り値:

ファイルまたはディレクトリが正常に削除された場合は true、そうでない場合は false

例外:

IOException - 削除に失敗した場合

save

void save(byte[] byteArray)
   throws IOException

バイト配列をこのストレージに書き込みます。

パラメータ:

byteArray - バイト配列

例外:

IOException - 書き込みに失敗した場合

write

void write(CharSequence src)
    throws IOException

文字列を標準のキャラセットでこのストレージに書き込みます。

パラメータ:

src - 文字列

例外:

IOException - 書き込みに失敗した場合

write

void write(CharSequence src,
           String charsetName)
    throws IOException

文字列を指定されたキャラセット名でこのストレージに書き込みます。

パラメータ:

src - 文字列

charsetName - キャラセット名

例外:

IOException - 書き込みに失敗した場合

write

void write(CharSequence src,
           Charset charset)
    throws IOException

文字列を指定されたキャラセットでこのストレージに書き込みます。

パラメータ:

src - 文字列

charset - キャラセット

例外:

IOException - 書き込みに失敗した場合

open

InputStream open()
          throws IOException

このストレージの入力ストリームを取得します。

戻り値:

入力ストリーム

例外:

IOException - 入力ストリームの取得に失敗した場合

create

OutputStream create()
             throws IOException

このストレージの出力ストリームを取得します。

戻り値:

出力ストリーム

例外:

IOException - 出力ストリームの取得に失敗した場合

append

OutputStream append()
             throws IOException

このストレージの出力ストリームを追記モードで取得します。

戻り値:

出力ストリーム

例外:

IOException - 出力ストリームの取得に失敗した場合

copy

void copy(T to,
          boolean overwrite)
   throws IOException

このファイル、またはディレクトリを引数で指定された対象にコピーします。
このインスタンスが存在しない場合:

• IOException(FileNotFoundException)がスローされます。

このインスタンスがファイルの場合:

• toが存在しない場合はtoに対してコピーを行います。
• toがファイルの場合は、引数overwriteに従います。
• toがディレクトリの場合はIOExceptionがスローされます。

このインスタンスがディレクトリの場合:

• toが存在しない場合はtoディレクトリを作成し、コピーを行います。
• toがファイルの場合はIOExceptionがスローされます。
• toがディレクトリの場合、かつtoディレクトリ配下にファイルまたはフォルダが存在した場合は引数overwiteに従います。
  このインスタンス配下のファイルと同名の階層のフォルダがコピー先に存在した場合はIOExceptionがスローされます。
• toがディレクトリの場合、かつtoディレクトリ配下にファイルまたはフォルダが存在していない場合はこのインスタンス配下のファイルまたはディレクトリをtoディレクトリ配下にコピーします。
• toがディレクトリの場合、かつこのインスタンス配下のファイルと一致しないファイルがtoディレクトリ配下に存在した場合は、そのファイルに対しては何も行われません。
  (mergeする動作となります、削除が必要な場合はコピー先に対してremove(boolean)を呼び出した後このメソッドを実行して下さい)

パラメータ:

to - コピー先

overwrite - trueの場合上書きします

例外:

IOException - コピーに失敗した場合