Overview

This document will describe the migration of fileUpload component.

information from 3.3.x:

references:

http://docs.jboss.org/richfaces/latest_3_3_X/en/devguide/html/rich_fileUpload.html

tld:

http://docs.jboss.org/richfaces/latest_3_3_X/en/tlddoc/rich/fileUpload.html

svn

Related requests and jiras:

list of jira's

Removed features

• Upload Data - duplicates the uploadListener functionality.

Base functionality - to be implemented in M5

• Modes
  • html
• upload
  • optional restriction for the same named files upload
  • limitation of size per file (for application)
  • in memory/disk files storing
  • limitation for files per extension/type
  • support for multiple files upload
  • context parameters for directory specifying as for 3.3
  • already possible to add messages from listener and it will be shown in ajaxRendered zone.
    • render and execute in long term
• Markup redefinition

• Entries list
  • Clear functionality for single file
  • Clear all
• Upload progress
  • using plugged by default progressBar
  • PB could be customized through definition in named facet
• Disabled state for component
• Visual presets
  • 3.3.x look and feel (except long term)
• Client side events
  • before upload - every file
  • upload of all files finished

Long Term

• Modes
  • flash
• Upload
  • customization of count of files available for upload ??
  • Auto clearing the list
  • Immediate upload
  • size limitation per component (seems not really possible with current impl. need to review.)
  • execute&render attributes + review other ajax ones which possible to add.
  • possibility to return state of single upload in listener.
• Markup redefinition
  • Labels definition through resource bundles
  • Customization which was available using macrosubstitutions
    • header controls and labels set
    • entry controls and labels set
• "Stop" functionality for upload
• Servlets 3 native upload capabilities support
• Visual preset
  • based on simple  <input type="file"/> elements

• Client API
• Client side events
  • upload of single file finished
  • add file
  • remove file
  • stop
  • cancel
  • clear
  • transfer error
  • size error
  • type rejected

Questionable

• Validation
  • If we can't support normal FAces validation (as fileUpload not actually input but works through UploadEvent) - we need to have possibility to add messages from listener and abort further processing.
  • still want to try to support required.