openGionopenGion
5.7.0.0

org.opengion.hayabusa.servlet
クラス MultipartRequest

java.lang.Object
  上位を拡張 org.opengion.hayabusa.servlet.MultipartRequest

public final class MultipartRequest
extends java.lang.Object

ファイルをサーバーにアップロードする場合に使用されるマルチパート処理サーブレットです。 通常のファイルアップロード時の、form で使用する、enctype="multipart/form-data" を指定した場合の、他のリクエスト情報も、取り出すことが可能です。 ファイルをアップロード後に、指定のファイル名に変更する機能があります。 file 登録ダイアログで指定した name に、"_NEW" という名称を付けたリクエスト値を ファイルのアップロードと同時に送信することで、この名前にファイルを付け替えます。 また、アップロード後のファイル名は、name 指定の名称で、取り出せます。 クライアントから登録したオリジナルのファイル名は、name に、"_ORG" という名称 で取り出すことが可能です。 maxPostSize : 最大転送サイズ(Byte)を指定します。 0,またはマイナスで無制限です。 useBackup : ファイルアップロード時に、すでに同名のファイルが存在した場合に、 バックアップ処理(renameTo)するかどうか[true/false]を指定します(初期値:false) ファイルアップロード時に、アップロード先に、同名のファイルが存在した場合は、既存機能は、そのまま 置き換えていましたが、簡易バージョンアップ機能として、useBackup="true" を指定すると、既存のファイルを リネームして、バックアップファイルを作成します。 バックアップファイルは、アップロードフォルダを基準として、_backup/ファイル名.拡張子_処理時刻のlong値.拡張子 になります。 オリジナルのファイル名(拡張子付)を残したまま、"_処理時刻のlong値" を追加し、さらに、オリジナルの拡張子を追加します。 バックアップファイルの形式は指定できません。

機能分類
その他機能
バージョン
4.0
作成者
Kazuhiko Hasegawa
導入されたバージョン:
JDK5.0,

コンストラクタの概要
MultipartRequest(javax.servlet.http.HttpServletRequest request, java.lang.String saveDirectory, int maxPostSize, java.lang.String encoding, java.lang.String inputFilename, boolean useBackup)
          MultipartRequest オブジェクトを構築します。
 
メソッドの概要
 java.io.File getFile(java.lang.String name)
          指定の名前の UploadedFile オブジェクトから File オブジェクトを取得します。
 java.lang.String[] getFilenames()
          ファイルアップロードされたファイル群のファイル名配列を取得します。
 java.lang.String getFilesystemName(java.lang.String name)
          指定の名前の UploadedFile オブジェクトから 登録されるファイル名を取得します。
 int[] getIntParameters(java.lang.String name)
          指定の名前のリクエストパラメータの値を配列(int)型式で取得します。
 java.lang.String getOriginalFileName(java.lang.String name)
          指定の名前の UploadedFile オブジェクトから アップロードされたファイル名を取得します。
 java.lang.String getParameter(java.lang.String name)
          指定の名前のリクエストパラメータの値を取得します。
 java.lang.String[] getParameterNames()
          リクエストパラメータの名前配列を取得します。
 java.lang.String[] getParameters(java.lang.String name)
          指定の名前のリクエストパラメータの値を配列型式で取得します。
 
クラス java.lang.Object から継承されたメソッド
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
 

コンストラクタの詳細

MultipartRequest

public MultipartRequest(javax.servlet.http.HttpServletRequest request,
                        java.lang.String saveDirectory,
                        int maxPostSize,
                        java.lang.String encoding,
                        java.lang.String inputFilename,
                        boolean useBackup)
                 throws java.io.IOException
MultipartRequest オブジェクトを構築します。 引数として、ファイルアップロード時の保存フォルダ、最大サイズ、エンコード、 新しいファイル名などを指定できます。新しいファイル名は、アップロードされる ファイルが一つだけの場合に使用できます。複数のファイルを同時に変更したい 場合は、アップロードルールにのっとり、リクエストパラメータで指定してください。

パラメータ:
request - HttpServletRequestオブジェクト
saveDirectory - ファイルアップロードがあった場合の保存フォルダ名
maxPostSize - ファイルアップロード時の最大ファイルサイズ(Byte)0,またはマイナスで無制限
encoding - ファイルのエンコード
inputFilename - アップロードされたファイルの新しい名前
useBackup - ファイルアップロード時に、バックアップ処理するかどうか[true/false]を指定
例外:
java.io.IOException
変更履歴:
3.8.1.3A (2006/01/30) 新ファイル名にオリジナルファイル名の拡張子をセットします
4.0.0.0 (2007/11/28) メソッドの戻り値をチェックします。
5.5.2.6 (2012/05/25) findbugs対応。staticフィールドへの書き込みに、AtomicInteger を利用します。
5.6.5.3 (2013/06/28) useBackup引数追加
メソッドの詳細

getParameterNames

public java.lang.String[] getParameterNames()
リクエストパラメータの名前配列を取得します。

戻り値:
リクエストパラメータの名前配列

getFilenames

public java.lang.String[] getFilenames()
ファイルアップロードされたファイル群のファイル名配列を取得します。

戻り値:
アップロードされたファイル名配列

getParameter

public java.lang.String getParameter(java.lang.String name)
指定の名前のリクエストパラメータの値を取得します。

パラメータ:
name - リクエストパラメータ名
戻り値:
パラメータの値

getParameters

public java.lang.String[] getParameters(java.lang.String name)
指定の名前のリクエストパラメータの値を配列型式で取得します。

パラメータ:
name - リクエストパラメータ名
戻り値:
パラメータの値配列
変更履歴:
5.3.2.0 (2011/02/01) 新規作成

getIntParameters

public int[] getIntParameters(java.lang.String name)
指定の名前のリクエストパラメータの値を配列(int)型式で取得します。

パラメータ:
name - リクエストパラメータ名
戻り値:
パラメータの値配列
変更履歴:
5.3.2.0 (2011/02/01) 新規作成
5.3.6.0 (2011/06/01) 配列値が""の場合にNumberFormatExceptionが発生するバグを修正

getFilesystemName

public java.lang.String getFilesystemName(java.lang.String name)
指定の名前の UploadedFile オブジェクトから 登録されるファイル名を取得します。 登録されるファイル名とは、新たに書き換えられたファイル名のことです。

パラメータ:
name - キー情報
戻り値:
新たに書き換えられたファイル名
変更履歴:
5.6.6.1 (2013/07/12) null 対策

getOriginalFileName

public java.lang.String getOriginalFileName(java.lang.String name)
指定の名前の UploadedFile オブジェクトから アップロードされたファイル名を取得します。 アップロードされたファイル名とは、オリジナルのファイル名のことです。

パラメータ:
name - キー情報
戻り値:
オリジナルのファイル名
変更履歴:
5.6.6.1 (2013/07/12) null 対策

getFile

public java.io.File getFile(java.lang.String name)
指定の名前の UploadedFile オブジェクトから File オブジェクトを取得します。

パラメータ:
name - キー情報
戻り値:
Fileオブジェクト
変更履歴:
5.6.6.1 (2013/07/12) null 対策

openGion 5.7.0.0

Webアプリケーションフレームワーク openGion
SourceForge.JPCopyright (c) 2009 The openGion Project.