com.oreilly.servlet

类 MultipartRequest

java.lang.Object

com.oreilly.servlet.MultipartRequest

public class MultipartRequest
extends Object

A utility class to handle multipart/form-data requests, the kind of requests that support file uploads. This class emulates the interface of HttpServletRequest, making it familiar to use. It uses a "push" model where any incoming files are read and saved directly to disk in the constructor. If you wish to have more flexibility, e.g. write the files to a database, use the "pull" model MultipartParser instead.

This class can receive arbitrarily large files (up to an artificial limit you can set), and fairly efficiently too. It cannot handle nested data (multipart content within multipart content). It can now with the latest release handle internationalized content (such as non Latin-1 filenames).

To avoid collisions and have fine control over file placement, there's a constructor variety that takes a pluggable FileRenamePolicy implementation. A particular policy can choose to rename or change the location of the file before it's written.

See the included upload.war for an example of how to use this class.

The full file upload specification is contained in experimental RFC 1867, available at http://www.ietf.org/rfc/rfc1867.txt.

版本:

1.12, 2004/04/11, added null check for Opera malformed bug
, 1.11, 2002/11/01, combine query string params in param list
, 1.10, 2002/05/27, added access to the original file names
, 1.9, 2002/04/30, added support for file renaming, thanks to Changshin Lee
, 1.8, 2002/04/30, added support for internationalization, thanks to Changshin Lee
, 1.7, 2001/02/07, made fields protected to increase user flexibility
, 1.6, 2000/07/21, redid internals to use MultipartParser, thanks to Geoff Soutter
, 1.5, 2000/02/04, added auto MacBinary decoding for IE on Mac
, 1.4, 2000/01/05, added getParameterValues(), WebSphere 2.x getContentType() workaround, stopped writing empty "unknown" file
, 1.3, 1999/12/28, IE4 on Win98 lastIndexOf("boundary=") workaround
, 1.2, 1999/12/20, IE4 on Mac readNextPart() workaround
, 1.1, 1999/01/15, JSDK readLine() bug workaround
, 1.0, 1998/09/18

作者:

Jason Hunter, Geoff Soutter

另请参阅:

MultipartParser

字段概要

字段

限定符和类型	字段和说明
protected com.oreilly.servlet.FileMap	files
protected Hashtable	parameters

构造器概要

构造器

构造器和说明
MultipartRequest(javax.servlet.http.HttpServletRequest request, String saveDirectory) Constructs a new MultipartRequest to handle the specified request, saving any uploaded files to the given directory, and limiting the upload size to 1 Megabyte.
MultipartRequest(javax.servlet.http.HttpServletRequest request, String saveDirectory, long maxPostSize) Constructs a new MultipartRequest to handle the specified request, saving any uploaded files to the given directory, and limiting the upload size to the specified length.
MultipartRequest(javax.servlet.http.HttpServletRequest request, String saveDirectory, long maxPostSize, FileRenamePolicy policy) Constructs a new MultipartRequest to handle the specified request, saving any uploaded files to the given directory, and limiting the upload size to the specified length.
MultipartRequest(javax.servlet.http.HttpServletRequest request, String saveDirectory, long maxPostSize, String encoding) Constructs a new MultipartRequest to handle the specified request, saving any uploaded files to the given directory, and limiting the upload size to the specified length.
MultipartRequest(javax.servlet.http.HttpServletRequest request, String saveDirectory, long maxPostSize, String encoding, FileRenamePolicy policy)
MultipartRequest(javax.servlet.http.HttpServletRequest request, String saveDirectory, String encoding) Constructs a new MultipartRequest to handle the specified request, saving any uploaded files to the given directory, and limiting the upload size to the specified length.
MultipartRequest(javax.servlet.ServletRequest request, String saveDirectory) Constructor with an old signature, kept for backward compatibility.
MultipartRequest(javax.servlet.ServletRequest request, String saveDirectory, long maxPostSize) Constructor with an old signature, kept for backward compatibility.

方法概要

限定符和类型	方法和说明
String	getContentType(String name) Returns the content type of the specified file (as supplied by the client browser), or null if the file was not included in the upload.
File	getFile(String name) Returns a File object for the specified file saved on the server's filesystem, or null if the file was not included in the upload.
Enumeration	getFileNames() Returns the names of all the uploaded files as an Enumeration of Strings.
Set<String>	getFileNameSet() jfinal 3.2 以及后续版本使用该方法来取出上传文件的文件名 避免构造 Enumeration 对象
String	getFilesystemName(String name) Returns the filesystem name of the specified file, or null if the file was not included in the upload.
String	getOriginalFileName(String name) Returns the original filesystem name of the specified file (before any renaming policy was applied), or null if the file was not included in the upload.
String	getParameter(String name) Returns the value of the named parameter as a String, or null if the parameter was not sent or was sent without a value.
Enumeration	getParameterNames() Returns the names of all the parameters as an Enumeration of Strings.
String[]	getParameterValues(String name) Returns the values of the named parameter as a String array, or null if the parameter was not sent.
void	parse(javax.servlet.http.HttpServletRequest request, String saveDirectory, long maxPostSize, String encoding, FileRenamePolicy policy) Constructs a new MultipartRequest to handle the specified request, saving any uploaded files to the given directory, and limiting the upload size to the specified length.

从类继承的方法 java.lang.Object

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

字段详细资料

parameters

protected Hashtable parameters

files

protected com.oreilly.servlet.FileMap files

构造器详细资料

MultipartRequest

public MultipartRequest(javax.servlet.http.HttpServletRequest request,
                        String saveDirectory)
                 throws IOException

Constructs a new MultipartRequest to handle the specified request, saving any uploaded files to the given directory, and limiting the upload size to 1 Megabyte. If the content is too large, an IOException is thrown. This constructor actually parses the multipart/form-data and throws an IOException if there's any problem reading or parsing the request.

参数:

request - the servlet request.

saveDirectory - the directory in which to save any uploaded files.

抛出:

IOException - if the uploaded content is larger than 1 Megabyte or there's a problem reading or parsing the request.

MultipartRequest

public MultipartRequest(javax.servlet.http.HttpServletRequest request,
                        String saveDirectory,
                        long maxPostSize)
                 throws IOException

Constructs a new MultipartRequest to handle the specified request, saving any uploaded files to the given directory, and limiting the upload size to the specified length. If the content is too large, an IOException is thrown. This constructor actually parses the multipart/form-data and throws an IOException if there's any problem reading or parsing the request.

参数:

request - the servlet request.

saveDirectory - the directory in which to save any uploaded files.

maxPostSize - the maximum size of the POST content.

抛出:

IOException - if the uploaded content is larger than maxPostSize or there's a problem reading or parsing the request.

MultipartRequest

public MultipartRequest(javax.servlet.http.HttpServletRequest request,
                        String saveDirectory,
                        String encoding)
                 throws IOException

Constructs a new MultipartRequest to handle the specified request, saving any uploaded files to the given directory, and limiting the upload size to the specified length. If the content is too large, an IOException is thrown. This constructor actually parses the multipart/form-data and throws an IOException if there's any problem reading or parsing the request.

参数:

request - the servlet request.

saveDirectory - the directory in which to save any uploaded files.

encoding - the encoding of the response, such as ISO-8859-1

抛出:

IOException - if the uploaded content is larger than 1 Megabyte or there's a problem reading or parsing the request.

MultipartRequest

public MultipartRequest(javax.servlet.http.HttpServletRequest request,
                        String saveDirectory,
                        long maxPostSize,
                        FileRenamePolicy policy)
                 throws IOException

Constructs a new MultipartRequest to handle the specified request, saving any uploaded files to the given directory, and limiting the upload size to the specified length. If the content is too large, an IOException is thrown. This constructor actually parses the multipart/form-data and throws an IOException if there's any problem reading or parsing the request.

参数:

request - the servlet request.

saveDirectory - the directory in which to save any uploaded files.

maxPostSize - the maximum size of the POST content.

policy - the rules for renaming in case of file name collisions

抛出:

IOException - if the uploaded content is larger than maxPostSize or there's a problem reading or parsing the request.

MultipartRequest

public MultipartRequest(javax.servlet.http.HttpServletRequest request,
                        String saveDirectory,
                        long maxPostSize,
                        String encoding)
                 throws IOException

Constructs a new MultipartRequest to handle the specified request, saving any uploaded files to the given directory, and limiting the upload size to the specified length. If the content is too large, an IOException is thrown. This constructor actually parses the multipart/form-data and throws an IOException if there's any problem reading or parsing the request.

参数:

request - the servlet request.

saveDirectory - the directory in which to save any uploaded files.

maxPostSize - the maximum size of the POST content.

encoding - the encoding of the response, such as ISO-8859-1

抛出:

IOException - if the uploaded content is larger than maxPostSize or there's a problem reading or parsing the request.

MultipartRequest

public MultipartRequest(javax.servlet.http.HttpServletRequest request,
                        String saveDirectory,
                        long maxPostSize,
                        String encoding,
                        FileRenamePolicy policy)
                 throws IOException

抛出:

IOException

MultipartRequest

public MultipartRequest(javax.servlet.ServletRequest request,
                        String saveDirectory)
                 throws IOException

Constructor with an old signature, kept for backward compatibility. Without this constructor, a servlet compiled against a previous version of this class (pre 1.4) would have to be recompiled to link with this version. This constructor supports the linking via the old signature. Callers must simply be careful to pass in an HttpServletRequest.

抛出:

IOException

MultipartRequest

public MultipartRequest(javax.servlet.ServletRequest request,
                        String saveDirectory,
                        long maxPostSize)
                 throws IOException

Constructor with an old signature, kept for backward compatibility. Without this constructor, a servlet compiled against a previous version of this class (pre 1.4) would have to be recompiled to link with this version. This constructor supports the linking via the old signature. Callers must simply be careful to pass in an HttpServletRequest.

抛出:

IOException

方法详细资料

parse

public void parse(javax.servlet.http.HttpServletRequest request,
                  String saveDirectory,
                  long maxPostSize,
                  String encoding,
                  FileRenamePolicy policy)
           throws IOException

Constructs a new MultipartRequest to handle the specified request, saving any uploaded files to the given directory, and limiting the upload size to the specified length. If the content is too large, an IOException is thrown. This constructor actually parses the multipart/form-data and throws an IOException if there's any problem reading or parsing the request. To avoid file collisions, this constructor takes an implementation of the FileRenamePolicy interface to allow a pluggable rename policy.

参数:

request - the servlet request.

saveDirectory - the directory in which to save any uploaded files.

maxPostSize - the maximum size of the POST content.

encoding - the encoding of the response, such as ISO-8859-1

policy - a pluggable file rename policy

抛出:

IOException - if the uploaded content is larger than maxPostSize or there's a problem reading or parsing the request.

getParameterNames

public Enumeration getParameterNames()

Returns the names of all the parameters as an Enumeration of Strings. It returns an empty Enumeration if there are no parameters.

返回:

the names of all the parameters as an Enumeration of Strings.

getFileNames

public Enumeration getFileNames()

Returns the names of all the uploaded files as an Enumeration of Strings. It returns an empty Enumeration if there are no file input fields on the form. Any file input field that's left empty will result in a FilePart with null contents. Each file name is the name specified by the form, not by the user.

返回:

the names of all the uploaded files as an Enumeration of Strings.

getFileNameSet

public Set<String> getFileNameSet()

jfinal 3.2 以及后续版本使用该方法来取出上传文件的文件名 避免构造 Enumeration 对象

getParameter

public String getParameter(String name)

Returns the value of the named parameter as a String, or null if the parameter was not sent or was sent without a value. The value is guaranteed to be in its normal, decoded form. If the parameter has multiple values, only the last one is returned (for backward compatibility). For parameters with multiple values, it's possible the last "value" may be null.

参数:

name - the parameter name.

返回:

the parameter value.

getParameterValues

public String[] getParameterValues(String name)

Returns the values of the named parameter as a String array, or null if the parameter was not sent. The array has one entry for each parameter field sent. If any field was sent without a value that entry is stored in the array as a null. The values are guaranteed to be in their normal, decoded form. A single value is returned as a one-element array.

参数:

name - the parameter name.

返回:

the parameter values.

getFilesystemName

public String getFilesystemName(String name)

Returns the filesystem name of the specified file, or null if the file was not included in the upload. A filesystem name is the name specified by the user. It is also the name under which the file is actually saved.

参数:

name - the html page's file parameter name.

返回:

the filesystem name of the file.

getOriginalFileName

public String getOriginalFileName(String name)

Returns the original filesystem name of the specified file (before any renaming policy was applied), or null if the file was not included in the upload. A filesystem name is the name specified by the user.

参数:

name - the html page's file parameter name.

返回:

the original file name of the file.

getContentType

public String getContentType(String name)

Returns the content type of the specified file (as supplied by the client browser), or null if the file was not included in the upload.

参数:

name - the html page's file parameter name.

返回:

the content type of the file.

getFile

public File getFile(String name)

Returns a File object for the specified file saved on the server's filesystem, or null if the file was not included in the upload.

参数:

name - the html page's file parameter name.

返回:

a File object for the named file.