org.apache.myfaces.trinidad.webapp
Interface UploadedFileProcessor


public interface UploadedFileProcessor

Interface responsible for processing file uploads. An Apache Trinidad application has a single UploadedFileProcessor instance. It is accessible from the RequestContext, but will be invoked automatically by the framework as needed. Developers can replace the standard processor using the trinidad-config.xml file.

To configure file uploads, the default instance supports three context initialization parameters :

See Also:
UploadedFile

Field Summary
static java.lang.String MAX_DISK_SPACE_PARAM_NAME
          Initialization parameter for the default UploadedFileProcessor that configures the maximum amount of disk space that can be used in a single request to store uploaded files.
static java.lang.String MAX_MEMORY_PARAM_NAME
          Initialization parameter for the default UploadedFileProcessor that configures the maximum amount of memory that can be used in a single request to store uploaded files.
static java.lang.String TEMP_DIR_PARAM_NAME
          Initialization parameter for the default UploadedFileProcessor that configures the to the directory where temporary files should be stored while uploading.
 
Method Summary
 void init(java.lang.Object context)
          Initialize the UploadedFileProcessor with access to the current web application context.
 UploadedFile processFile(java.lang.Object request, UploadedFile file)
          Process a single uploaded file, moving it from temporary storage to per-request storage.
 

Field Detail

MAX_MEMORY_PARAM_NAME

static final java.lang.String MAX_MEMORY_PARAM_NAME
Initialization parameter for the default UploadedFileProcessor that configures the maximum amount of memory that can be used in a single request to store uploaded files. Any requirements above this will be stored on disk. The default is 100 kilobytes.

See Also:
Constant Field Values

MAX_DISK_SPACE_PARAM_NAME

static final java.lang.String MAX_DISK_SPACE_PARAM_NAME
Initialization parameter for the default UploadedFileProcessor that configures the maximum amount of disk space that can be used in a single request to store uploaded files. The default is 2000 kilobytes. Any requests that exceed this size will result in an EOFException being thrown on that request.

See Also:
Constant Field Values

TEMP_DIR_PARAM_NAME

static final java.lang.String TEMP_DIR_PARAM_NAME
Initialization parameter for the default UploadedFileProcessor that configures the to the directory where temporary files should be stored while uploading. This defaults to the the application server's temporary directory, as provided by the "javax.servlet.context.tempdir" property. If that is not set, the System "java.io.tempdir" property will be used as a backup.

See Also:
Constant Field Values
Method Detail

init

void init(java.lang.Object context)
Initialize the UploadedFileProcessor with access to the current web application context.

Parameters:
context - the current ServletContext or PortletContext

processFile

UploadedFile processFile(java.lang.Object request,
                         UploadedFile file)
                         throws java.io.IOException
Process a single uploaded file, moving it from temporary storage to per-request storage. An implementation of this method must process an incoming UploadedFile object and return a new UploadedFile instance that will remain valid for the duration of this request. The incoming UploadedFile object is a temporary file object that has a number of restrictions:

The UploadedFile object returned from this method must remain valid for the duration of this request. The framework guarantees that UploadedFile.dispose() will be called before the request completes.

Parameters:
request - the current servlet or portlet request
file - a temporary file object
Returns:
a new instance of UploadedFile. It is legal to return null, in which case the file will not be available later in the request.
Throws:
java.io.IOException


Copyright © 2001-2008 The Apache Software Foundation. All Rights Reserved.