devpia.dextuploadnj
Class FileSaveOption
- サポートされる最小バージョン
- 2.7.0
- 最小サポート環境
- JRE 1.6
- 説明
-
一時ファイルの保存に必要なオプションを設定するクラスです。
既存のFileItem.save/saveAsオーバーロードメソッドを使用して一時ファイルを保存する場合は、パラメーターを個別に設定するのではなく、FileSaveOptionを使用することをお勧めします。 バージョン2.7.0以降に追加されたすべてのオプションは、FileSaveOptionを介してのみ設定されます。 たとえば、nfcなどのオプションの場合、FileSaveOptionを使用してのみ設定できます。
// 古い方法 item.saveAs("/home/user/others/", "uploaded_file.txt"); // FileSaveOptionの使用 FileSaveOption option = new FileSaveOption(); option.setTargetDirectoryPath("/home/user/others/"); option.setTargetFilename("uploaded_file.txt"); item.save(option); - コンストラクタ
-
FileSaveOption
- Creates an instance of the FileSaveOption class.
-
形式
public FileSaveOption() public FileSaveOption(String targetDirectoryPath, String targetFilename, boolean overwrite, boolean copy, boolean nfc)
-
パラメータ
名前 形式 説明 targetDirectoryPath java.lang.String ファイルを保存するためのディレクトリパス targetFilename java.lang.String 一時ファイルを保存するときに使用するファイル名 overwrite boolean 重複ファイルを上書きするかどうか copy boolean 一時ファイルを削除するかどうか nfc boolean Unicode正規化形式に変更するかどうか
- メソッド
-
getTargetDirectoryPath
- ファイルを保存するためのディレクトリパスを返します
-
形式
public String getTargetDirectoryPath()
-
リターン
ディレクトリパス
setTargetDirectoryPath
-
ファイルを保存するためのディレクトリパスを設定します。
-
形式
public void setTargetDirectoryPath(String targetDirectoryPath)
-
パラメータ
名前 形式 説明 targetDirectoryPath java.lang.String ディレクトリパス -
使い方
FileSaveOption option = new FileSaveOption(); option.setTargetDirectoryPath("/home/user/others/");
getTargetFilename
- 一時ファイルの保存時に使用するファイル名を返します。
-
形式
public String getTargetFilename()
-
リターン
ファイル名
setTargetFilename
-
一時ファイルの保存時に使用するファイル名を設定します。
-
形式
public void setTargetFilename(String targetFilename)
-
パラメータ
名前 形式 説明 targetFilename java.lang.String ファイル名 -
使い方
FileSaveOption option = new FileSaveOption(); option.setTargetFilename("uploaded_file.txt");
isOverwrite
-
重複ファイルを上書きするかどうかを返します。
-
形式
public boolean isOverwrite()
-
リターン
trueまたはfalse(デフォルト)
setOverwrite
-
重複ファイルを上書きするかどうかを設定します。
DEXTUploadNJがファイルを保存するときに、同じファイル名の重複ファイルがある場合、サフィックス値がファイル名に自動的に追加されます。 ただし、Webのように多数のリクエストを同時に処理するシステムの場合、サフィックス値でも非常に短時間で重複する可能性があります。そのため、overwrite引数の値がfalseであっても、ファイルの書き込みに失敗する場合があります。 このような事態をできるだけ回避するために、ファイルを保存するときは、元のファイル名をそのまま保存せずに、重複する名前ができるだけ発生しないようにファイル名を変更する必要があります。
-
形式
public void setOverwrite(boolean overwrite)
-
パラメータ
名前 形式 説明 overwrite boolean trueまたはfalse -
使い方
FileSaveOption option = new FileSaveOption(); option.setOverwrite(true);
isCopy
-
一時ファイルを削除するかどうかを返します。
-
形式
public boolean isCopy()
-
リターン
trueまたはfalse(デフォルト)
setCopy
-
一時ファイルを削除するかどうかを設定します。
DEXTUploadNJは、ファイルを保存した直後に一時ファイルを削除します。 したがって、FileItem.saveメソッドを複数回呼び出して使用することはできません。 一時ファイルを削除せずに保持したい場合は、copyプロパティをtrueに設定できます。
-
形式
public void setCopy(boolean copy)
-
パラメータ
名前 形式 説明 copy boolean trueまたはfalse -
使い方
FileSaveOption option = new FileSaveOption(); option.setCopy(true);
isNfc
-
ファイル名がnfcUnicode正規化形式に変更されたかどうかを返します。
-
形式
public boolean isNfc()
-
リターン
trueまたはfalse(デフォルト)
setNfc
-
ファイル名をnfcUnicode正規化形式に変更するかどうかを設定します。
Windows / Linuxとは異なり、macOSでは、ファイル名またはディレクトリ名はnfd標準形式で管理されます。 macOSとWindows/Linuxの間の名前の互換性のために、nfcの変更が必要な場合は、nfcプロパティをtrueに設定できます。
-
形式
public void setNfc(boolean nfc)
-
パラメータ
名前 形式 説明 nfc boolean trueまたはfalse -
使い方
FileSaveOption option = new FileSaveOption(); option.setNfc(true);