javazoom.upload
Class MultipartFormDataRequest

java.lang.Object
  javazoom.upload.MultipartFormDataRequest

public class MultipartFormDataRequest

extends java.lang.Object

This class implements a "multipart/form-data" HTTP request parser.
You need one to handle HTTP request for uploading files.

Field Summary

static java.lang.String	CFUPARSER Commons FileUpload parser
static java.lang.String	COSPARSER Cos parser
static java.lang.String	DEFAULTENCODING Default encoding : iso-8859-1
static java.lang.String	DEFAULTPARSER Default multipart parser implementation is COSPARSER
static int	MAXCONTENTLENGTHALLOWED Maximum "Content-Length" size allowed (to avoid DoS attacks) : Default is 1GB
static java.lang.String	PARSERTEMPDIRECTORY Struts multipart parser temporary directory : System temp directory
static java.lang.String	STRUTSPARSER Struts parser

Constructor Summary

MultipartFormDataRequest(javax.servlet.http.HttpServletRequest req)
Constructs a MultipartFormDataRequest from an HttpServletRequest.

MultipartFormDataRequest(javax.servlet.http.HttpServletRequest req, java.util.Vector listeners)
Constructs a MultipartFormDataRequest from an HttpServletRequest.

MultipartFormDataRequest(javax.servlet.http.HttpServletRequest req, java.util.Vector listeners, int maxcontentlength)
Constructs a MultipartFormDataRequest from an HttpServletRequest.

MultipartFormDataRequest(javax.servlet.http.HttpServletRequest req, java.util.Vector listeners, int maxcontentlength, java.lang.String parser)
Constructs a MultipartFormDataRequest from an HttpServletRequest.

MultipartFormDataRequest(javax.servlet.http.HttpServletRequest req, java.util.Vector listeners, int maxcontentlength, java.lang.String parser, java.lang.String encoding)
Constructs a MultipartFormDataRequest from an HttpServletRequest.

MultipartFormDataRequest(javax.servlet.http.HttpServletRequest req, java.util.Vector listeners, int maxcontentlength, java.lang.String parser, java.lang.String encoding, boolean allowbroken)
Constructs a MultipartFormDataRequest from an HttpServletRequest.

Method Summary

java.util.Hashtable	getFiles() Returns an Hastable of UploadFile.
java.lang.String	getParameter(java.lang.String name) Returns parameter matching to name (see SERVLETS API).
java.util.Enumeration	getParameterNames() Returns parameters enumeration (see SERVLETS API).
java.lang.String[]	getParameterValues(java.lang.String name) Returns parameter values array for name (see SERVLETS API).
javax.servlet.http.HttpServletRequest	getRequest() Return HttpServletRequest after parsing.
static boolean	isMultipartFormData(javax.servlet.http.HttpServletRequest req) Check the content type to make sure it's "multipart/form-data"
static void	isParserAvailable(java.lang.String classname) Checks if multipart parser in CLASSPATH.

Methods inherited from class java.lang.Object

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

Field Detail

COSPARSER

public static java.lang.String COSPARSER

Cos parser

STRUTSPARSER

public static java.lang.String STRUTSPARSER

Struts parser

CFUPARSER

public static java.lang.String CFUPARSER

Commons FileUpload parser

DEFAULTPARSER

public static java.lang.String DEFAULTPARSER

Default multipart parser implementation is COSPARSER

PARSERTEMPDIRECTORY

public static java.lang.String PARSERTEMPDIRECTORY

Struts multipart parser temporary directory : System temp directory

MAXCONTENTLENGTHALLOWED

public static int MAXCONTENTLENGTHALLOWED

Maximum "Content-Length" size allowed (to avoid DoS attacks) : Default is 1GB

DEFAULTENCODING

public static java.lang.String DEFAULTENCODING

Default encoding : iso-8859-1

Constructor Detail

MultipartFormDataRequest

public MultipartFormDataRequest(javax.servlet.http.HttpServletRequest req,
                                java.util.Vector listeners,
                                int maxcontentlength,
                                java.lang.String parser,
                                java.lang.String encoding,
                                boolean allowbroken)
                         throws UploadException,
                                java.io.IOException

Constructs a MultipartFormDataRequest from an HttpServletRequest. Upload is done there. All HTTP parameters are loaded and, depending on parser selection, uploaded files in memory or in cache/temporary folder. You can also specify maximum "Content-Length" size for the POST request, encoding and UploadListeners. Set "allowbroken" parameter to true to allow UploadBean to store broken upload.

Parameters:

req - HttpServletRequest

listeners - Vector

maxcontentlength - int

parser - String

encoding - String

allowbroken - boolean

Throws:

UploadException

java.io.IOException

MultipartFormDataRequest

public MultipartFormDataRequest(javax.servlet.http.HttpServletRequest req,
                                java.util.Vector listeners,
                                int maxcontentlength,
                                java.lang.String parser,
                                java.lang.String encoding)
                         throws UploadException,
                                java.io.IOException

Constructs a MultipartFormDataRequest from an HttpServletRequest. Upload is done there. All HTTP parameters are loaded and, depending on parser selection, uploaded files in memory or in cache/temporary folder. You can also specify maximum "Content-Length" size for the POST request, encoding and UploadListeners.

Parameters:

req - HttpServletRequest

listeners - Vector

maxcontentlength - int

parser - String

encoding - String

Throws:

UploadException

java.io.IOException

MultipartFormDataRequest

public MultipartFormDataRequest(javax.servlet.http.HttpServletRequest req,
                                java.util.Vector listeners,
                                int maxcontentlength,
                                java.lang.String parser)
                         throws UploadException,
                                java.io.IOException

Constructs a MultipartFormDataRequest from an HttpServletRequest. Upload is done there. All HTTP parameters and uploaded files are loaded. You can also specify maximum "Content-Length" size for the POST request and the multipart parser.

Parameters:

req - HttpServletRequest

listeners - Vector

maxcontentlength - int

parser - String

Throws:

UploadException

java.io.IOException

MultipartFormDataRequest

public MultipartFormDataRequest(javax.servlet.http.HttpServletRequest req,
                                java.util.Vector listeners,
                                int maxcontentlength)
                         throws UploadException,
                                java.io.IOException

Constructs a MultipartFormDataRequest from an HttpServletRequest. Upload is done there. All HTTP parameters and uploaded files are loaded. You can also specify maximum "Content-Length" size for the POST request.

Parameters:

req - HttpServletRequest

listeners - Vector

maxcontentlength - int

Throws:

UploadException

java.io.IOException

MultipartFormDataRequest

public MultipartFormDataRequest(javax.servlet.http.HttpServletRequest req,
                                java.util.Vector listeners)
                         throws UploadException,
                                java.io.IOException

Constructs a MultipartFormDataRequest from an HttpServletRequest. Upload is done there. All HTTP parameters and uploaded files are loaded. You can add UploadListebers too.

Parameters:

req - HttpServletRequest

listeners - Vector

Throws:

UploadException

java.io.IOException

MultipartFormDataRequest

public MultipartFormDataRequest(javax.servlet.http.HttpServletRequest req)
                         throws UploadException,
                                java.io.IOException

Constructs a MultipartFormDataRequest from an HttpServletRequest. Upload is done there. All HTTP parameters and uploaded files are loaded.

Parameters:

req - HttpServletRequest

Throws:

UploadException

java.io.IOException

Method Detail

getRequest

public javax.servlet.http.HttpServletRequest getRequest()

Return HttpServletRequest after parsing.

Returns:

HttpServletRequest

getFiles

public java.util.Hashtable getFiles()

Returns an Hastable of UploadFile. Hashtable isEmpty() method returns true only if there is no input file field in the HTML form.

Returns:

Hashtable

getParameterNames

public java.util.Enumeration getParameterNames()

Returns parameters enumeration (see SERVLETS API).

Returns:

Enumeration

getParameter

public java.lang.String getParameter(java.lang.String name)

Returns parameter matching to name (see SERVLETS API).

Parameters:

name - String

Returns:

String

getParameterValues

public java.lang.String[] getParameterValues(java.lang.String name)

Returns parameter values array for name (see SERVLETS API).

Parameters:

name - String

Returns:

String[]

isMultipartFormData

public static boolean isMultipartFormData(javax.servlet.http.HttpServletRequest req)

Check the content type to make sure it's "multipart/form-data"

Parameters:

req - HttpServletRequest

Returns:

boolean

isParserAvailable

public static void isParserAvailable(java.lang.String classname)
                              throws UploadException

Checks if multipart parser in CLASSPATH.

Parameters:

classname - String

Throws:

UploadException