Notify the callback of another file that has been uploaded
Check fileInfo.getStatus() to determine if the file has pre-failed
uploading, due to too many files uploaded, an invalid file extension,
or content type.
If we detect that a file failed, say because it's over quota, then
we'll tell the callback, and it might massage the result, to still
accept the file, or possibly to fail the file that we thought was ok,
by calling FileEntryResults.FileInfo.updateStatus(FileEntryStatus, boolean).
When files are being uploaded, they will be saved into the file-system
unless a FileEntryCallback is provided, in which case the application
may take responsibility for the process of saving the files.
The uploaded files need to be processed before RestoreViewPhase, meaning
that the FileEntry component is not yet available, to direct how and where
to save the files.
FileEntryStatuses are the built-in statuses which correspond to the
localised messages defined in the org.icefaces.component.resources.messages
ResourceBundle.
When formatting the MessageFormat patterns that comes from the
ResourceBundles, the following parameters are provided:
param[0] : label (Identifies the fileEntry component)
param[1] : fileName (The original file name, on user's computer)
param[2] : contentType (MIME type of uploaded file)
param[3] : file (Stored file, on server)
param[4] : size (Size of the uploaded file)
param[5] : maxTotalSize (Maximum sum of all uploaded file sizes)
param[6] : maxFileSize (Maximum size of each uploaded file)
param[7] : maxFileCount (Maximum number of uploaded files)
When formatting the MessageFormat patterns that comes from the
ResourceBundles, for the required status, the following parameters
are provided:
param[0] : label (Identifies the fileEntry component)
FileEntry depends on this event being broadcast every lifecycle that
it executes, whereas the fileEntryListener should only be invoked when
files have been uploaded.
To properly function, dateTimeEntry needs to use the same timezone
in the inputText field as well as the calendar, which is accomplished
by using a javax.faces.convert.DateTimeConverter, which provides
the required Converter behaviours, as we as gives access to its
TimeZone object.
In the fileEntryListener, applications may override the uploaded
files' statuses, if the files fail the application's custom
validation, by using this method.