[ANNOUNCEMENT] Commons FileUpload 1.0 Released

[Martin Cooper <ma...@apache.org>]

The FileUpload team is pleased to announce the Final release of Commons
FileUpload 1.0. This is the first official release of the FileUpload
component from the Apache Software Foundation.

The binary distribution is available at:

http://jakarta.apache.org/site/binindex.cgi

and the source distribution is available at:

http://jakarta.apache.org/site/sourceindex.cgi

When downloading from a mirror site, please remember to verify the
signatures of the distribution using the keys found on the main Apache web
site:

http://www.apache.org/dist/jakarta/commons/fileupload/KEYS

For more information on Commons FileUpload, see the FileUpload web site:

http://jakarta.apache.org/commons/fileupload/

--
Martin Cooper

[FILEUPLOAD] Progress reporting

[Peter Courcoux <pe...@courcoux.biz>]

Martin,

Congratulations and thanks for the hard work getting the 1.0 release
out. 

As discussed some while ago, I have patches to fileupload which enable
support for file upload progress reporting. These are attached below.

I have changed the implementation since first proposing this on the list
and believe that these are backwards compatible. 

Issues for consideration:-

We report only the names of files extracted from fileitems as they are
parsed and ignore other field names.

MultipartStream updates the reporter object every time its internal
buffer is filled from the request InputStream. This internal buffer
defaults to 4k in size and the reporter is therefore updated in 4k
chunks. This is configurable only by specifying the buffer size. This
seems to be a reasonable compromise between fine grain updating and
performance. It is also why I have chosen not to report fields as they
are read as I guess that the updating is not frequent enough to allow
any meaningful information in most cases.

The default implementation of reporting is minimal, but can be extended
to provide percentage done and graphical progress reporting etc.

I hope I have put the right licence in the files. Please note that as
the changes are to add functionality, I have added myself as an author
to the files I have changed. I do not know what the protocol for this
is. Feel free to remove this if not correct.

I have tried to put some usage notes in the javadocs. However, I am
currently using this implementation with Turbine and will submit the
required changes to turbine-dev, including a detailed howto with example
code.

Regards,

Peter
-- 
Peter Courcoux <pe...@courcoux.biz>