pt.moredata.dataentry.util.http
Class MultipartServletRequest

java.lang.Object
  pt.moredata.dataentry.util.http.MultipartServletRequest

public class MultipartServletRequest

extends java.lang.Object

Company MoreData

Version:

$Revision: 1.3 $

Author:

pcarmo

Field Summary

protected java.util.Hashtable	files Lista de ficheiros enviados pelo browser.
protected java.util.Hashtable	filesData InputStreams dos ficheiros, indexados pelo nome do ficheiro.
protected java.util.Hashtable	parameters Lista de parametros enviados pelo browser.

Constructor Summary

MultipartServletRequest(javax.servlet.http.HttpServletRequest request)

MultipartServletRequest(javax.servlet.http.HttpServletRequest request, java.lang.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.

MultipartServletRequest(javax.servlet.http.HttpServletRequest request, java.lang.String saveDirectory, int 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.

MultipartServletRequest(javax.servlet.ServletRequest request, java.lang.String saveDirectory)
Constructor with an old signature, kept for backward compatibility.

MultipartServletRequest(javax.servlet.ServletRequest request, java.lang.String saveDirectory, int maxPostSize)
Constructor with an old signature, kept for backward compatibility.

Method Summary

java.lang.String	getContentType(java.lang.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.
java.io.File	getFile(java.lang.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.
java.util.Enumeration	getFileNames() Returns the names of all the uploaded files as an Enumeration of Strings.
byte[]	getFilesData(java.lang.String fileName) Devolve o conteudo de um ficheiro que foi recebido via http.
java.lang.String	getFilesystemName(java.lang.String name) Returns the filesystem name of the specified file, or null if the file was not included in the upload.
java.lang.String	getParameter(java.lang.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.
java.util.Enumeration	getParameterNames() Returns the names of all the parameters as an Enumeration of Strings.
java.lang.String[]	getParameterValues(java.lang.String name) Returns the values of the named parameter as a String array, or null if the parameter was not sent.

Methods inherited from class java.lang.Object

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

Field Detail

parameters

protected java.util.Hashtable parameters

Lista de parametros enviados pelo browser.

files

protected java.util.Hashtable files

Lista de ficheiros enviados pelo browser.

filesData

protected java.util.Hashtable filesData

InputStreams dos ficheiros, indexados pelo nome do ficheiro.

Constructor Detail

MultipartServletRequest

public MultipartServletRequest(javax.servlet.http.HttpServletRequest request,
                               java.lang.String saveDirectory)
                        throws java.io.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.

Parameters:

request - the servlet request.

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

Throws:

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

MultipartServletRequest

public MultipartServletRequest(javax.servlet.http.HttpServletRequest request)
                        throws java.io.IOException

MultipartServletRequest

public MultipartServletRequest(javax.servlet.http.HttpServletRequest request,
                               java.lang.String saveDirectory,
                               int maxPostSize)
                        throws java.io.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.

Parameters:

request - the servlet request.

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

maxPostSize - the maximum size of the POST content.

Throws:

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

MultipartServletRequest

public MultipartServletRequest(javax.servlet.ServletRequest request,
                               java.lang.String saveDirectory)
                        throws java.io.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.

MultipartServletRequest

public MultipartServletRequest(javax.servlet.ServletRequest request,
                               java.lang.String saveDirectory,
                               int maxPostSize)
                        throws java.io.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.

Method Detail

getFilesData

public byte[] getFilesData(java.lang.String fileName)

Devolve o conteudo de um ficheiro que foi recebido via http.

Parameters:

fileName - O nome do ficheiro que foi recebido.

getParameterNames

public java.util.Enumeration getParameterNames()

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

Returns:

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

getFileNames

public java.util.Enumeration getFileNames()

Returns the names of all the uploaded files as an Enumeration of Strings. It returns an empty Enumeration if there are no uploaded files. Each file name is the name specified by the form, not by the user.

Returns:

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

getParameter

public java.lang.String getParameter(java.lang.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.

Parameters:

name - the parameter name.

Returns:

the parameter value.

getParameterValues

public java.lang.String[] getParameterValues(java.lang.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.

Parameters:

name - the parameter name.

Returns:

the parameter values.

getFilesystemName

public java.lang.String getFilesystemName(java.lang.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.

Parameters:

name - the file name.

Returns:

the filesystem name of the file.

getContentType

public java.lang.String getContentType(java.lang.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.

Parameters:

name - the file name.

Returns:

the content type of the file.

getFile

public java.io.File getFile(java.lang.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.

Parameters:

name - the file name.

Returns:

a File object for the named file.