クラス MultipartRequest
- java.lang.Object
-
- org.opengion.hayabusa.servlet.MultipartRequest
-
public final class MultipartRequest extends 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値" を追加し、さらに、オリジナルの拡張子を追加します。 バックアップファイルの形式は指定できません。 5.7.1.2 (2013/12/20) zip 対応 filename 属性に、".zip" の拡張子のファイル名を指定した場合は、アップロードされた一連のファイルを ZIP圧縮します。これは、アップロード後の処理になります。 ZIP圧縮のオリジナルファイルは、そのまま残ります。 なお、ZIPファイルは、useBackup属性を true に設定しても、無関係に、上書きされます。- 導入されたバージョン:
- JDK5.0,
-
-
メソッドの概要
すべてのメソッド インスタンス・メソッド concreteメソッド 修飾子とタイプ メソッド 説明 int[]
getIntParameters(String name)
指定の名前のリクエストパラメータの値を配列(int)型式で取得します。String
getParameter(String name)
指定の名前のリクエストパラメータの値を取得します。String[]
getParameterNames()
リクエストパラメータの名前配列を取得します。String[]
getParameters(String name)
指定の名前のリクエストパラメータの値を配列型式で取得します。UploadedFile[]
getUploadedFile()
ファイルアップロードされたファイル群のファイル配列を取得します。
-
-
-
コンストラクタの詳細
-
MultipartRequest
public MultipartRequest(javax.servlet.http.HttpServletRequest request, String saveDirectory, int maxPostSize, String encoding, String inputFilename, String useBackup, String fileURL) throws IOException, IllegalArgumentException
MultipartRequest オブジェクトを構築します。 引数として、ファイルアップロード時の保存フォルダ、最大サイズ、エンコード、 新しいファイル名などを指定できます。新しいファイル名は、アップロードされる ファイルが一つだけの場合に使用できます。複数のファイルを同時に変更したい 場合は、アップロードルールにのっとり、リクエストパラメータで指定してください。 HTML5 では、ファイルアップロード時に、multiple 属性(inputタグのtype="file")を 付ける事で、ファイルを複数選択できます。 その場合は、inputのname属性は、一つなので、_NEW による名前の書き換えはできません。- パラメータ:
request
- HttpServletRequestオブジェクトsaveDirectory
- ファイルアップロードがあった場合の保存フォルダ名maxPostSize
- ファイルアップロード時の最大ファイルサイズ(Byte)0,またはマイナスで無制限encoding
- ファイルのエンコードinputFilename
- アップロードされたファイルの新しい名前useBackup
- ファイルアップロード時に、バックアップ処理するかどうか[true/false/rename]を指定fileURL
- クラウドストレージ用のURL- 例外:
IOException
- 入出力エラーが発生したときIllegalArgumentException
- セーブディレクトリ に関係するエラー
-
-
メソッドの詳細
-
getParameterNames
public String[] getParameterNames()
リクエストパラメータの名前配列を取得します。- 戻り値:
- リクエストパラメータの名前配列
-
getUploadedFile
public UploadedFile[] getUploadedFile()
ファイルアップロードされたファイル群のファイル配列を取得します。- 戻り値:
- アップロードされたファイル群
-
getParameter
public String getParameter(String name)
指定の名前のリクエストパラメータの値を取得します。 複数存在する場合は、一番最後の値を返します。- パラメータ:
name
- リクエストパラメータ名- 戻り値:
- パラメータの値
-
getParameters
public String[] getParameters(String name)
指定の名前のリクエストパラメータの値を配列型式で取得します。- パラメータ:
name
- リクエストパラメータ名- 戻り値:
- パラメータの値配列(存在しない場合は、長さ0の配列を返します)
-
getIntParameters
public int[] getIntParameters(String name)
指定の名前のリクエストパラメータの値を配列(int)型式で取得します。- パラメータ:
name
- リクエストパラメータ名- 戻り値:
- パラメータの値配列(存在しない場合は、長さ0の配列を返します)
-
-