devpia.dextupload
Class FileItem

java.lang.Object
  devpia.dextupload.ErrorManager
      devpia.dextupload.FileItem

public class FileItem

extends devpia.dextupload.ErrorManager

ユーザーが転送したファイルアイテムを管理するクラスです。 ひとつの[FileItem]オブジェクトはひとつの転送されたファイルアイテムを意味します。

Method Summary

void	DeleteSavedFiles() [FileItem]の[Save()]メソッドで保存した全てのファイルを削除します。
java.io.File	getFile() [DefaultPath]に保存された一時ファイルの[File]を返します。
java.lang.String	getFileName() アップロードされたファイル名を求めます。
java.lang.String	GetFileNameWithoutExt() [FileItem]オブジェクトに保存されたファイル名を拡張子を除いて求めます。
java.lang.String	getFormName() ファイルアイテムのフォーム名を求めます。
java.io.InputStream	getInputStream() [DefaultPath]に保存された一時ファイルの[InputStream]を返します。
java.lang.String	getLastSavedFileName() [Save()]メソッドなどを使って最後に保存されたファイルの名前を求めます。
java.lang.String	getLastSavedFilePath() [Save()]メソッドなどを使って最後に保存されたファイルのパスを求めます。
java.lang.String	getMimeType() アップロードされたファイルのMimeTypeの値を求めます。
java.lang.String	getValue() アップロードされたファイルの全体の名前
boolean	IsMoved() アップロードされた一時ファイルが[Save()]メソッドを使って他のフォルダに移動されたかどうかを確認します。
boolean	IsUploaded() ブラウザから実際にファイルがアップロードされたかどうかを判断します。
int	length() ファイルサイズをbyte単位で求めます。
java.lang.String	Save(java.lang.String TargetPath, boolean Overwrite) アップロードされたファイルを元来のファイル名と同じ名前で指定のパスに移動します。
java.lang.String	Save(java.lang.String TargetPath, boolean Overwrite, boolean Copy) アップロードされたファイルを元来のファイル名と同じ名前で指定のパスに移動します。
java.lang.String	SaveAs(java.lang.String TargetName, boolean Overwrite) アップロードされたファイルを指定のファイル名で指定のパスに移動します。
java.lang.String	SaveAs(java.lang.String TargetName, boolean Overwrite, boolean Copy) アップロードされたファイルを指定のファイル名で指定のパスに移動します。
java.lang.String	SaveAs(java.lang.String TargetPath, java.lang.String TargetName, boolean Overwrite) アップロードされたファイルを指定のファイル名で指定のパスに移動します。
java.lang.String	SaveAs(java.lang.String TargetPath, java.lang.String TargetName, boolean Overwrite, boolean Copy) アップロードされたファイルを指定のファイル名で指定のパスに移動します。
java.lang.String	SaveAsVirtual(java.lang.String VirtualName, boolean Overwrite) アップロードされたファイルを指定のファイル名で指定のバーチャルパスに移動します。
java.lang.String	SaveAsVirtual(java.lang.String VirtualName, boolean Overwrite, boolean Copy) アップロードされたファイルを指定のファイル名で指定のバーチャルパスに移動します。
java.lang.String	SaveAsVirtual(java.lang.String VirtualPath, java.lang.String TargetName, boolean Overwrite) アップロードされたファイルを指定のファイル名で指定のバーチャルパスに移動します。
java.lang.String	SaveAsVirtual(java.lang.String VirtualPath, java.lang.String TargetName, boolean Overwrite, boolean Copy) アップロードされたファイルを指定のファイル名で指定のバーチャルパスに移動します。
java.lang.String	SaveVirtual(java.lang.String VirtualPath, boolean Overwrite) アップロードされたファイルを元来のファイル名と同じ名前で指定のバーチャルパスに移動します。
java.lang.String	SaveVirtual(java.lang.String VirtualPath, boolean Overwrite, boolean Copy) アップロードされたファイルを元来のファイル名と同じ名前で指定のバーチャルパスに移動します。

Methods inherited from class java.lang.Object

equals, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Method Detail

length

public int length()

ファイルサイズをbyte単位で求めます。

Returns:

ファイルサイズ

getFormName

public java.lang.String getFormName()

ファイルアイテムのフォーム名を求めます。

Returns:

ファイルアイテムのフォーム名

getFileName

public java.lang.String getFileName()

アップロードされたファイル名を求めます。

Returns:

アップロードされたファイル名

getValue

public java.lang.String getValue()

アップロードされたファイルの全体の名前 [FileUpload]オブジェクトの[getParameter()]メソッドと同じ値を返します。

Returns:

アップロードされたファイルの全体の名前

See Also:

FileUpload.getParameter(java.lang.String)

getLastSavedFileName

public java.lang.String getLastSavedFileName()
                                      throws DEXTUploadException

[Save()]メソッドなどを使って最後に保存されたファイルの名前を求めます。

Returns:

保存されたファイルの名前

Throws:

DEXTUploadException

See Also:

Save(String, boolean), SaveAs(String, boolean), SaveVirtual(String, boolean), SaveAsVirtual(String, boolean)

getLastSavedFilePath

public java.lang.String getLastSavedFilePath()
                                      throws DEXTUploadException

[Save()]メソッドなどを使って最後に保存されたファイルのパスを求めます。

Returns:

保存されたファイルのパス

Throws:

DEXTUploadException

See Also:

Save(String, boolean), SaveAs(String, boolean), SaveVirtual(String, boolean), SaveAsVirtual(String, boolean)

getMimeType

public java.lang.String getMimeType()

アップロードされたファイルのMimeTypeの値を求めます。

Returns:

アップロードされたファイルのMimeType値

getFile

public java.io.File getFile()
                     throws DEXTUploadException,
                            java.io.IOException

[DefaultPath]に保存された一時ファイルの[File]を返します。 [Save()]メソッドなどを使って移動された場合は[null]を返します。

Returns:

一時ファイルの[File]

Throws:

DEXTUploadException

java.io.IOException

See Also:

Save(String, boolean), SaveAs(String, boolean), SaveVirtual(String, boolean), SaveAsVirtual(String, boolean)

getInputStream

public java.io.InputStream getInputStream()
                                   throws DEXTUploadException,
                                          java.io.FileNotFoundException,
                                          java.io.IOException

[DefaultPath]に保存された一時ファイルの[InputStream]を返します。 [Save()]メソッドなどを使って移動された場合は[null]を返します。 主にBLOBでDBに保存する際に使用します。

Returns:

保存された一時ファイルの[InputStream]

Throws:

DEXTUploadException

java.io.FileNotFoundException

java.io.IOException

GetFileNameWithoutExt

public java.lang.String GetFileNameWithoutExt()

[FileItem]オブジェクトに保存されたファイル名を拡張子を除いて求めます。

Returns:

拡張子を除いたファイル名

Save

public java.lang.String Save(java.lang.String TargetPath,
                             boolean Overwrite,
                             boolean Copy)
                      throws DEXTUploadException,
                             java.io.IOException

アップロードされたファイルを元来のファイル名と同じ名前で指定のパスに移動します。

Parameters:

TargetPath - アップロードされたファイルの保存パス

Overwrite - 同一のファイルが存在する場合の処理　True=ファイルを上書きする/　False=ファイルを保存しない

Copy - 一時ファイルを移動せずにコピーします。(コピーは性能が落ちますが、ファイルを数ヶ所に保存することができます。)

Returns:

保存されたファイルのパス(ファイル名を含む)

Throws:

DEXTUploadException

java.io.IOException

See Also:

SaveAs(String, boolean, boolean), SaveVirtual(String, boolean, boolean), SaveAsVirtual(String, boolean, boolean)

Save

public java.lang.String Save(java.lang.String TargetPath,
                             boolean Overwrite)
                      throws DEXTUploadException,
                             java.io.IOException

アップロードされたファイルを元来のファイル名と同じ名前で指定のパスに移動します。

Parameters:

TargetPath - アップロードされたファイルの保存パス

Overwrite - 同一のファイルが存在する場合の処理　True=ファイルを上書きする/　False=ファイルを保存しない

Returns:

保存されたファイルのパス(ファイル名を含む)

Throws:

DEXTUploadException

java.io.IOException

See Also:

SaveAs(String, boolean), SaveVirtual(String, boolean), SaveAsVirtual(String, boolean)

SaveAs

public java.lang.String SaveAs(java.lang.String TargetName,
                               boolean Overwrite)
                        throws DEXTUploadException,
                               java.io.IOException

アップロードされたファイルを指定のファイル名で指定のパスに移動します。

Parameters:

TargetName - アップロードされたファイルの保存パス(ファイル名を含む)

Overwrite - 同一のファイルが存在する場合の処理　True=ファイルを上書きする/　False=ファイルを保存しない

Returns:

保存されたファイルのパス(ファイル名を含む)

Throws:

DEXTUploadException

java.io.IOException

See Also:

Save(String, boolean), SaveVirtual(String, boolean), SaveAsVirtual(String, boolean)

SaveAs

public java.lang.String SaveAs(java.lang.String TargetPath,
                               java.lang.String TargetName,
                               boolean Overwrite)
                        throws DEXTUploadException,
                               java.io.IOException

アップロードされたファイルを指定のファイル名で指定のパスに移動します。

Parameters:

TargetPath - アップロードされたファイルの保存パス

TargetName - 保存する新しいファイル明転

Overwrite - 同一のファイルが存在する場合の処理　True=ファイルを上書きする/　False=ファイルを保存しない

Returns:

保存されたファイルのパス(ファイル名を含む)

Throws:

DEXTUploadException

java.io.IOException

See Also:

Save(String, boolean), SaveVirtual(String, boolean), SaveAsVirtual(String, boolean)

SaveAs

public java.lang.String SaveAs(java.lang.String TargetPath,
                               java.lang.String TargetName,
                               boolean Overwrite,
                               boolean Copy)
                        throws DEXTUploadException,
                               java.io.IOException

アップロードされたファイルを指定のファイル名で指定のパスに移動します。

Parameters:

TargetPath - アップロードされたファイルの保存パス

TargetName - 保存する新しいファイル明転

Overwrite - 同一のファイルが存在する場合の処理　True=ファイルを上書きする/　False=ファイルを保存しない

Copy - 一時ファイルを移動せずにコピーします。(コピーは性能が落ちますが、ファイルを数ヶ所に保存することができます。)

Returns:

保存されたファイルのパス(ファイル名を含む)

Throws:

DEXTUploadException

java.io.IOException

See Also:

Save(String, boolean), SaveVirtual(String, boolean), SaveAsVirtual(String, boolean)

SaveAs

public java.lang.String SaveAs(java.lang.String TargetName,
                               boolean Overwrite,
                               boolean Copy)
                        throws DEXTUploadException,
                               java.io.IOException

アップロードされたファイルを指定のファイル名で指定のパスに移動します。

Parameters:

TargetName - アップロードされたファイルの保存パス(ファイル名を含む)

Overwrite - 同一のファイルが存在する場合の処理　True=ファイルを上書きする/　False=ファイルを保存しない

Copy - 一時ファイルを移動せずにコピーします。(コピーは性能が落ちますが、ファイルを数ヶ所に保存することができます。)

Returns:

保存されたファイルのパス(ファイル名を含む)

Throws:

DEXTUploadException

java.io.IOException

See Also:

Save(String, boolean, boolean), SaveVirtual(String, boolean, boolean), SaveAsVirtual(String, boolean, boolean)

SaveVirtual

public java.lang.String SaveVirtual(java.lang.String VirtualPath,
                                    boolean Overwrite)
                             throws DEXTUploadException,
                                    java.io.IOException

アップロードされたファイルを元来のファイル名と同じ名前で指定のバーチャルパスに移動します。

Parameters:

VirtualPath - アップロードされたファイルを保存する仮想パス

Overwrite - 同一のファイルが存在する場合の処理　True=ファイルを上書きする/　False=ファイルを保存しない

Returns:

保存されたファイルのパス(ファイル名を含む)

Throws:

DEXTUploadException

java.io.IOException

See Also:

Save(String, boolean), SaveAs(String, boolean), SaveAsVirtual(String, boolean)

SaveVirtual

public java.lang.String SaveVirtual(java.lang.String VirtualPath,
                                    boolean Overwrite,
                                    boolean Copy)
                             throws DEXTUploadException,
                                    java.io.IOException

アップロードされたファイルを元来のファイル名と同じ名前で指定のバーチャルパスに移動します。

Parameters:

VirtualPath - アップロードされたファイルを保存する仮想パス

Overwrite - 同一のファイルが存在する場合の処理　True=ファイルを上書きする/　False=ファイルを保存しない

Copy - 一時ファイルを移動せずにコピーします。(コピーは性能が落ちますが、ファイルを数ヶ所に保存することができます。)

Returns:

保存されたファイルのパス(ファイル名を含む)

Throws:

DEXTUploadException

java.io.IOException

See Also:

Save(String, boolean, boolean), SaveAs(String, boolean, boolean), SaveAsVirtual(String, boolean, boolean)

SaveAsVirtual

public java.lang.String SaveAsVirtual(java.lang.String VirtualName,
                                      boolean Overwrite)
                               throws DEXTUploadException,
                                      java.io.IOException

アップロードされたファイルを指定のファイル名で指定のバーチャルパスに移動します。

Parameters:

VirtualName - アップロードされたファイルを保存する仮想パス(ファイル名を含む)

Overwrite - 同一のファイルが存在する場合の処理　True=ファイルを上書きする/　False=ファイルを保存しない

Returns:

保存されたファイルのパス(ファイル名を含む)

Throws:

DEXTUploadException

java.io.IOException

See Also:

Save(String, boolean), SaveAs(String, boolean), SaveVirtual(String, boolean)

SaveAsVirtual

public java.lang.String SaveAsVirtual(java.lang.String VirtualName,
                                      boolean Overwrite,
                                      boolean Copy)
                               throws DEXTUploadException,
                                      java.io.IOException

アップロードされたファイルを指定のファイル名で指定のバーチャルパスに移動します。

Parameters:

VirtualName - アップロードされたファイルを保存する仮想パス(ファイル名を含む)

Overwrite - 同一のファイルが存在する場合の処理　True=ファイルを上書きする/　False=ファイルを保存しない

Copy - 一時ファイルを移動せずにコピーします。(コピーは性能が落ちますが、ファイルを数ヶ所に保存することができます。)

Returns:

保存されたファイルのパス(ファイル名を含む)

Throws:

DEXTUploadException

java.io.IOException

See Also:

Save(String, boolean, boolean), SaveAs(String, boolean, boolean), SaveVirtual(String, boolean, boolean)

SaveAsVirtual

public java.lang.String SaveAsVirtual(java.lang.String VirtualPath,
                                      java.lang.String TargetName,
                                      boolean Overwrite)
                               throws DEXTUploadException,
                                      java.io.IOException

アップロードされたファイルを指定のファイル名で指定のバーチャルパスに移動します。

Parameters:

VirtualPath - アップロードされたファイルを保存する仮想パス

TargetName - 保存する新しいファイル明転

Overwrite - 同一のファイルが存在する場合の処理　True=ファイルを上書きする/　False=ファイルを保存しない

Returns:

保存されたファイルのパス(ファイル名を含む)

Throws:

DEXTUploadException

java.io.IOException

See Also:

Save(String, boolean), SaveAs(String, boolean), SaveVirtual(String, boolean)

SaveAsVirtual

public java.lang.String SaveAsVirtual(java.lang.String VirtualPath,
                                      java.lang.String TargetName,
                                      boolean Overwrite,
                                      boolean Copy)
                               throws DEXTUploadException,
                                      java.io.IOException

アップロードされたファイルを指定のファイル名で指定のバーチャルパスに移動します。

Parameters:

VirtualPath - アップロードされたファイルを保存する仮想パス

TargetName - 保存する新しいファイル明転

Overwrite - 同一のファイルが存在する場合の処理　True=ファイルを上書きする/　False=ファイルを保存しない

Copy - 一時ファイルを移動せずにコピーします。(コピーは性能が落ちますが、ファイルを数ヶ所に保存することができます。)

Returns:

保存されたファイルのパス(ファイル名を含む)

Throws:

DEXTUploadException

java.io.IOException

See Also:

Save(String, boolean, boolean), SaveAs(String, boolean, boolean), SaveVirtual(String, boolean, boolean)

IsUploaded

public boolean IsUploaded()

ブラウザから実際にファイルがアップロードされたかどうかを判断します。 ファイルを選択せずにsubmitする場合、このメソッドは[False]をリターンします。

Returns:

実際にファイルがアップロードされたかどうかを表示

IsMoved

public boolean IsMoved()

アップロードされた一時ファイルが[Save()]メソッドを使って他のフォルダに移動されたかどうかを確認します。 この値が[True]の場合はもう[Save()]メソッドを使えません。

Returns:

一時ファイルが移動されたかどうかを表示

DeleteSavedFiles

public void DeleteSavedFiles()

[FileItem]の[Save()]メソッドで保存した全てのファイルを削除します。